@arcgis/core 5.1.0-next.13 → 5.1.0-next.15

package/widgets/Editor/EditorViewModel.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
-import{__decorate as e}from"tslib";import{isSome as t}from"../../core/arrayUtils.js";import{createTask as i}from"../../core/asyncUtils.js";import o from"../../core/Collection.js";import{deprecatedFunction as r}from"../../core/deprecate.js";import s from"../../core/Error.js";import{EventedAccessor as a}from"../../core/Evented.js";import{abortHandle as n,makeHandle as l}from"../../core/handleUtils.js";import"../../core/has.js";import c from"../../core/Logger.js";import{destroyMaybe as d,abortMaybe as p,removeMaybe as h}from"../../core/maybe.js";import{throwIfAborted as u,createResolver as w}from"../../core/promiseUtils.js";import f from"../../core/ReactiveMap.js";import{watch as m,syncAndInitial as y,initial as g,on as k,when as v,sync as _,whenOnce as W}from"../../core/reactiveUtils.js";import{property as M,subclass as T}from"../../core/accessorSupport/decorators.js";import{UpdatingHandles as b}from"../../core/support/UpdatingHandles.js";import{getTemplatesForLayers as F}from"../../editing/templateUtils.js";import{getGraphicLayer as S}from"../../graphic/graphicOriginUtils.js";import V from"../../layers/GraphicsLayer.js";import{isEditableLayer as I}from"../../layers/support/editableLayers.js";import{isFeatureLayer as L,isSubtypeGroupLayer as E,getOwningPortalUrl as A}from"../../layers/support/layerUtils.js";import{parseKnownArcGISOnlineDomain as C}from"../../portal/support/urlUtils.js";import U from"../../views/SelectionManager.js";import O from"../../views/interactive/sketch/SketchLabelOptions.js";import j from"../../views/interactive/sketch/SketchOptions.js";import R from"../../views/interactive/sketch/SketchTooltipOptions.js";import P from"../../views/interactive/sketch/SketchValueOptions.js";import{SnappingManager as H}from"../../views/interactive/snapping/SnappingManager.js";import q from"../../views/interactive/snapping/SnappingOptions.js";import{isISelectableLayer as x}from"../../views/support/selectionUtils.js";import G from"../Attachments/AttachmentsViewModel.js";import D from"./CreateFeaturesWorkflow.js";import B from"./UpdateWorkflow.js";import{getLayersFromWorkflow as N,isCreateFeaturesWorkflow as Q,isUpdateRecordWorkflow as z,isUpdateFeaturesWorkflow as Z,isMergeFeaturesWorkflow as $,isSplitFeatureWorkflow as J,isUpdateWorkflow as K,isFeatureFormViewModel as X,findEditorItemForLayerOrThrow as Y,toFeatureInfos as ee,fetchFullFeaturesByObjectId as te,fetchFullFeatures as ie,findEditorItemForLayer as oe,whenEditorLayerView as re}from"./workflowUtils.js";import se from"./support/EditorItem.js";import{assertViewNot3D as ae,MultipleSourceLayersError as ne,InsufficientFeatureCountError as le,MissingOriginLayerError as ce,assertMergeWorkflowCapabilities as de,FetchFullFeatureError as pe,assertSplitWorkflowCapabilities as he}from"./support/errors.js";import{makeTemplateGroupInfoForLayer as ue}from"../FeatureTemplates/featureTemplatesUtils.js";import we from"../FeatureTemplates/FeatureTemplatesViewModel.js";import fe from"../Sketch/SketchViewModel.js";import me from"../Spinner/SpinnerViewModel.js";import{goTo as ye}from"../support/goToUtils.js";import{isFeatureItem as ge,isLayerItem as ke}from"../support/SelectionList/selectionListUtils.js";import ve from"../support/SelectionList/SelectionListViewModel.js";import _e from"../support/SelectionToolbar/SelectionToolbarViewModel.js";function We(e,t){return e?.find(e=>e.layer===t)}let Me=class extends a{constructor(e){super(e),this._defaultSelectionManager=new U,this._queuedSelectionTool=null,this._sketchEventListenerHandle=null,this._sketchGraphicsLayer=new V({listMode:"hide",internal:!0,title:"Editor sketch layer"}),this._snappingManager=null,this._templatesByLayer=new Map,this._updateItemsTask=null,this._updateTemplatesTask=null,this._updatingHandles=new b,this._featureTemplatesViewModelIsRestricted=!1,this.activeWorkflow=null,this._activityQueue=new o,this.editorItems=new o,this.editorItemsLayerMap=new f,this.failures=[],this.hideTemplatesForInactiveLayers=!1,this.attachmentsViewModel=new G({capabilities:{editing:!0}}),this.featureTemplatesViewModel=new we({disabledItemFunction:({layer:e})=>this._itemIsSuspended(e)}),this.layerInfos=null,this.useLegacyCreateTools=!0,this.ownSketchViewModel=new fe({layer:this._sketchGraphicsLayer,useLegacyCreateTools:this.useLegacyCreateTools}),this.selectionListViewModel=new ve,this.selectionManager=null,this.selectionToolbarViewModel=new _e({continuousSelectionEnabled:!0,defaultOperationType:"replace",persistSelection:!1,returnGeometry:!1}),this.sketchOptions=new j,this.snappingOptions=new q({attributeRulesEnabled:!0}),this.spinnerViewModel=new me,this.syncViewSelection=!1,this.pageStack=[],this.showDiscardEditsPrompt=()=>Promise.resolve(!0),this._candidateCommitted=!1,this.back=async()=>{if("viewing-selection-list"===this.state)return this.selectionListViewModel.filterText=void 0,void this.effectiveSelectionManager.clear();this.canGoBack&&(this.activeWorkflow?.hasPreviousStep?await this.activeWorkflow.back(this.showDiscardEditsPrompt):await this._cancelWorkflow({force:!this.hasPendingEdits}))},this.saveWorkflow=async()=>await(this.activeWorkflow?.save()),this.selectFeature=(e,t=!1)=>{const i=this.activeWorkflow;if(this._candidateCommitted||"update"!==i?.type)return;const{rootFeatures:o}=i.data;o.removeAll(),e&&o.add(e),t&&(i.next(),this._candidateCommitted=!0)}}initialize(){this.addHandles([m(()=>{const e=this.view,t=e?.map?.editableLayers.toArray(),i=e?.allLayerViews,o=i?.filter(e=>!!t?.includes(e.layer));return[t,o,this.layerInfos]},()=>this._updateEditorItems(),y),m(()=>this.hideTemplatesForInactiveLayers,()=>this.syncFeatureTemplates()),m(()=>this._selectionSources,()=>this._syncSelectionSources(),g),k(()=>this.activeWorkflow,"cancel",()=>this.emit("workflow-cancel")),k(()=>this.activeWorkflow,"commit",()=>this.emit("workflow-commit")),k(()=>this.activeWorkflow,"complete",()=>{this.emit("workflow-commit"),this._set("activeWorkflow",null)}),v(()=>!this.activeWorkflow&&this._queuedSelectionTool,()=>this._queuedSelectionTool&&this.selectionToolbarViewModel.activateTool(this._queuedSelectionTool)),m(()=>this.activeWorkflow,e=>this._defaultSelectionManager.highlightEnabled=!e),v(()=>this.view?.map,e=>e.add(this._sketchGraphicsLayer),g),k(()=>this.editorItems,"change",()=>this._afterEditorItemsChange()),m(()=>[this.canCreate,this.canUpdateVisible],()=>this._afterEditorItemsChange()),m(()=>this.page,(e,t)=>{const i=[...this.pageStack];if(-1===i.indexOf(e))i.push(e);else for(;i.length&&i.at(-1)!==e;)i.pop();this.pageStack=i},y),v(()=>"awaiting-update-feature-candidate"===this.state,()=>this._candidateCommitted=!1),k(()=>this.featureTemplatesViewModel,"select",async({item:e,oldItem:t})=>{const{activeWorkflow:i}=this;if(i){if("update"===i.type&&"awaiting-feature-creation-info"===i.activeWorkflow?.stepId)return;try{await this.cancelWorkflow({force:!this.hasPendingEdits})}catch{return void this.featureTemplatesViewModel.select(t,{emit:!1})}}if(!e)return;const o={layer:e.layer,template:e.template};if(e.supportsUpload)return this.featureTemplatesViewModel.select(t,{emit:!1}),this.startCreateFeaturesWorkflow(o);await this.startCreateFeaturesWorkflowAtFeatureCreation(o)}),m(()=>[this.view,this.featureTemplatesViewModel],([e,t])=>{t.view=e},y),k(()=>this.view,"key-down",e=>{"Escape"===e.key&&this.activeWorkflow?.keyboardCancellationEnabled&&(e.stopPropagation(),this.back())}),k(()=>this.sketchViewModel,["create","delete","update"],e=>{const{activeWorkflow:t}=this,i=N(t),o=`sketch-${e.type}`;this.emit(o,{type:o,detail:e,layer:i[0],layers:i})},_),m(()=>this.view,e=>{if(this._snappingManager=d(this._snappingManager),!e)return;const t=this.snappingOptions;this._snappingManager=new H({view:e,options:t}),this.ownSketchViewModel.snappingManager=this._snappingManager},y),m(()=>this.snappingOptions,e=>{this._snappingManager&&(this._snappingManager.options=e)},y),k(()=>this.selectionToolbarViewModel,"complete",e=>this._onSelectionComplete(e)),m(()=>({view:this.view,selectionManager:this.effectiveSelectionManager,selectionListViewModel:this.selectionListViewModel,selectionToolbarViewModel:this.selectionToolbarViewModel}),({view:e,selectionManager:t,selectionListViewModel:i,selectionToolbarViewModel:o})=>{t.view=e,i.view=e,o.view=e},y),m(()=>this.effectiveSelectionManager,e=>{this.selectionListViewModel.selectionManager=e,this.selectionToolbarViewModel.selectionManager=e},y)])}destroy(){this._cancelWorkflow({warnIfNoWorkflow:!1}).then(()=>{this.view?.map?.remove(this._sketchGraphicsLayer),this.view=null}),this._updateItemsTask=p(this._updateItemsTask),this._updatingHandles.destroy(),this._sketchEventListenerHandle=h(this._sketchEventListenerHandle),this.selectionListViewModel?.destroy(),this.selectionToolbarViewModel?.destroy(),this._defaultSelectionManager.destroy()}get _featureTemplatesLayersAndTables(){const e=new o;for(const t of this.editorItems){const i=this.hideTemplatesForInactiveLayers&&!t.visible;t.supportsCreateFeaturesWorkflow&&!i&&e.push(t.layer)}return e}get _selectionSources(){const e=new o;if(this.syncViewSelection||this.selectionManager)return e;for(const t of this.editorItems)x(t.layer)&&t.supportsUpdateWorkflow&&e.push(t.layer);return e}get activeFeatureCount(){const e=this.activeLeafWorkflow;return Q(e)?e.pendingFeatures.length:z(e)&&e.data.edits.feature?1:Z(e)?e.data.fullFeatures.length:$(e)?e.data.features.length:J(e)?2:0}get activeLeafWorkflow(){const e=this.activeWorkflow;return e&&K(e)?e.activeWorkflow??e:e}get canCreate(){return this.editorItems.some(e=>e.supportsCreateFeaturesWorkflow)}get canCreateVisible(){return!!this.featureTemplatesLayers.length}get canUpdate(){return this.editorItems.some(e=>e.supportsUpdateWorkflow)}get canUpdateVisible(){return this.editorItems.some(e=>e.supportsUpdateWorkflow&&e.visible)}get featureTemplatesLayers(){return this._featureTemplatesLayersAndTables.filter(e=>"scene"===e.type||!e.isTable)}get effectiveSelectionManager(){const e=this.view;return e&&this.syncViewSelection?e.selectionManager:this.selectionManager??this._defaultSelectionManager}get featureFormViewModel(){const e=this.activeWorkflow?.formViewModel;return X(e)?e:null}get formViewModel(){return this.activeWorkflow?.formViewModel}get utilityNetworkAssociationAddAssociationViewModel(){const{activeWorkflow:e}=this;return"update"===e?.type?e.activeUtilityNetworkAssociationAddAssociationViewModel:null}get labelOptions(){return this.sketchOptions.labels}set labelOptions(e){this.sketchOptions.labels=e}get isUsingLegacyCreateTools(){return this.useLegacyCreateTools||"2d"!==this.view?.type}get sketchViewModel(){const{activeWorkflow:e}=this;return"update"===e?.type?e.activeSketchViewModel:"create-features"===e?.type?e.sketchViewModel:this.ownSketchViewModel}get state(){if(!this.view?.ready)return"disabled";const e=this.attachmentsViewModel.mode;if("add"===e)return"adding-attachment";if("edit"===e)return"editing-attachment";const{activeWorkflow:t}=this,i=!t?.stepId;return this.effectiveSelectionManager.count&&i?"viewing-selection-list":i?"ready":"update"===t.type&&t.activeWorkflow?.stepId?t.activeWorkflow.stepId:t.stepId}get syncing(){return this._activityQueue.length>0}get updating(){return this._updatingHandles.updating||!0===this.activeWorkflow?.updating}get tooltipOptions(){return this.sketchOptions.tooltips}set tooltipOptions(e){this.sketchOptions.tooltips=e}get valueOptions(){return this.sketchOptions.values}set valueOptions(e){this.sketchOptions.values=e}set view(e){this.ownSketchViewModel.view=e,this.spinnerViewModel.view=e,this._set("view",e)}get canZoomTo(){const e=this.sketchViewModel,t=e?.createGraphic?.geometry?.type;return!(!e?.updateGraphics?.length&&"multipoint"!==t)}get page(){const{activeWorkflow:e,state:t}=this;if("update"===e?.type&&X(e.formViewModel)){const{associatedLayer:t,associationId:i}=e.formViewModel;if(t||null!=i)return"viewing-associated-features"}if("update"===e?.type&&"awaiting-feature-to-update"===e.stepId)return"ready";if("create-features"===e?.type&&0===e.numPendingFeatures){const t=e.data.upload;if(t)return"default"===t.state?"ready":"creating-features-upload-details"}return t??"disabled"}get featureFormDisabled(){const{activeLeafWorkflow:e}=this;if(z(e))return!1===e.data.editorItem?.capabilities.update.attributes||!0===e.formViewModel.disabled;if(Z(e)){const{formViewModel:t}=e;return t.disabled||t.readOnly}return!1}get featureFormHasAssociation(){return!!this.featureFormViewModel?.activeAssociation}get canGoBack(){return null!=this.activeWorkflow&&!this.syncing}get shouldShowDeleteButton(){const{activeLeafWorkflow:e}=this;if(z(e)){const{data:t}=e;return t.editorItem?.capabilities.delete.enabled&&!t.readOnly}return!!Z(e)&&e.data.editorItems.every(e=>e.capabilities.delete.enabled)}get hasPendingEdits(){return this.activeWorkflow?.hasPendingEdits??!1}get snappingManager(){return this._snappingManager}activateSelectionTool(e){return this.selectionToolbarViewModel.activateTool(e)}cancelSelectionTool(){this.selectionToolbarViewModel.cancel()}getTemplatesForLayer(e){return this._templatesByLayer.get(e)??[]}async startCreateFeaturesWorkflowAtFeatureTypeSelection(){return this.startCreateFeaturesWorkflow()}async startCreateFeaturesWorkflowAtFeatureCreation(e){return this.startCreateFeaturesWorkflow(e,"creating-features")}async startCreateFeaturesWorkflow(e,t="awaiting-feature-creation-info"){if(await W(()=>!this.updating),!this.canCreate)throw new s("editing:unsupported-workflow","Creating features is unsupported or disabled.");const i=this._createUpdatingResolver();try{await this._cancelWorkflow();const i=this._createCreateFeaturesWorkflow(e,t);this._set("activeWorkflow",i),await i.start()}catch(o){this._logErrorAndCancelWorkflow(o)}finally{i.resolve()}}async startCreateFeaturesWorkflowAtFeatureEdit(e){await W(()=>!this.updating);const t=this._createUpdatingResolver();try{const{initialFeature:t}=e,i=t.sourceLayer=t.layer,o=i?Y(this.editorItems,i):void 0;if(!o?.supportsCreateFeaturesWorkflow)throw new s("editing:unsupported-workflow","Creating features is unsupported or disabled for this layer.");await this._cancelWorkflow();const r=this._createCreateFeaturesWorkflow({initialFeature:t,layer:o.layer,maxFeatures:1},"creating-features");this._set("activeWorkflow",r),await r.start()}catch(i){this._logErrorAndCancelWorkflow(i)}finally{t.resolve()}}async startMergeFeaturesWorkflow(e,t={}){await W(()=>!this.updating),ae(this,"merge-features");const i=Array.isArray(e)?ee(e):[e];if(i.length>1)throw new ne;if(0===i.length||i[0].objectIds.length<2)throw new le(2);const r=i[0],s=r.layer;if(!s)throw new ce;const a=Y(this.editorItems,s);de(a);const l=this._createUpdatingResolver(),c=new AbortController;this.addHandles(n(c));try{await this._cancelWorkflow(),this.cancelSelectionTool();const e=await te(r.objectIds,s,this.view?.spatialReference,c.signal);if(e.length!==r.objectIds.length)throw new pe;let i;if(t.keyFeature){const o=t.keyFeature.getObjectId();i=e.find(e=>e.getObjectId()===o)??t.keyFeature}const a=this._createUpdateWorkflow("editing-existing-feature",{rootFeatures:new o(e),rootWorkflowOptions:{type:"merge",props:{...t,keyFeature:i}}});this._set("activeWorkflow",a),this.addHandles(this._destroyWorkflowOnCommit(a)),await a.start()}catch(d){this._logErrorAndCancelWorkflow(d)}finally{l.resolve()}}async startSplitFeatureWorkflow(e,t={}){await W(()=>!this.updating),ae(this,"split-feature");const i=S(e);if(!i)throw new ce;const r=Y(this.editorItems,i);he(r);const s=this._createUpdatingResolver(),a=new AbortController;this.addHandles(n(a));try{await this._cancelWorkflow(),this.cancelSelectionTool();const r=await ie([e],i,this.view?.spatialReference,a.signal);if(1!==r.length)throw new pe;const s=this._createUpdateWorkflow("editing-existing-feature",{rootFeatures:new o(r),rootWorkflowOptions:{type:"split",props:t}});this._set("activeWorkflow",s),this.addHandles(this._destroyWorkflowOnCommit(s)),await s.start()}catch(l){this._logErrorAndCancelWorkflow(l)}finally{s.resolve()}}async startUpdateFeaturesWorkflow(e){if(await W(()=>!this.updating),!this.canUpdate)return void this._logError("editing:unsupported-workflow","Update features workflow is unsupported or disabled.");const t=Array.isArray(e)?ee(e):[e];if(t.length>1)throw new ne;const i=this._createUpdatingResolver();try{await this._cancelWorkflow(),this.cancelSelectionTool();const e=this._createUpdateWorkflow("editing-existing-feature",{rootFeatureInfos:t,rootWorkflowOptions:{type:"update-multiple"}});e.addHandles(this._destroyWorkflowOnCommit(e)),this._set("activeWorkflow",e),await e.start()}catch(o){this._logErrorAndCancelWorkflow(o)}finally{i.resolve()}}async startUpdateWorkflowAtFeatureSelection(){if(await W(()=>!this.updating),!this.canUpdate)return void this._logError("editing:unsupported-workflow","Update workflow is unsupported or disabled.");const e=this._createUpdatingResolver();try{await this._cancelWorkflow();const e=this._createUpdateWorkflow();this._set("activeWorkflow",e),await e.start()}catch(t){this._logErrorAndCancelWorkflow(t)}finally{e.resolve()}}async startUpdateWorkflowAtMultipleFeatureSelection(e){if(await W(()=>!this.updating),!this.canUpdate)return void this._logError("editing:unsupported-workflow","Update workflow is unsupported or disabled.");const t=this._createUpdatingResolver();try{await this._cancelWorkflow();const t=this._createUpdateWorkflow("awaiting-update-feature-candidate");t.data.candidates=e,this._set("activeWorkflow",t),await t.start()}catch(i){this._logErrorAndCancelWorkflow(i)}finally{t.resolve()}}async startUpdateWorkflowAtFeatureEdit(e){if(await W(()=>!this.updating),!this.canUpdate)return void this._logError("editing:unsupported-workflow","Update workflow is unsupported or disabled.");const t=this._createUpdatingResolver();try{await this._cancelWorkflow(),this.cancelSelectionTool();const t=this._createUpdateWorkflow("editing-existing-feature",{rootFeatures:new o([e])});t.addHandles(this._destroyWorkflowOnCommit(t)),this._set("activeWorkflow",t),await t.start()}catch(i){this._logErrorAndCancelWorkflow(i)}finally{t.resolve()}}async startUpdateWorkflowWithActiveSelection(){const{selectionListViewModel:e}=this;if(!e.visibleFeatureCount||!e.visibleLayerCount)throw new s("editing:missing-selection","Unable to determine visible selection.");if(e.visibleLayerCount>1)throw new s("editing:features-different-layers","Cannot start workflow with features from different layers.");const t=e.layerItems.find(e=>e.visible);t&&await this._startUpdateWorkflowWithLayerItem(t,"update")}async deleteFeatureFromWorkflow(){r(c.getLogger(this),"EditorViewModel.deleteFeatureFromWorkflow is deprecated. Use EditorViewModel.deleteFeatures instead.",{version:"4.33",replacement:"EditorViewModel.deleteFeatures",warnOnce:!0}),await this.deleteFeatures()}async deleteFeatures(){const e=this.activeWorkflow;if(K(e))return e.deleteActiveFeatures();this._logError("editing:unsupported-workflow","Deleting features requires an active update workflow.")}async deleteAssociationFromWorkflow(){const{activeWorkflow:e}=this;e&&"update"===e.type?await e.deleteActiveAssociation():this._logError("editing:unsupported-workflow","Deleting an association requires an active update workflow.")}async cancelWorkflow(e){return this._cancelWorkflow({warnIfNoWorkflow:!0,...e})}itemHasInvalidFormTemplate(e){return null!=e&&!0===oe(this.editorItems,e.layer)?.hasInvalidFormTemplate}syncFeatureTemplates(){this._featureTemplatesViewModelIsRestricted||this._updateTemplates()}zoomTo(e){const{view:i,sketchViewModel:o}=this;if(!i)return;const r=void 0,s=e??o?.createGraphic;if(s)"mesh"===s.geometry?.type?ye(i,s.geometry,r):ye(i,s,r);else{const e=o?.updateGraphics?.toArray();"3d"===i.type&&e?.some(e=>"mesh"===e.geometry?.type)?ye(i,e.map(e=>e.geometry).filter(t),r):e&&ye(i,e,r)}}async toggleUpdateWorkflow(){this.canUpdate&&(this.hasPendingEdits&&!await this.showDiscardEditsPrompt()||(this.activeWorkflow&&"awaiting-feature-to-update"===this.state?await this.cancelWorkflow({force:!0}):await this.startUpdateWorkflowAtFeatureSelection()))}async onSelectionListItemSelect(e){ge(e)&&await this.startUpdateWorkflowAtFeatureEdit(e.graphic)}async onSelectionListMenuItemSelect(e,t){ge(e)?await this.startUpdateWorkflowAtFeatureEdit(e.graphic):ke(e)&&await this._startUpdateWorkflowWithLayerItem(e,t)}restrictFeatureTemplatesViewModelToLayer(e){return this._featureTemplatesViewModelIsRestricted=!0,this._setFeatureTemplatesViewModelLayers([e]),l(()=>{this._featureTemplatesViewModelIsRestricted=!1,this._setFeatureTemplatesViewModelLayers(this.featureTemplatesLayers)})}async _getEditorItemCandidates(e){const{view:t}=this;if(!t?.map)return[];const{map:i}=t,o=i.editableLayers.toArray(),r=i.allTables.toArray().filter(e=>L(e)||E(e));return await Promise.allSettled([...o.flatMap(e=>this._getLayerLoadPromise(e)),...r.flatMap(e=>this._getLayerLoadPromise(e))]),u(e),[...o.reverse(),...r.reverse()].filter(e=>I(e)&&("mesh"!==e.geometryType||"3d"===t.type)).flatMap(e=>"subtype-group"===e.type?e.sublayers.toArray():e)}_getLayerLoadPromise(e){return E(e)?e.loadAll():e.load()}_drainEditorItems(){this.editorItemsLayerMap.clear(),this.editorItems.drain(e=>e.destroy())}_updateEditorItems(){p(this._updateItemsTask);const{view:e}=this,t=i(async t=>{if(!e?.map||!e?.allLayerViews)return;const i=await this._getEditorItemCandidates(t);if(!i.length)return void this._drainEditorItems();const o=[],r=[],s=[],{editorItemsLayerMap:a,layerInfos:n}=this;for(const c of i){const t=We(n,c),i=await re(e,c).catch(()=>null),l=t?o:i?r:s,d=new se({layer:c,layerInfo:t,layerView:i});l.push(d),a.set(c,d)}n?.length&&o.sort((e,t)=>n.findIndex(({layer:t})=>t===e.layer)-n.findIndex(({layer:e})=>e===t.layer));const l=[...o,...r,...s];t.aborted||(this._drainEditorItems(),this.editorItems.addMany(l))});this._updatingHandles.consumePromise(t.promise),this._updateItemsTask=t}_updateTemplates(){p(this._updateTemplatesTask);const e=i(async e=>{const t=this._templatesByLayer,i=this._featureTemplatesLayersAndTables.filter(e=>!t.has(e));if(i.length>0){const o=await F({layers:i.toArray(),view:this.view,signal:e,queryOptions:{returnVisibleTemplatesOnly:!0}});for(const{layer:e,templates:i}of o)t.set(e,i)}this._setFeatureTemplatesViewModelLayers(this.featureTemplatesLayers)});this._updatingHandles.consumePromise(e.promise),this._updateTemplatesTask=e}_setFeatureTemplatesViewModelLayers(e){const t=this._templatesByLayer,i=[];for(const o of e){const e=t.get(o);e&&e.length>0&&i.push(ue(o,e))}this.featureTemplatesViewModel.templateInfos=i}_afterEditorItemsChange(){const{activeWorkflow:e}=this;if(this.syncFeatureTemplates(),!e)return;const{stepId:t}=e;"create-features"!==e.type?"update"===e.type&&("awaiting-feature-to-update"===t&&!this.canUpdateVisible||"awaiting-update-feature-candidate"===t&&!e.hasUpdatableCandidates)&&this._cancelWorkflow():"awaiting-feature-creation-info"!==t||this.canCreate||this._cancelWorkflow()}async _cancelWorkflow(e){const t=this.activeWorkflow;if(!t)return void(e?.warnIfNoWorkflow&&this._logError("editing:no-active-workflow","There is no active workflow to cancel."));if(!e||!1!==e.force){this.emit("workflow-cancel"),this._set("activeWorkflow",null);try{await t.cancel(e)}finally{t.destroy()}}else try{await t.cancel(e),this._set("activeWorkflow",null),t.destroy()}catch(i){}}_createCreateFeaturesWorkflow(e,t){return D.create({viewModel:this,creationInfo:e,sketchOptions:this.sketchOptions,snappingManager:this._snappingManager,startAt:t,applyEdits:(e,t,i)=>this._applyEdits(e,t,i),applyEditsFeatureService:(e,t,i)=>this._applyEditsFeatureService(e,t,i),addAttachmentsCallback:(e,t)=>this._addAttachments(e,t)})}_createUpdateWorkflow(e,t){const i=B.create({viewModel:this,sketchOptions:this.sketchOptions,snappingManager:this._snappingManager,startAt:e,...t,applyEdits:(e,t,i)=>this._applyEdits(e,t,i),applyEditsFeatureService:(e,t,i)=>this._applyEditsFeatureService(e,t,i),addAttachmentsCallback:(e,t)=>this._addAttachments(e,t)});return i}_addAttachments(e,t){const i=t.map(t=>this._addAttachment(e,t.feature,t.attachment))??[];return Promise.all(i)}async _addAttachment(e,t,i){let o=null;if(!("addAttachment"in e)||null==e.capabilities?.attachment)throw new s("editor:attachments-not-supported","Adding attachments is not supported for this layer type");return await this._queueOperation(async()=>(o=await(e.addAttachment?.(t,i).catch(e=>{throw e?.error||e}))??null,o)),o}async _applyEdits(e,t,i){let o=null;const r=e.url?await A(e.url):null,s={returnServiceEditsOption:(!r||!C(r))&&!/\/hosted\//i.test(e.url)?"original-and-current-features":void 0,editsRespectTrueCurves:!0,...i};return await this._queueOperation(async()=>{const{view:i}=this;if(!i)return null;const r=await re(i,e).catch(()=>null);return o=await e.applyEdits(t,s),r&&await W(()=>!r.updating),o}),o}async _applyEditsFeatureService(e,t,i){let o=null;return await this._queueOperation(async()=>o=await e.applyEdits(t,i)),o}_destroyWorkflowOnCommit(e){return k(()=>e,"commit",()=>{e.destroy(),this.activeWorkflow===e&&this._set("activeWorkflow",null)})}_queueOperation(e){this._activityQueue.push(e);const t=(e,t)=>{const i=t.indexOf(e);i>-1&&t.splice(i,1)};return e().then(e=>(Array.isArray(e)?e.forEach(e=>this._handleEditsResultError(e)):this._handleEditsResultError(e),e)).catch(i=>{this._logError("editing:operation-error","An error occurred.",{error:i});const o={error:i,retry:()=>(t(o,this.failures),this._queueOperation(e)),cancel:()=>{t(o,this.failures)}};this._set("failures",[...this.failures,o])}).then(()=>{t(e,this._activityQueue)})}_handleEditsResultError(e){if(null!=e&&"error"in e&&null!=e.error)throw e.error;if(null!=e&&"addFeatureResults"in e){const{addFeatureResults:t,deleteFeatureResults:i,updateFeatureResults:o}=e,r=t.find(e=>!!e.error)||o.find(e=>!!e.error)||i.find(e=>!!e.error);if(r)throw r.error}}_createUpdatingResolver(){const e=w();return this._updatingHandles.consumePromise(e.promise),e}_logErrorAndCancelWorkflow(e){const{name:t,message:i,details:o}=e;this._logError(t??"editing:workflow-start-failed",i??void 0,o??e),this._cancelWorkflow({force:!0})}_itemIsSuspended(e){const t=Y(this.editorItems,e);return null!=t&&(!t.visible||t.disabled)}_logError(e,t,i){c.getLogger(this).error(new s(e,t,i))}_syncSelectionSources(){this._defaultSelectionManager.sources.items=this._selectionSources.toArray()}async _onSelectionComplete(e){if(e.aborted)return;const{operationType:t,selection:i}=e,{effectiveSelectionManager:o}=this;this._queuedSelectionTool=void 0;const r=[],s=[];i.forEach(e=>{const t=S(e),i=this.editorItemsLayerMap.get(t);i?.editable&&s.push(e),!1!==i?.visible&&r.push(e)});const a=1===s.length;if("ready"===this.state&&a&&"replace"===t)return this._queuedSelectionTool=e.toolName,this.startUpdateWorkflowAtFeatureEdit(s[0]);switch(t){case"remove":o.updateSelection({current:[],added:[],removed:r});break;case"replace":o.clear(),o.updateSelection({current:r,added:[],removed:[]});break;case"add":o.updateSelection({current:r,added:[],removed:[]})}}async _startUpdateWorkflowWithLayerItem(e,t){if(!e.objectIds?.length)return;const i=e.featureItems.filter(e=>e.visible).map(e=>e.graphic),o=this.selectionListViewModel.filterText;if(1===i.length)return await this.startUpdateWorkflowAtFeatureEdit(i[0]);let r;if(null!=o&&""!==o){const e=ee(i);if(e.length>1)throw new ne;if(r=e[0],!r)throw new le("merge"===t?2:1)}else r={layer:e.layer,objectIds:e.objectIds};"update"===t?await this.startUpdateFeaturesWorkflow(r):"merge"===t&&await this.startMergeFeaturesWorkflow(r)}};e([M()],Me.prototype,"_defaultSelectionManager",void 0),e([M()],Me.prototype,"_featureTemplatesLayersAndTables",null),e([M()],Me.prototype,"_queuedSelectionTool",void 0),e([M()],Me.prototype,"_snappingManager",void 0),e([M()],Me.prototype,"_selectionSources",null),e([M()],Me.prototype,"activeFeatureCount",null),e([M({readOnly:!0})],Me.prototype,"activeWorkflow",void 0),e([M()],Me.prototype,"activeLeafWorkflow",null),e([M({readOnly:!0})],Me.prototype,"_activityQueue",void 0),e([M({readOnly:!0})],Me.prototype,"canCreate",null),e([M()],Me.prototype,"canCreateVisible",null),e([M({readOnly:!0})],Me.prototype,"canUpdate",null),e([M()],Me.prototype,"canUpdateVisible",null),e([M()],Me.prototype,"featureTemplatesLayers",null),e([M()],Me.prototype,"editorItems",void 0),e([M()],Me.prototype,"editorItemsLayerMap",void 0),e([M()],Me.prototype,"effectiveSelectionManager",null),e([M({readOnly:!0})],Me.prototype,"failures",void 0),e([M()],Me.prototype,"hideTemplatesForInactiveLayers",void 0),e([M({type:G})],Me.prototype,"attachmentsViewModel",void 0),e([M()],Me.prototype,"featureFormViewModel",null),e([M()],Me.prototype,"formViewModel",null),e([M()],Me.prototype,"utilityNetworkAssociationAddAssociationViewModel",null),e([M({type:we})],Me.prototype,"featureTemplatesViewModel",void 0),e([M({type:O})],Me.prototype,"labelOptions",null),e([M()],Me.prototype,"layerInfos",void 0),e([M({constructOnly:!0})],Me.prototype,"useLegacyCreateTools",void 0),e([M()],Me.prototype,"isUsingLegacyCreateTools",null),e([M()],Me.prototype,"ownSketchViewModel",void 0),e([M()],Me.prototype,"selectionListViewModel",void 0),e([M()],Me.prototype,"selectionManager",void 0),e([M()],Me.prototype,"selectionToolbarViewModel",void 0),e([M()],Me.prototype,"sketchOptions",void 0),e([M()],Me.prototype,"sketchViewModel",null),e([M({type:q,nonNullable:!0})],Me.prototype,"snappingOptions",void 0),e([M()],Me.prototype,"spinnerViewModel",void 0),e([M()],Me.prototype,"state",null),e([M({readOnly:!0})],Me.prototype,"syncing",null),e([M()],Me.prototype,"syncViewSelection",void 0),e([M()],Me.prototype,"updating",null),e([M({type:R})],Me.prototype,"tooltipOptions",null),e([M({type:P})],Me.prototype,"valueOptions",null),e([M()],Me.prototype,"view",null),e([M()],Me.prototype,"canZoomTo",null),e([M()],Me.prototype,"pageStack",void 0),e([M()],Me.prototype,"showDiscardEditsPrompt",void 0),e([M()],Me.prototype,"_candidateCommitted",void 0),e([M()],Me.prototype,"page",null),e([M()],Me.prototype,"featureFormDisabled",null),e([M()],Me.prototype,"featureFormHasAssociation",null),e([M()],Me.prototype,"canGoBack",null),e([M()],Me.prototype,"shouldShowDeleteButton",null),e([M()],Me.prototype,"hasPendingEdits",null),e([M()],Me.prototype,"snappingManager",null),Me=e([T("esri.widgets.Editor.EditorViewModel")],Me);const Te=Me;export{Te as default};
+import{__decorate as e}from"tslib";import{isSome as t}from"../../core/arrayUtils.js";import{createTask as i}from"../../core/asyncUtils.js";import o from"../../core/Collection.js";import{deprecatedFunction as r}from"../../core/deprecate.js";import s from"../../core/Error.js";import{EventedAccessor as a}from"../../core/Evented.js";import{abortHandle as n,makeHandle as l}from"../../core/handleUtils.js";import"../../core/has.js";import c from"../../core/Logger.js";import{destroyMaybe as d,abortMaybe as p,removeMaybe as h}from"../../core/maybe.js";import{throwIfAborted as u,createResolver as w}from"../../core/promiseUtils.js";import f from"../../core/ReactiveMap.js";import{watch as m,syncAndInitial as y,initial as g,on as k,when as v,sync as _,whenOnce as W}from"../../core/reactiveUtils.js";import{property as M,subclass as T}from"../../core/accessorSupport/decorators.js";import{UpdatingHandles as b}from"../../core/support/UpdatingHandles.js";import{getTemplatesForLayers as F}from"../../editing/templateUtils.js";import{getGraphicLayer as S}from"../../graphic/graphicOriginUtils.js";import V from"../../layers/GraphicsLayer.js";import{isEditableLayer as I}from"../../layers/support/editableLayers.js";import{isFeatureLayer as L,isSubtypeGroupLayer as E,getOwningPortalUrl as A}from"../../layers/support/layerUtils.js";import{parseKnownArcGISOnlineDomain as C}from"../../portal/support/urlUtils.js";import U from"../../views/SelectionManager.js";import O from"../../views/interactive/sketch/SketchLabelOptions.js";import j from"../../views/interactive/sketch/SketchOptions.js";import R from"../../views/interactive/sketch/SketchTooltipOptions.js";import P from"../../views/interactive/sketch/SketchValueOptions.js";import{SnappingManager as H}from"../../views/interactive/snapping/SnappingManager.js";import q from"../../views/interactive/snapping/SnappingOptions.js";import{isISelectableLayer as x}from"../../views/support/selectionUtils.js";import G from"../Attachments/AttachmentsViewModel.js";import D from"./CreateFeaturesWorkflow.js";import B from"./UpdateWorkflow.js";import{getLayersFromWorkflow as N,isCreateFeaturesWorkflow as Q,isUpdateRecordWorkflow as z,isUpdateFeaturesWorkflow as Z,isMergeFeaturesWorkflow as $,isSplitFeatureWorkflow as J,isUpdateWorkflow as K,isFeatureFormViewModel as X,findEditorItemForLayerOrThrow as Y,toFeatureInfos as ee,fetchFullFeaturesByObjectId as te,fetchFullFeatures as ie,findEditorItemForLayer as oe,whenEditorLayerView as re}from"./workflowUtils.js";import se from"./support/EditorItem.js";import{assertViewNot3D as ae,MultipleSourceLayersError as ne,InsufficientFeatureCountError as le,MissingOriginLayerError as ce,assertMergeWorkflowCapabilities as de,FetchFullFeatureError as pe,assertSplitWorkflowCapabilities as he}from"./support/errors.js";import{makeTemplateGroupInfoForLayer as ue}from"../FeatureTemplates/featureTemplatesUtils.js";import we from"../FeatureTemplates/FeatureTemplatesViewModel.js";import fe from"../Sketch/SketchViewModel.js";import me from"../Spinner/SpinnerViewModel.js";import{goTo as ye}from"../support/goToUtils.js";import{isFeatureItem as ge,isLayerItem as ke}from"../support/SelectionList/selectionListUtils.js";import ve from"../support/SelectionList/SelectionListViewModel.js";import _e from"../support/SelectionToolbar/SelectionToolbarViewModel.js";function We(e,t){return e?.find(e=>e.layer===t)}let Me=class extends a{constructor(e){super(e),this._defaultSelectionManager=new U,this._queuedSelectionTool=null,this._sketchEventListenerHandle=null,this._sketchGraphicsLayer=new V({listMode:"hide",internal:!0,title:"Editor sketch layer"}),this._snappingManager=null,this._templatesByLayer=new Map,this._updateItemsTask=null,this._updateTemplatesTask=null,this._updatingHandles=new b,this._featureTemplatesViewModelIsRestricted=!1,this.activeWorkflow=null,this._activityQueue=new o,this.editorItems=new o,this.editorItemsLayerMap=new f,this.failures=[],this.hideTemplatesForInactiveLayers=!1,this.attachmentsViewModel=new G({capabilities:{editing:!0}}),this.featureTemplatesViewModel=new we({disabledItemFunction:({layer:e})=>this._itemIsSuspended(e)}),this.layerInfos=null,this.useLegacyCreateTools=!0,this.ownSketchViewModel=new fe({layer:this._sketchGraphicsLayer,useLegacyCreateTools:this.useLegacyCreateTools}),this.selectionListViewModel=new ve,this.selectionManager=null,this.selectionToolbarViewModel=new _e({continuousSelectionEnabled:!0,defaultOperationType:"replace",persistSelection:!1,returnGeometry:!1}),this.sketchOptions=new j,this.snappingOptions=new q({attributeRulesEnabled:!0}),this.spinnerViewModel=new me,this.syncViewSelection=!1,this.pageStack=[],this.showDiscardEditsPrompt=()=>Promise.resolve(!0),this._candidateCommitted=!1,this.back=async()=>{if("viewing-selection-list"===this.state)return this.selectionListViewModel.filterText=void 0,void this.effectiveSelectionManager.clear();this.canGoBack&&(this.activeWorkflow?.hasPreviousStep?await this.activeWorkflow.back(this.showDiscardEditsPrompt):await this._cancelWorkflow({force:!this.hasPendingEdits}))},this.saveWorkflow=async()=>await(this.activeWorkflow?.save()),this.selectFeature=(e,t=!1)=>{const i=this.activeWorkflow;if(this._candidateCommitted||"update"!==i?.type)return;const{rootFeatures:o}=i.data;o.removeAll(),e&&o.add(e),t&&(i.next(),this._candidateCommitted=!0)}}initialize(){this.addHandles([m(()=>{const e=this.view,t=e?.map?.editableLayers.toArray(),i=e?.allLayerViews,o=i?.filter(e=>!!t?.includes(e.layer));return[t,o,this.layerInfos]},()=>this._updateEditorItems(),y),m(()=>this.hideTemplatesForInactiveLayers,()=>this.syncFeatureTemplates()),m(()=>this._selectionSources,()=>this._syncSelectionSources(),g),k(()=>this.activeWorkflow,"cancel",()=>this.emit("workflow-cancel")),k(()=>this.activeWorkflow,"commit",()=>this.emit("workflow-commit")),k(()=>this.activeWorkflow,"complete",()=>{this.emit("workflow-commit"),this._set("activeWorkflow",null)}),v(()=>!this.activeWorkflow&&this._queuedSelectionTool,()=>this._queuedSelectionTool&&this.selectionToolbarViewModel.activateTool(this._queuedSelectionTool)),m(()=>this.activeWorkflow,e=>this._defaultSelectionManager.highlightEnabled=!e),v(()=>this.view?.map,e=>e.add(this._sketchGraphicsLayer),g),k(()=>this.editorItems,"change",()=>this._afterEditorItemsChange()),m(()=>[this.canCreate,this.canUpdateVisible],()=>this._afterEditorItemsChange()),m(()=>this.page,(e,t)=>{const i=[...this.pageStack];if(-1===i.indexOf(e))i.push(e);else for(;i.length&&i.at(-1)!==e;)i.pop();this.pageStack=i},y),v(()=>"awaiting-update-feature-candidate"===this.state,()=>this._candidateCommitted=!1),k(()=>this.featureTemplatesViewModel,"select",async({item:e,oldItem:t})=>{const{activeWorkflow:i}=this;if(i){if("update"===i.type&&"awaiting-feature-creation-info"===i.activeWorkflow?.stepId)return;try{await this.cancelWorkflow({force:!this.hasPendingEdits})}catch{return void this.featureTemplatesViewModel.select(t,{emit:!1})}}if(!e)return;const o={layer:e.layer,template:e.template};if(e.supportsUpload)return this.featureTemplatesViewModel.select(t,{emit:!1}),this.startCreateFeaturesWorkflow(o);await this.startCreateFeaturesWorkflowAtFeatureCreation(o)}),m(()=>[this.view,this.featureTemplatesViewModel],([e,t])=>{t.view=e},y),k(()=>this.view,"key-down",e=>{"Escape"===e.key&&this.activeWorkflow?.keyboardCancellationEnabled&&(e.stopPropagation(),this.back())}),k(()=>this.sketchViewModel,["create","delete","update"],e=>{const{activeWorkflow:t}=this,i=N(t),o=`sketch-${e.type}`;this.emit(o,{type:o,detail:e,layer:i[0],layers:i})},_),m(()=>this.view,e=>{if(this._snappingManager=d(this._snappingManager),!e)return;const t=this.snappingOptions;this._snappingManager=new H({view:e,options:t}),this.ownSketchViewModel.snappingManager=this._snappingManager},y),m(()=>this.snappingOptions,e=>{this._snappingManager&&(this._snappingManager.options=e)},y),k(()=>this.selectionToolbarViewModel,"complete",e=>this._onSelectionComplete(e)),m(()=>({view:this.view,selectionManager:this.effectiveSelectionManager,selectionListViewModel:this.selectionListViewModel,selectionToolbarViewModel:this.selectionToolbarViewModel}),({view:e,selectionManager:t,selectionListViewModel:i,selectionToolbarViewModel:o})=>{t.view=e,i.view=e,o.view=e},y),m(()=>this.effectiveSelectionManager,e=>{this.selectionListViewModel.selectionManager=e,this.selectionToolbarViewModel.selectionManager=e},y)])}destroy(){this._cancelWorkflow({warnIfNoWorkflow:!1}).then(()=>{this.view?.map?.remove(this._sketchGraphicsLayer),this.view=null}),this._updateItemsTask=p(this._updateItemsTask),this._updatingHandles.destroy(),this._sketchEventListenerHandle=h(this._sketchEventListenerHandle),this.selectionListViewModel?.destroy(),this.selectionToolbarViewModel?.destroy(),this._defaultSelectionManager.destroy()}get _featureTemplatesLayersAndTables(){const e=new o;for(const t of this.editorItems){const i=this.hideTemplatesForInactiveLayers&&!t.visible;t.supportsCreateFeaturesWorkflow&&!i&&e.push(t.layer)}return e}get _selectionSources(){const e=new o;if(this.syncViewSelection||this.selectionManager)return e;for(const t of this.editorItems)x(t.layer)&&t.supportsUpdateWorkflow&&e.push(t.layer);return e}get activeFeatureCount(){const e=this.activeLeafWorkflow;return Q(e)?e.pendingFeatures.length:z(e)&&e.data.edits.feature?1:Z(e)?e.data.fullFeatures.length:$(e)?e.data.features.length:J(e)?2:0}get activeLeafWorkflow(){const e=this.activeWorkflow;return e&&K(e)?e.activeWorkflow??e:e}get canCreate(){return this.editorItems.some(e=>e.supportsCreateFeaturesWorkflow)}get canCreateVisible(){return!!this.featureTemplatesLayers.length}get canUpdate(){return this.editorItems.some(e=>e.supportsUpdateWorkflow)}get canUpdateVisible(){return this.editorItems.some(e=>e.supportsUpdateWorkflow&&e.visible)}get featureTemplatesLayers(){return this._featureTemplatesLayersAndTables.filter(e=>"scene"===e.type||!e.isTable)}get effectiveSelectionManager(){const e=this.view;return e&&this.syncViewSelection?e.selectionManager:this.selectionManager??this._defaultSelectionManager}get featureFormViewModel(){const e=this.activeWorkflow?.formViewModel;return X(e)?e:null}get formViewModel(){return this.activeWorkflow?.formViewModel}get utilityNetworkAssociationAddAssociationViewModel(){const{activeWorkflow:e}=this;return"update"===e?.type?e.activeUtilityNetworkAssociationAddAssociationViewModel:null}get labelOptions(){return this.sketchOptions.labels}set labelOptions(e){this.sketchOptions.labels=e}get isUsingLegacyCreateTools(){return this.useLegacyCreateTools||"2d"!==this.view?.type}get sketchViewModel(){const{activeWorkflow:e}=this;return"update"===e?.type?e.activeSketchViewModel:"create-features"===e?.type?e.sketchViewModel:this.ownSketchViewModel}get state(){if(!this.view?.ready)return"disabled";const e=this.attachmentsViewModel.mode;if("add"===e)return"adding-attachment";if("edit"===e)return"editing-attachment";const{activeWorkflow:t}=this,i=!t?.stepId;return this.effectiveSelectionManager.count&&i?"viewing-selection-list":i?"ready":"update"===t.type&&t.activeWorkflow?.stepId?t.activeWorkflow.stepId:t.stepId}get syncing(){return this._activityQueue.length>0}get updating(){return this._updatingHandles.updating||!0===this.activeWorkflow?.updating}get tooltipOptions(){return this.sketchOptions.tooltips}set tooltipOptions(e){this.sketchOptions.tooltips=e}get valueOptions(){return this.sketchOptions.values}set valueOptions(e){this.sketchOptions.values=e}set view(e){this.ownSketchViewModel.view=e,this.spinnerViewModel.view=e,this._set("view",e)}get canZoomTo(){const e=this.sketchViewModel,t=e?.createGraphic?.geometry?.type;return!(!e?.updateGraphics?.length&&"multipoint"!==t)}get page(){const{activeWorkflow:e,state:t}=this;if("update"===e?.type&&X(e.formViewModel)){const{associatedLayer:t,associationId:i}=e.formViewModel;if(t||null!=i)return"viewing-associated-features"}if("update"===e?.type&&"awaiting-feature-to-update"===e.stepId)return"ready";if("create-features"===e?.type&&0===e.numPendingFeatures){const t=e.data.upload;if(t)return"default"===t.state?"ready":"creating-features-upload-details"}return t??"disabled"}get featureFormDisabled(){const{activeLeafWorkflow:e}=this;if(z(e))return!1===e.data.editorItem?.capabilities.update.attributes||!0===e.formViewModel.disabled;if(Z(e)){const{formViewModel:t}=e;return t.disabled||t.readOnly}return!1}get featureFormHasAssociation(){return!!this.featureFormViewModel?.activeAssociation}get canGoBack(){return null!=this.activeWorkflow&&!this.syncing}get shouldShowDeleteButton(){const{activeLeafWorkflow:e}=this;if(z(e)){const{data:t}=e;return t.editorItem?.capabilities.delete.enabled&&!t.readOnly}return!!Z(e)&&e.data.editorItems.every(e=>e.capabilities.delete.enabled)}get hasPendingEdits(){return this.activeWorkflow?.hasPendingEdits??!1}get snappingManager(){return this._snappingManager}activateSelectionTool(e){return this.selectionToolbarViewModel.activateTool(e)}cancelSelectionTool(){this.selectionToolbarViewModel.cancel()}getTemplatesForLayer(e){return this._templatesByLayer.get(e)??[]}async startCreateFeaturesWorkflowAtFeatureTypeSelection(){return this.startCreateFeaturesWorkflow()}async startCreateFeaturesWorkflowAtFeatureCreation(e){return this.startCreateFeaturesWorkflow(e,"creating-features")}async startCreateFeaturesWorkflow(e,t="awaiting-feature-creation-info"){if(await W(()=>!this.updating),!this.canCreate)throw new s("editing:unsupported-workflow","Creating features is unsupported or disabled.");const i=this._createUpdatingResolver();try{await this._cancelWorkflow();const i=this._createCreateFeaturesWorkflow(e,t);this._set("activeWorkflow",i),await i.start()}catch(o){this._logErrorAndCancelWorkflow(o)}finally{i.resolve()}}async startCreateFeaturesWorkflowAtFeatureEdit(e){await W(()=>!this.updating);const t=this._createUpdatingResolver();try{const{initialFeature:t}=e,i=t.sourceLayer=t.layer,o=i?Y(this.editorItems,i):void 0;if(!o?.supportsCreateFeaturesWorkflow)throw new s("editing:unsupported-workflow","Creating features is unsupported or disabled for this layer.");await this._cancelWorkflow();const r=this._createCreateFeaturesWorkflow({initialFeature:t,layer:o.layer,maxFeatures:1},"creating-features");this._set("activeWorkflow",r),await r.start()}catch(i){this._logErrorAndCancelWorkflow(i)}finally{t.resolve()}}async startMergeFeaturesWorkflow(e,t={}){await W(()=>!this.updating),ae(this,"merge-features");const i=Array.isArray(e)?ee(e):[e];if(i.length>1)throw new ne;if(0===i.length||i[0].objectIds.length<2)throw new le(2);const r=i[0],s=r.layer;if(!s)throw new ce;const a=Y(this.editorItems,s);de(a);const l=this._createUpdatingResolver(),c=new AbortController;this.addHandles(n(c));try{await this._cancelWorkflow(),this.cancelSelectionTool();const e=await te(r.objectIds,s,this.view?.spatialReference,c.signal);if(e.length!==r.objectIds.length)throw new pe;let i;if(t.keyFeature){const o=t.keyFeature.getObjectId();i=e.find(e=>e.getObjectId()===o)??t.keyFeature}const a=this._createUpdateWorkflow("editing-existing-feature",{rootFeatures:new o(e),rootWorkflowOptions:{type:"merge",props:{...t,keyFeature:i}}});this._set("activeWorkflow",a),this.addHandles(this._destroyWorkflowOnCommit(a)),await a.start()}catch(d){this._logErrorAndCancelWorkflow(d)}finally{l.resolve()}}async startSplitFeatureWorkflow(e,t={}){await W(()=>!this.updating),ae(this,"split-feature");const i=S(e);if(!i)throw new ce;const r=Y(this.editorItems,i);he(r);const s=this._createUpdatingResolver(),a=new AbortController;this.addHandles(n(a));try{await this._cancelWorkflow(),this.cancelSelectionTool();const r=await ie([e],i,this.view?.spatialReference,a.signal);if(1!==r.length)throw new pe;const s=this._createUpdateWorkflow("editing-existing-feature",{rootFeatures:new o(r),rootWorkflowOptions:{type:"split",props:t}});this._set("activeWorkflow",s),this.addHandles(this._destroyWorkflowOnCommit(s)),await s.start()}catch(l){this._logErrorAndCancelWorkflow(l)}finally{s.resolve()}}async startUpdateFeaturesWorkflow(e){if(await W(()=>!this.updating),!this.canUpdate)return void this._logError("editing:unsupported-workflow","Update features workflow is unsupported or disabled.");const t=Array.isArray(e)?ee(e):[e];if(t.length>1)throw new ne;const i=this._createUpdatingResolver();try{await this._cancelWorkflow(),this.cancelSelectionTool();const e=this._createUpdateWorkflow("editing-existing-feature",{rootFeatureInfos:t,rootWorkflowOptions:{type:"update-multiple"}});e.addHandles(this._destroyWorkflowOnCommit(e)),this._set("activeWorkflow",e),await e.start()}catch(o){this._logErrorAndCancelWorkflow(o)}finally{i.resolve()}}async startUpdateWorkflowAtFeatureSelection(){if(await W(()=>!this.updating),!this.canUpdate)return void this._logError("editing:unsupported-workflow","Update workflow is unsupported or disabled.");const e=this._createUpdatingResolver();try{await this._cancelWorkflow();const e=this._createUpdateWorkflow();this._set("activeWorkflow",e),await e.start()}catch(t){this._logErrorAndCancelWorkflow(t)}finally{e.resolve()}}async startUpdateWorkflowAtMultipleFeatureSelection(e){if(await W(()=>!this.updating),!this.canUpdate)return void this._logError("editing:unsupported-workflow","Update workflow is unsupported or disabled.");const t=this._createUpdatingResolver();try{await this._cancelWorkflow();const t=this._createUpdateWorkflow("awaiting-update-feature-candidate");t.data.candidates=e,this._set("activeWorkflow",t),await t.start()}catch(i){this._logErrorAndCancelWorkflow(i)}finally{t.resolve()}}async startUpdateWorkflowAtFeatureEdit(e){if(await W(()=>!this.updating),!this.canUpdate)return void this._logError("editing:unsupported-workflow","Update workflow is unsupported or disabled.");const t=this._createUpdatingResolver();try{await this._cancelWorkflow(),this.cancelSelectionTool();const t=this._createUpdateWorkflow("editing-existing-feature",{rootFeatures:new o([e])});t.addHandles(this._destroyWorkflowOnCommit(t)),this._set("activeWorkflow",t),await t.start()}catch(i){this._logErrorAndCancelWorkflow(i)}finally{t.resolve()}}async startUpdateWorkflowWithActiveSelection(){const{selectionListViewModel:e}=this;if(!e.visibleFeatureCount||!e.visibleLayerCount)throw new s("editing:missing-selection","Unable to determine visible selection.");if(e.visibleLayerCount>1)throw new s("editing:features-different-layers","Cannot start workflow with features from different layers.");const t=e.layerItems.find(e=>e.visible);t&&await this._startUpdateWorkflowWithLayerItem(t,"update")}async deleteFeatureFromWorkflow(){r(c.getLogger(this),"EditorViewModel.deleteFeatureFromWorkflow is deprecated. Use EditorViewModel.deleteFeatures instead.",{version:"4.33",replacement:"EditorViewModel.deleteFeatures",warnOnce:!0}),await this.deleteFeatures()}async deleteFeatures(){const e=this.activeWorkflow;if(K(e))return e.deleteActiveFeatures();this._logError("editing:unsupported-workflow","Deleting features requires an active update workflow.")}async deleteAssociationFromWorkflow(){const{activeWorkflow:e}=this;e&&"update"===e.type?await e.deleteActiveAssociation():this._logError("editing:unsupported-workflow","Deleting an association requires an active update workflow.")}async cancelWorkflow(e){return this._cancelWorkflow({warnIfNoWorkflow:!0,...e})}itemHasInvalidFormTemplate(e){return null!=e&&!0===oe(this.editorItems,e.layer)?.hasInvalidFormTemplate}syncFeatureTemplates(){this._featureTemplatesViewModelIsRestricted||this._updateTemplates()}zoomTo(e){const{view:i,sketchViewModel:o}=this;if(!i)return;const r=void 0,s=e??o?.createGraphic;if(s)"mesh"===s.geometry?.type?ye(i,s.geometry,r):ye(i,s,r);else{const e=o?.updateGraphics?.toArray();"3d"===i.type&&e?.some(e=>"mesh"===e.geometry?.type)?ye(i,e.map(e=>e.geometry).filter(t),r):e&&ye(i,e,r)}}async toggleUpdateWorkflow(){this.canUpdate&&(this.hasPendingEdits&&!await this.showDiscardEditsPrompt()||(this.activeWorkflow&&"awaiting-feature-to-update"===this.state?await this.cancelWorkflow({force:!0}):await this.startUpdateWorkflowAtFeatureSelection()))}async onSelectionListItemSelect(e){ge(e)&&await this.startUpdateWorkflowAtFeatureEdit(e.graphic)}async onSelectionListMenuItemSelect(e,t){ge(e)?await this.startUpdateWorkflowAtFeatureEdit(e.graphic):ke(e)&&await this._startUpdateWorkflowWithLayerItem(e,t)}restrictFeatureTemplatesViewModelToLayer(e){return this._featureTemplatesViewModelIsRestricted=!0,this._setFeatureTemplatesViewModelLayers([e]),l(()=>{this._featureTemplatesViewModelIsRestricted=!1,this._setFeatureTemplatesViewModelLayers(this.featureTemplatesLayers)})}async _getEditorItemCandidates(e){const{view:t}=this;if(!t?.map)return[];const{map:i}=t,o=i.editableLayers.toArray(),r=i.allTables.toArray().filter(e=>L(e)||E(e));return await Promise.allSettled([...o.flatMap(e=>this._getLayerLoadPromise(e)),...r.flatMap(e=>this._getLayerLoadPromise(e))]),u(e),[...o.reverse(),...r.reverse()].filter(e=>I(e)&&("mesh"!==e.geometryType||"3d"===t.type)).flatMap(e=>"subtype-group"===e.type?e.sublayers.toArray():e)}_getLayerLoadPromise(e){return E(e)?e.loadAll():e.load()}_drainEditorItems(){this.editorItems.drain(e=>e.destroy())}_updateEditorItems(){p(this._updateItemsTask);const{view:e}=this,t=i(async t=>{if(!e?.map||!e?.allLayerViews)return;const i=await this._getEditorItemCandidates(t);if(!i.length)return this._drainEditorItems(),void this.editorItemsLayerMap.clear();const o=[],r=[],s=[],{editorItemsLayerMap:a,layerInfos:n}=this;for(const c of i){const t=We(n,c),i=await re(e,c).catch(()=>null),l=t?o:i?r:s,d=new se({layer:c,layerInfo:t,layerView:i});l.push(d),a.set(c,d)}n?.length&&o.sort((e,t)=>n.findIndex(({layer:t})=>t===e.layer)-n.findIndex(({layer:e})=>e===t.layer));const l=[...o,...r,...s];t.aborted||(this._drainEditorItems(),this.editorItems.addMany(l))});this._updatingHandles.consumePromise(t.promise),this._updateItemsTask=t}_updateTemplates(){p(this._updateTemplatesTask);const e=i(async e=>{const t=this._templatesByLayer,i=this._featureTemplatesLayersAndTables.filter(e=>!t.has(e));if(i.length>0){const o=await F({layers:i.toArray(),view:this.view,signal:e,queryOptions:{returnVisibleTemplatesOnly:!0}});for(const{layer:e,templates:i}of o)t.set(e,i)}this._setFeatureTemplatesViewModelLayers(this.featureTemplatesLayers)});this._updatingHandles.consumePromise(e.promise),this._updateTemplatesTask=e}_setFeatureTemplatesViewModelLayers(e){const t=this._templatesByLayer,i=[];for(const o of e){const e=t.get(o);e&&e.length>0&&i.push(ue(o,e))}this.featureTemplatesViewModel.templateInfos=i}_afterEditorItemsChange(){const{activeWorkflow:e}=this;if(this.syncFeatureTemplates(),!e)return;const{stepId:t}=e;"create-features"!==e.type?"update"===e.type&&("awaiting-feature-to-update"===t&&!this.canUpdateVisible||"awaiting-update-feature-candidate"===t&&!e.hasUpdatableCandidates)&&this._cancelWorkflow():"awaiting-feature-creation-info"!==t||this.canCreate||this._cancelWorkflow()}async _cancelWorkflow(e){const t=this.activeWorkflow;if(!t)return void(e?.warnIfNoWorkflow&&this._logError("editing:no-active-workflow","There is no active workflow to cancel."));if(!e||!1!==e.force){this.emit("workflow-cancel"),this._set("activeWorkflow",null);try{await t.cancel(e)}finally{t.destroy()}}else try{await t.cancel(e),this._set("activeWorkflow",null),t.destroy()}catch(i){}}_createCreateFeaturesWorkflow(e,t){return D.create({viewModel:this,creationInfo:e,sketchOptions:this.sketchOptions,snappingManager:this._snappingManager,startAt:t,applyEdits:(e,t,i)=>this._applyEdits(e,t,i),applyEditsFeatureService:(e,t,i)=>this._applyEditsFeatureService(e,t,i),addAttachmentsCallback:(e,t)=>this._addAttachments(e,t)})}_createUpdateWorkflow(e,t){const i=B.create({viewModel:this,sketchOptions:this.sketchOptions,snappingManager:this._snappingManager,startAt:e,...t,applyEdits:(e,t,i)=>this._applyEdits(e,t,i),applyEditsFeatureService:(e,t,i)=>this._applyEditsFeatureService(e,t,i),addAttachmentsCallback:(e,t)=>this._addAttachments(e,t)});return i}_addAttachments(e,t){const i=t.map(t=>this._addAttachment(e,t.feature,t.attachment))??[];return Promise.all(i)}async _addAttachment(e,t,i){let o=null;if(!("addAttachment"in e)||null==e.capabilities?.attachment)throw new s("editor:attachments-not-supported","Adding attachments is not supported for this layer type");return await this._queueOperation(async()=>(o=await(e.addAttachment?.(t,i).catch(e=>{throw e?.error||e}))??null,o)),o}async _applyEdits(e,t,i){let o=null;const r=e.url?await A(e.url):null,s={returnServiceEditsOption:(!r||!C(r))&&!/\/hosted\//i.test(e.url)?"original-and-current-features":void 0,editsRespectTrueCurves:!0,...i};return await this._queueOperation(async()=>{const{view:i}=this;if(!i)return null;const r=await re(i,e).catch(()=>null);return o=await e.applyEdits(t,s),r&&await W(()=>!r.updating),o}),o}async _applyEditsFeatureService(e,t,i){let o=null;return await this._queueOperation(async()=>o=await e.applyEdits(t,i)),o}_destroyWorkflowOnCommit(e){return k(()=>e,"commit",()=>{e.destroy(),this.activeWorkflow===e&&this._set("activeWorkflow",null)})}_queueOperation(e){this._activityQueue.push(e);const t=(e,t)=>{const i=t.indexOf(e);i>-1&&t.splice(i,1)};return e().then(e=>(Array.isArray(e)?e.forEach(e=>this._handleEditsResultError(e)):this._handleEditsResultError(e),e)).catch(i=>{this._logError("editing:operation-error","An error occurred.",{error:i});const o={error:i,retry:()=>(t(o,this.failures),this._queueOperation(e)),cancel:()=>{t(o,this.failures)}};this._set("failures",[...this.failures,o])}).then(()=>{t(e,this._activityQueue)})}_handleEditsResultError(e){if(null!=e&&"error"in e&&null!=e.error)throw e.error;if(null!=e&&"addFeatureResults"in e){const{addFeatureResults:t,deleteFeatureResults:i,updateFeatureResults:o}=e,r=t.find(e=>!!e.error)||o.find(e=>!!e.error)||i.find(e=>!!e.error);if(r)throw r.error}}_createUpdatingResolver(){const e=w();return this._updatingHandles.consumePromise(e.promise),e}_logErrorAndCancelWorkflow(e){const{name:t,message:i,details:o}=e;this._logError(t??"editing:workflow-start-failed",i??void 0,o??e),this._cancelWorkflow({force:!0})}_itemIsSuspended(e){const t=Y(this.editorItems,e);return null!=t&&(!t.visible||t.disabled)}_logError(e,t,i){c.getLogger(this).error(new s(e,t,i))}_syncSelectionSources(){this._defaultSelectionManager.sources.items=this._selectionSources.toArray()}async _onSelectionComplete(e){if(e.aborted)return;const{operationType:t,selection:i}=e,{effectiveSelectionManager:o}=this;this._queuedSelectionTool=void 0;const r=[],s=[];i.forEach(e=>{const t=S(e),i=this.editorItemsLayerMap.get(t);i?.editable&&s.push(e),!1!==i?.visible&&r.push(e)});const a=1===s.length;if("ready"===this.state&&a&&"replace"===t)return this._queuedSelectionTool=e.toolName,this.startUpdateWorkflowAtFeatureEdit(s[0]);switch(t){case"remove":o.updateSelection({current:[],added:[],removed:r});break;case"replace":o.clear(),o.updateSelection({current:r,added:[],removed:[]});break;case"add":o.updateSelection({current:r,added:[],removed:[]})}}async _startUpdateWorkflowWithLayerItem(e,t){if(!e.objectIds?.length)return;const i=e.featureItems.filter(e=>e.visible).map(e=>e.graphic),o=this.selectionListViewModel.filterText;if(1===i.length)return await this.startUpdateWorkflowAtFeatureEdit(i[0]);let r;if(null!=o&&""!==o){const e=ee(i);if(e.length>1)throw new ne;if(r=e[0],!r)throw new le("merge"===t?2:1)}else r={layer:e.layer,objectIds:e.objectIds};"update"===t?await this.startUpdateFeaturesWorkflow(r):"merge"===t&&await this.startMergeFeaturesWorkflow(r)}};e([M()],Me.prototype,"_defaultSelectionManager",void 0),e([M()],Me.prototype,"_featureTemplatesLayersAndTables",null),e([M()],Me.prototype,"_queuedSelectionTool",void 0),e([M()],Me.prototype,"_snappingManager",void 0),e([M()],Me.prototype,"_selectionSources",null),e([M()],Me.prototype,"activeFeatureCount",null),e([M({readOnly:!0})],Me.prototype,"activeWorkflow",void 0),e([M()],Me.prototype,"activeLeafWorkflow",null),e([M({readOnly:!0})],Me.prototype,"_activityQueue",void 0),e([M({readOnly:!0})],Me.prototype,"canCreate",null),e([M()],Me.prototype,"canCreateVisible",null),e([M({readOnly:!0})],Me.prototype,"canUpdate",null),e([M()],Me.prototype,"canUpdateVisible",null),e([M()],Me.prototype,"featureTemplatesLayers",null),e([M()],Me.prototype,"editorItems",void 0),e([M()],Me.prototype,"editorItemsLayerMap",void 0),e([M()],Me.prototype,"effectiveSelectionManager",null),e([M({readOnly:!0})],Me.prototype,"failures",void 0),e([M()],Me.prototype,"hideTemplatesForInactiveLayers",void 0),e([M({type:G})],Me.prototype,"attachmentsViewModel",void 0),e([M()],Me.prototype,"featureFormViewModel",null),e([M()],Me.prototype,"formViewModel",null),e([M()],Me.prototype,"utilityNetworkAssociationAddAssociationViewModel",null),e([M({type:we})],Me.prototype,"featureTemplatesViewModel",void 0),e([M({type:O})],Me.prototype,"labelOptions",null),e([M()],Me.prototype,"layerInfos",void 0),e([M({constructOnly:!0})],Me.prototype,"useLegacyCreateTools",void 0),e([M()],Me.prototype,"isUsingLegacyCreateTools",null),e([M()],Me.prototype,"ownSketchViewModel",void 0),e([M()],Me.prototype,"selectionListViewModel",void 0),e([M()],Me.prototype,"selectionManager",void 0),e([M()],Me.prototype,"selectionToolbarViewModel",void 0),e([M()],Me.prototype,"sketchOptions",void 0),e([M()],Me.prototype,"sketchViewModel",null),e([M({type:q,nonNullable:!0})],Me.prototype,"snappingOptions",void 0),e([M()],Me.prototype,"spinnerViewModel",void 0),e([M()],Me.prototype,"state",null),e([M({readOnly:!0})],Me.prototype,"syncing",null),e([M()],Me.prototype,"syncViewSelection",void 0),e([M()],Me.prototype,"updating",null),e([M({type:R})],Me.prototype,"tooltipOptions",null),e([M({type:P})],Me.prototype,"valueOptions",null),e([M()],Me.prototype,"view",null),e([M()],Me.prototype,"canZoomTo",null),e([M()],Me.prototype,"pageStack",void 0),e([M()],Me.prototype,"showDiscardEditsPrompt",void 0),e([M()],Me.prototype,"_candidateCommitted",void 0),e([M()],Me.prototype,"page",null),e([M()],Me.prototype,"featureFormDisabled",null),e([M()],Me.prototype,"featureFormHasAssociation",null),e([M()],Me.prototype,"canGoBack",null),e([M()],Me.prototype,"shouldShowDeleteButton",null),e([M()],Me.prototype,"hasPendingEdits",null),e([M()],Me.prototype,"snappingManager",null),Me=e([T("esri.widgets.Editor.EditorViewModel")],Me);const Te=Me;export{Te as default};

package/widgets/Editor/components/Settings.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
-import{loadCalciteComponents as t}from"../../support/componentsUtils.js";import e from"../../support/SketchTooltipControls.js";import o from"../../support/SnappingControls.js";import{tsx as s}from"../../support/widget.js";import i from"../../support/SketchTooltipControls/VisibleElements.js";import n from"../../support/SnappingControls/VisibleElements.js";const p={settingsContainer:"esri-editor__settings"},r=()=>t({accordion:()=>import("@esri/calcite-components/dist/components/calcite-accordion"),"accordion-item":()=>import("@esri/calcite-components/dist/components/calcite-accordion-item")});function c({editorViewModel:t,messagesCommon:r,visibleElements:c}){const{snappingOptions:a,sketchOptions:l,view:m,snappingManager:g}=t,d=[],u={directionModePicker:c.directionModePicker,labelsToggle:c.labelsToggle,tooltipsToggle:c.tooltipsToggle};return Object.values(u).includes(!0)&&d.push(s(e,{sketchOptions:l,visibleElements:new i(u)})),c.snappingControls&&d.push(s(o,{afterCreate:t=>t.layerListOpen=!1,snappingManager:g,snappingOptions:a,view:m,visibleElements:c.snappingControlsElements??new n})),0===d.length?null:s("calcite-accordion",{appearance:"transparent",class:p.settingsContainer,key:"settings"},s("calcite-accordion-item",{"data-testid":"settings",heading:r.settings,iconStart:"gear"},d))}export{c as Settings,p as css,r as loadSettingsComponents};
+import{loadCalciteComponents as t}from"../../support/componentsUtils.js";import e from"../../support/SketchTooltipControls.js";import o from"../../support/SnappingControls.js";import{tsx as i}from"../../support/widget.js";import s from"../../support/SketchTooltipControls/VisibleElements.js";import n from"../../support/SnappingControls/VisibleElements.js";const p={settingsContainer:"esri-editor__settings"},r=()=>t({accordion:()=>import("@esri/calcite-components/dist/components/calcite-accordion"),"accordion-item":()=>import("@esri/calcite-components/dist/components/calcite-accordion-item")});function c({editorViewModel:t,messagesCommon:r,visibleElements:c}){const{snappingOptions:a,sketchOptions:l,view:m,snappingManager:g}=t,d=[],u={directionModePicker:c.directionModePicker,labelsToggle:c.labelsToggle,tooltipsToggle:c.tooltipsToggle};return Object.values(u).includes(!0)&&d.push(i(e,{sketchOptions:l,viewType:m?.type,visibleElements:new s(u)})),c.snappingControls&&d.push(i(o,{afterCreate:t=>t.layerListOpen=!1,snappingManager:g,snappingOptions:a,view:m,visibleElements:c.snappingControlsElements??new n})),0===d.length?null:i("calcite-accordion",{appearance:"transparent",class:p.settingsContainer,key:"settings"},i("calcite-accordion-item",{"data-testid":"settings",heading:r.settings,iconStart:"gear"},d))}export{c as Settings,p as css,r as loadSettingsComponents};

package/widgets/Editor.d.ts

@@ -138,7 +138,7 @@ export interface EditorEvents extends EditorViewModelEvents {}
  * [layerInfos](https://developers.arcgis.com/javascript/latest/references/core/widgets/Editor/#layerInfos) property.
  * This property takes an array of objects which allows configuring the the editing experience for these layers.
  *
- * ![editor](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/editor/editor-in-action2.gif)
+ * ![editor](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/editor/editor-in-action2.gif)
  *
  * Note that the update operations (such as rotate, move, and transform) happen in the map space.
  * This means that, for example in 3D, if a graphic is rotated in a global WGS84 view, its shape and segment lengths change.
@@ -199,7 +199,7 @@ export interface EditorEvents extends EditorViewModelEvents {}
  *
  * See more about the available tooltip inputs and constraints under the [tooltip options](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/sketch/SketchTooltipOptions/) class.
  *
- * ![editing constraints](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/editor/editing-constraints.gif)
+ * ![editing constraints](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/editor/editing-constraints.gif)
  *
  * <span id="relationship-editing"></span>
  * ## Relationship editing
@@ -208,7 +208,7 @@ export interface EditorEvents extends EditorViewModelEvents {}
  *
  * Once the form is authored, the [Editor](https://developers.arcgis.com/javascript/latest/references/core/widgets/Editor/) automatically checks if there is a [FormTemplate](https://developers.arcgis.com/javascript/latest/references/core/form/FormTemplate/) set on the editable [layer](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#formTemplate), or the widget's corresponding [LayerInfo](https://developers.arcgis.com/javascript/latest/references/core/widgets/Editor/types/#LayerInfo). If the form's template is not set or is not configured to contain [relationship elements](https://developers.arcgis.com/javascript/latest/references/core/form/elements/RelationshipElement/), the Editor will not display the option to edit the relationship data. Additional considerations when using the Editor to edit related data are provided below.
  *
- * ![editing related records with the Editor widget](https://developers.arcgis.com/javascript/latest/assets/img/guide/whats-new/428/ff-related-features.gif)
+ * ![editing related records with the Editor widget](https://developers.arcgis.com/javascript/latest/assets/images/guide/whats-new/428/ff-related-features.gif)
  *
  * <details>
  * <summary>Read More</summary>
@@ -233,7 +233,7 @@ export interface EditorEvents extends EditorViewModelEvents {}
  *
  * Once the form is created, the [Editor](https://developers.arcgis.com/javascript/latest/references/core/widgets/Editor/) checks if a [FormTemplate](https://developers.arcgis.com/javascript/latest/references/core/form/FormTemplate/) is assigned to the [layer](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#formTemplate) or the widget's [LayerInfo](https://developers.arcgis.com/javascript/latest/references/core/widgets/Editor/types/#LayerInfo). If the form's template lacks the necessary [association elements](https://developers.arcgis.com/javascript/latest/references/core/form/elements/UtilityNetworkAssociationsElement/), the [Editor](https://developers.arcgis.com/javascript/latest/references/core/widgets/Editor/) will not display associated features or options to edit them. Also, if an associated feature exists on a layer and that layer is not included in the [WebMap](https://developers.arcgis.com/javascript/latest/references/core/WebMap/) being used, the associated feature will not be shown in Editor.
  *
- * ![editing associated features with the Editor widget](https://developers.arcgis.com/javascript/latest/assets/img/guide/whats-new/432/ff-associated-features.gif)
+ * ![editing associated features with the Editor widget](https://developers.arcgis.com/javascript/latest/assets/images/guide/whats-new/432/ff-associated-features.gif)
  *
  * <span id="adding-associations"></span>
  * ### Creating associations
@@ -255,17 +255,17 @@ export interface EditorEvents extends EditorViewModelEvents {}
  *
  * Click "Add" to create the association.
  *
- * ![creating a new association with the Editor widget](https://developers.arcgis.com/javascript/latest/assets/img/guide/whats-new/432/ff-add-association.gif)
+ * ![creating a new association with the Editor widget](https://developers.arcgis.com/javascript/latest/assets/images/guide/whats-new/432/ff-add-association.gif)
  *
  * Alternatively, if compatible layers are visible on the map, a feature can be selected on the map using a spatial selection toolbar.
  * Features can be selected at a single point or within a region. Any compatible features at the selected point or within the defined region are displayed in a list.
  * Hover over a feature in the list to highlight it on the map; click a feature in the list to choose the feature to form the association with.
  *
- * ![spatially selecting a feature to form an association with](https://developers.arcgis.com/javascript/latest/assets/img/guide/whats-new/433/spatial-selection-demo-small.gif)
+ * ![spatially selecting a feature to form an association with](https://developers.arcgis.com/javascript/latest/assets/images/guide/whats-new/433/spatial-selection-demo-small.gif)
  *
  * While viewing compatible features on a layer, filters can optionally be used to find a specific feature to form an association with.
  *
- * ![creating a new association with attribute filter with the Editor widget](https://developers.arcgis.com/javascript/latest/assets/img/guide/whats-new/432/ff-add-association-filter.gif)
+ * ![creating a new association with attribute filter with the Editor widget](https://developers.arcgis.com/javascript/latest/assets/images/guide/whats-new/432/ff-add-association-filter.gif)
  *
  * <span id="deleting-associations"></span>
  * ### Deleting associations
@@ -294,7 +294,7 @@ export interface EditorEvents extends EditorViewModelEvents {}
  * While viewing associated features on a layer, a search bar can optionally be used to filter by the title of the
  * feature shown in the list.
  *
- * ![deleting an association with the Editor widget](https://developers.arcgis.com/javascript/latest/assets/img/guide/whats-new/432/ff-delete-association.gif)
+ * ![deleting an association with the Editor widget](https://developers.arcgis.com/javascript/latest/assets/images/guide/whats-new/432/ff-delete-association.gif)
  *
  * <span id="date-time"></span>
  * ## Editing date and time

package/widgets/ElevationProfile/ElevationProfileLineGround.d.ts

@@ -28,7 +28,7 @@ export interface ElevationProfileLineGroundProperties extends ElevationProfileLi
  * Whenever layers are added or removed from the [Ground](https://developers.arcgis.com/javascript/latest/references/core/Ground/) or their visibility changes, the
  * profile line will be updated.
  *
- * ![elevation-profile-ground](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/elevation-profile/elevation-profile-ground.png)
+ * ![elevation-profile-ground](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/elevation-profile/elevation-profile-ground.png)
  *
  * @deprecated since version 5.0. Use the [Elevation Profile component](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-elevation-profile/) or [ElevationProfileLineGround](https://developers.arcgis.com/javascript/latest/references/core/analysis/ElevationProfile/ElevationProfileLineGround/) from [ElevationProfileAnalysis](https://developers.arcgis.com/javascript/latest/references/core/analysis/ElevationProfileAnalysis/) instead. For information on widget deprecation, read about [Esri's move to web components](https://developers.arcgis.com/javascript/latest/components-transition-plan/).
  * @since 4.18

package/widgets/ElevationProfile/ElevationProfileLineInput.d.ts

@@ -31,7 +31,7 @@ export interface ElevationProfileLineInputProperties extends ElevationProfileLin
  * ElevationProfileLineInput only when the input feature is a client-side graphic with z values
  * in a [MapView](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/).
  *
- * ![elevation-profile-zline](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/elevation-profile/elevation-profile-zline.png)
+ * ![elevation-profile-zline](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/elevation-profile/elevation-profile-zline.png)
  * _Profile generated from a line feature with z-values. The orange profile is created with a profile line of type input._
  *
  * @deprecated since version 5.0. Use the [Elevation Profile component](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-elevation-profile/) or [ElevationProfileLineInput](https://developers.arcgis.com/javascript/latest/references/core/analysis/ElevationProfile/ElevationProfileLineInput/) from [ElevationProfileAnalysis](https://developers.arcgis.com/javascript/latest/references/core/analysis/ElevationProfileAnalysis/) instead. For information on widget deprecation, read about [Esri's move to web components](https://developers.arcgis.com/javascript/latest/components-transition-plan/).

package/widgets/ElevationProfile/ElevationProfileLineView.d.ts

@@ -34,7 +34,7 @@ export interface ElevationProfileLineViewProperties extends ElevationProfileLine
  *
  * This profile line type is not supported in a [MapView](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/).
  *
- * ![elevation-profile](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/elevation-profile/elevation-profile-city.png)
+ * ![elevation-profile](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/elevation-profile/elevation-profile-city.png)
  * _The purple building profile is the result of a profile line of type view._
  *
  * @deprecated since version 5.0. Use the [Elevation Profile component](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-elevation-profile/) or [ElevationProfileLineScene](https://developers.arcgis.com/javascript/latest/references/core/analysis/ElevationProfile/ElevationProfileLineScene/) from [ElevationProfileAnalysis](https://developers.arcgis.com/javascript/latest/references/core/analysis/ElevationProfileAnalysis/) instead. For information on widget deprecation, read about [Esri's move to web components](https://developers.arcgis.com/javascript/latest/components-transition-plan/).

package/widgets/ElevationProfile.d.ts

@@ -106,7 +106,7 @@ export interface ElevationProfileProperties extends WidgetProperties, Partial<Pi
  * Alternatively, the widget allows setting an input graphic programmatically at creation or runtime by setting the
  * [input](https://developers.arcgis.com/javascript/latest/references/core/widgets/ElevationProfile/#input) property.
  *
- * [![elevation-profile](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/elevation-profile/elevation-profile-city.png)](https://developers.arcgis.com/javascript/latest/sample-code/widgets-elevation-profile/)
+ * [![elevation-profile](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/elevation-profile/elevation-profile-city.png)](https://developers.arcgis.com/javascript/latest/sample-code/widgets-elevation-profile/)
  * _ElevationProfile widget used in a city scene, displaying ground and building profiles. See [Sample - ElevationProfile widget](https://developers.arcgis.com/javascript/latest/sample-code/widgets-elevation-profile/)_
  *
  * The widget can visualize multiple profile lines, depending on the environment (2D versus 3D) and elevation source data:
@@ -144,10 +144,10 @@ export interface ElevationProfileProperties extends WidgetProperties, Partial<Pi
  * Scrolling the chart zooms in to a specific part of the profile chart. When zoomed in, click the minus button to reset the zoom.
  * On touch devices, pinch to zoom in and out.
  *
- * ![elevation-profile-draw](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/elevation-profile/elevation-profile-draw.gif)
+ * ![elevation-profile-draw](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/elevation-profile/elevation-profile-draw.gif)
  * _Drawing a path to get a ground profile._
  *
- * ![elevation-profile-zline](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/elevation-profile/elevation-profile-zline.png)
+ * ![elevation-profile-zline](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/elevation-profile/elevation-profile-zline.png)
  * _Profile generated from a line feature with z-values shows a paraglide track above ground._
  *
  * How distance values are computed depends on the map's spatial reference:

package/widgets/Expand.d.ts

@@ -230,7 +230,7 @@ export default class Expand extends Widget {
   /**
    * A number to display at the corner of the widget to indicate the number of, for example, open issues or unread notices.
    *
-   * ![expand widget icon number](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/expand-with-iconnumber.png)
+   * ![expand widget icon number](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/expand-with-iconnumber.png)
    *
    * @default 0
    */

package/widgets/FeatureForm.d.ts

@@ -81,7 +81,7 @@ export interface FeatureFormEvents extends FeatureFormViewModelEvents {}
  *
  * This widget is intended to be used with [FeatureLayer.applyEdits()](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#applyEdits) method. This enables an end user to update a feature's attribute on an editable feature layer. The UI to submit and apply any updates should be wired up within the application's code.
  *
- * ![featureForm](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/featureForm.png)
+ * ![featureForm](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/featureForm.png)
  *
  * > [!WARNING]
  * >

package/widgets/FeatureTable/ActionColumn.d.ts

@@ -22,9 +22,9 @@ export interface ActionColumnProperties extends ColumnProperties, Partial<Pick<A
  * is invoked whenever the action is clicked. Actions can be configured to dynamically
  * display based on provided conditions.
  *
- * ![featuretable action column](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/featuretable/action-column.png)
+ * ![featuretable action column](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/featuretable/action-column.png)
  *
- * [![FeatureTable action column](https://developers.arcgis.com/javascript/latest/assets/img/guide/whats-new/430/featuretable/table-actioncolumn.gif)](https://developers.arcgis.com/javascript/latest/sample-code/widgets-featuretable-row-highlights/)
+ * [![FeatureTable action column](https://developers.arcgis.com/javascript/latest/assets/images/guide/whats-new/430/featuretable/table-actioncolumn.gif)](https://developers.arcgis.com/javascript/latest/sample-code/widgets-featuretable-row-highlights/)
  *
  * @since 4.30
  * @see [FeatureTable](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/)

package/widgets/FeatureTable/AttachmentsColumn.d.ts

@@ -23,7 +23,7 @@ export interface AttachmentsColumnProperties extends ColumnProperties, Partial<P
  * > This class should be used for observing potential changes. It is designed
  * > primarily to read and not interact directly with the attachment columns.
  *
- * ![attachments columns](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/featuretable/attachments-enabled.png)
+ * ![attachments columns](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/featuretable/attachments-enabled.png)
  *
  * @since 4.30
  * @see [FeatureTable](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/)

package/widgets/FeatureTable/FeatureTableViewModel.d.ts

@@ -293,7 +293,7 @@ export default class FeatureTableViewModel extends GridViewModel {
    * viewing additional information about a feature. This column is displayed as the
    * last column in the table and is only displayed if this property is set.
    *
-   * ![featuretable action column](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/featuretable/action-column.png)
+   * ![featuretable action column](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/featuretable/action-column.png)
    *
    * @since 4.30
    * @see [Calcite Icon Search](https://developers.arcgis.com/calcite-design-system/icons/)
@@ -351,7 +351,7 @@ export default class FeatureTableViewModel extends GridViewModel {
   /**
    * Indicates whether to display the `Attachments` field in the table. It displays the count of attachments per feature and is only applicable if the feature layer [supports attachments](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#capabilities).
    *
-   * ![featuretable attachmentsEnabled](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/featuretable/attachments-enabled.png)
+   * ![featuretable attachmentsEnabled](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/featuretable/attachments-enabled.png)
    *
    * @default false
    * @see [FeatureLayer.capabilities.data.supportsAttachment](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#capabilities)
@@ -445,7 +445,7 @@ export default class FeatureTableViewModel extends GridViewModel {
    * > If the service's field is not editable, it is not possible to override its permissions using any of the options above.
    * > [FieldColumnTemplate.editable](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/support/FieldColumnTemplate/#editable) can never override what is set on the layer, field, or table.
    *
-   * ![featuretable editing](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/featuretable/editing.png)
+   * ![featuretable editing](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/featuretable/editing.png)
    *
    * @default false
    * @since 4.16

package/widgets/FeatureTable/Grid/GroupColumn.d.ts

@@ -11,7 +11,7 @@ export interface GroupColumnProperties extends ColumnProperties {}
  * > This class should be used for observing potential changes. Any configuration and changes to the
  * > columns should be handled via the [TableTemplate](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/support/TableTemplate/) and the [GroupColumnTemplate](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/support/GroupColumnTemplate/) class.
  *
- * ![featuretable group columns](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/featuretable/group-columns.png)
+ * ![featuretable group columns](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/featuretable/group-columns.png)
  *
  * @since 4.24
  * @see [FeatureTable](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/)

package/widgets/FeatureTable/RelationshipColumn.d.ts

@@ -31,7 +31,7 @@ export interface RelationshipColumnProperties extends ColumnProperties, Partial<
  * > This class should be used for observing potential changes. It is designed
  * > primarily to read and not interact directly with the relationship columns.
  *
- * ![relationship columns](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/featuretable/relationship-column.png)
+ * ![relationship columns](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/featuretable/relationship-column.png)
  *
  * @since 4.30
  * @see [Column](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/Grid/Column/)

package/widgets/FeatureTable/VisibleElements.d.ts

@@ -20,7 +20,7 @@ export interface VisibleElementsProperties extends Partial<Pick<VisibleElements,
  * The visible elements that are displayed within the widget.
  * This provides the ability to turn individual elements of the widget's display on/off.
  *
- * ![featuretable-visibleelements](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/featuretable/featuretablevisibleelements.png)
+ * ![featuretable-visibleelements](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/featuretable/featuretablevisibleelements.png)
  *
  * @since 5.0
  */

package/widgets/FeatureTable.d.ts

@@ -395,7 +395,7 @@ export interface FeatureTableEvents extends FeatureTableViewModelEvents {}
  * Once set, interacting with a table row will select and highlight the corresponding feature in the view.
  * Multiple selections within the table are turned on by default. To update this behavior, set the [multipleSelectionEnabled](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#multipleSelectionEnabled) property to `false`.
  *
- * ![featuretable-highlightIds](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/featuretable/selected-features.png)
+ * ![featuretable-highlightIds](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/featuretable/selected-features.png)
  *
  * <details>
  * <summary>Read More</summary>
@@ -415,7 +415,7 @@ export interface FeatureTableEvents extends FeatureTableViewModelEvents {}
  *   });
  * });
  * ```
- * ![featuretable-rowHighlightIds](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/featuretable/rowhighlightids.png)
+ * ![featuretable-rowHighlightIds](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/featuretable/rowhighlightids.png)
  *
  * Additionally, selection and highlight behavior can be enhanced using the feature table's [events](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#FeatureTableEvents). These events are designed to listen for cell interaction and include: [@cell-click](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#event-cell-click), [@cell-keydown](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#event-cell-keydown), [@cell-pointerout](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#event-cell-pointerout), and [@cell-pointerover](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#event-cell-pointerover). The latter two events are especially useful for tasks such as highlighting a feature in the view while hovering over a cell, all doing so without requiring the end-user to select the row. For example, these events can be used to display cell information in a tooltip that is attached to the mouse cursor.
  *
@@ -447,7 +447,7 @@ export interface FeatureTableEvents extends FeatureTableViewModelEvents {}
  * ## Editing within the FeatureTable
  * The FeatureTable provides the ability to edit feature attributes within the table. This is accomplished by setting the [editingEnabled](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#editingEnabled) property to `true`. The editing experience is similar to that of a spreadsheet, where end-users can click into a cell to edit its value. The table automatically saves edits to the layer once navigating away from the cell or `Enter` is pressed. Press the `Esc` key to cancel an edit. The FeatureTable also provides the ability to delete selected records. This is done by selecting the rows to delete and clicking the `Delete Selection` menu item. The `Delete Selection` menu item is only available if the [editingEnabled](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#editingEnabled) property is set to `true` and the feature service supports editing.
  *
- * ![featuretable editing](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/featuretable/editing.png)
+ * ![featuretable editing](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/featuretable/editing.png)
  *
  * <details>
  * <summary>Read More</summary>
@@ -474,11 +474,11 @@ export interface FeatureTableEvents extends FeatureTableViewModelEvents {}
  *
  *  | Origin table with related records |
  *  |---------------------------------- |
- *  | ![Origin table related records](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/featuretable/relate-table-origin.png) |
+ *  | ![Origin table related records](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/featuretable/relate-table-origin.png) |
  *
  *  | Destination table with related records |
  *  |-----------------------------------|
- *  | ![Destination table related records](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/featuretable/relate-dest-table.png) |
+ *  | ![Destination table related records](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/featuretable/relate-dest-table.png) |
  *
  * This is done by setting the [relatedRecordsEnabled](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#relatedRecordsEnabled) property to `true`. When this property is set, the table will contain a field that links to any related records associated with each feature in the table. When clicked, a separate table displays the related records for that feature. The FeatureTable provides the ability to show nested related records, which are related records that contain their own related records. It automatically recognizes if there are any related tables associated a table and, if applicable, displays links to related records for that feature or row. The following example demonstrates how to configure the FeatureTable to display related records:
  *
@@ -562,7 +562,7 @@ export interface FeatureTableEvents extends FeatureTableViewModelEvents {}
  * <details>
  * <summary>Read More</summary>
  *
- * [![FeatureTable custom content](https://developers.arcgis.com/javascript/latest/assets/img/guide/whats-new/430/featuretable/table-custom-content.png)](https://developers.arcgis.com/javascript/latest/sample-code/widgets-featuretable-custom-content/)
+ * [![FeatureTable custom content](https://developers.arcgis.com/javascript/latest/assets/images/guide/whats-new/430/featuretable/table-custom-content.png)](https://developers.arcgis.com/javascript/latest/sample-code/widgets-featuretable-custom-content/)
  *
  *
  * ```javascript
@@ -600,7 +600,7 @@ export interface FeatureTableEvents extends FeatureTableViewModelEvents {}
  *
  * | Default column menu items   | Configured column menu items |
  * |--------|------|
- * | ![Default column menu items](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/featuretable/column-menu-items.png) | ![Configured column menu items](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/featuretable/column-menu-items-config.png)) |
+ * | ![Default column menu items](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/featuretable/column-menu-items.png) | ![Configured column menu items](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/featuretable/column-menu-items-config.png)) |
  *
  * ```javascript
  * featureTable.menuConfig = {
@@ -628,7 +628,7 @@ export interface FeatureTableEvents extends FeatureTableViewModelEvents {}
  *
  * | Default table menu items   | Configured table menu items |
  * |--------|------|
- * | ![Default table menu items](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/featuretable/table-menu-items.png) | ![Configured table menu items](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/featuretable/table-menu-items-config.png)) |
+ * | ![Default table menu items](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/featuretable/table-menu-items.png) | ![Configured table menu items](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/featuretable/table-menu-items-config.png)) |
  *
  * ```javascript
  * const columnTemplate = new FieldColumnTemplate({
@@ -699,7 +699,7 @@ export default class FeatureTable extends Widget<FeatureTableProperties> {
    * viewing additional information about a feature. This column is displayed as the
    * last column in the table and is only displayed if this property is set.
    *
-   * ![featuretable action column](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/featuretable/action-column.png)
+   * ![featuretable action column](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/featuretable/action-column.png)
    *
    * @since 4.30
    * @see [actionColumn](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#actionColumn)
@@ -759,7 +759,7 @@ export default class FeatureTable extends Widget<FeatureTableProperties> {
   /**
    * Indicates whether to display the `Attachments` field in the table. It displays the count of attachments per feature and is only applicable if the feature layer [supports attachments](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#capabilities).
    *
-   * ![featuretable attachmentsEnabled](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/featuretable/attachments-enabled.png)
+   * ![featuretable attachmentsEnabled](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/featuretable/attachments-enabled.png)
    *
    * @default false
    * @see [FeatureLayer.capabilities.data.supportsAttachment](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#capabilities)

package/widgets/FeatureTemplates/FeatureTemplatesViewModel.d.ts

@@ -104,7 +104,7 @@ export default class FeatureTemplatesViewModel extends EventedAccessor {
    * an object containing a [name](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTemplates/TemplateItem/#label)
    * property of the [template item](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTemplates/TemplateItem/).
    *
-   * ![featureTemplatesFilterFunction](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/featureTemplatesFilterFunction.png)
+   * ![featureTemplatesFilterFunction](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/featureTemplatesFilterFunction.png)
    *
    * @example
    * // Filter and display templates only if their names contain the word `Street`
@@ -130,10 +130,10 @@ export default class FeatureTemplatesViewModel extends EventedAccessor {
    *
    * Type | Description | Example
    * ----- | ----------- | -------
-   * layer | This is the *default* grouping. Groups template items by layers. | ![featureTemplatesGroupByLayer](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/groupByLayers.png)
-   * geometry | Groups template items by geometry type. | ![FeatureTemplatesGroupByGeometry](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/groupByGeometry.png)
-   * none | The widget displays everything in one list with no grouping. | ![featureTemplatesGroupByLayer](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/groupByNone.png)
-   * [GroupByFunction](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTemplates/types/#GroupByFunction) | Custom function that takes an object containing a [FeatureTemplate](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureTemplate/) and [FeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/). | ![FeatureTemplatesGroupByCustomGroupFunction](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/groupCustomGroup.png)
+   * layer | This is the *default* grouping. Groups template items by layers. | ![featureTemplatesGroupByLayer](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/groupByLayers.png)
+   * geometry | Groups template items by geometry type. | ![FeatureTemplatesGroupByGeometry](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/groupByGeometry.png)
+   * none | The widget displays everything in one list with no grouping. | ![featureTemplatesGroupByLayer](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/groupByNone.png)
+   * [GroupByFunction](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTemplates/types/#GroupByFunction) | Custom function that takes an object containing a [FeatureTemplate](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureTemplate/) and [FeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/). | ![FeatureTemplatesGroupByCustomGroupFunction](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/groupCustomGroup.png)
    *
    * @default "layer"
    * @example

package/widgets/FeatureTemplates.d.ts

@@ -36,7 +36,7 @@ export interface FeatureTemplatesProperties extends WidgetProperties, Partial<Pi
    * The visible elements that are displayed within the widget.
    * This property provides the ability to turn individual elements of the widget's display on/off.
    *
-   * ![featureTemplatesFilter](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/featureTemplatesFilter.png)
+   * ![featureTemplatesFilter](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/featureTemplatesFilter.png)
    *
    * @since 4.15
    * @example
@@ -59,7 +59,7 @@ export interface FeatureTemplatesEvents extends FeatureTemplatesViewModelEvents
  * [FeatureLayer.applyEdits()](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#applyEdits) to enable an end user to
  * update one of its feature layers.
  *
- * [![featureTemplates](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/featureTemplates.png)](https://developers.arcgis.com/javascript/latest/sample-code/editing-applyedits/)
+ * [![featureTemplates](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/featureTemplates.png)](https://developers.arcgis.com/javascript/latest/sample-code/editing-applyedits/)
  *
  * @deprecated since version 5.0. Use the [Feature Templates](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-templates/) component instead. For information on widget deprecation, read about [Esri's move to web components](https://developers.arcgis.com/javascript/latest/components-transition-plan/).
  * @since 4.10
@@ -115,7 +115,7 @@ export default class FeatureTemplates extends Widget {
    * an object containing a [name](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTemplates/TemplateItem/#label)
    * property of the [template item](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTemplates/TemplateItem/).
    *
-   * ![featureTemplatesFilterFunction](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/featureTemplatesFilterFunction.png)
+   * ![featureTemplatesFilterFunction](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/featureTemplatesFilterFunction.png)
    *
    * @example
    * // Filter and display templates only if their labels contain the word `Street`
@@ -147,10 +147,10 @@ export default class FeatureTemplates extends Widget {
    *
    * Type | Description | Example
    * ----- | ----------- | -------
-   * layer | This is the *default* grouping. Groups template items by layers. | ![featureTemplatesGroupByLayer](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/groupByLayers.png)
-   * geometry | Groups template items by geometry type. | ![FeatureTemplatesGroupByGeometry](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/groupByGeometry.png)
-   * none | The widget displays everything in one list with no grouping. | ![featureTemplatesGroupByLayer](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/groupByNone.png)
-   * [GroupByFunction](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTemplates/types/#GroupByFunction) | Custom function that takes an object containing a [FeatureTemplate](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureTemplate/) and [FeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/). | ![FeatureTemplatesGroupByCustomGroupFunction](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/groupCustomGroup.png)
+   * layer | This is the *default* grouping. Groups template items by layers. | ![featureTemplatesGroupByLayer](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/groupByLayers.png)
+   * geometry | Groups template items by geometry type. | ![FeatureTemplatesGroupByGeometry](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/groupByGeometry.png)
+   * none | The widget displays everything in one list with no grouping. | ![featureTemplatesGroupByLayer](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/groupByNone.png)
+   * [GroupByFunction](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTemplates/types/#GroupByFunction) | Custom function that takes an object containing a [FeatureTemplate](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureTemplate/) and [FeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/). | ![FeatureTemplatesGroupByCustomGroupFunction](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/groupCustomGroup.png)
    *
    * @default "layer"
    * @example
@@ -254,7 +254,7 @@ export default class FeatureTemplates extends Widget {
    * The visible elements that are displayed within the widget.
    * This property provides the ability to turn individual elements of the widget's display on/off.
    *
-   * ![featureTemplatesFilter](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/featureTemplatesFilter.png)
+   * ![featureTemplatesFilter](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/featureTemplatesFilter.png)
    *
    * @since 4.15
    * @example