@vertigis/arcgis-extensions 37.1.1 → 37.2.1

package/mapping/_LayerExtension.js

@@ -1 +1 @@
-import{__decorate}from"tslib";import{ArgumentError}from"../ArgumentError.js";import{InvalidOperationError}from"../InvalidOperationError.js";import{ItemType}from"../ItemType.js";import{FeatureSourceBase}from"../data/FeatureSourceBase.js";import{Schema}from"../data/Schema.js";import{LayerBase as PortalLayerBase}from"../portal/LayerBase.js";import{ERR_LAYER_TYPE_MISMATCH}from"../portal/_layerHelper.js";import{DefaultArcGISRequestHelper}from"../support/ArcGISRequestHelper.js";import{ReadOnlyInitializableCollection}from"../support/ReadOnlyInitializableCollection.js";import{serializable}from"../support/Serializable.js";import{CollectionProxy}from"../utilities/CollectionProxy.js";import{isLayer}from"../utilities/_layers.js";import{checkArg}from"../utilities/checkArg.js";import{Collection,compare}from"../utilities/collection.js";import{load}from"../utilities/esri.js";import{isGroupLayerExtension}from"../utilities/extensions.js";import{hasMmapLayer}from"../utilities/layers.js";import{getLogger}from"../utilities/log.js";import{deepClone}from"../utilities/object.js";import{toPortalItem}from"../utilities/portal.js";import{onCollectionPropertyChange,watchEach}from"../utilities/watch.js";import{_assignSublayerExtensions}from"./_SublayerExtension.js";import{ExtensionBaseLayerListSettings,fromLayerListMode}from"./support/LayerListSettings.js";import{SublayerExtensionCollectionBase}from"./support/_SublayerExtensionCollection.js";const ERR_INVALID_LAYER_TYPE="Invalid type of layer for this type of layer extension.",ERR_FEATURES_NOT_SUPPORTED="This type of layer does not have features.",ERR_ADD_SUBLAYERX_NOT_SUPPORTED="This type of layer cannot have sublayers.",ERR_SCHEMA_READ_ONLY="This schema property is read-only.",DEFAULT_CAPABILITIES=Object.freeze({supportsAdd:!1,supportsUpdate:!1,supportsDelete:!1,supportsEditing:!1,supportsQuery:!1,supportsAttachmentEditing:!1});export class LayerExtension extends FeatureSourceBase{constructor(e){super(e),this._itemType=ItemType.LAYER_EXTENSION,this._watchHandles=[],this._dynamicallyAddedLayer=!1,this._visibilityMode="independent",this._onSublayerAddedPostInitialize=async e=>{try{await e.initialize()}catch(t){getLayerXLogger().error({message:`Error occurred while initializing sublayer extension for sublayer '${e.title??e.sublayer.id??e.id}'.`,error:t})}},this._onVisibleChanged=e=>{if("inherited"===this.visibilityMode&&this.supportsSublayers&&this._sublayers)for(const t of this._sublayers.toArray())t.visible=e;this.notifyChange("isEffectivelyVisible")},this._onSublayersSublayerVisibleChanged=(e,t,i,r)=>{e&&"exclusive"===this.visibilityMode&&this._ensureAChildSublayerVisible(r)},this._onSublayersChange=e=>{e.added?.length&&"exclusive"===this.visibilityMode&&this._ensureAChildSublayerVisible(e.added[e.added.length-1])};const t={...this.getDefaults(),...e};checkArg("properties.layer",t.layer).isNotMissing();const{layer:i}=t;let r;if(i?.hasOwnProperty("listMode")&&(r=fromLayerListMode(i.listMode)),this.layerListSettings=this._createLayerListSettings({...r,...t.layerListSettings}),isLayer(i))checkArg("properties.layer",i).satisfies((e=>this._isSupportedLayer(e)),ERR_INVALID_LAYER_TYPE),this._setLayer(i);else if(i){if(i.$portalItem){const e=i.$portalItem;this._portalItem=toPortalItem(e)}this._deferredLayerProperties=i}this._sublayerExtensions=this._createSublayerExtensionCollection(),this.allSublayerExtensions=new AllSublayerExtensionCollectionImpl(this),this.watch("parentLayerExtension.isEffectivelyVisible",(()=>this.notifyChange("isEffectivelyVisible"))),this.watch("layer.sublayers",(()=>this.notifyChange("_sublayers")))}get layer(){return this._layer}get mapExtension(){return this._mapExtension}get basemapExtension(){return this._basemapExtension}get groundExtension(){return this._groundExtension}get parentLayerExtension(){return this._parentLayerExtension}get hasFeatures(){return!1}get capabilities(){return this._capabilities()}get renderer(){}get visibilityMode(){return this._visibilityMode}set visibilityMode(e){this._visibilityMode=e,"exclusive"===e&&this._ensureAtMostOneChildSublayerVisible()}get sublayerExtensions(){return this._sublayerExtensions}get requestHelper(){return this._requestHelper||(this._requestHelper=new DefaultArcGISRequestHelper),this._requestHelper}set requestHelper(e){this._requestHelper=e}get title(){return this.layer?.title??this._deferredLayerProperties?.title??("string"==typeof this._deferredLayerProperties?.$ref?this._deferredLayerProperties?.$ref:this._deferredLayerProperties?.$ref?.title??this._deferredLayerProperties?.$ref?.id)??"Layer"}get supportsSublayers(){return!1}get effectiveMinScale(){return this.layer&&this.layer.minScale||0}get effectiveMaxScale(){return this.layer&&this.layer.maxScale||0}get isEffectivelyVisible(){const e=!!this.layer&&this.layer.visible;return this.parentLayerExtension?this.parentLayerExtension.isEffectivelyVisible&&e:e}get effectiveFullExtent(){return this.layer?this.layer.fullExtent:void 0}get canChangeScale(){return!0}get canChangeOpacity(){return!0}get canChangeLabels(){return!1}get initialVisibility(){return this._initialVisibility??this.layer?.visible??!1}get _layerSupportsHideChildren(){return this.supportsSublayers}get _sublayers(){if(this.supportsSublayers)return this.layer?this.layer.sublayers:void 0}get dynamicallyAddedLayer(){return this._dynamicallyAddedLayer}set dynamicallyAddedLayer(e){this._dynamicallyAddedLayer=e}get sublayersAreReadOnly(){return!0}static create(e){if(!LayerExtension.factory)throw new InvalidOperationError("Cannot create layer extension: no layer extension factory has been registered.");return LayerExtension.factory.create(e)}static async fromPortalItem(e,t){checkArg("portalItemLike",e).isNotMissing();const i=t??{};checkArg("layerExtensionProperties.layer",i.layer).satisfies((e=>!isLayer(e)));const r={...i.layer};checkArg("layerExtensionProperties.layer.$ref",r.$ref).satisfies((e=>null==e));const s=new DefaultArcGISRequestHelper,a=toPortalItem(e);let n;await load(a);const o=a.typeKeywords??"";if("Map Service"===a.type)n=o.includes("Tiled")||o.includes("Hosted Service")?"ArcGISTiledMapServiceLayer":"ArcGISMapServiceLayer";else if("Feature Service"===a.type)n="ArcGISFeatureLayer";else if("Image Service"===a.type){const e=await LayerExtension._getLayerData(a.url,s);e.cacheType?"Map"===e.cacheType?n="ArcGISTiledImageServiceLayer":("Elevation"===e.cacheType||o.includes("Elevation 3D Layer"))&&(n="ArcGISTiledElevationServiceLayer"):n=e.singleFusedMapCache||e.tileInfo||o.includes("Hosted Service")?"ArcGISTiledImageServiceLayer":"ArcGISImageServiceLayer"}else if("CSV"===a.type)n="CSV";else if("KML"===a.type)n="KML";else if("Scene Service"===a.type)o.includes("3DObject")||o.includes("Point")?n="ArcGISSceneServiceLayer":o.includes("IntegratedMesh")?n="IntegratedMeshLayer":o.includes("PointCloud")?n="PointCloudLayer":o.includes("Building")&&(n="BuildingSceneLayer");else if("Stream Service"===a.type)n="ArcGISStreamLayer";else if("Vector Tile Service"===a.type)n="VectorTileLayer";else if("Feature Collection"===a.type){n="ArcGISFeatureLayer";const e=await a.fetchData();r.featureCollection=e}else if("WMTS"===a.type){n="WebTiledLayer";const e=await a.fetchData();Object.assign(r,e)}else if("WMS"===a.type){n="WMS";const e=await a.fetchData();Object.assign(r,e)}if(!n)throw new ArgumentError("portalItem","Could not determine correct type of LayerExtension to create from portal item");if(r.layerType&&r.layerType!==n)throw new ArgumentError("layerExtensionProperties.layer.layerType","Layer type defined in layer properties does not match layer type from portal item");return r.layerType=n,r.$portalItem=a,i.layer=r,LayerExtension.create(i)}static _matchesRef(e,t){if(!e||!t)return!1;const i=t.$ref;return"string"==typeof i?e.id===i||e.title===i:!!i&&(e.id===i.id||e.title===i.title&&!i.path)}static async _getLayerData(e,t){const i=await t.request(e,{query:{f:"json"}});if(!i||!i.data)throw new Error(`Response to request for url ${e} was invalid.`);return i.data}getFeatures(e,t){if(!this.hasFeatures)throw new InvalidOperationError(ERR_FEATURES_NOT_SUPPORTED);return super.getFeatures(e,t)}getFullExtent(){return this.effectiveFullExtent}async addFeatures(e,t){if(checkArg("features",e).isNotMissing(),!this.hasFeatures)throw new InvalidOperationError(ERR_FEATURES_NOT_SUPPORTED);await super.addFeatures(e,t)}async updateFeatures(e,t){if(checkArg("features",e).isNotMissing(),!this.hasFeatures)throw new InvalidOperationError(ERR_FEATURES_NOT_SUPPORTED);await super.updateFeatures(e,t)}async deleteFeatures(e,t){if(checkArg("features",e).isNotMissing(),!this.hasFeatures)throw new InvalidOperationError(ERR_FEATURES_NOT_SUPPORTED);await super.deleteFeatures(e,t)}async _createBackingLayer(){this._portalItem||this.layer||this._deferredLayerProperties&&this._deferredLayerProperties.$ref?!this.layer&&this._portalItem&&this._setLayer(await this._createLayer(this.getDefaults().layer)):(this._setLayer(await this._createLayer(this._deferredLayerProperties)),checkArg("properties.layer",this._layer).satisfies((e=>this._isSupportedLayer(e)),ERR_INVALID_LAYER_TYPE),this._deferredLayerProperties=void 0)}_setMapExtension(e){const t=this.mapExtension;this._mapExtension=e,t&&this.featureSettings.formatSettings.parent===t.formatSettings&&(this.featureSettings.formatSettings.parent=void 0),e&&(this.featureSettings.formatSettings.parent||(this.featureSettings.formatSettings.parent=e.formatSettings)),this._resolveLayer(),this.notifyChange("mapExtension")}_setBasemapExtension(e){this._basemapExtension=e,this._resolveLayer(),e&&(this.taskSettings.parent=e.taskSettings),this.notifyChange("basemapExtension")}_setGroundExtension(e){this._groundExtension=e,this._resolveLayer(),e&&(this.taskSettings.parent=e.taskSettings),this.notifyChange("groundExtension")}_setParentLayerExtension(e){const t=this._parentLayerExtension;this._parentLayerExtension=e,t&&(this.featureSettings.formatSettings.parent===t.featureSettings.formatSettings&&(this.featureSettings.formatSettings.parent=this.mapExtension?this.mapExtension.formatSettings:void 0),this.taskSettings.parent===t.taskSettings&&(this.taskSettings.parent=void 0)),e&&((!this.featureSettings.formatSettings.parent||this.mapExtension&&this.featureSettings.formatSettings.parent===this.mapExtension.formatSettings)&&(this.featureSettings.formatSettings.parent=e.featureSettings.formatSettings),this.taskSettings.parent||(this.taskSettings.parent=e.taskSettings)),this._resolveLayer(),this.notifyChange("parentLayerExtension")}_resolveLayer(e){if(this.layer||!this._deferredLayerProperties)return;const t=e=>LayerExtension._matchesRef(e,this._deferredLayerProperties);let i;e?i=e.find(t):this.basemapExtension?.basemap?(i=this.basemapExtension.basemap.baseLayers.find(t),i=i||this.basemapExtension.basemap.referenceLayers.find(t)):this.groundExtension?.ground?i=this.groundExtension.ground.layers.find(t):this.parentLayerExtension?.layer?i=this.parentLayerExtension.layer.layers.find(t):this.mapExtension&&(i=this.mapExtension.map.layers.find(t)),i&&this._isSupportedLayer(i)&&(this._setLayer(i),this._originalRef=this._deferredLayerProperties.$ref,this._deferredLayerProperties.$portalItem&&getLayerXLogger().warn("LayerExtension defined with both $ref and $portalItem. Ignoring $portalItem."))}async _switchLayer(e){if(e===this.layer)return;checkArg("newLayer",e).isNotMissing().satisfies((e=>this._isSupportedLayer(e)),ERR_INVALID_LAYER_TYPE),this.isInitialized&&await load(e);const t=new Map;if(this._sublayers)for(const e of this._sublayers.toArray())t.set(e.id,this.sublayerExtensions.forSublayer(e));e.visible=this.layer.visible,e.opacity=this.layer.opacity,e.listMode=this.layer.listMode,e.hasOwnProperty("labelsVisible")&&this.layer.hasOwnProperty("labelsVisible")&&(e.labelsVisible=this.layer.labelsVisible),this._setLayer(e);const i=[];if(this._sublayers){const e=this._sublayers.filter((e=>t.has(e.id))).toArray();i.push(...e.map((async e=>{const i=t.get(e.id);await i._switchSublayer(e),this._sublayerExtensions._register(i)})))}this.isInitialized&&i.push(this._initializeChildren()),await Promise.all(i)}_getProjectWebmapJSON(){if(!this.layer)return;let e=PortalLayerBase.fromEsriApiLayer(this.layer);if(!this.dynamicallyAddedLayer){const{id:t,title:i,layerType:r,visibility:s,opacity:a}=e;e={id:t,title:i,layerType:r,visibility:s,opacity:a}}return e}async _onDestroy(){this._watchHandles.forEach((e=>e?.remove())),await Promise.all(this.sublayerExtensions.toArray().map((e=>e.destroy()))),await super._onDestroy()}_getSerializableProperties(){return{...super._getSerializableProperties(),iconUrl:{serializeModes:["initial","project"],serialize:e=>"project"!==e||this.dynamicallyAddedLayer?this.iconUrl:this.getDefault("iconUrl")},visibilityMode:{serializeModes:["initial","project"],serialize:e=>"project"!==e||this.dynamicallyAddedLayer?this.visibilityMode:this.getDefault("visibilityMode"),default:"independent"},tpkSource:{serializeModes:["initial"]},layerListSettings:{serializeModes:["initial","project"],serialize:e=>"project"!==e||this.dynamicallyAddedLayer?this.layerListSettings:this.getDefault("layerListSettings")},sublayerExtensions:{serializeModes:["initial","project"],serialize:e=>this.sublayerExtensions.map((e=>e.toItemUri())).toArray(),deserialize:e=>{_assignSublayerExtensions(this.sublayerExtensions,e,(e=>this._createSublayerExtension(e)))}},layer:{serializeModes:["initial","project"],serialize:e=>{if(this.layer){if((this._mapExtension||this._parentLayerExtension||this._basemapExtension||this._groundExtension)&&(this._layer.id||this._layer.title)){const e=PortalLayerBase.getLayerType(this._layer),t=this._getSerializableRefLayerProperties();return{$ref:this._originalRef||{id:this._layer.id,title:this._layer.title,subtype:this._getSerializableLayerType()},layerType:e,...t}}return PortalLayerBase.fromEsriApiLayer(this.layer)}return this._deferredLayerProperties?deepClone(this._deferredLayerProperties):void 0},isDefault:()=>{throw new Error("Missing implementation for _getSerializableProperties() > layer > default. Subclasses of LayerExtension must implement this.")},deserialize:e=>{if(isLayer(e)){if(e!==this.layer)throw new Error("Property 'layer' is read-only.")}else e&&(this._layer?this._applyLayerProperties(e,this.layer):this._deferredLayerProperties&&(this._deferredLayerProperties={...this._deferredLayerProperties,...e}))}},dynamicallyAddedLayer:{serializeModes:["project"],default:!1},requestHelper:{serialize:!1}}}_getSerializableLayerType(){}_getSerializableRefLayerProperties(){return{}}_createSublayerExtension(e){if(!this.supportsSublayers)throw new InvalidOperationError(ERR_ADD_SUBLAYERX_NOT_SUPPORTED);throw new Error("Missing implementation for _createSublayerExtension(). Subclasses of LayerExtension that support sublayers must implement this.")}async _onInitialize(){if(await super._onInitialize(),await this._createBackingLayer(),this._portalItem&&(await load(this._portalItem),await this._applyPortalItemProperties(this._portalItem),this.layer.title=this._portalItem.title,this.layer.portalItem=this._portalItem,this.iconUrl||(this.iconUrl=this._portalItem.thumbnailUrl),await this._applyLayerProperties(this._deferredLayerProperties,this.layer),this._deferredLayerProperties=void 0),this._resolveLayer(),!this.layer){const e=this._deferredLayerProperties.$ref;throw this._mapExtension||this._parentLayerExtension||this._basemapExtension||this._groundExtension?new InvalidOperationError(`No layer found matching reference "${"string"==typeof e?e:JSON.stringify(e)}".`):new InvalidOperationError("Cannot resolve layer reference: missing parent.")}this._deferredLayerProperties&&(await this._applyLayerProperties(this._deferredLayerProperties,this.layer),this._deferredLayerProperties=void 0),await this._initializeLayer(),await load(this.layer),this.supportsSublayers&&!this.layer.sublayers&&this.layer._set("sublayers",new Collection),this._initialVisibility=this.layer.visible,this._sublayerExtensions.onParentInitialized()}async _postInitialize(){await super._postInitialize(),this.layerListSettings.onLayerExtensionInitialized(),this._watchHandles.push(onCollectionPropertyChange(this,"layer.sublayers",(async e=>{const t=(e.added??[]).map((e=>this.sublayerExtensions.forSublayer(e)));await Promise.all(t.map(this._onSublayerAddedPostInitialize))})))}_applyPortalItemProperties(e){throw new InvalidOperationError("Cannot use this type of layer extension with a PortalItem.")}async _initializeLayer(){}_createLayerListSettings(e){return new LayerExtensionLayerListSettings(e,this)}_createSublayerExtensionCollection(){return new SublayerExtensionCollectionImpl(this)}_capabilities(){return DEFAULT_CAPABILITIES}*_initializableChildCollections(){yield*super._initializableChildCollections(),yield this.sublayerExtensions}async _createLayer(e){return PortalLayerBase.toEsriApiLayer(e)}_applyLayerProperties(e,t){checkArg("layerJson",e).isNotMissing();const i=e.layerType||e.type;return checkArg("layerJson.layerType",i).satisfies((e=>!e||e===this.getDefault("layer")?.layerType),ERR_LAYER_TYPE_MISMATCH),checkArg("layer",t).isNotMissing().satisfies((e=>this._isSupportedLayer(e)),ERR_LAYER_TYPE_MISMATCH),PortalLayerBase.applyToEsriApiLayer(e,t)}_setLayer(e){if(this._layer=e,e.watch("visible",this._onVisibleChanged),this.layer.watch("minScale",(()=>this.notifyChange("effectiveMinScale"))),this.layer.watch("maxScale",(()=>this.notifyChange("effectiveMaxScale"))),this.layer.watch("title",(()=>this.notifyChange("title"))),this.supportsSublayers)if(this._sublayers)this._setupSublayersHandles();else{const t=e.watch("sublayers",(()=>{this._setupSublayersHandles(),t.remove()}),!0)}this.notifyChange("layer"),this.notifyChange("title"),this.notifyChange("effectiveMinScale"),this.notifyChange("effectiveMaxScale"),this.notifyChange("isEffectivelyVisible")}_setupSublayersHandles(){this._sublayers.on("change",this._onSublayersChange),watchEach(this._sublayers,"visible",this._onSublayersSublayerVisibleChanged)}_ensureAChildSublayerVisible(e){for(const t of this._sublayers.toArray())t!==e&&(t.visible=!1)}_ensureAtMostOneChildSublayerVisible(){this.layer&&this._sublayers&&this._ensureAChildSublayerVisible(this._sublayers.find((e=>e.visible)))}}class SublayerExtensionCollectionImpl extends SublayerExtensionCollectionBase{constructor(e){super(e,"_sublayers"),this._layerExtension=e}add(e,t){if(checkArg("sublayerX",e).isNotMissing(),!this._layerExtension.supportsSublayers)throw new InvalidOperationError(ERR_ADD_SUBLAYERX_NOT_SUPPORTED);const i=e.sublayer?e.sublayer.layer:void 0;i&&i!==this._layerExtension.layer&&i.sublayers.remove(e.sublayer),super.add(e,t)}}class AllSublayerExtensionCollectionImpl extends ReadOnlyInitializableCollection{constructor(e){super(),this._layerExtension=e}get _collection(){return this._layerExtension.sublayerExtensions.flatten((e=>e.sublayerExtensions))}findById(e){return checkArg("id",e).isNotMissing(),this.find((t=>t.id===e))}findBySublayerId(e){return checkArg("id",e).isNotMissing(),this.find((t=>t.sublayer.id===e))}forSublayer(e){return checkArg("sublayer",e).isNotMissing(),this.findBySublayerId(e.id)}emit(e,t){if("change"===e){const i=new Collection;i.addMany(t.added);const r=i.flatten((e=>e.sublayerExtensions)).toArray(),s=new Collection;s.addMany(t.removed);const a=s.flatten((e=>e.sublayerExtensions)).toArray(),n=new Collection;n.addMany(t.moved);const o=n.flatten((e=>e.sublayerExtensions)).toArray();return super.emit(e,{added:r,removed:a,moved:o,target:this})}return super.emit(e,t)}_itemIsInitialized(e){return super._itemIsInitialized(e)&&!!e.sublayer}}let LayerExtensionLayerListSettings=class extends ExtensionBaseLayerListSettings{get _esriLayer(){return this._extension.layer}get _listModePath(){return"layer.listMode"}get _supportsChildren(){return this._extension.supportsSublayers}};LayerExtensionLayerListSettings=__decorate([serializable],LayerExtensionLayerListSettings);export{LayerExtensionLayerListSettings};let LayerExtensionSchema=class extends Schema{constructor(e){if(super(),this._layerBindings=new Map,this._layerExtension=e,this._bindSettingsToLayerProperties(),e.layer)this._onLayerResolved(e.layer);else{const t=e.watch("layer",(()=>{this._onLayerResolved(e.layer),t.remove()}),!0)}}_getPropertyBindings(){return{}}_getSetting(e,t){if(this._layerBindings.has(e)){let t=this._layerBindings.get(e);if("string"==typeof t&&(t={property:t}),t.hasOwnProperty("value"))return t.value;if(this._layerExtension.layer)return this._layerExtension.layer[t.property]}return super._getSetting(e,t)}_setSetting(e,t){if(this._layerBindings.has(e)){let i=this._layerBindings.get(e);if("string"==typeof i&&(i={property:i}),i.readonly||i.hasOwnProperty("value"))throw new InvalidOperationError(ERR_SCHEMA_READ_ONLY);if(this._layerExtension.layer)return void(this._layerExtension.layer[i.property]=t)}super._setSetting(e,t)}_bindSettingsToLayerProperties(){const e=this._getPropertyBindings();for(const t of Object.keys(e)){let i=e[t];"string"==typeof i&&(i={property:i}),this._layerBindings.set(t,i),i.hasOwnProperty("value")||this._layerExtension.watch(`layer.${i.property}`,(()=>this.notifyChange(t)),!i.hasOwnProperty("sync")||i.sync)}}_onLayerResolved(e){for(const t of this._layerBindings.keys())this.isModified(t)&&(e[t]=this[t],this.reset(t))}};LayerExtensionSchema=__decorate([serializable],LayerExtensionSchema);export{LayerExtensionSchema};export class ArrayWrappedCollection extends CollectionProxy{constructor(e,t){if(super(),this._layerExtension=e,this._property=t,this._layerProperty=e instanceof LayerExtension?"layer":"sublayer",e[this._layerProperty])this._onLayerResolved(e[this._layerProperty]);else{this._collection=new Collection;const t=e.watch(this._layerProperty,(()=>{const i=e[this._layerProperty];this.length&&i.set({[this._property]:this.toArray()}),this._onLayerResolved(i),t.remove()}),!0)}}add(e,t){const i=this._layerExtension[this._layerProperty];i&&!i.get(this._property)&&(i.set({[this._property]:[]}),this._collection=wrapArrayWithCollection(i.get(this._property))),super.add(e,t)}_onLayerResolved(e){this._collection=wrapArrayWithCollection(e.get(this._property)??[]),e.watch(this._property,(()=>{this._collection=wrapArrayWithCollection(e.get(this._property)??[])}),!0)}}export function _assignLayerExtensions(e,t){return compare(e,t,{onNew:(t,i)=>{e.add(t instanceof LayerExtension?t:LayerExtension.create(t),isLayerRef(t)?void 0:i)},onMatch:(t,i,r,s)=>{i instanceof LayerExtension||t.assignProperties(i),r===s||isLayerRef(i)||e.reorder(t,s)},onMissing:t=>{(hasMmapLayer([t])||isGroupLayerExtension(t)&&0===t.layerExtensions.toArray().length)&&e.remove(t)},equals:(e,t)=>t instanceof LayerExtension?t===e:!!LayerExtension._matchesRef(e.layer,t.layer)||e.id===t.id})}function wrapArrayWithCollection(e){const t=new Collection;return Object.defineProperty(t,"_items",{get:()=>e}),Object.defineProperty(t,"length",{get:()=>e.length,set:t=>e.length=t}),t}function getLayerXLogger(){return getLogger("geocortex.api.mapping.LayerExtension")}function isLayerRef(e){return e instanceof LayerExtension?!!e._deferredLayerProperties?.$ref:!isLayer(e.layer)&&!!e.layer?.$ref}
+import{__decorate}from"tslib";import{ArgumentError}from"../ArgumentError.js";import{InvalidOperationError}from"../InvalidOperationError.js";import{ItemType}from"../ItemType.js";import{FeatureSourceBase}from"../data/FeatureSourceBase.js";import{Schema}from"../data/Schema.js";import{LayerBase as PortalLayerBase}from"../portal/LayerBase.js";import{ERR_LAYER_TYPE_MISMATCH}from"../portal/_layerHelper.js";import{DefaultArcGISRequestHelper}from"../support/ArcGISRequestHelper.js";import{ReadOnlyInitializableCollection}from"../support/ReadOnlyInitializableCollection.js";import{serializable}from"../support/Serializable.js";import{isLayer}from"../utilities/_layers.js";import{checkArg}from"../utilities/checkArg.js";import{Collection,compare}from"../utilities/collection.js";import{load}from"../utilities/esri.js";import{isGroupLayerExtension}from"../utilities/extensions.js";import{hasMmapLayer}from"../utilities/layers.js";import{getLogger}from"../utilities/log.js";import{deepClone}from"../utilities/object.js";import{toPortalItem}from"../utilities/portal.js";import{onCollectionPropertyChange,watchEach}from"../utilities/watch.js";import{_assignSublayerExtensions}from"./_SublayerExtension.js";import{ExtensionBaseLayerListSettings,fromLayerListMode}from"./support/LayerListSettings.js";import{SublayerExtensionCollectionBase}from"./support/_SublayerExtensionCollection.js";const ERR_INVALID_LAYER_TYPE="Invalid type of layer for this type of layer extension.",ERR_FEATURES_NOT_SUPPORTED="This type of layer does not have features.",ERR_ADD_SUBLAYERX_NOT_SUPPORTED="This type of layer cannot have sublayers.",ERR_SCHEMA_READ_ONLY="This schema property is read-only.",DEFAULT_CAPABILITIES=Object.freeze({supportsAdd:!1,supportsUpdate:!1,supportsDelete:!1,supportsEditing:!1,supportsQuery:!1,supportsAttachmentEditing:!1});export class LayerExtension extends FeatureSourceBase{constructor(e){super(e),this._itemType=ItemType.LAYER_EXTENSION,this._watchHandles=[],this._dynamicallyAddedLayer=!1,this._visibilityMode="independent",this._onSublayerAddedPostInitialize=async e=>{try{await e.initialize()}catch(t){getLayerXLogger().error({message:`Error occurred while initializing sublayer extension for sublayer '${e.title??e.sublayer.id??e.id}'.`,error:t})}},this._onVisibleChanged=e=>{if("inherited"===this.visibilityMode&&this.supportsSublayers&&this._sublayers)for(const t of this._sublayers.toArray())t.visible=e;this.notifyChange("isEffectivelyVisible")},this._onSublayersSublayerVisibleChanged=(e,t,i,r)=>{e&&"exclusive"===this.visibilityMode&&this._ensureAChildSublayerVisible(r)},this._onSublayersChange=e=>{e.added?.length&&"exclusive"===this.visibilityMode&&this._ensureAChildSublayerVisible(e.added[e.added.length-1])};const t={...this.getDefaults(),...e};checkArg("properties.layer",t.layer).isNotMissing();const{layer:i}=t;let r;if(i?.hasOwnProperty("listMode")&&(r=fromLayerListMode(i.listMode)),this.layerListSettings=this._createLayerListSettings({...r,...t.layerListSettings}),isLayer(i))checkArg("properties.layer",i).satisfies((e=>this._isSupportedLayer(e)),ERR_INVALID_LAYER_TYPE),this._setLayer(i);else if(i){if(i.$portalItem){const e=i.$portalItem;this._portalItem=toPortalItem(e)}this._deferredLayerProperties=i}this._sublayerExtensions=this._createSublayerExtensionCollection(),this.allSublayerExtensions=new AllSublayerExtensionCollectionImpl(this),this.watch("parentLayerExtension.isEffectivelyVisible",(()=>this.notifyChange("isEffectivelyVisible"))),this.watch("layer.sublayers",(()=>this.notifyChange("_sublayers")))}get layer(){return this._layer}get mapExtension(){return this._mapExtension}get basemapExtension(){return this._basemapExtension}get groundExtension(){return this._groundExtension}get parentLayerExtension(){return this._parentLayerExtension}get hasFeatures(){return!1}get capabilities(){return this._capabilities()}get renderer(){}get visibilityMode(){return this._visibilityMode}set visibilityMode(e){this._visibilityMode=e,"exclusive"===e&&this._ensureAtMostOneChildSublayerVisible()}get sublayerExtensions(){return this._sublayerExtensions}get requestHelper(){return this._requestHelper||(this._requestHelper=new DefaultArcGISRequestHelper),this._requestHelper}set requestHelper(e){this._requestHelper=e}get title(){return this.layer?.title??this._deferredLayerProperties?.title??("string"==typeof this._deferredLayerProperties?.$ref?this._deferredLayerProperties?.$ref:this._deferredLayerProperties?.$ref?.title??this._deferredLayerProperties?.$ref?.id)??"Layer"}get supportsSublayers(){return!1}get effectiveMinScale(){return this.layer&&this.layer.minScale||0}get effectiveMaxScale(){return this.layer&&this.layer.maxScale||0}get isEffectivelyVisible(){const e=!!this.layer&&this.layer.visible;return this.parentLayerExtension?this.parentLayerExtension.isEffectivelyVisible&&e:e}get effectiveFullExtent(){return this.layer?this.layer.fullExtent:void 0}get canChangeScale(){return!0}get canChangeOpacity(){return!0}get canChangeLabels(){return!1}get initialVisibility(){return this._initialVisibility??this.layer?.visible??!1}get _layerSupportsHideChildren(){return this.supportsSublayers}get _sublayers(){if(this.supportsSublayers)return this.layer?this.layer.sublayers:void 0}get dynamicallyAddedLayer(){return this._dynamicallyAddedLayer}set dynamicallyAddedLayer(e){this._dynamicallyAddedLayer=e}get sublayersAreReadOnly(){return!0}static create(e){if(!LayerExtension.factory)throw new InvalidOperationError("Cannot create layer extension: no layer extension factory has been registered.");return LayerExtension.factory.create(e)}static async fromPortalItem(e,t){checkArg("portalItemLike",e).isNotMissing();const i=t??{};checkArg("layerExtensionProperties.layer",i.layer).satisfies((e=>!isLayer(e)));const r={...i.layer};checkArg("layerExtensionProperties.layer.$ref",r.$ref).satisfies((e=>null==e));const s=new DefaultArcGISRequestHelper,a=toPortalItem(e);let n;await load(a);const o=a.typeKeywords??"";if("Map Service"===a.type)n=o.includes("Tiled")||o.includes("Hosted Service")?"ArcGISTiledMapServiceLayer":"ArcGISMapServiceLayer";else if("Feature Service"===a.type)n="ArcGISFeatureLayer";else if("Image Service"===a.type){const e=await LayerExtension._getLayerData(a.url,s);e.cacheType?"Map"===e.cacheType?n="ArcGISTiledImageServiceLayer":("Elevation"===e.cacheType||o.includes("Elevation 3D Layer"))&&(n="ArcGISTiledElevationServiceLayer"):n=e.singleFusedMapCache||e.tileInfo||o.includes("Hosted Service")?"ArcGISTiledImageServiceLayer":"ArcGISImageServiceLayer"}else if("CSV"===a.type)n="CSV";else if("KML"===a.type)n="KML";else if("Scene Service"===a.type)o.includes("3DObject")||o.includes("Point")?n="ArcGISSceneServiceLayer":o.includes("IntegratedMesh")?n="IntegratedMeshLayer":o.includes("PointCloud")?n="PointCloudLayer":o.includes("Building")&&(n="BuildingSceneLayer");else if("Stream Service"===a.type)n="ArcGISStreamLayer";else if("Vector Tile Service"===a.type)n="VectorTileLayer";else if("Feature Collection"===a.type){n="ArcGISFeatureLayer";const e=await a.fetchData();r.featureCollection=e}else if("WMTS"===a.type){n="WebTiledLayer";const e=await a.fetchData();Object.assign(r,e)}else if("WMS"===a.type){n="WMS";const e=await a.fetchData();Object.assign(r,e)}if(!n)throw new ArgumentError("portalItem","Could not determine correct type of LayerExtension to create from portal item");if(r.layerType&&r.layerType!==n)throw new ArgumentError("layerExtensionProperties.layer.layerType","Layer type defined in layer properties does not match layer type from portal item");return r.layerType=n,r.$portalItem=a,i.layer=r,LayerExtension.create(i)}static _matchesRef(e,t){if(!e||!t)return!1;const i=t.$ref;return"string"==typeof i?e.id===i||e.title===i:!!i&&(e.id===i.id||e.title===i.title&&!i.path)}static async _getLayerData(e,t){const i=await t.request(e,{query:{f:"json"}});if(!i||!i.data)throw new Error(`Response to request for url ${e} was invalid.`);return i.data}getFeatures(e,t){if(!this.hasFeatures)throw new InvalidOperationError(ERR_FEATURES_NOT_SUPPORTED);return super.getFeatures(e,t)}getFullExtent(){return this.effectiveFullExtent}async addFeatures(e,t){if(checkArg("features",e).isNotMissing(),!this.hasFeatures)throw new InvalidOperationError(ERR_FEATURES_NOT_SUPPORTED);await super.addFeatures(e,t)}async updateFeatures(e,t){if(checkArg("features",e).isNotMissing(),!this.hasFeatures)throw new InvalidOperationError(ERR_FEATURES_NOT_SUPPORTED);await super.updateFeatures(e,t)}async deleteFeatures(e,t){if(checkArg("features",e).isNotMissing(),!this.hasFeatures)throw new InvalidOperationError(ERR_FEATURES_NOT_SUPPORTED);await super.deleteFeatures(e,t)}async _createBackingLayer(){this._portalItem||this.layer||this._deferredLayerProperties&&this._deferredLayerProperties.$ref?!this.layer&&this._portalItem&&this._setLayer(await this._createLayer(this.getDefaults().layer)):(this._setLayer(await this._createLayer(this._deferredLayerProperties)),checkArg("properties.layer",this._layer).satisfies((e=>this._isSupportedLayer(e)),ERR_INVALID_LAYER_TYPE),this._deferredLayerProperties=void 0)}_setMapExtension(e){const t=this.mapExtension;this._mapExtension=e,t&&this.featureSettings.formatSettings.parent===t.formatSettings&&(this.featureSettings.formatSettings.parent=void 0),e&&(this.featureSettings.formatSettings.parent||(this.featureSettings.formatSettings.parent=e.formatSettings)),this._resolveLayer(),this.notifyChange("mapExtension")}_setBasemapExtension(e){this._basemapExtension=e,this._resolveLayer(),e&&(this.taskSettings.parent=e.taskSettings),this.notifyChange("basemapExtension")}_setGroundExtension(e){this._groundExtension=e,this._resolveLayer(),e&&(this.taskSettings.parent=e.taskSettings),this.notifyChange("groundExtension")}_setParentLayerExtension(e){const t=this._parentLayerExtension;this._parentLayerExtension=e,t&&(this.featureSettings.formatSettings.parent===t.featureSettings.formatSettings&&(this.featureSettings.formatSettings.parent=this.mapExtension?this.mapExtension.formatSettings:void 0),this.taskSettings.parent===t.taskSettings&&(this.taskSettings.parent=void 0)),e&&((!this.featureSettings.formatSettings.parent||this.mapExtension&&this.featureSettings.formatSettings.parent===this.mapExtension.formatSettings)&&(this.featureSettings.formatSettings.parent=e.featureSettings.formatSettings),this.taskSettings.parent||(this.taskSettings.parent=e.taskSettings)),this._resolveLayer(),this.notifyChange("parentLayerExtension")}_resolveLayer(e){if(this.layer||!this._deferredLayerProperties)return;const t=e=>LayerExtension._matchesRef(e,this._deferredLayerProperties);let i;e?i=e.find(t):this.basemapExtension?.basemap?(i=this.basemapExtension.basemap.baseLayers.find(t),i=i||this.basemapExtension.basemap.referenceLayers.find(t)):this.groundExtension?.ground?i=this.groundExtension.ground.layers.find(t):this.parentLayerExtension?.layer?i=this.parentLayerExtension.layer.layers.find(t):this.mapExtension&&(i=this.mapExtension.map.layers.find(t)),i&&this._isSupportedLayer(i)&&(this._setLayer(i),this._originalRef=this._deferredLayerProperties.$ref,this._deferredLayerProperties.$portalItem&&getLayerXLogger().warn("LayerExtension defined with both $ref and $portalItem. Ignoring $portalItem."))}async _switchLayer(e){if(e===this.layer)return;checkArg("newLayer",e).isNotMissing().satisfies((e=>this._isSupportedLayer(e)),ERR_INVALID_LAYER_TYPE),this.isInitialized&&await load(e);const t=new Map;if(this._sublayers)for(const e of this._sublayers.toArray())t.set(e.id,this.sublayerExtensions.forSublayer(e));e.visible=this.layer.visible,e.opacity=this.layer.opacity,e.listMode=this.layer.listMode,e.hasOwnProperty("labelsVisible")&&this.layer.hasOwnProperty("labelsVisible")&&(e.labelsVisible=this.layer.labelsVisible),this._setLayer(e);const i=[];if(this._sublayers){const e=this._sublayers.filter((e=>t.has(e.id))).toArray();i.push(...e.map((async e=>{const i=t.get(e.id);await i._switchSublayer(e),this._sublayerExtensions._register(i)})))}this.isInitialized&&i.push(this._initializeChildren()),await Promise.all(i)}_getProjectWebmapJSON(){if(!this.layer)return;let e=PortalLayerBase.fromEsriApiLayer(this.layer);if(!this.dynamicallyAddedLayer){const{id:t,title:i,layerType:r,visibility:s,opacity:a}=e;e={id:t,title:i,layerType:r,visibility:s,opacity:a}}return e}async _onDestroy(){this._watchHandles.forEach((e=>e?.remove())),await Promise.all(this.sublayerExtensions.toArray().map((e=>e.destroy()))),await super._onDestroy()}_getSerializableProperties(){return{...super._getSerializableProperties(),iconUrl:{serializeModes:["initial","project"],serialize:e=>"project"!==e||this.dynamicallyAddedLayer?this.iconUrl:this.getDefault("iconUrl")},visibilityMode:{serializeModes:["initial","project"],serialize:e=>"project"!==e||this.dynamicallyAddedLayer?this.visibilityMode:this.getDefault("visibilityMode"),default:"independent"},tpkSource:{serializeModes:["initial"]},layerListSettings:{serializeModes:["initial","project"],serialize:e=>"project"!==e||this.dynamicallyAddedLayer?this.layerListSettings:this.getDefault("layerListSettings")},sublayerExtensions:{serializeModes:["initial","project"],serialize:e=>this.sublayerExtensions.map((e=>e.toItemUri())).toArray(),deserialize:e=>{_assignSublayerExtensions(this.sublayerExtensions,e,(e=>this._createSublayerExtension(e)))}},layer:{serializeModes:["initial","project"],serialize:e=>{if(this.layer){if((this._mapExtension||this._parentLayerExtension||this._basemapExtension||this._groundExtension)&&(this._layer.id||this._layer.title)){const e=PortalLayerBase.getLayerType(this._layer),t=this._getSerializableRefLayerProperties();return{$ref:this._originalRef||{id:this._layer.id,title:this._layer.title,subtype:this._getSerializableLayerType()},layerType:e,...t}}return PortalLayerBase.fromEsriApiLayer(this.layer)}return this._deferredLayerProperties?deepClone(this._deferredLayerProperties):void 0},isDefault:()=>{throw new Error("Missing implementation for _getSerializableProperties() > layer > default. Subclasses of LayerExtension must implement this.")},deserialize:e=>{if(isLayer(e)){if(e!==this.layer)throw new Error("Property 'layer' is read-only.")}else e&&(this._layer?this._applyLayerProperties(e,this.layer):this._deferredLayerProperties&&(this._deferredLayerProperties={...this._deferredLayerProperties,...e}))}},dynamicallyAddedLayer:{serializeModes:["project"],default:!1},requestHelper:{serialize:!1}}}_getSerializableLayerType(){}_getSerializableRefLayerProperties(){return{}}_createSublayerExtension(e){if(!this.supportsSublayers)throw new InvalidOperationError(ERR_ADD_SUBLAYERX_NOT_SUPPORTED);throw new Error("Missing implementation for _createSublayerExtension(). Subclasses of LayerExtension that support sublayers must implement this.")}async _onInitialize(){if(await super._onInitialize(),await this._createBackingLayer(),this._portalItem&&(await load(this._portalItem),await this._applyPortalItemProperties(this._portalItem),this.layer.title=this._portalItem.title,this.layer.portalItem=this._portalItem,this.iconUrl||(this.iconUrl=this._portalItem.thumbnailUrl),await this._applyLayerProperties(this._deferredLayerProperties,this.layer),this._deferredLayerProperties=void 0),this._resolveLayer(),!this.layer){const e=this._deferredLayerProperties.$ref;throw this._mapExtension||this._parentLayerExtension||this._basemapExtension||this._groundExtension?new InvalidOperationError(`No layer found matching reference "${"string"==typeof e?e:JSON.stringify(e)}".`):new InvalidOperationError("Cannot resolve layer reference: missing parent.")}this._deferredLayerProperties&&(await this._applyLayerProperties(this._deferredLayerProperties,this.layer),this._deferredLayerProperties=void 0),await this._initializeLayer(),await load(this.layer),this.supportsSublayers&&!this.layer.sublayers&&this.layer._set("sublayers",new Collection),this._initialVisibility=this.layer.visible,this._sublayerExtensions.onParentInitialized()}async _postInitialize(){await super._postInitialize(),this.layerListSettings.onLayerExtensionInitialized(),this._watchHandles.push(onCollectionPropertyChange(this,"layer.sublayers",(async e=>{const t=(e.added??[]).map((e=>this.sublayerExtensions.forSublayer(e)));await Promise.all(t.map(this._onSublayerAddedPostInitialize))})))}_applyPortalItemProperties(e){throw new InvalidOperationError("Cannot use this type of layer extension with a PortalItem.")}async _initializeLayer(){}_createLayerListSettings(e){return new LayerExtensionLayerListSettings(e,this)}_createSublayerExtensionCollection(){return new SublayerExtensionCollectionImpl(this)}_capabilities(){return DEFAULT_CAPABILITIES}*_initializableChildCollections(){yield*super._initializableChildCollections(),yield this.sublayerExtensions}async _createLayer(e){return PortalLayerBase.toEsriApiLayer(e)}_applyLayerProperties(e,t){checkArg("layerJson",e).isNotMissing();const i=e.layerType||e.type;return checkArg("layerJson.layerType",i).satisfies((e=>!e||e===this.getDefault("layer")?.layerType),ERR_LAYER_TYPE_MISMATCH),checkArg("layer",t).isNotMissing().satisfies((e=>this._isSupportedLayer(e)),ERR_LAYER_TYPE_MISMATCH),PortalLayerBase.applyToEsriApiLayer(e,t)}_setLayer(e){if(this._layer=e,e.watch("visible",this._onVisibleChanged),this.layer.watch("minScale",(()=>this.notifyChange("effectiveMinScale"))),this.layer.watch("maxScale",(()=>this.notifyChange("effectiveMaxScale"))),this.layer.watch("title",(()=>this.notifyChange("title"))),this.supportsSublayers)if(this._sublayers)this._setupSublayersHandles();else{const t=e.watch("sublayers",(()=>{this._setupSublayersHandles(),t.remove()}),!0)}this.notifyChange("layer"),this.notifyChange("title"),this.notifyChange("effectiveMinScale"),this.notifyChange("effectiveMaxScale"),this.notifyChange("isEffectivelyVisible")}_setupSublayersHandles(){this._sublayers.on("change",this._onSublayersChange),watchEach(this._sublayers,"visible",this._onSublayersSublayerVisibleChanged)}_ensureAChildSublayerVisible(e){for(const t of this._sublayers.toArray())t!==e&&(t.visible=!1)}_ensureAtMostOneChildSublayerVisible(){this.layer&&this._sublayers&&this._ensureAChildSublayerVisible(this._sublayers.find((e=>e.visible)))}}class SublayerExtensionCollectionImpl extends SublayerExtensionCollectionBase{constructor(e){super(e,"_sublayers"),this._layerExtension=e}add(e,t){if(checkArg("sublayerX",e).isNotMissing(),!this._layerExtension.supportsSublayers)throw new InvalidOperationError(ERR_ADD_SUBLAYERX_NOT_SUPPORTED);const i=e.sublayer?e.sublayer.layer:void 0;i&&i!==this._layerExtension.layer&&i.sublayers.remove(e.sublayer),super.add(e,t)}}class AllSublayerExtensionCollectionImpl extends ReadOnlyInitializableCollection{constructor(e){super(),this._layerExtension=e}get _collection(){return this._layerExtension.sublayerExtensions.flatten((e=>e.sublayerExtensions))}findById(e){return checkArg("id",e).isNotMissing(),this.find((t=>t.id===e))}findBySublayerId(e){return checkArg("id",e).isNotMissing(),this.find((t=>t.sublayer.id===e))}forSublayer(e){return checkArg("sublayer",e).isNotMissing(),this.findBySublayerId(e.id)}emit(e,t){if("change"===e){const i=new Collection;i.addMany(t.added);const r=i.flatten((e=>e.sublayerExtensions)).toArray(),s=new Collection;s.addMany(t.removed);const a=s.flatten((e=>e.sublayerExtensions)).toArray(),n=new Collection;n.addMany(t.moved);const o=n.flatten((e=>e.sublayerExtensions)).toArray();return super.emit(e,{added:r,removed:a,moved:o,target:this})}return super.emit(e,t)}_itemIsInitialized(e){return super._itemIsInitialized(e)&&!!e.sublayer}}let LayerExtensionLayerListSettings=class extends ExtensionBaseLayerListSettings{get _esriLayer(){return this._extension.layer}get _listModePath(){return"layer.listMode"}get _supportsChildren(){return this._extension.supportsSublayers}};LayerExtensionLayerListSettings=__decorate([serializable],LayerExtensionLayerListSettings);export{LayerExtensionLayerListSettings};let LayerExtensionSchema=class extends Schema{constructor(e){if(super(),this._layerBindings=new Map,this._layerExtension=e,this._bindSettingsToLayerProperties(),e.layer)this._onLayerResolved(e.layer);else{const t=e.watch("layer",(()=>{this._onLayerResolved(e.layer),t.remove()}),!0)}}_getPropertyBindings(){return{}}_getSetting(e,t){if(this._layerBindings.has(e)){let t=this._layerBindings.get(e);if("string"==typeof t&&(t={property:t}),t.hasOwnProperty("value"))return t.value;if(this._layerExtension.layer)return this._layerExtension.layer[t.property]}return super._getSetting(e,t)}_setSetting(e,t){if(this._layerBindings.has(e)){let i=this._layerBindings.get(e);if("string"==typeof i&&(i={property:i}),i.readonly||i.hasOwnProperty("value"))throw new InvalidOperationError(ERR_SCHEMA_READ_ONLY);if(this._layerExtension.layer)return void(this._layerExtension.layer[i.property]=t)}super._setSetting(e,t)}_bindSettingsToLayerProperties(){const e=this._getPropertyBindings();for(const t of Object.keys(e)){let i=e[t];"string"==typeof i&&(i={property:i}),this._layerBindings.set(t,i),i.hasOwnProperty("value")||this._layerExtension.watch(`layer.${i.property}`,(()=>this.notifyChange(t)),!i.hasOwnProperty("sync")||i.sync)}}_onLayerResolved(e){for(const t of this._layerBindings.keys())this.isModified(t)&&(e[t]=this[t],this.reset(t))}};LayerExtensionSchema=__decorate([serializable],LayerExtensionSchema);export{LayerExtensionSchema};export function _assignLayerExtensions(e,t){return compare(e,t,{onNew:(t,i)=>{e.add(t instanceof LayerExtension?t:LayerExtension.create(t),isLayerRef(t)?void 0:i)},onMatch:(t,i,r,s)=>{i instanceof LayerExtension||t.assignProperties(i),r===s||isLayerRef(i)||e.reorder(t,s)},onMissing:t=>{(hasMmapLayer([t])||isGroupLayerExtension(t)&&0===t.layerExtensions.toArray().length)&&e.remove(t)},equals:(e,t)=>t instanceof LayerExtension?t===e:!!LayerExtension._matchesRef(e.layer,t.layer)||e.id===t.id})}function getLayerXLogger(){return getLogger("geocortex.api.mapping.LayerExtension")}function isLayerRef(e){return e instanceof LayerExtension?!!e._deferredLayerProperties?.$ref:!isLayer(e.layer)&&!!e.layer?.$ref}

package/mapping/support/ArrayWrappedCollection.d.ts

@@ -0,0 +1,42 @@
+import type { AccessorLike } from "../../support/esri";
+import { CollectionProxy } from "../../utilities/CollectionProxy.js";
+import type { LayerExtension } from "../_LayerExtension";
+import type { SublayerExtension } from "../_SublayerExtension";
+/**
+ * Properties that can be passed into the ArrayWrappedCollection constructor.
+ */
+export interface ArrayWrappedCollectionProperties {
+    /**
+     * The parent of the ArrayWrappedCollection. If a targetProperty is not
+     * specified, then the arrayProperty is accessed/watched directly off the
+     * parent.
+     */
+    parent: AccessorLike;
+    /**
+     * An optional path to another Accessor, relative to the parent, that owns
+     * the array being wrapped.
+     */
+    targetProperty?: string;
+    /**
+     * The path to the array to be wrapped by the collection. If targetProperty
+     * is not specified, the path is relative to the parent; otherwise, the path
+     * is relative to the parent.get(targetProperty).
+     */
+    arrayProperty: string;
+}
+/**
+ * A collection that wraps an array on an Accessor.
+ */
+export declare class ArrayWrappedCollection<T> extends CollectionProxy<T> {
+    private readonly _parent;
+    private readonly _targetProperty;
+    private readonly _arrayProperty;
+    private get _target();
+    constructor(layerExtension: LayerExtension | SublayerExtension, property: string);
+    constructor(properties: ArrayWrappedCollectionProperties);
+    /**
+     * @inheritDoc
+     */
+    add(item: T, index?: number): void;
+    private _onTargetResolved;
+}

package/mapping/support/ArrayWrappedCollection.js

@@ -0,0 +1 @@
+import Collection from"@arcgis/core/core/Collection";import{CollectionProxy}from"../../utilities/CollectionProxy.js";export class ArrayWrappedCollection extends CollectionProxy{constructor(t,r){if(super(),r)this._parent=t,this._targetProperty=t.hasOwnProperty("sublayer")?"sublayer":"layer",this._arrayProperty=r;else{const{parent:r,targetProperty:e,arrayProperty:o}=t;this._parent=r,this._targetProperty=e,this._arrayProperty=o}if(this._target)this._onTargetResolved(this._target);else{this._collection=new Collection;const t=this._parent.watch(this._targetProperty,(()=>{const r=this._target;r&&(this.length&&r.set({[this._arrayProperty]:this.toArray()}),this._onTargetResolved(r),t.remove())}),!0)}}get _target(){return this._targetProperty?this._parent.get(this._targetProperty):this._parent}add(t,r){const e=this._target;e&&!e.get(this._arrayProperty)&&(e.set({[this._arrayProperty]:[]}),this._collection=wrapArrayWithCollection(e.get(this._arrayProperty))),super.add(t,r)}_onTargetResolved(t){this._collection=wrapArrayWithCollection(t.get(this._arrayProperty)??[]),this._parent.watch(this._targetProperty?`${this._targetProperty}.${this._arrayProperty}`:this._arrayProperty,(()=>{this._target&&(this._collection=wrapArrayWithCollection(this._target.get(this._arrayProperty)??[]))}),!0)}}function wrapArrayWithCollection(t){const r=Array.isArray(t)?t:[],e=new Collection;return Object.defineProperty(e,"_items",{get:()=>r}),Object.defineProperty(e,"length",{get:()=>r.length,set:t=>r.length=t}),e}

package/mapping/support/PopupTemplateFeatureSettings.js

@@ -1 +1 @@
-import{__decorate}from"tslib";import{FeatureSettings}from"../../data/FeatureSettings.js";import{serializable}from"../../support/Serializable.js";let PopupTemplateFeatureSettings=class extends FeatureSettings{constructor(e){super(),this._layerBindings=new Map,this._layerExtension=e,this._bindSettingToLayerProperty("popupTemplate");const t=this._getLayer();if(t)this._onLayerResolved(t);else{const t=this._isLayerExtension(this._layerExtension)?"layer":"sublayer",s=e.watch(t,(e=>{this._onLayerResolved(e),s.remove()}),!0)}}_getSetting(e,t){const s=this._getLayer();return this._layerBindings.has(e)&&s?s[this._layerBindings.get(e)]:super._getSetting(e,t)}_setSetting(e,t){const s=this._getLayer();this._layerBindings.has(e)&&s?s[this._layerBindings.get(e)]=t:super._setSetting(e,t)}_bindSettingToLayerProperty(e,t){const s=t||e;this._layerBindings.set(e,s);const i=this._isLayerExtension(this._layerExtension)?"layer":"sublayer";this._layerExtension.watch(`${i}.${s}`,(()=>this.notifyChange(e)),!0)}_onLayerResolved(e){for(const t of this._layerBindings.keys())this.isModified(t)&&(e[t]=this[t],this.reset(t))}_isLayerExtension(e){return"layer"in e}_getLayer(){if(this._layerExtension)return this._isLayerExtension(this._layerExtension)?this._layerExtension.layer:this._layerExtension.sublayer}};PopupTemplateFeatureSettings=__decorate([serializable],PopupTemplateFeatureSettings);export{PopupTemplateFeatureSettings};
+import{__decorate}from"tslib";import{FeatureSettings}from"../../data/FeatureSettings.js";import{TableExtension}from"../../data/_TableExtension.js";import{serializable}from"../../support/Serializable.js";import{LayerExtension}from"../_LayerExtension.js";import{SublayerExtension}from"../_SublayerExtension.js";let PopupTemplateFeatureSettings=class extends FeatureSettings{constructor(e){super(),this._layerExtension=e,this._bindSettingToLayerProperty("popupTemplate");const t=this._getLayerLike(),i=this._getLayerLikeType();if(t)this._onLayerResolved(t);else if(i){const t=e.watch(i,(e=>{this._onLayerResolved(e),t.remove()}),!0)}}get _bindings(){return this._propertyBindings||(this._propertyBindings=new Map),this._propertyBindings}_getSerializableProperties(){return{...super._getSerializableProperties(),popupTemplate:{serialize:!1}}}_getSetting(e,t){const i=this._getLayerLike();return this._bindings.has(e)&&i?i.get(this._bindings.get(e)):super._getSetting(e,t)}_setSetting(e,t){const i=this._getLayerLike();this._bindings.has(e)&&i?i.set({[this._bindings.get(e)]:t}):super._setSetting(e,t)}_bindSettingToLayerProperty(e,t){const i=this._getLayerLikeType();if(!i)return;const s=t||e;this._bindings.set(e,s),this._layerExtension.watch(`${i}.${s}`,(()=>this.notifyChange(e)),!0)}_onLayerResolved(e){for(const t of this._bindings.keys())this.isModified(t)&&(e.set({[t]:this.get(t)}),this.reset(t))}_getLayerLike(){return this._layerExtension instanceof LayerExtension?this._layerExtension.layer:this._layerExtension instanceof TableExtension?this._layerExtension.table:this._layerExtension instanceof SublayerExtension?this._layerExtension.sublayer:void 0}_getLayerLikeType(){return this._layerExtension instanceof LayerExtension?"layer":this._layerExtension instanceof TableExtension?"table":this._layerExtension instanceof SublayerExtension?"sublayer":void 0}};PopupTemplateFeatureSettings=__decorate([serializable],PopupTemplateFeatureSettings);export{PopupTemplateFeatureSettings};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vertigis/arcgis-extensions",
   "license": "SEE LICENSE IN LICENSE",
-  "version": "37.1.1",
+  "version": "37.2.1",
   "repository": {
     "type": "git",
     "url": "https://geocortex.visualstudio.com/Geocortex/_git/geocortex-api-ts"

package/portal/MediaInfo.d.ts

@@ -26,6 +26,10 @@ export declare namespace MediaType {
  * https://developers.arcgis.com/web-scene-specification/objects/mediaInfo/.
  */
 export interface MediaInfo {
+    /**
+     * A string providing the alternate text for the media.
+     */
+    altText?: string;
     /**
      * A caption describing the media. This can contain a field name enclosed in
      * `{}`, such as `{IMAGE_CAPTION}`.

package/portal/PopupInfo.d.ts

@@ -1,4 +1,5 @@
 import EsriPopupTemplate from "@arcgis/core/PopupTemplate";
+import type EsriPopupContent from "@arcgis/core/popup/content/Content";
 import type { FieldInfo } from "./FieldInfo.js";
 import type { MediaInfo } from "./MediaInfo.js";
 import type { PopupExpressionInfo } from "./PopupExpressionInfo.js";
@@ -86,12 +87,30 @@ export interface PopupInfo {
  * https://developers.arcgis.com/web-scene-specification/objects/popupElement/.
  */
 export interface PopupElement {
+    /**
+     * A dictionary of key value pairs representing attributes to be used
+     * instead of fields and their values. This property is only used when the
+     * element is of type expression and should be returned as part of the
+     * arcade expression itself. This property allows passing arcade derived
+     * attribute values into fields or media elements.
+     */
+    attributes?: Record<string, unknown>;
+    /**
+     * An optional string value describing the element in detail. This property
+     * does not apply when the type is text or expression.
+     */
+    description?: string;
     /**
      * This property applies to elements of type attachments. A string value
      * indicating how to display the attachment. Possible values are, preview,
      * and list. If list is specified, attachments show as links.
      */
     displayType?: string;
+    /**
+     * This property applies to elements of type expression. An Arcade
+     * expression that defines the pop-up element content.
+     */
+    expressionInfo?: PopupExpressionInfo;
     /**
      * This property applies to elements of type fields. It is an array of
      * popupInfo.fieldInfo objects representing a field/value pair displayed as
@@ -115,15 +134,19 @@ export interface PopupElement {
      */
     text?: string;
     /**
-     * String value indicating which elements to use. See
-     * {@link PopupElementType}.
+     * An optional string value indicating what the element represents. This
+     * property does not apply when the type is text or expression.
+     */
+    title?: string;
+    /**
+     * String value indicating which element to use.
      */
     type?: PopupElementType;
 }
 /**
  * The type of the PopupElement.
  */
-export declare type PopupElementType = "attachments" | "fields" | "media" | "text";
+export declare type PopupElementType = "attachments" | "fields" | "media" | "text" | "expression";
 /**
  * The sort in the popupInfo for the parent feature. This impacts the sorting
  * order for the returned child records.
@@ -166,3 +189,27 @@ export interface OrderByFields {
      */
     order?: string;
 }
+export declare namespace PopupContent {
+    /**
+     * Converts an ArcGIS Portal JSON representation of a popup template to its
+     * Esri JavaScript API equivalent.
+     *
+     * @param json The popup template JSON to convert.
+     */
+    function toEsriApiPopupContent(json: PopupElement): EsriPopupContent;
+    /**
+     * Converts an Esri JavaScript API PopupElement object to its ArcGIS Portal
+     * JSON representation.
+     *
+     * @param popupElement The PopupElement object to convert.
+     */
+    function fromEsriApiPopupContent(popupElement: EsriPopupContent): PopupElement;
+    /**
+     * Applies an ArcGIS Portal JSON representation of a Field to its Esri
+     * JavaScript API representation.
+     *
+     * @param elementJson The field JSON to apply.
+     * @param content The field object to apply the JSON to.
+     */
+    function applyToEsriApiPopupContent(elementJson: PopupElement, content: EsriPopupContent): void;
+}

package/portal/PopupInfo.js

@@ -1 +1 @@
-import EsriPopupTemplate from"@arcgis/core/PopupTemplate";import{checkArg}from"../utilities/checkArg.js";import{deepClone}from"../utilities/object.js";export var PopupInfo;!function(o){o.toEsriApiPopupTemplate=function(o){checkArg("json",o).isNotMissing();const p=deepClone(o),e=EsriPopupTemplate.fromJSON(p);return e.content||(e.content=[]),e},o.fromEsriApiPopupTemplate=function(o){return checkArg("popupTemplate",o).isNotMissing(),o.toJSON()}}(PopupInfo||(PopupInfo={}));
+import EsriPopupTemplate from"@arcgis/core/PopupTemplate";import EsriExpressionInfo from"@arcgis/core/popup/ElementExpressionInfo";import EsriFieldInfo from"@arcgis/core/popup/FieldInfo";import{TextContent}from"@arcgis/core/popup/content";import AttachmentsContent from"@arcgis/core/popup/content/AttachmentsContent";import BarChartMediaInfo from"@arcgis/core/popup/content/BarChartMediaInfo";import ColumnChartMediaInfo from"@arcgis/core/popup/content/ColumnChartMediaInfo";import ExpressionContent from"@arcgis/core/popup/content/ExpressionContent";import FieldsContent from"@arcgis/core/popup/content/FieldsContent";import ImageMediaInfo from"@arcgis/core/popup/content/ImageMediaInfo";import LineChartMediaInfo from"@arcgis/core/popup/content/LineChartMediaInfo";import MediaContent from"@arcgis/core/popup/content/MediaContent";import PieChartMediaInfo from"@arcgis/core/popup/content/PieChartMediaInfo";import{checkArg}from"../utilities/checkArg.js";import{isAttachmentsContent,isExpressionContent,isFieldsContent,isMediaContent,isTextContent}from"../utilities/esri.js";import{deepClone}from"../utilities/object.js";export var PopupInfo;!function(t){t.toEsriApiPopupTemplate=function(t){checkArg("json",t).isNotMissing();const e=deepClone(t),o=EsriPopupTemplate.fromJSON(e);return o.content||(o.content=[]),o},t.fromEsriApiPopupTemplate=function(t){return checkArg("popupTemplate",t).isNotMissing(),t.toJSON()}}(PopupInfo||(PopupInfo={}));export var PopupContent;function toEsriApiMediaInfo(t){switch(t.type){case"image":return ImageMediaInfo.fromJSON(t);case"barchart":return BarChartMediaInfo.fromJSON(t);case"columnchart":return ColumnChartMediaInfo.fromJSON(t);case"linechart":return LineChartMediaInfo.fromJSON(t);case"piechart":return PieChartMediaInfo.fromJSON(t);default:throw new Error(`Unknown MediaInfo type: ${JSON.stringify(t)}`)}}!function(t){t.toEsriApiPopupContent=function(t){checkArg("json",t).isNotMissing();const e=deepClone(t);switch(t.type){case"attachments":return AttachmentsContent.fromJSON(e);case"expression":return ExpressionContent.fromJSON(e);case"fields":return FieldsContent.fromJSON(e);case"media":return MediaContent.fromJSON(e);case"text":return TextContent.fromJSON(e);default:throw new Error(`Unknown PopupContent type: ${JSON.stringify(e)}`)}},t.fromEsriApiPopupContent=function(t){return checkArg("PopupElement",t).isNotMissing(),t.toJSON()},t.applyToEsriApiPopupContent=function(t,e){checkArg("elementJson",t).isNotMissing(),checkArg("content",e).isNotMissing(),isTextContent(e)&&"text"===t.type?t.hasOwnProperty("text")&&(e.text=t.text):isExpressionContent(e)&&"expression"===t.type?t.hasOwnProperty("expressionInfo")&&(e.expressionInfo=EsriExpressionInfo.fromJSON(t.expressionInfo)):(t.hasOwnProperty("title")&&(e.title=t.title),t.hasOwnProperty("description")&&(e.description=t.title)),isAttachmentsContent(e)&&"attachments"===t.type?t.hasOwnProperty("displayType")&&(e.displayType=t.displayType):isFieldsContent(e)&&"fields"===t.type?t.hasOwnProperty("fieldInfos")&&(e.fieldInfos=t.fieldInfos.map((t=>EsriFieldInfo.fromJSON(t)))):isMediaContent(e)&&"media"===t.type&&t.hasOwnProperty("mediaInfos")&&(e.mediaInfos=t.mediaInfos.map((t=>toEsriApiMediaInfo(t))))}}(PopupContent||(PopupContent={}));

package/support/InitializableBase.d.ts

@@ -132,3 +132,25 @@ export declare abstract class InitializableBase<TProperties extends Initializabl
      */
     protected _initializableChildCollections(): IterableIterator<Collection<InitializableBase>>;
 }
+/**
+ * Options for the initializeCollection() function.
+ */
+export interface InitializeCollectionOptions {
+    /**
+     * An event callback for handling errors thrown by collection items with
+     * failureMode "warn".
+     */
+    onInitializeWarning?: EventCallback<InitializeWarningEvent>;
+    /**
+     * The target to include in the {@link InitializeWarningEvent}.
+     */
+    target?: InitializableBase;
+}
+/**
+ * Initializes a collection of {@link InitializableBase} items.
+ *
+ * @param collection The collection of items to initialize.
+ * @param options Options including a callback and target for handling errors
+ *   thrown by collection items with failureMode "warn".
+ */
+export declare function initializeCollection<T extends InitializableBase = InitializableBase>(collection: Collection<T>, options?: InitializeCollectionOptions): Promise<void>;

package/support/InitializableBase.js

@@ -1 +1 @@
-import{getLogger}from"../utilities/log.js";import{parallelEach}from"../utilities/promise.js";import{InitializeError}from"./InitializeError.js";import{SerializableBase}from"./Serializable.js";export class InitializableBase extends SerializableBase{constructor(){super(...arguments),this._isInitialized=!1,this._isDestroyed=!1,this._failureMode="warn"}get isInitialized(){return this._isInitialized}get isDestroyed(){return this._isDestroyed}get failureMode(){return this._failureMode}set failureMode(i){this._failureMode=i}async initialize(){return void 0===this._initializePromise&&(this._initializePromise=(async()=>{try{await this._onInitialize(),await this._initializeChildren(),await this._postInitialize()}catch(i){throw i instanceof Error?(this._initializePromise=void 0,new InitializeError(this.failureMode,i,this)):i}this._isInitialized=!0,this.notifyChange("isInitialized")})()),this._initializePromise}async destroy(){return void 0===this._destroyPromise&&(this._destroyPromise=(async()=>{try{await this._onDestroy()}catch(i){throw this._destroyPromise=void 0,i}this._isDestroyed=!0,this.notifyChange("isDestroyed")})()),this._destroyPromise}on(i,e){return super.on(i,e)}emit(i,e){return super.emit(i,e)}_getSerializableProperties(){return{...super._getSerializableProperties(),failureMode:{serializeModes:["initial"],default:"warn"}}}async _onInitialize(){}async _postInitialize(){}async _onDestroy(){}async _initializeChildren(){await parallelEach(this._initializableChildCollections(),(i=>parallelEach(i.toArray(),(async i=>{const e=i.on("initializeWarning",(i=>{this.emit("initializeWarning",i)}));try{await i.initialize()}catch(e){const t=e instanceof InitializeError?e:new InitializeError(i.failureMode,e,i);if("error"===t.failureMode)throw t;"warn"===t.failureMode&&getInitializableBaseLogger().warn({message:"Error attempting to initialize child item: {0}.",error:t},t.error.message);const r={error:t,target:this};this.emit("initializeWarning",r)}finally{e.remove()}}))))}*_initializableChildCollections(){}}function getInitializableBaseLogger(){return getLogger("geocortex.api.support.InitializeBase")}
+import{getLogger}from"../utilities/log.js";import{parallelEach}from"../utilities/promise.js";import{InitializeError}from"./InitializeError.js";import{SerializableBase}from"./Serializable.js";export class InitializableBase extends SerializableBase{constructor(){super(...arguments),this._isInitialized=!1,this._isDestroyed=!1,this._failureMode="warn"}get isInitialized(){return this._isInitialized}get isDestroyed(){return this._isDestroyed}get failureMode(){return this._failureMode}set failureMode(i){this._failureMode=i}async initialize(){return void 0===this._initializePromise&&(this._initializePromise=(async()=>{try{await this._onInitialize(),await this._initializeChildren(),await this._postInitialize()}catch(i){throw i instanceof Error?(this._initializePromise=void 0,new InitializeError(this.failureMode,i,this)):i}this._isInitialized=!0,this.notifyChange("isInitialized")})()),this._initializePromise}async destroy(){return void 0===this._destroyPromise&&(this._destroyPromise=(async()=>{try{await this._onDestroy()}catch(i){throw this._destroyPromise=void 0,i}this._isDestroyed=!0,this.notifyChange("isDestroyed")})()),this._destroyPromise}on(i,e){return super.on(i,e)}emit(i,e){return super.emit(i,e)}_getSerializableProperties(){return{...super._getSerializableProperties(),failureMode:{serializeModes:["initial"],default:"warn"}}}async _onInitialize(){}async _postInitialize(){}async _onDestroy(){}async _initializeChildren(){await parallelEach(this._initializableChildCollections(),(i=>initializeCollection(i,{target:this,onInitializeWarning:i=>this.emit("initializeWarning",i)})))}*_initializableChildCollections(){}}function getInitializableBaseLogger(){return getLogger("geocortex.api.support.InitializeBase")}const DEFAULT_INITIALIZE_COLLECTION_OPTIONS={onInitializeWarning:()=>{}};export async function initializeCollection(i,e=DEFAULT_INITIALIZE_COLLECTION_OPTIONS){const{onInitializeWarning:t,target:r}=e;await parallelEach(i.toArray(),(async i=>{const e=i.on("initializeWarning",t);try{await i.initialize()}catch(e){const a=e instanceof InitializeError?e:new InitializeError(i.failureMode,e,i);if("error"===a.failureMode)throw a;"warn"===a.failureMode&&getInitializableBaseLogger().warn({message:"Error attempting to initialize child item: {0}.",error:a},a.error.message);t({error:a,target:r})}finally{e.remove()}}))}

package/support/Settings.js

@@ -1 +1 @@
-import{CopyOnWriteCollection}from"../utilities/CopyOnWriteCollection.js";import{every}from"../utilities/iterable.js";import{isDefault,SerializableBase,shouldExcludeDefaults}from"./Serializable.js";import{Collection}from"./esri.js";export class Settings extends SerializableBase{get parent(){return this._parent}set parent(e){this._setParent(e)}reset(e){if(this._overrides)if(e)this.parent&&this._settingObservers&&this._settingObservers.forEach((e=>{this._watchParent(e)})),this._overrides.delete(e),this._notifyChange(e);else{const e=[...this._overrides.keys()];this._overrides.clear();for(const t of e)this.parent&&this._settingObservers&&this._settingObservers.forEach((e=>{this._watchParent(e)})),this._notifyChange(t)}}isModified(e){if(!this._overrides)return!1;if(e){if(!this._overrides.has(e))return!1;const t=this._overrides.get(e);return t instanceof CopyOnWriteCollection?t.isModified:!(t instanceof Settings)||t.isModified()}return!every(this._overrides.values(),(e=>e instanceof CopyOnWriteCollection&&!e.isModified||e instanceof Settings&&!e.isModified()))}toJSON(e="all"){const t=super.toJSON(e);if(t)for(const e of Object.keys(t))this.isModified(e)||delete t[e];if(!shouldExcludeDefaults(e)||!isDefault(t))return t}getDefaults(){return{}}_watchProperty(e,t,s,i){const r={path:`${e}${t?`.${t}`:""}`,handle:super._watchProperty(e,t,s,i),callback:s,remove:()=>{r.handle.remove(),r.parentHandle&&r.parentHandle.remove(),this._settingObservers.delete(r)}};return!this.isModified(e)&&this.parent&&this._watchParent(r),this._settingObservers=this._settingObservers||new Set,this._settingObservers.add(r),r}_getSetting(e,t){return this._overrides?.has(e)?this._overrides.get(e):this.parent?this.parent[e]:t}_getCollectionSetting(e){if(!this._overrides||!this._overrides.has(e)){const t=this.parent?this.parent[e]:new Collection;this._overrides=this._overrides||new Map,this._overrides.set(e,new CopyOnWriteCollection(t))}return this._overrides.get(e)}_getNestedSettings(e,t){if(!this._overrides||!this._overrides.has(e)){const s=t();this.parent&&(s.parent=this.parent[e]),this._overrides=this._overrides||new Map,this._overrides.set(e,s)}return this._overrides.get(e)}_setSetting(e,t){!this.isModified(e)&&this.parent&&this._settingObservers&&this._settingObservers.forEach((t=>{t.path===e&&this._unwatchParent(t)})),this._overrides=this._overrides||new Map,this._overrides.set(e,t)}_setParent(e){this.parent&&this._settingObservers&&this._settingObservers.forEach((e=>{e.parentHandle&&e.parentHandle.remove(),e.parentHandle=void 0})),e&&this._settingObservers&&this._settingObservers.forEach((t=>{this.isModified(t.path)||(t.parentHandle=e.watch(t.path,((e,s,i)=>{t.callback(e,s,i,this)})))})),this._settingObservers&&this._settingObservers.forEach((e=>{this._notifyChange(e.path)})),this._parent=e,this._overrides&&this._overrides.forEach(((t,s)=>{t instanceof CopyOnWriteCollection?t.originalCollection=e?e[s]:new Collection:t instanceof Settings&&(t.parent=e?e[s]:void 0)}))}_watchParent(e){e.parentHandle||(e.parentHandle=this.parent.watch(e.path,((t,s,i)=>{e.callback(t,s,i,this)})))}_unwatchParent(e){e.parentHandle&&(e.parentHandle.remove(),e.parentHandle=void 0)}}
+import{CopyOnWriteCollection}from"../utilities/CopyOnWriteCollection.js";import{every}from"../utilities/iterable.js";import{isDefault,SerializableBase,shouldExcludeDefaults}from"./Serializable.js";import{Collection}from"./esri.js";export class Settings extends SerializableBase{get parent(){return this._parent}set parent(e){this._setParent(e)}reset(e){if(this._overrides)if(e)this.parent&&this._settingObservers&&this._settingObservers.forEach((e=>{this._watchParent(e)})),this._overrides.delete(e),this._notifyChange(e);else{const e=[...this._overrides.keys()];this._overrides.clear();for(const t of e)this.parent&&this._settingObservers&&this._settingObservers.forEach((e=>{this._watchParent(e)})),this._notifyChange(t)}}isModified(e){if(!this._overrides)return!1;if(e){if(!this._overrides.has(e))return!1;const t=this._overrides.get(e);return t instanceof CopyOnWriteCollection?t.isModified:!(t instanceof Settings)||t.isModified()}return!every(this._overrides.values(),(e=>e instanceof CopyOnWriteCollection&&!e.isModified||e instanceof Settings&&!e.isModified()))}toJSON(e="all"){const t=super.toJSON(e);if(t)for(const e of Object.keys(t))this.isModified(e)||delete t[e];if(!shouldExcludeDefaults(e)||!isDefault(t))return t}getDefaults(){return{}}_watchProperty(e,t,s,i){const r={path:`${e}${t?`.${t}`:""}`,handle:super._watchProperty(e,t,s,i),callback:s,remove:()=>{r.handle.remove(),r.parentHandle&&r.parentHandle.remove(),this._settingObservers.delete(r)}};return!this.isModified(e)&&this.parent&&this._watchParent(r),this._settingObservers=this._settingObservers||new Set,this._settingObservers.add(r),r}_getSetting(e,t){return this._overrides?.has(e)?this._overrides.get(e):this.parent?this.parent[e]:t}_getCollectionSetting(e){if(!this._overrides||!this._overrides.has(e)){const t=this.parent?this.parent[e]:new Collection;this._overrides=this._overrides||new Map,this._overrides.set(e,new CopyOnWriteCollection(t))}return this._overrides.get(e)}_getNestedSettings(e,t){if(!this._overrides||!this._overrides.has(e)){const s=t();this.parent&&(s.parent=this.parent[e]),this._overrides=this._overrides||new Map,this._overrides.set(e,s)}return this._overrides.get(e)}_setSetting(e,t){!this.isModified(e)&&this.parent&&this._settingObservers&&this._settingObservers.forEach((t=>{t.path===e&&this._unwatchParent(t)})),this._overrides=this._overrides||new Map,this._overrides.set(e,t)}_setParent(e){this.parent&&this._settingObservers&&this._settingObservers.forEach((e=>{e.parentHandle&&e.parentHandle.remove(),e.parentHandle=void 0})),e&&this._settingObservers&&this._settingObservers.forEach((t=>{this.isModified(t.path)||(t.parentHandle=e.watch(t.path,((e,s,i)=>{t.callback(e,s,i,this)})))})),this._parent=e,this._settingObservers&&this._settingObservers.forEach((e=>{this._notifyChange(e.path)})),this._overrides&&this._overrides.forEach(((t,s)=>{t instanceof CopyOnWriteCollection?t.originalCollection=e?e.get(s):new Collection:t instanceof Settings&&(t.parent=e?e.get(s):void 0)}))}_watchParent(e){e.parentHandle||(e.parentHandle=this.parent.watch(e.path,((t,s,i)=>{e.callback(t,s,i,this)})))}_unwatchParent(e){e.parentHandle&&(e.parentHandle.remove(),e.parentHandle=void 0)}}

package/utilities/esri.d.ts

@@ -7,7 +7,14 @@ import type CodedValueDomain from "@arcgis/core/layers/support/CodedValueDomain"
 import type FeatureType from "@arcgis/core/layers/support/FeatureType";
 import type Field from "@arcgis/core/layers/support/Field";
 import type EsriFieldInfo from "@arcgis/core/popup/FieldInfo";
+import type EsriAttachmentsContent from "@arcgis/core/popup/content/AttachmentsContent";
+import type EsriPopupContent from "@arcgis/core/popup/content/Content";
+import type EsriCustomContent from "@arcgis/core/popup/content/CustomContent";
+import type EsriExpressionContent from "@arcgis/core/popup/content/ExpressionContent";
+import type EsriFieldsContent from "@arcgis/core/popup/content/FieldsContent";
 import type ImageMediaInfo from "@arcgis/core/popup/content/ImageMediaInfo";
+import type EsriMediaContent from "@arcgis/core/popup/content/MediaContent";
+import type EsriTextContent from "@arcgis/core/popup/content/TextContent";
 import type PortalItem from "@arcgis/core/portal/PortalItem";
 import type FeatureSet from "@arcgis/core/rest/support/FeatureSet";
 /**
@@ -71,6 +78,48 @@ export declare function isPopupTemplate(popupTemplate: unknown): popupTemplate i
  * @param field The field to check.
  */
 export declare function isField(field: unknown): field is Field;
+/**
+ * Returns true if content is an Esri AttachmentsContent.
+ *
+ * @param content The content to check.
+ */
+export declare function isAttachmentsContent(content: unknown): content is EsriAttachmentsContent;
+/**
+ * Returns true if content is an Esri CustomContent.
+ *
+ * @param content The content to check.
+ */
+export declare function isCustomContent(content: unknown): content is EsriCustomContent;
+/**
+ * Returns true if content is an Esri ExpressionContent.
+ *
+ * @param content The content to check.
+ */
+export declare function isExpressionContent(content: unknown): content is EsriExpressionContent;
+/**
+ * Returns true if content is an Esri FieldsContent.
+ *
+ * @param content The content to check.
+ */
+export declare function isFieldsContent(content: unknown): content is EsriFieldsContent;
+/**
+ * Returns true if content is an Esri MediaContent.
+ *
+ * @param content The content to check.
+ */
+export declare function isMediaContent(content: unknown): content is EsriMediaContent;
+/**
+ * Returns true if content is an Esri TextContent.
+ *
+ * @param content The content to check.
+ */
+export declare function isTextContent(content: unknown): content is EsriTextContent;
+/**
+ * Returns true if content is an Esri PopupContent.
+ *
+ * @param content The content to check.
+ */
+export declare function isPopupContent(content: unknown): content is EsriPopupContent;
 /**
  * Returns true if featureSet is an Esri FeatureSet object.
  *

package/utilities/esri.js

@@ -1 +1 @@
-export async function load(e){e&&"function"==typeof e.load&&await e.load(),await ready(e)}export async function ready(e){e&&"function"==typeof e.when&&await e.when()}export function getAllFieldInfos(e){if(!e)return;const r=Array.isArray(e.content)?e.content.filter((e=>"fields"===e.type)).map((e=>e.fieldInfos||[])):[];return(e.fieldInfos||[]).concat(...r)}const FIELD_TOKEN_REGEX=/\{(expression[\\/])?[\w.]+\}/g,RELATIONSHIP_TOKEN_REGEX=/\{relationships[\\/][\w.]+[\\/][\w.]+\}/g,FIELD_ARCADE_REGEX=/\$feature\.([\w.]+)|\$feature\["([\w.]+)"\]/g;export function getAllReferencedFieldNames(e){if(!e)return;const r=new Set,t=[],n=[];return t.push(e.title),e.expressionInfos&&e.expressionInfos.forEach((e=>{n.push(e.expression,e.title)})),Array.isArray(e.content)?e.content.forEach((e=>{if("text"===e.type)t.push(e.text);else if("media"===e.type){let n=e.mediaInfos||[];n=Array.isArray(n)?n:[n],n.forEach((e=>{t.push(e.title,e.caption),isImageMediaInfo(e)?e.value&&t.push(e.value.linkURL,e.value.sourceURL):e.value&&(r.add(e.value.tooltipField),r.add(e.value.normalizeField),(e.value.fields||[]).forEach((e=>r.add(e))))}))}})):"string"==typeof e.content&&t.push(e.content),n.filter((e=>!!e)).forEach((e=>{const t=e.matchAll(FIELD_ARCADE_REGEX);for(const e of t)r.add(e[1]??e[2])})),t.filter((e=>!!e)).forEach((e=>{let t;const n=new RegExp(FIELD_TOKEN_REGEX),o=new RegExp(RELATIONSHIP_TOKEN_REGEX),a=n=>{const o=new RegExp(n);for(t=o.exec(e);t&&"string"==typeof t[0]&&void 0===t[1];)r.add(t[0].replace(/\{|\}/g,"").split(":")[0]),t=o.exec(e)};a(n),a(o)})),Array.from(r.values()).filter((e=>!!e))}export function isCodedValueDomain(e){return"esri.layers.support.CodedValueDomain"===e?.declaredClass}export function isColor(e){return"esri.Color"===e?.declaredClass}export function isImageMediaInfo(e){return"esri.popup.content.ImageMediaInfo"===e?.declaredClass}export function isPopupTemplate(e){return"esri.PopupTemplate"===e?.declaredClass}export function isField(e){return"esri.layers.support.Field"===e?.declaredClass}export function isFeatureSet(e){return"esri.rest.support.FeatureSet"===e?.declaredClass}export function isFeatureType(e){return"esri.layers.support.FeatureType"===e?.declaredClass}export function isViewpoint(e){return"esri.Viewpoint"===e?.declaredClass}export function isPortalItem(e){return"esri.portal.PortalItem"===e?.declaredClass}export function isGraphic(e){return"esri.Graphic"===e?.declaredClass}export function isSpatialReference(e){return"esri.geometry.SpatialReference"===e?.declaredClass}export function isEsriObject(e){return!!e?.declaredClass}
+export async function load(e){e&&"function"==typeof e.load&&await e.load(),await ready(e)}export async function ready(e){e&&"function"==typeof e.when&&await e.when()}export function getAllFieldInfos(e){if(!e)return;const t=Array.isArray(e.content)?e.content.filter((e=>"fields"===e.type)).map((e=>e.fieldInfos||[])):[];return(e.fieldInfos||[]).concat(...t)}const FIELD_TOKEN_REGEX=/\{(expression[\\/])?[\w.]+\}/g,RELATIONSHIP_TOKEN_REGEX=/\{relationships[\\/][\w.]+[\\/][\w.]+\}/g,FIELD_ARCADE_REGEX=/\$feature\.([\w.]+)|\$feature\["([\w.]+)"\]/g;export function getAllReferencedFieldNames(e){if(!e)return;const t=new Set,n=[],r=[];return n.push(e.title),e.expressionInfos&&e.expressionInfos.forEach((e=>{r.push(e.expression,e.title)})),Array.isArray(e.content)?e.content.forEach((e=>{if("text"===e.type)n.push(e.text);else if("media"===e.type){let r=e.mediaInfos||[];r=Array.isArray(r)?r:[r],r.forEach((e=>{n.push(e.title,e.caption),isImageMediaInfo(e)?e.value&&n.push(e.value.linkURL,e.value.sourceURL):e.value&&(t.add(e.value.tooltipField),t.add(e.value.normalizeField),(e.value.fields||[]).forEach((e=>t.add(e))))}))}})):"string"==typeof e.content&&n.push(e.content),r.filter((e=>!!e)).forEach((e=>{const n=e.matchAll(FIELD_ARCADE_REGEX);for(const e of n)t.add(e[1]??e[2])})),n.filter((e=>!!e)).forEach((e=>{let n;const r=new RegExp(FIELD_TOKEN_REGEX),o=new RegExp(RELATIONSHIP_TOKEN_REGEX),s=r=>{const o=new RegExp(r);for(n=o.exec(e);n&&"string"==typeof n[0]&&void 0===n[1];)t.add(n[0].replace(/\{|\}/g,"").split(":")[0]),n=o.exec(e)};s(r),s(o)})),Array.from(t.values()).filter((e=>!!e))}export function isCodedValueDomain(e){return"esri.layers.support.CodedValueDomain"===e?.declaredClass}export function isColor(e){return"esri.Color"===e?.declaredClass}export function isImageMediaInfo(e){return"esri.popup.content.ImageMediaInfo"===e?.declaredClass}export function isPopupTemplate(e){return"esri.PopupTemplate"===e?.declaredClass}export function isField(e){return"esri.layers.support.Field"===e?.declaredClass}export function isAttachmentsContent(e){return"esri.popup.content.AttachmentsContent"===e?.declaredClass}export function isCustomContent(e){return"esri.popup.content.CustomContent"===e?.declaredClass}export function isExpressionContent(e){return"esri.popup.content.ExpressionContent"===e?.declaredClass}export function isFieldsContent(e){return"esri.popup.content.FieldsContent"===e?.declaredClass}export function isMediaContent(e){return"esri.popup.content.MediaContent"===e?.declaredClass}export function isTextContent(e){return"esri.popup.content.TextContent"===e?.declaredClass}export function isPopupContent(e){return isAttachmentsContent(e)||isExpressionContent(e)||isCustomContent(e)||isFieldsContent(e)||isTextContent(e)||isMediaContent(e)}export function isFeatureSet(e){return"esri.rest.support.FeatureSet"===e?.declaredClass}export function isFeatureType(e){return"esri.layers.support.FeatureType"===e?.declaredClass}export function isViewpoint(e){return"esri.Viewpoint"===e?.declaredClass}export function isPortalItem(e){return"esri.portal.PortalItem"===e?.declaredClass}export function isGraphic(e){return"esri.Graphic"===e?.declaredClass}export function isSpatialReference(e){return"esri.geometry.SpatialReference"===e?.declaredClass}export function isEsriObject(e){return!!e?.declaredClass}

package/utilities/extensions.d.ts

@@ -1,4 +1,5 @@
 import type { ArcGISServiceTableExtension } from "../data/ArcGISServiceTableExtension.js";
+import type { BuildingComponentSublayerExtension } from "../mapping/BuildingComponentSublayerExtension.js";
 import type { BuildingSceneLayerExtension } from "../mapping/BuildingSceneLayerExtension.js";
 import type { CSVLayerExtension } from "../mapping/CSVLayerExtension.js";
 import type { FeatureCollectionLayerExtension } from "../mapping/FeatureCollectionLayerExtension.js";
@@ -9,6 +10,7 @@ import type { ImageryLayerExtension } from "../mapping/ImageryLayerExtension.js"
 import type { KMLLayerExtension } from "../mapping/KMLLayerExtension.js";
 import type { MapImageLayerExtension } from "../mapping/MapImageLayerExtension.js";
 import type { MapImageSublayerExtension } from "../mapping/MapImageSublayerExtension.js";
+import type { PointCloudLayerExtension } from "../mapping/PointCloudLayerExtension.js";
 import type { SceneLayerExtension } from "../mapping/SceneLayerExtension.js";
 import type { StreamLayerExtension } from "../mapping/StreamLayerExtension.js";
 import type { SubtypeGroupLayerExtension } from "../mapping/SubtypeGroupLayerExtension.js";
@@ -131,3 +133,15 @@ export declare function isKMLLayerExtension(extension: unknown): extension is KM
  * @param extension The extension to check.
  */
 export declare function isBuildingSceneLayerExtension(extension: unknown): extension is BuildingSceneLayerExtension;
+/**
+ * Returns true if the extension is a PointCloudLayerExtension.
+ *
+ * @param extension The extension to check.
+ */
+export declare function isPointCloudLayerExtension(extension: unknown): extension is PointCloudLayerExtension;
+/**
+ * Returns true if the extension is a BuildingComponentSublayerExtension.
+ *
+ * @param extension The extension to check.
+ */
+export declare function isBuildingComponentSublayerExtension(extension: unknown): extension is BuildingComponentSublayerExtension;

package/utilities/extensions.js

@@ -1 +1 @@
-import{isLayerExtension,isSublayerExtension,isTableExtension}from"../ItemType.js";import{isMapImageSublayer,isSubtypeSublayer,isWMSSublayer}from"./layers.js";export function isArcGISServiceTableExtension(e){return isTableExtension(e)&&"ArcGISServiceTable"===e.getDefaults().table.$tableType}export function isGroupLayerExtension(e){return isLayerExtension(e)&&!!e.layerExtensions}export function isFeatureLayerExtension(e){return isLayerExtension(e)&&"ArcGISFeatureLayer"===e.getDefaults().layer?.layerType}export function isSubtypeSublayerExtension(e){return isSublayerExtension(e)&&(isSubtypeSublayer(e.sublayer)||"SubtypeSublayer"===e._deferredSublayerProperties?.$sublayerType)}export function isSubtypeGroupLayerExtension(e){return isLayerExtension(e)&&"ArcGISSubtypeGroupLayer"===e.getDefaults().layer?.layerType}export function isFeatureCollectionLayerExtension(e){return isLayerExtension(e)&&"feature-collection-layer"===e._getSerializableLayerType?.()}export function isCSVLayerExtension(e){return isLayerExtension(e)&&"CSV"===e.getDefaults().layer.layerType}export function isGeoRssLayerExtension(e){return isLayerExtension(e)&&"GeoRSS"===e.getDefaults().layer.layerType}export function isImageryLayerExtension(e){return isLayerExtension(e)&&"ArcGISImageServiceLayer"===e.getDefaults().layer.layerType}export function isSceneLayerExtension(e){return isLayerExtension(e)&&"ArcGISSceneServiceLayer"===e.getDefaults().layer.layerType}export function isStreamLayerExtension(e){return isLayerExtension(e)&&"ArcGISStreamLayer"===e.getDefaults().layer.layerType}export function isMapImageLayerExtension(e){return isLayerExtension(e)&&"ArcGISMapServiceLayer"===e.getDefaults().layer.layerType}export function isTileLayerExtension(e){return isLayerExtension(e)&&"ArcGISTiledMapServiceLayer"===e.getDefaults().layer.layerType}export function isWMSLayerExtension(e){return isLayerExtension(e)&&"WMS"===e.getDefaults().layer.layerType}export function isWMSSublayerExtension(e){return isSublayerExtension(e)&&(isWMSSublayer(e.sublayer)||"WMSSublayer"===e._deferredSublayerProperties?.$sublayerType)}export function isMapImageSublayerExtension(e){return isSublayerExtension(e)&&(isMapImageSublayer(e.sublayer)||"ArcGISMapServiceSublayer"===e._deferredSublayerProperties?.$sublayerType)}export function isWMTSLayerExtension(e){if(!isLayerExtension(e))return!1;const r=e.getDefaults().layer;return"WebTiledLayer"===r.layerType&&!!r.wmtsInfo}export function isKMLLayerExtension(e){return isLayerExtension(e)&&"KML"===e.getDefaults().layer.layerType}export function isBuildingSceneLayerExtension(e){return isLayerExtension(e)&&"BuildingSceneLayer"===e.getDefaults().layer.layerType}
+import{isLayerExtension,isSublayerExtension,isTableExtension}from"../ItemType.js";import{isBuildingComponentSublayer,isMapImageSublayer,isSubtypeSublayer,isWMSSublayer}from"./layers.js";export function isArcGISServiceTableExtension(e){return isTableExtension(e)&&"ArcGISServiceTable"===e.getDefaults().table.$tableType}export function isGroupLayerExtension(e){return isLayerExtension(e)&&!!e.layerExtensions}export function isFeatureLayerExtension(e){return isLayerExtension(e)&&"ArcGISFeatureLayer"===e.getDefaults().layer?.layerType}export function isSubtypeSublayerExtension(e){return isSublayerExtension(e)&&(isSubtypeSublayer(e.sublayer)||"SubtypeSublayer"===e._deferredSublayerProperties?.$sublayerType)}export function isSubtypeGroupLayerExtension(e){return isLayerExtension(e)&&"ArcGISSubtypeGroupLayer"===e.getDefaults().layer?.layerType}export function isFeatureCollectionLayerExtension(e){return isLayerExtension(e)&&"feature-collection-layer"===e._getSerializableLayerType?.()}export function isCSVLayerExtension(e){return isLayerExtension(e)&&"CSV"===e.getDefaults().layer.layerType}export function isGeoRssLayerExtension(e){return isLayerExtension(e)&&"GeoRSS"===e.getDefaults().layer.layerType}export function isImageryLayerExtension(e){return isLayerExtension(e)&&"ArcGISImageServiceLayer"===e.getDefaults().layer.layerType}export function isSceneLayerExtension(e){return isLayerExtension(e)&&"ArcGISSceneServiceLayer"===e.getDefaults().layer.layerType}export function isStreamLayerExtension(e){return isLayerExtension(e)&&"ArcGISStreamLayer"===e.getDefaults().layer.layerType}export function isMapImageLayerExtension(e){return isLayerExtension(e)&&"ArcGISMapServiceLayer"===e.getDefaults().layer.layerType}export function isTileLayerExtension(e){return isLayerExtension(e)&&"ArcGISTiledMapServiceLayer"===e.getDefaults().layer.layerType}export function isWMSLayerExtension(e){return isLayerExtension(e)&&"WMS"===e.getDefaults().layer.layerType}export function isWMSSublayerExtension(e){return isSublayerExtension(e)&&(isWMSSublayer(e.sublayer)||"WMSSublayer"===e._deferredSublayerProperties?.$sublayerType)}export function isMapImageSublayerExtension(e){return isSublayerExtension(e)&&(isMapImageSublayer(e.sublayer)||"ArcGISMapServiceSublayer"===e._deferredSublayerProperties?.$sublayerType)}export function isWMTSLayerExtension(e){if(!isLayerExtension(e))return!1;const r=e.getDefaults().layer;return"WebTiledLayer"===r.layerType&&!!r.wmtsInfo}export function isKMLLayerExtension(e){return isLayerExtension(e)&&"KML"===e.getDefaults().layer.layerType}export function isBuildingSceneLayerExtension(e){return isLayerExtension(e)&&"BuildingSceneLayer"===e.getDefaults().layer.layerType}export function isPointCloudLayerExtension(e){return isLayerExtension(e)&&"PointCloudLayer"===e.getDefaults().layer.layerType}export function isBuildingComponentSublayerExtension(e){return isSublayerExtension(e)&&(isBuildingComponentSublayer(e.sublayer)||"BuildingComponentSublayer"===e._deferredSublayerProperties?.$sublayerType)}

package/version.d.ts

@@ -1,4 +1,4 @@
 /**
  * The current version of the Geocortex ArcGIS Extensions API.
  */
-export declare const version = "37.1.1";
+export declare const version = "37.2.1";

package/version.js

@@ -1 +1 @@
-export const version="37.1.1";
+export const version="37.2.1";