@arcgis/core 5.2.0-next.15 → 5.2.0-next.17

package/layers/support/SubtypeSublayer.d.ts

@@ -21,7 +21,7 @@ import type { ClonableMixin } from "../../core/Clonable.js";
 import type { IdentifiableMixin, IdentifiableMixinProperties } from "../../core/Identifiable.js";
 import type { Loadable, LoadableMixinProperties } from "../../core/Loadable.js";
 import type { MultiOriginJSONSupportMixin } from "../../core/MultiOriginJSONSupport.js";
-import type { EditOptions, Edits, EditsResult, FeatureEditResult } from "../../editing/types.js";
+import type { AddAttachmentOptions, AttachmentEditOptions, EditOptions, Edits, EditsResult, FeatureEditResult } from "../../editing/types.js";
 import type { FeatureLayerCapabilities, FeatureTitleOptions } from "../types.js";
 import type { DomainUnion } from "./types.js";
 import type { RequestOptions } from "../../request/types.js";
@@ -670,6 +670,7 @@ export default class SubtypeSublayer extends SubtypeSublayerSuperclass {
    *
    * @param feature - Feature to associate with the added attachment.
    * @param attachment - HTML form that contains a file upload field specifying the file to be added as an attachment.
+   * @param options - Additional options for the resulting feature service request.
    * @returns When resolved, a [FeatureEditResult](https://developers.arcgis.com/javascript/latest/references/core/editing/types/#FeatureEditResult)
    * object is returned.
    * @see [capabilities.data.supportsAttachment](https://developers.arcgis.com/javascript/latest/references/core/layers/support/SubtypeSublayer/#capabilities)
@@ -708,7 +709,7 @@ export default class SubtypeSublayer extends SubtypeSublayerSuperclass {
    *   });
    * });
    */
-  addAttachment(feature: Graphic, attachment: HTMLFormElement | FormData): Promise<FeatureEditResult>;
+  addAttachment(feature: Graphic, attachment: HTMLFormElement | FormData, options?: AddAttachmentOptions): Promise<FeatureEditResult>;
   /**
    * Applies edits to features in a layer. New features can be created and existing features can be updated or deleted. Feature geometries and/or attributes may be modified.
    * Attachments can also be added, updated or deleted.
@@ -814,13 +815,14 @@ export default class SubtypeSublayer extends SubtypeSublayerSuperclass {
    *
    * @param feature - Feature containing attachments to be deleted.
    * @param attachmentIds - Ids of the attachments to be deleted.
+   * @param options - Additional options for the resulting feature service request.
    * @returns When resolved, a [FeatureEditResult](https://developers.arcgis.com/javascript/latest/references/core/editing/types/#FeatureEditResult)
    * object is returned.  FeatureEditResult indicates whether or not the edit was successful. If successful, the `objectId` of the result is the Id of
    * the new attachment. If unsuccessful, it also includes an error `name` and error `message`.
    * @since 4.26
    * @see [capabilities.data.supportsAttachment](https://developers.arcgis.com/javascript/latest/references/core/layers/support/SubtypeSublayer/#capabilities)
    */
-  deleteAttachments(feature: Graphic, attachmentIds: number[]): Promise<FeatureEditResult[]>;
+  deleteAttachments(feature: Graphic, attachmentIds: number[], options?: AttachmentEditOptions): Promise<FeatureEditResult[]>;
   /**
    * Returns the title of a [feature](https://developers.arcgis.com/javascript/latest/references/core/Graphic/). The feature title is generated based on the following conditions for a `SubtypeSublayer`.
    * - If the feature has a popup title configured, then the popup title will be returned.
@@ -1097,12 +1099,13 @@ export default class SubtypeSublayer extends SubtypeSublayerSuperclass {
    * @param feature - The feature containing the attachment to be updated.
    * @param attachmentId - Id of the attachment to be updated.
    * @param attachment - HTML form that contains a file upload field pointing to the file to be added as an attachment.
+   * @param options - Additional options for the resulting feature service request.
    * @returns When resolved, a [FeatureEditResult](https://developers.arcgis.com/javascript/latest/references/core/editing/types/#FeatureEditResult)
    * object is returned. FeatureEditResult indicates whether or not the edit was successful. If successful, the `objectId` of the result is the Id of
    * the new attachment. If unsuccessful, it also includes an error `name` and error `message`.
    * @since 4.26
    * @see [capabilities.data.supportsAttachment](https://developers.arcgis.com/javascript/latest/references/core/layers/support/SubtypeSublayer/#capabilities)
    */
-  updateAttachment(feature: Graphic, attachmentId: number, attachment: HTMLFormElement | FormData): Promise<FeatureEditResult>;
+  updateAttachment(feature: Graphic, attachmentId: number, attachment: HTMLFormElement | FormData, options?: AttachmentEditOptions): Promise<FeatureEditResult>;
 }
 declare const SubtypeSublayerSuperclass: typeof Loadable & typeof IdentifiableMixin & typeof ClonableMixin & typeof MultiOriginJSONSupportMixin

package/layers/support/SubtypeSublayer.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{__decorate as e}from"tslib";import t from"../../PopupTemplate.js";import{ClonableMixin as r}from"../../core/Clonable.js";import i from"../../core/Error.js";import{IdentifiableMixin as n}from"../../core/Identifiable.js";import{clone as o}from"../../core/lang.js";import{Loadable as s}from"../../core/Loadable.js";import l from"../../core/Logger.js";import{destroyMaybe as a}from"../../core/maybe.js";import{MultiOriginJSONSupportMixin as p}from"../../core/MultiOriginJSONSupport.js";import{setDeepValue as d}from"../../core/object.js";import{sqlAnd as u}from"../../core/sql.js";import{property as y,subclass as f}from"../../core/accessorSupport/decorators.js";import{excludeTables as c}from"../../core/accessorSupport/layerContainerType.js";import m from"../../form/FormTemplate.js";import h from"../../geometry/SpatialReference.js";import g from"../../graphic/SubtypeGroupGraphicOrigin.js";import{labelsVisible as b,legendEnabled as j,minScale as v,maxScale as w,popupEnabled as F}from"./commonProperties.js";import{createQuery as T,computeDomainFromSubtypes as O}from"./featureLayerUtils.js";import C from"./FeatureTemplate.js";import I from"./FieldConfiguration.js";import{popupTemplateWithFieldConfigurations as S,fieldConfigurationsFromPopupTemplate as A,fieldConfigurationsFromFields as E}from"./fieldConfigUtils.js";import{defineFieldProperties as q}from"./fieldProperties.js";import{fixRendererFields as _}from"./fieldUtils.js";import x from"./LabelClass.js";import{reader as P}from"./labelingInfo.js";import{rendererReader as R,supportedRendererTypes as L}from"./subtypeGroupLayerUtils.js";import D from"./TitleCreator.js";import G from"../../renderers/SimpleRenderer.js";import N from"../../rest/support/AttachmentQuery.js";import U from"../../rest/support/Query.js";import{createPopupTemplate as $}from"../../support/popupUtils.js";import{defaultPolygonSymbol2D as V,defaultPolylineSymbol2D as M,defaultPointSymbol2D as Q}from"../../symbols/support/defaults.js";import k from"../../tables/AttributeTableTemplate.js";import{writer as B}from"../../core/accessorSupport/decorators/writer.js";import{reader as H}from"../../core/accessorSupport/decorators/reader.js";const J=q();let W=0;function z(e,t){let r=e.json.write;return"object"!=typeof r&&(r=e.json.write={}),r.ignoreOrigin=!0,t?.spatialOnly&&(r.layerContainerTypes=c),e}function K(e){const t={write:{ignoreOrigin:!0}};return e?.name&&(t.name=e.name),"object"==typeof t.write&&(e?.spatialOnly&&(t.write.layerContainerTypes=c),e?.target&&(t.write.target=e.target)),t}function X(e){return new G({symbol:Y(e)})}function Y(e){switch(e){case"point":case"multipoint":return Q.clone();case"polyline":return M.clone();case"polygon":case"multipatch":return V.clone();default:return null}}function Z(e,t){return!!t&&("unique-value"===e?.type&&null!=e.field&&e.field.toLowerCase()===t.toLowerCase()&&!e.field2&&!e.field3&&!e.valueExpression)}function ee(e){return ie(e,"user")===e}function te(e){return ie(e,"service")}function re(e){return ie(e,"portal-item")}function ie(e,t){const r=e.parent?.getAtOrigin("sublayers",t);return r?.find(({subtypeCode:t})=>t===e.subtypeCode)}function ne(e,t){return null==e?null:t.subtypes?.find(t=>t.code===e)}function oe(e,t){let r=null;switch(t.geometryType){case"esriGeometryPoint":case"esriGeometryMultipoint":r="point";break;case"esriGeometryPolyline":r="line";break;case"esriGeometryPolygon":case"esriGeometryMultiPatch":r="polygon";break;default:t.type,r=null}const i={},n=ne(e,t);if(null!=n){const{defaultValues:e}=n;for(const t in e)i[t]=e[t]}return i[t.subtypeField]=e,new C({name:"New Feature",drawingTool:r,prototype:{attributes:i}})}let se=class extends(p(r(n(s)))){constructor(e){super(e),this.attributeTableTemplate=null,this.charts=null,this.editingEnabled=!0,this.fieldOverrides=null,this.fieldsIndex=null,this.formTemplate=null,this.graphicOrigin=new g(this),this.id=`${Date.now().toString(16)}-subtype-sublayer-${W++}`,this.type="subtype-sublayer",this.labelsVisible=!0,this.labelingInfo=null,this.layerType="ArcGISFeatureLayer",this.legendEnabled=!0,this.listMode="show",this.minScale=0,this.maxScale=0,this.opacity=1,this.parent=null,this.popupEnabled=!0,this.popupTemplate=null,this.subtypeCode=null,this.visible=!0}load(e){return _(this.renderer,this.fieldsIndex),Promise.resolve(this)}get _titleCreator(){const e=this._get("_titleCreator");return a(e),new D({fieldsIndex:this.fieldsIndex,objectIdField:this.objectIdField,displayField:this.parent?.displayField??"",fields:this.fields,effectivePopupTemplate:this.popupTemplate??this.defaultPopupTemplate})}get capabilities(){return this.parent?.capabilities}get effectiveCapabilities(){return this.parent?.effectiveCapabilities}get effectiveEditingEnabled(){const{parent:e}=this;return e?e.effectiveEditingEnabled&&this.editingEnabled:this.editingEnabled}get elevationInfo(){return this.parent?.elevationInfo}get featureTitleFields(){return[...this._titleCreator.requiredFields]}set fieldConfigurations(e){if(this._override("fieldConfigurations",e),!this.parent?.loaded)return;const t=S(this,e);t&&this._set("popupTemplate",t)}get fieldConfigurations(){return this._isOverridden("fieldConfigurations")?this._get("fieldConfigurations"):A(this)||null}writeFieldOverrides(e,t,r){const{fields:i,parent:n}=this;let s;if(i){s=[];let e=0;i.forEach(({name:t,alias:r,editable:i,visible:o})=>{if(!o)return;const l=n?.fields?.find(e=>e.name===t);if(!l)return;const a={name:t};let p=!1;r!==l.alias&&(a.alias=r,p=!0),i!==l.editable&&(a.editable=i,p=!0),s.push(a),p&&e++}),0===e&&s.length===i.length&&(s=null)}else s=o(e);s?.length&&d(r,s,t)}get fields(){const{parent:e,fieldOverrides:t,subtypeCode:r}=this,i=e?.fields;if(!e||!i?.length)return null;const{subtypes:n,subtypeField:o}=e,s=n?.find(e=>e.code===r),l=s?.defaultValues,a=s?.domains,p=[];for(const d of i){const e=d.clone(),{name:i}=e,n=t?.find(e=>e.name===i);if(e.visible=!t?.length||!!n,n){const{alias:t,editable:r}=n;t&&(e.alias=t),!1===r&&(e.editable=!1)}const s=l?.[i]??null;e.defaultValue=i===o?r:s;const u=a?.[i]??null;e.domain=i===o?null:u?"inherited"===u.type?e.domain:u.clone():null,p.push(e)}return p}get floorInfo(){return this.parent?.floorInfo}get isTable(){return!!this.parent?.isTable}get geometryType(){return this.parent?.geometryType}get globalIdField(){return this.parent?this.parent.globalIdField:(l.getLogger(this).error(pe("globalIdField")),null)}get effectiveScaleRange(){const{minScale:e,maxScale:t}=this;return{minScale:e,maxScale:t}}get objectIdField(){return this.parent||l.getLogger(this).error(pe("objectIdField")),this.parent?.objectIdField}writePopupTemplate(e,t,r,i){e&&(t[r]=e.toJSON({...i,writeFieldFormat:!0}))}get defaultPopupTemplate(){return this.createPopupTemplate()}get relationships(){return this.parent?.relationships}set renderer(e){_(e,this.fieldsIndex),this._override("renderer",e)}get renderer(){if(this._isOverridden("renderer"))return this._get("renderer");const{parent:e}=this;return e&&!e.isTable&&"mesh"!==e.geometryType?(ee(this)?o(te(this)?.renderer):null)??X(e.geometryType):null}readRendererFromService(e,t,r){if("Table"===t.type)return null;const i=t.drawingInfo?.renderer,n=R(i,t,r);let o;const{subtypeCode:s}=this;if(null!=s&&Z(n,t.subtypeField)){const e=n.uniqueValueInfos?.find(({value:e})=>(e="number"==typeof e?String(e):e)===String(s));e&&(o=new G({symbol:e.symbol}))}else"simple"!==n?.type||n.visualVariables?.length||(o=n);return o}readRenderer(e,t,r){const i=t?.layerDefinition?.drawingInfo?.renderer;if(i)return R(i,t,r)||void 0}get spatialReference(){return this.parent?.spatialReference??h.WGS84}get subtypeField(){return this.parent?.subtypeField}get templates(){return this._isOverridden("templates")?this._get("templates"):o(ee(this)?te(this)?.templates:re(this)?.templates||te(this)?.templates)}set templates(e){this._override("templates",e)}readTemplatesFromService(e,t){return[oe(this.subtypeCode,t)]}get title(){if(this._isOverridden("title"))return this._get("title");const e=ee(this)?te(this):null;return e?.title}set title(e){this._override("title",e)}readTitleFromService(e,t){const r=ne(this.subtypeCode,t);return null!=r?r.name:null}get url(){return this.parent?.url}get userHasUpdateItemPrivileges(){return!!this.parent?.userHasUpdateItemPrivileges}async addAttachment(e,t){const{parent:r}=this;if(!r)throw pe("addAttachment");if(e.getAttribute(r.subtypeField)!==this.subtypeCode)throw new i("subtype-sublayer:addAttachment","The feature provided does not belong to this SubtypeSublayer");return r.addAttachment(e,t)}async updateAttachment(e,t,r){const{parent:n}=this;if(!n)throw pe("updateAttachment");if(e.getAttribute(n.subtypeField)!==this.subtypeCode)throw new i("subtype-sublayer:updateAttachment","The feature provided does not belong to this SubtypeSublayer");return n.updateAttachment(e,t,r)}async deleteAttachments(e,t){const{parent:r}=this;if(!r)throw pe("deleteAttachments");if(e.getAttribute(r.subtypeField)!==this.subtypeCode)throw new i("subtype-sublayer:deleteAttachments","The feature provided does not belong to this SubtypeSublayer");return r.deleteAttachments(e,t)}async applyEdits(e,t){if(!this.parent)throw pe("applyEdits");return this.parent.applyEdits(e,t)}createFieldConfigurations(){return E(this)}createPopupTemplate(e){let t=this;const{parent:r,fields:i,title:n}=this;if(r){const{displayField:e,editFieldsInfo:o,objectIdField:s}=r;t={displayField:e,editFieldsInfo:o,fields:i,objectIdField:s,title:n}}return $(t,e)}createQuery(){if(!this.parent)throw pe("createQuery");const e=T(this.parent),t=`${this.parent.subtypeField}=${this.subtypeCode}`;return e.where=u(t,this.parent.definitionExpression),e}getFeatureTitle(e,t){return this._titleCreator.getTitle(this,e,t)}getFeatureTitles(e,t){return this._titleCreator.getTitles(this,e,t)}getField(e){return this.fieldsIndex.get(e)}getFieldAlias(e){const t=this.getField(e);if(t)return this.getFieldConfiguration(t.name)?.alias||t.alias}getFieldConfiguration(e){return e=e.toLowerCase(),this.fieldConfigurations?.find(t=>t.name.toLowerCase()===e)}getFieldDomain(e,t){if(!t?.excludeImpliedDomains&&this.parent){const t=O(this.parent,e);if(t)return t}return this._getLayerDomain(e)}async queryAttachments(e,t){const r=await this.load();if(!r.parent)throw pe("queryAttachments");const i=e instanceof N?e.clone():new N(e);return i.where=ae(i.where,r.parent.subtypeField,r.subtypeCode),r.parent.queryAttachments(i,t)}async queryFeatureCount(e,t){const r=await this.load();if(!r.parent)throw pe("queryFeatureCount");return r.parent.queryFeatureCount(le(r.parent,r,e),t)}async queryFeatures(e,t){const r=await this.load();if(!r.parent)throw pe("queryFeatures");return r.parent.queryFeatures(le(r.parent,r,e),t)}async queryObjectIds(e,t){const r=await this.load();if(!r.parent)throw pe("queryObjectIds");return r.parent.queryObjectIds(le(r.parent,r,e),t)}async queryRelatedFeatures(e,t){const r=await this.load();if(!r.parent)throw pe("queryRelatedFeatures");return r.parent.queryRelatedFeatures(e,t)}async queryRelatedFeaturesCount(e,t){const r=await this.load();if(!r.parent)throw pe("queryRelatedFeaturesCount");return r.parent.queryRelatedFeaturesCount(e,t)}_getLayerDomain(e){const t=this.fieldsIndex.get(e);return t?t.domain:null}};e([y({clonable:!1,readOnly:!0})],se.prototype,"_titleCreator",null),e([y({type:k,json:K({name:"attributeTableInfo"})})],se.prototype,"attributeTableTemplate",void 0),e([y({readOnly:!0,json:{read:!1}})],se.prototype,"capabilities",null),e([y({readOnly:!0,json:{read:!1}})],se.prototype,"effectiveCapabilities",null),e([y({json:K()})],se.prototype,"charts",void 0),e([y({type:Boolean,nonNullable:!0,json:K({name:"enableEditing"})})],se.prototype,"editingEnabled",void 0),e([y({type:Boolean,readOnly:!0})],se.prototype,"effectiveEditingEnabled",null),e([y({readOnly:!0,json:{read:!1}})],se.prototype,"elevationInfo",null),e([y({clonable:!1,readOnly:!0})],se.prototype,"featureTitleFields",null),e([y({type:[I],json:{name:"layerDefinition.fieldConfigurations",write:{ignoreOrigin:!0}}})],se.prototype,"fieldConfigurations",null),e([y({json:{name:"layerDefinition.fieldOverrides",origins:{service:{read:!1}},write:{ignoreOrigin:!0,allowNull:!0}}})],se.prototype,"fieldOverrides",void 0),e([B("fieldOverrides")],se.prototype,"writeFieldOverrides",null),e([y({...J.fields,readOnly:!0,json:{read:!1}})],se.prototype,"fields",null),e([y(J.fieldsIndex)],se.prototype,"fieldsIndex",void 0),e([y({readOnly:!0,json:{read:!1}})],se.prototype,"floorInfo",null),e([y({type:m,json:K({name:"formInfo"})})],se.prototype,"formTemplate",void 0),e([y({readOnly:!0,clonable:!1})],se.prototype,"graphicOrigin",void 0),e([y({type:String,clonable:!1,json:{origins:{service:{read:!1},"portal-item":{read:!1}},write:{ignoreOrigin:!0}}})],se.prototype,"id",void 0),e([y({readOnly:!0,json:{read:!1}})],se.prototype,"isTable",null),e([y({readOnly:!0,json:{read:!1}})],se.prototype,"geometryType",null),e([y({readOnly:!0,json:{read:!1}})],se.prototype,"globalIdField",null),e([y({readOnly:!0,json:{read:!1}})],se.prototype,"type",void 0),e([y(z(o(b)))],se.prototype,"labelsVisible",void 0),e([y({type:[x],json:{name:"layerDefinition.drawingInfo.labelingInfo",origins:{service:{read:!1}},read:{reader:P},write:{ignoreOrigin:!0,layerContainerTypes:c}}})],se.prototype,"labelingInfo",void 0),e([y({type:["ArcGISFeatureLayer"],readOnly:!0,json:{read:!1,write:{ignoreOrigin:!0,layerContainerTypes:c}}})],se.prototype,"layerType",void 0),e([y(z(o(j)))],se.prototype,"legendEnabled",void 0),e([y({type:["show","hide"]})],se.prototype,"listMode",void 0),e([y((()=>{const e=o(v);return e.json.origins.service.read=!1,z(e,{spatialOnly:!0})})())],se.prototype,"minScale",void 0),e([y((()=>{const e=o(w);return e.json.origins.service.read=!1,z(e,{spatialOnly:!0})})())],se.prototype,"maxScale",void 0),e([y({readOnly:!0})],se.prototype,"effectiveScaleRange",null),e([y({readOnly:!0,json:{read:!1}})],se.prototype,"objectIdField",null),e([y({type:Number,range:{min:0,max:1},nonNullable:!0,json:K({spatialOnly:!0})})],se.prototype,"opacity",void 0),e([y({clonable:!1})],se.prototype,"parent",void 0),e([y(z(o(F)))],se.prototype,"popupEnabled",void 0),e([y({type:t,json:K({name:"popupInfo"})})],se.prototype,"popupTemplate",void 0),e([B("popupTemplate")],se.prototype,"writePopupTemplate",null),e([y({readOnly:!0})],se.prototype,"defaultPopupTemplate",null),e([y({readOnly:!0,json:{read:!1}})],se.prototype,"relationships",null),e([y({types:L,json:K({target:"layerDefinition.drawingInfo.renderer",spatialOnly:!0})})],se.prototype,"renderer",null),e([H("service","renderer",["drawingInfo.renderer","subtypeField","type"])],se.prototype,"readRendererFromService",null),e([H("renderer",["layerDefinition.drawingInfo.renderer"])],se.prototype,"readRenderer",null),e([y({readOnly:!0,json:{read:!1}})],se.prototype,"spatialReference",null),e([y({type:Number,json:{origins:{service:{read:!1}},write:{ignoreOrigin:!0}}})],se.prototype,"subtypeCode",void 0),e([y({readOnly:!0,json:{read:!1}})],se.prototype,"subtypeField",null),e([y({type:[C],json:K({name:"layerDefinition.templates"})})],se.prototype,"templates",null),e([H("service","templates",["geometryType","subtypeField","subtypes","type"])],se.prototype,"readTemplatesFromService",null),e([y({type:String,json:K()})],se.prototype,"title",null),e([H("service","title",["subtypes"])],se.prototype,"readTitleFromService",null),e([y({readOnly:!0,json:{read:!1}})],se.prototype,"url",null),e([y({readOnly:!0})],se.prototype,"userHasUpdateItemPrivileges",null),e([y({type:Boolean,nonNullable:!0,json:K({name:"visibility",spatialOnly:!0})})],se.prototype,"visible",void 0),se=e([f("esri.layers.support.SubtypeSublayer")],se);const le=(e,t,r)=>{if(!r)return t.createQuery();const i=U.from(r);return i.where=ae(i.where,e.subtypeField,t.subtypeCode),i},ae=(e,t,r)=>{const i=new RegExp(`${t}\\s*=\\s*\\d+`),n=`${t}=${r}`,o=e??"";return i.test(o)?o.replace(i,n):u(n,o)},pe=e=>new i("subtype-sublayer:parent-missing",`This sublayer must have a parent SubtypeGroupLayer in order to use ${e}`);export{se as default};
+import{__decorate as e}from"tslib";import t from"../../PopupTemplate.js";import{ClonableMixin as r}from"../../core/Clonable.js";import i from"../../core/Error.js";import{IdentifiableMixin as n}from"../../core/Identifiable.js";import{clone as o}from"../../core/lang.js";import{Loadable as s}from"../../core/Loadable.js";import l from"../../core/Logger.js";import{destroyMaybe as a}from"../../core/maybe.js";import{MultiOriginJSONSupportMixin as p}from"../../core/MultiOriginJSONSupport.js";import{setDeepValue as d}from"../../core/object.js";import{sqlAnd as u}from"../../core/sql.js";import{property as y,subclass as f}from"../../core/accessorSupport/decorators.js";import{excludeTables as c}from"../../core/accessorSupport/layerContainerType.js";import m from"../../form/FormTemplate.js";import h from"../../geometry/SpatialReference.js";import g from"../../graphic/SubtypeGroupGraphicOrigin.js";import{labelsVisible as b,legendEnabled as j,minScale as v,maxScale as w,popupEnabled as F}from"./commonProperties.js";import{createQuery as T,computeDomainFromSubtypes as O}from"./featureLayerUtils.js";import C from"./FeatureTemplate.js";import I from"./FieldConfiguration.js";import{popupTemplateWithFieldConfigurations as S,fieldConfigurationsFromPopupTemplate as A,fieldConfigurationsFromFields as E}from"./fieldConfigUtils.js";import{defineFieldProperties as q}from"./fieldProperties.js";import{fixRendererFields as _}from"./fieldUtils.js";import x from"./LabelClass.js";import{reader as P}from"./labelingInfo.js";import{rendererReader as R,supportedRendererTypes as L}from"./subtypeGroupLayerUtils.js";import D from"./TitleCreator.js";import G from"../../renderers/SimpleRenderer.js";import N from"../../rest/support/AttachmentQuery.js";import U from"../../rest/support/Query.js";import{createPopupTemplate as $}from"../../support/popupUtils.js";import{defaultPolygonSymbol2D as V,defaultPolylineSymbol2D as M,defaultPointSymbol2D as Q}from"../../symbols/support/defaults.js";import k from"../../tables/AttributeTableTemplate.js";import{writer as B}from"../../core/accessorSupport/decorators/writer.js";import{reader as H}from"../../core/accessorSupport/decorators/reader.js";const J=q();let W=0;function z(e,t){let r=e.json.write;return"object"!=typeof r&&(r=e.json.write={}),r.ignoreOrigin=!0,t?.spatialOnly&&(r.layerContainerTypes=c),e}function K(e){const t={write:{ignoreOrigin:!0}};return e?.name&&(t.name=e.name),"object"==typeof t.write&&(e?.spatialOnly&&(t.write.layerContainerTypes=c),e?.target&&(t.write.target=e.target)),t}function X(e){return new G({symbol:Y(e)})}function Y(e){switch(e){case"point":case"multipoint":return Q.clone();case"polyline":return M.clone();case"polygon":case"multipatch":return V.clone();default:return null}}function Z(e,t){return!!t&&("unique-value"===e?.type&&null!=e.field&&e.field.toLowerCase()===t.toLowerCase()&&!e.field2&&!e.field3&&!e.valueExpression)}function ee(e){return ie(e,"user")===e}function te(e){return ie(e,"service")}function re(e){return ie(e,"portal-item")}function ie(e,t){const r=e.parent?.getAtOrigin("sublayers",t);return r?.find(({subtypeCode:t})=>t===e.subtypeCode)}function ne(e,t){return null==e?null:t.subtypes?.find(t=>t.code===e)}function oe(e,t){let r=null;switch(t.geometryType){case"esriGeometryPoint":case"esriGeometryMultipoint":r="point";break;case"esriGeometryPolyline":r="line";break;case"esriGeometryPolygon":case"esriGeometryMultiPatch":r="polygon";break;default:t.type,r=null}const i={},n=ne(e,t);if(null!=n){const{defaultValues:e}=n;for(const t in e)i[t]=e[t]}return i[t.subtypeField]=e,new C({name:"New Feature",drawingTool:r,prototype:{attributes:i}})}let se=class extends(p(r(n(s)))){constructor(e){super(e),this.attributeTableTemplate=null,this.charts=null,this.editingEnabled=!0,this.fieldOverrides=null,this.fieldsIndex=null,this.formTemplate=null,this.graphicOrigin=new g(this),this.id=`${Date.now().toString(16)}-subtype-sublayer-${W++}`,this.type="subtype-sublayer",this.labelsVisible=!0,this.labelingInfo=null,this.layerType="ArcGISFeatureLayer",this.legendEnabled=!0,this.listMode="show",this.minScale=0,this.maxScale=0,this.opacity=1,this.parent=null,this.popupEnabled=!0,this.popupTemplate=null,this.subtypeCode=null,this.visible=!0}load(e){return _(this.renderer,this.fieldsIndex),Promise.resolve(this)}get _titleCreator(){const e=this._get("_titleCreator");return a(e),new D({fieldsIndex:this.fieldsIndex,objectIdField:this.objectIdField,displayField:this.parent?.displayField??"",fields:this.fields,effectivePopupTemplate:this.popupTemplate??this.defaultPopupTemplate})}get capabilities(){return this.parent?.capabilities}get effectiveCapabilities(){return this.parent?.effectiveCapabilities}get effectiveEditingEnabled(){const{parent:e}=this;return e?e.effectiveEditingEnabled&&this.editingEnabled:this.editingEnabled}get elevationInfo(){return this.parent?.elevationInfo}get featureTitleFields(){return[...this._titleCreator.requiredFields]}set fieldConfigurations(e){if(this._override("fieldConfigurations",e),!this.parent?.loaded)return;const t=S(this,e);t&&this._set("popupTemplate",t)}get fieldConfigurations(){return this._isOverridden("fieldConfigurations")?this._get("fieldConfigurations"):A(this)||null}writeFieldOverrides(e,t,r){const{fields:i,parent:n}=this;let s;if(i){s=[];let e=0;i.forEach(({name:t,alias:r,editable:i,visible:o})=>{if(!o)return;const l=n?.fields?.find(e=>e.name===t);if(!l)return;const a={name:t};let p=!1;r!==l.alias&&(a.alias=r,p=!0),i!==l.editable&&(a.editable=i,p=!0),s.push(a),p&&e++}),0===e&&s.length===i.length&&(s=null)}else s=o(e);s?.length&&d(r,s,t)}get fields(){const{parent:e,fieldOverrides:t,subtypeCode:r}=this,i=e?.fields;if(!e||!i?.length)return null;const{subtypes:n,subtypeField:o}=e,s=n?.find(e=>e.code===r),l=s?.defaultValues,a=s?.domains,p=[];for(const d of i){const e=d.clone(),{name:i}=e,n=t?.find(e=>e.name===i);if(e.visible=!t?.length||!!n,n){const{alias:t,editable:r}=n;t&&(e.alias=t),!1===r&&(e.editable=!1)}const s=l?.[i]??null;e.defaultValue=i===o?r:s;const u=a?.[i]??null;e.domain=i===o?null:u?"inherited"===u.type?e.domain:u.clone():null,p.push(e)}return p}get floorInfo(){return this.parent?.floorInfo}get isTable(){return!!this.parent?.isTable}get geometryType(){return this.parent?.geometryType}get globalIdField(){return this.parent?this.parent.globalIdField:(l.getLogger(this).error(pe("globalIdField")),null)}get effectiveScaleRange(){const{minScale:e,maxScale:t}=this;return{minScale:e,maxScale:t}}get objectIdField(){return this.parent||l.getLogger(this).error(pe("objectIdField")),this.parent?.objectIdField}writePopupTemplate(e,t,r,i){e&&(t[r]=e.toJSON({...i,writeFieldFormat:!0}))}get defaultPopupTemplate(){return this.createPopupTemplate()}get relationships(){return this.parent?.relationships}set renderer(e){_(e,this.fieldsIndex),this._override("renderer",e)}get renderer(){if(this._isOverridden("renderer"))return this._get("renderer");const{parent:e}=this;return e&&!e.isTable&&"mesh"!==e.geometryType?(ee(this)?o(te(this)?.renderer):null)??X(e.geometryType):null}readRendererFromService(e,t,r){if("Table"===t.type)return null;const i=t.drawingInfo?.renderer,n=R(i,t,r);let o;const{subtypeCode:s}=this;if(null!=s&&Z(n,t.subtypeField)){const e=n.uniqueValueInfos?.find(({value:e})=>(e="number"==typeof e?String(e):e)===String(s));e&&(o=new G({symbol:e.symbol}))}else"simple"!==n?.type||n.visualVariables?.length||(o=n);return o}readRenderer(e,t,r){const i=t?.layerDefinition?.drawingInfo?.renderer;if(i)return R(i,t,r)||void 0}get spatialReference(){return this.parent?.spatialReference??h.WGS84}get subtypeField(){return this.parent?.subtypeField}get templates(){return this._isOverridden("templates")?this._get("templates"):o(ee(this)?te(this)?.templates:re(this)?.templates||te(this)?.templates)}set templates(e){this._override("templates",e)}readTemplatesFromService(e,t){return[oe(this.subtypeCode,t)]}get title(){if(this._isOverridden("title"))return this._get("title");const e=ee(this)?te(this):null;return e?.title}set title(e){this._override("title",e)}readTitleFromService(e,t){const r=ne(this.subtypeCode,t);return null!=r?r.name:null}get url(){return this.parent?.url}get userHasUpdateItemPrivileges(){return!!this.parent?.userHasUpdateItemPrivileges}async addAttachment(e,t,r){const{parent:n}=this;if(!n)throw pe("addAttachment");if(e.getAttribute(n.subtypeField)!==this.subtypeCode)throw new i("subtype-sublayer:addAttachment","The feature provided does not belong to this SubtypeSublayer");return n.addAttachment(e,t,r)}async updateAttachment(e,t,r,n){const{parent:o}=this;if(!o)throw pe("updateAttachment");if(e.getAttribute(o.subtypeField)!==this.subtypeCode)throw new i("subtype-sublayer:updateAttachment","The feature provided does not belong to this SubtypeSublayer");return o.updateAttachment(e,t,r,n)}async deleteAttachments(e,t,r){const{parent:n}=this;if(!n)throw pe("deleteAttachments");if(e.getAttribute(n.subtypeField)!==this.subtypeCode)throw new i("subtype-sublayer:deleteAttachments","The feature provided does not belong to this SubtypeSublayer");return n.deleteAttachments(e,t,r)}async applyEdits(e,t){if(!this.parent)throw pe("applyEdits");return this.parent.applyEdits(e,t)}createFieldConfigurations(){return E(this)}createPopupTemplate(e){let t=this;const{parent:r,fields:i,title:n}=this;if(r){const{displayField:e,editFieldsInfo:o,objectIdField:s}=r;t={displayField:e,editFieldsInfo:o,fields:i,objectIdField:s,title:n}}return $(t,e)}createQuery(){if(!this.parent)throw pe("createQuery");const e=T(this.parent),t=`${this.parent.subtypeField}=${this.subtypeCode}`;return e.where=u(t,this.parent.definitionExpression),e}getFeatureTitle(e,t){return this._titleCreator.getTitle(this,e,t)}getFeatureTitles(e,t){return this._titleCreator.getTitles(this,e,t)}getField(e){return this.fieldsIndex.get(e)}getFieldAlias(e){const t=this.getField(e);if(t)return this.getFieldConfiguration(t.name)?.alias||t.alias}getFieldConfiguration(e){return e=e.toLowerCase(),this.fieldConfigurations?.find(t=>t.name.toLowerCase()===e)}getFieldDomain(e,t){if(!t?.excludeImpliedDomains&&this.parent){const t=O(this.parent,e);if(t)return t}return this._getLayerDomain(e)}async queryAttachments(e,t){const r=await this.load();if(!r.parent)throw pe("queryAttachments");const i=e instanceof N?e.clone():new N(e);return i.where=ae(i.where,r.parent.subtypeField,r.subtypeCode),r.parent.queryAttachments(i,t)}async queryFeatureCount(e,t){const r=await this.load();if(!r.parent)throw pe("queryFeatureCount");return r.parent.queryFeatureCount(le(r.parent,r,e),t)}async queryFeatures(e,t){const r=await this.load();if(!r.parent)throw pe("queryFeatures");return r.parent.queryFeatures(le(r.parent,r,e),t)}async queryObjectIds(e,t){const r=await this.load();if(!r.parent)throw pe("queryObjectIds");return r.parent.queryObjectIds(le(r.parent,r,e),t)}async queryRelatedFeatures(e,t){const r=await this.load();if(!r.parent)throw pe("queryRelatedFeatures");return r.parent.queryRelatedFeatures(e,t)}async queryRelatedFeaturesCount(e,t){const r=await this.load();if(!r.parent)throw pe("queryRelatedFeaturesCount");return r.parent.queryRelatedFeaturesCount(e,t)}_getLayerDomain(e){const t=this.fieldsIndex.get(e);return t?t.domain:null}};e([y({clonable:!1,readOnly:!0})],se.prototype,"_titleCreator",null),e([y({type:k,json:K({name:"attributeTableInfo"})})],se.prototype,"attributeTableTemplate",void 0),e([y({readOnly:!0,json:{read:!1}})],se.prototype,"capabilities",null),e([y({readOnly:!0,json:{read:!1}})],se.prototype,"effectiveCapabilities",null),e([y({json:K()})],se.prototype,"charts",void 0),e([y({type:Boolean,nonNullable:!0,json:K({name:"enableEditing"})})],se.prototype,"editingEnabled",void 0),e([y({type:Boolean,readOnly:!0})],se.prototype,"effectiveEditingEnabled",null),e([y({readOnly:!0,json:{read:!1}})],se.prototype,"elevationInfo",null),e([y({clonable:!1,readOnly:!0})],se.prototype,"featureTitleFields",null),e([y({type:[I],json:{name:"layerDefinition.fieldConfigurations",write:{ignoreOrigin:!0}}})],se.prototype,"fieldConfigurations",null),e([y({json:{name:"layerDefinition.fieldOverrides",origins:{service:{read:!1}},write:{ignoreOrigin:!0,allowNull:!0}}})],se.prototype,"fieldOverrides",void 0),e([B("fieldOverrides")],se.prototype,"writeFieldOverrides",null),e([y({...J.fields,readOnly:!0,json:{read:!1}})],se.prototype,"fields",null),e([y(J.fieldsIndex)],se.prototype,"fieldsIndex",void 0),e([y({readOnly:!0,json:{read:!1}})],se.prototype,"floorInfo",null),e([y({type:m,json:K({name:"formInfo"})})],se.prototype,"formTemplate",void 0),e([y({readOnly:!0,clonable:!1})],se.prototype,"graphicOrigin",void 0),e([y({type:String,clonable:!1,json:{origins:{service:{read:!1},"portal-item":{read:!1}},write:{ignoreOrigin:!0}}})],se.prototype,"id",void 0),e([y({readOnly:!0,json:{read:!1}})],se.prototype,"isTable",null),e([y({readOnly:!0,json:{read:!1}})],se.prototype,"geometryType",null),e([y({readOnly:!0,json:{read:!1}})],se.prototype,"globalIdField",null),e([y({readOnly:!0,json:{read:!1}})],se.prototype,"type",void 0),e([y(z(o(b)))],se.prototype,"labelsVisible",void 0),e([y({type:[x],json:{name:"layerDefinition.drawingInfo.labelingInfo",origins:{service:{read:!1}},read:{reader:P},write:{ignoreOrigin:!0,layerContainerTypes:c}}})],se.prototype,"labelingInfo",void 0),e([y({type:["ArcGISFeatureLayer"],readOnly:!0,json:{read:!1,write:{ignoreOrigin:!0,layerContainerTypes:c}}})],se.prototype,"layerType",void 0),e([y(z(o(j)))],se.prototype,"legendEnabled",void 0),e([y({type:["show","hide"]})],se.prototype,"listMode",void 0),e([y((()=>{const e=o(v);return e.json.origins.service.read=!1,z(e,{spatialOnly:!0})})())],se.prototype,"minScale",void 0),e([y((()=>{const e=o(w);return e.json.origins.service.read=!1,z(e,{spatialOnly:!0})})())],se.prototype,"maxScale",void 0),e([y({readOnly:!0})],se.prototype,"effectiveScaleRange",null),e([y({readOnly:!0,json:{read:!1}})],se.prototype,"objectIdField",null),e([y({type:Number,range:{min:0,max:1},nonNullable:!0,json:K({spatialOnly:!0})})],se.prototype,"opacity",void 0),e([y({clonable:!1})],se.prototype,"parent",void 0),e([y(z(o(F)))],se.prototype,"popupEnabled",void 0),e([y({type:t,json:K({name:"popupInfo"})})],se.prototype,"popupTemplate",void 0),e([B("popupTemplate")],se.prototype,"writePopupTemplate",null),e([y({readOnly:!0})],se.prototype,"defaultPopupTemplate",null),e([y({readOnly:!0,json:{read:!1}})],se.prototype,"relationships",null),e([y({types:L,json:K({target:"layerDefinition.drawingInfo.renderer",spatialOnly:!0})})],se.prototype,"renderer",null),e([H("service","renderer",["drawingInfo.renderer","subtypeField","type"])],se.prototype,"readRendererFromService",null),e([H("renderer",["layerDefinition.drawingInfo.renderer"])],se.prototype,"readRenderer",null),e([y({readOnly:!0,json:{read:!1}})],se.prototype,"spatialReference",null),e([y({type:Number,json:{origins:{service:{read:!1}},write:{ignoreOrigin:!0}}})],se.prototype,"subtypeCode",void 0),e([y({readOnly:!0,json:{read:!1}})],se.prototype,"subtypeField",null),e([y({type:[C],json:K({name:"layerDefinition.templates"})})],se.prototype,"templates",null),e([H("service","templates",["geometryType","subtypeField","subtypes","type"])],se.prototype,"readTemplatesFromService",null),e([y({type:String,json:K()})],se.prototype,"title",null),e([H("service","title",["subtypes"])],se.prototype,"readTitleFromService",null),e([y({readOnly:!0,json:{read:!1}})],se.prototype,"url",null),e([y({readOnly:!0})],se.prototype,"userHasUpdateItemPrivileges",null),e([y({type:Boolean,nonNullable:!0,json:K({name:"visibility",spatialOnly:!0})})],se.prototype,"visible",void 0),se=e([f("esri.layers.support.SubtypeSublayer")],se);const le=(e,t,r)=>{if(!r)return t.createQuery();const i=U.from(r);return i.where=ae(i.where,e.subtypeField,t.subtypeCode),i},ae=(e,t,r)=>{const i=new RegExp(`${t}\\s*=\\s*\\d+`),n=`${t}=${r}`,o=e??"";return i.test(o)?o.replace(i,n):u(n,o)},pe=e=>new i("subtype-sublayer:parent-missing",`This sublayer must have a parent SubtypeGroupLayer in order to use ${e}`);export{se as default};

package/layers/support/featureLayerUtils.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{id as e}from"../../kernel.js";import{isPopupTemplate as t}from"../../popupTemplateUtils.js";import{resultOrAbort as r}from"../../core/asyncUtils.js";import n from"../../core/Error.js";import{JSONMap as o}from"../../core/jsonMap.js";import i from"../../core/Logger.js";import{parseWhereClause as s}from"../../core/sql.js";import{normalizeGlobalID as a}from"../../core/uuid.js";import{createTypeReader as u}from"../../core/accessorSupport/extensions/serializableProperty/reader.js";import{isHostedAgolService as l}from"./arcgisLayerUrl.js";import c from"./CodedValue.js";import p from"./CodedValueDomain.js";import{queryAllJSON as d}from"./featureQueryAll.js";import{isStringField as f,isIntegerField as y}from"./fieldUtils.js";import{isLabelClass as m}from"./labelUtils.js";import{isLayerWithFeatureCapabilities as b,getOwningPortalUrl as h}from"./layerUtils.js";import w from"../../renderers/SimpleRenderer.js";import g from"../../renderers/UniqueValueRenderer.js";import{isSizeVariable as I}from"../../renderers/visualVariables/support/sizeVariableUtils.js";import j from"../../rest/support/AttachmentQuery.js";import{normalizationTypeJsonMap as x}from"../../rest/support/NormalizationBinParametersMixin.js";import v from"../../rest/support/Query.js";import F from"../../rest/support/RelationshipQuery.js";import{loadArcade as S}from"../../support/loadArcade.js";import{symbolTypesRenderer as P}from"../../symbols/support/typeUtils.js";const L=()=>i.getLogger("esri.layers.support.featureLayerUtils"),q=new o({esriGeometryPoint:"point",esriGeometryMultipoint:"multipoint",esriGeometryPolyline:"polyline",esriGeometryPolygon:"polygon",esriGeometryMultiPatch:"multipatch"});async function A(e,t,r,o){const i=await Y(e);if(await E(e,t,o),!i.addAttachment)throw new n(o,"Layer source does not support addAttachment capability");return i.addAttachment(t,r)}function E(e,t,r){const{attributes:o}=t,{objectIdField:i}=e;return e.capabilities?.data?.supportsAttachment?t?o?i&&o[i]?Promise.resolve():Promise.reject(new n(r,`feature is missing the identifying attribute ${i}`)):Promise.reject(new n(r,"'attributes' are required on a feature to query attachments")):Promise.reject(new n(r,"A feature is required to add/delete/update attachments")):Promise.reject(new n(r,"this layer doesn't support attachments"))}async function M(e,t,r,o,i){const s=await Y(e);if(await E(e,t,i),!s.updateAttachment)throw new n(i,"Layer source does not support updateAttachment capability");return s.updateAttachment(t,r,o)}async function O(e,t,r){const{applyEdits:n}=await import("../graphics/editingSupport.js"),o=await e.load();let i=r;const{url:s,type:a,globalIdField:u}=o;return"feature"===a&&l(s)&&o.infoFor3D&&null!=t.deleteFeatures&&null!=u&&(i={...i,globalIdToObjectId:await pe(o,t.deleteFeatures,u)}),n(o,o.source,t,i)}async function C(e,t,r){const{uploadAssets:n}=await import("../graphics/editingSupport.js"),o=await e.load();return n(o,o.source,t,r)}async function D(e,t,r,o){const i=await Y(e);if(await E(e,t,o),!i.deleteAttachments)throw new n(o,"Layer source does not support deleteAttachments capability");return i.deleteAttachments(t,r)}async function T(e,t,r){const o=(await e.load({signal:t?.signal})).source;if(!o.fetchRecomputedExtents)throw new n(r,"Layer source does not support fetchUpdates capability");return o.fetchRecomputedExtents(t)}async function z(e,t,r,o){let i=j.from(t);const s=await e.load(),a=s.source,u=s.capabilities;if(!u?.data?.supportsAttachment)throw new n(o,"this layer doesn't support attachments");const{attachmentTypes:l,objectIds:c,globalIds:p,num:d,size:f,start:y,where:m}=i;if(!u?.operations?.supportsQueryAttachments){if(l?.length>0||p?.length>0||f?.length>0||d||y||m)throw new n(o,"when 'capabilities.operations.supportsQueryAttachments' is false, only objectIds is supported",i)}if(!(c?.length||p?.length||m))throw new n(o,"'objectIds', 'globalIds', or 'where' are required to perform attachment query",i);if(!a.queryAttachments)throw new n(o,"Layer source does not support queryAttachments capability",i);return!u?.attachment?.supportsOrderByFields&&i.orderByFields?.length&&(i=i.clone(),i.orderByFields=null),a.queryAttachments(i)}async function U(e,t,r,o){const i=await Y(e);if(!i.queryObjectIds)throw new n(o,"Layer source does not support queryObjectIds capability");return i.queryObjectIds(v.from(t)??e.createQuery(),r)}async function k(e,t,r,o){const i=await Y(e);if(!i.queryFeatureCount)throw new n(o,"Layer source does not support queryFeatureCount capability");return i.queryFeatureCount(v.from(t)??e.createQuery(),r)}async function B(e,t,r,o){const i=await Y(e);if(!i.queryExtent)throw new n(o,"Layer source does not support queryExtent capability");return i.queryExtent(v.from(t)??e.createQuery(),r)}async function V(e,t,r,o){const i=await Y(e);if(!i.queryRelatedFeatures)throw new n(o,"Layer source does not support queryRelatedFeatures capability");return i.queryRelatedFeatures(F.from(t),r)}async function R(e,t,r,o){const i=await Y(e);if(!i.queryRelatedFeaturesCount)throw new n(o,"Layer source does not support queryRelatedFeaturesCount capability");return i.queryRelatedFeaturesCount(F.from(t),r)}async function N(e){const t=e.source;if(t?.refresh)try{const{dataChanged:r,updates:n}=await t.refresh();if(null!=n&&(e.sourceJSON={...e.sourceJSON,...n},e.read(n,{origin:"service",url:e.parsedUrl})),r)return!0}catch{}if(e.definitionExpression)try{return(await s(e.definitionExpression,e.fieldsIndex)).hasDateFunctions}catch{}return!1}function G(e){const t=new v;t.historicMoment=e.historicMoment,t.gdbVersion=e.gdbVersion,t.returnGeometry=!0,t.outFields=["*"],t.multipatchOption="multipatch"===e.geometryType?"xyFootprint":null;const r=e.capabilities?.query;r&&(t.compactGeometryEnabled=r.supportsCompactGeometry,t.defaultSpatialReferenceEnabled=r.supportsDefaultSpatialReference);const n=e.capabilities?.data;n?.supportsZ&&null!=e.returnZ&&(t.returnZ=e.returnZ),n?.supportsM&&null!=e.returnM&&(t.returnM=e.returnM);const{timeOffset:o,timeExtent:i}=e;return t.timeExtent=null!=o&&null!=i?i.offset(-o.value,o.unit):i||null,t}function Q(e){const{globalIdField:t,fields:r}=e;if(t)return t;if(r)for(const n of r)if("esriFieldTypeGlobalID"===n.type)return n.name}function Z(e){const{objectIdField:t,fields:r}=e;if(t)return t;if(r)for(const n of r)if("esriFieldTypeOID"===n.type)return n.name}function $(e){return e.currentVersion?e.currentVersion:e.hasOwnProperty("capabilities")||e.hasOwnProperty("drawingInfo")||e.hasOwnProperty("hasAttachments")||e.hasOwnProperty("htmlPopupType")||e.hasOwnProperty("relationships")||e.hasOwnProperty("timeInfo")||e.hasOwnProperty("typeIdField")||e.hasOwnProperty("types")?10:9.3}function J(e,t,r,n){const o=r?.feature,i=!!e.subtypes?.length;if(i&&!r?.excludeImpliedDomains){const r=W(e,t);if(r)return r}const s=i&&H(e,o);if(s){const e=s?.domains?.[t];return"inherited"===e?.type?n:e}const a=de(e.types,e.typeIdField,o);if(a){const e=a.domains&&a.domains[t];if(e&&"inherited"!==e?.type)return e}if(n)return n;if(!r?.excludeImpliedDomains){const r=_(e,t);if(r)return r}return null}function H(e,t){const{subtypes:r,subtypeField:n}=e;if(!t?.attributes||!r?.length||!n)return null;const o=t.attributes[n];return null==o?null:r.find(e=>e.code===o)}function W(e,t){const{fieldsIndex:r,subtypeField:n}=e,{name:o,type:i}=r.get(t)??{};if(!o)return null;if((n&&r.get(n)?.name)===o&&e.subtypes?.length){const t=e.subtypes.map(e=>new c({code:X(e.code,i),name:e.name}));if(t?.length)return new p({codedValues:t})}return null}function _(e,t){const{fieldsIndex:r}=e,{name:n,type:o}=r.get(t)??{};if(!n)return null;if(("typeIdField"in e?r.get(e.typeIdField)?.name:null)===n&&"types"in e&&e.types?.length&&K(e.types)){const t=e.types?.map(e=>new c({code:X(e.id,o),name:e.name}));return new p({codedValues:t})}return null}function K(e){const t=new Set,r=new Set;for(const n of e){if(t.has(n.id)||r.has(n.name))return!1;t.add(n.id),r.add(n.name)}return!0}function X(e,t){return t?f({type:t})&&"number"==typeof e?`${e}`:y({type:t})&&"string"==typeof e?Number.parseInt(e,10):e:e}async function Y(e){return(await e.load()).source}async function ee(t,r){if(!e)return;const n=e.findCredential(t);if(n)return n.userId;let o;try{const n=await h(t,r);n&&(o=await e.checkSignInStatus(`${n}/sharing`))}catch(i){}return o?o.userId:null}async function te(t,r){if(!e)return;if(e.findCredential(t))return;let n;try{const o=await h(t,r);o&&(n=await e.checkSignInStatus(`${o}/sharing`))}catch(o){}if(n)try{const n=null!=r?r.signal:null;await e.getCredential(t,{signal:n})}catch(o){}}async function re(e,t,r){const n=e.parsedUrl?.path;n&&e.authenticationTriggerEvent===t&&await te(n,r)}async function ne(e){const t=e.parsedUrl?.path;t&&oe(e)&&await te(t)}function oe(e){return ie(e)&&("serviceDefinitionExpression"in e&&se(e.serviceDefinitionExpression)||"definitionExpression"in e&&se(e.definitionExpression))}function ie(e){return!(!b(e)||!e.capabilities?.query.supportsCurrentUser)}function se(e){return!!e?.toLowerCase().includes("current_user")}function ae(e){return!fe(e)&&(e.userHasUpdateItemPrivileges||e.editingEnabled)}const ue=u({types:P});function le(e,t){if(e.defaultSymbol)return e.types?.length?new g({defaultSymbol:ue(e.defaultSymbol,e,t),field:e.typeIdField,uniqueValueInfos:e.types.map(e=>({id:e.id,symbol:ue(e.symbol,e,t)}))}):new w({symbol:ue(e.defaultSymbol,e,t)})}function ce(e){let t=e.sourceJSON?.cacheMaxAge;if(!t)return!1;const r=e.editingInfo?.lastEditDate?.getTime();return null==r||(t*=1e3,Date.now()-r<t)}async function pe(e,t,n){if(null==t)return null;const o=[],{objectIdField:i}=e;if(t.forEach(e=>{let t=null;if("attributes"in e){const{attributes:r}=e;t={globalId:r[n],objectId:null!=r[i]&&-1!==r[i]?r[i]:null}}else t={globalId:e.globalId,objectId:null!=e.objectId&&-1!==e.objectId?e.objectId:null};null!=t.globalId&&(null!=t.objectId&&-1!==t.objectId||o.push(t.globalId))}),0===o.length)return null;const s=e.createQuery();s.where=o.map(e=>`${n}='${e}'`).join(" OR "),s.returnGeometry=!1,s.outFields=[i,n],s.cacheHint=!1;const u=await r(d(e,s));if(!u.ok)return null;const l=new Map,c=u.value.features;for(const r of c){const e=r.attributes[n],t=r.attributes[i];null!=e&&null!=t&&-1!==t&&l.set(a(e),t)}return l}function de(e,t,r){if(!t||!r||!e)return null;const n=r.getAttribute(t);if(null==n)return null;const o=e.filter(e=>{const{id:t}=e;return null!=t&&t.toString()===n.toString()});return o.length>1&&L().warn("getFeatureType",`Cannot unambiguously determine feature type because multiple types have the id ${n}.`),o[0]??null}function fe(e){return e.sourceJSON?.isMultiServicesView||ye(e)}function ye(e){return!!e.sourceJSON?.capabilities?.toLowerCase().split(",").map(e=>e.trim()).includes("map")}function me(e,t,r){const o=t?.queryAttributeBins;if(!t?.operations?.supportsQueryBins||!o)throw new n(r,"Layer source does not support binning");switch(e.binParameters?.type){case"auto-interval":if(!o.supportsAutoInterval)throw new n(r,"Layer source does not support auto-interval binning");if(e.binParameters.normalizationType&&(!o.supportsNormalization||!be(e.binParameters.normalizationType,o.supportedNormalizationTypes)))throw new n(r,"Layer source does not support normalization binning");break;case"date":if(!o.supportsDate)throw new n(r,"Layer source does not support date binning");if(e.binParameters.snapToData&&!o.supportsSnapToData)throw new n(r,"Layer source does not support snapToData binning");if(e.binParameters.returnFullIntervalBin&&!o.supportsReturnFullIntervalBin)throw new n(r,"Layer source does not support returnFullIntervalBin binning");break;case"fixed-boundaries":if(!o.supportsFixedBoundaries)throw new n(r,"Layer source does not support fixed-boundaries binning");break;case"fixed-interval":if(!o.supportsFixedInterval)throw new n(r,"Layer source does not support fixed-interval binning");if(e.binParameters.normalizationType&&(!o.supportsNormalization||!be(e.binParameters.normalizationType,o.supportedNormalizationTypes)))throw new n(r,"Layer source does not support normalization binning")}if(e.binParameters?.stackBy&&!o.supportsStackBy)throw new n(r,"Layer source does not support stackBy binning");if(e.binParameters?.splitBy&&!o.supportsSplitBy)throw new n(r,"Layer source does not support splitBy binning");if(e.binParameters?.firstDayOfWeek&&!o.supportsFirstDayOfWeek)throw new n(r,"Layer source does not support firstDayOfWeek binning");const i=o?.supportedStatistics;if(e.outStatistics&&i){const t=new Map([["count","count"],["sum","sum"],["min","min"],["max","max"],["avg","avg"],["stddev","stddev"],["var","var"],["percentile-continuous","percentileContinuous"],["percentile-discrete","percentileDiscrete"],["centroid-aggregate","centroid"],["convex-hull-aggregate","convexHull"],["envelope-aggregate","envelope"]]);for(const{statisticType:o}of e.outStatistics){const e=t.get(o);if(e&&!i[e])throw new n(r,`Layer source does not support ${o} statistic type`)}}}function be(e,t){return null!=e&&!!t?.[x.toJSON(e)]}function he(e){return m(e)?Boolean(e.labelExpressionInfo?.expression):t(e)?!!e.expressionInfos?.some(e=>e.expression)||!!Array.isArray(e.content)&&e.content.some(e=>"expression"===e.type&&e.expressionInfo?.expression):!("dot-density"!==e.type||!e.attributes?.some(e=>e.valueExpression))||(!(!("valueExpression"in e)||!e.valueExpression)||"visualVariables"in e&&null!=e.visualVariables&&e.visualVariables.some(e=>!!e.valueExpression||"size"===e.type&&(I(e.minSize)&&e.minSize.valueExpression||I(e.maxSize)&&e.maxSize.valueExpression)))}function we(e){if("renderer"in e&&e.renderer&&he(e.renderer))return!0;if("labelingInfo"in e&&e.labelingInfo)for(const t of e.labelingInfo)if(m(t)&&he(t))return!0;return!1}async function ge(e){let t="returnZ"in e?e.returnZ:void 0,r="returnM"in e?e.returnM:void 0;if(null!=t&&null!=r)return{returnZ:t,returnM:r};if(we(e)){const{arcadeUtils:n}=await S();n.layerHasGeometryFunctions(e)&&(t??=!0,r??=!0)}if("renderer"in e&&e.renderer?.symbols)for(const n of e.renderer.symbols)"cim"===n.type&&(Ie??=(await import("../../symbols/cim/CIMSymbolHelper.js")).forEachSymbolLayer,Ie(n.data.symbol,e=>{switch(e.type){case"CIMPictureMarker":case"CIMVectorMarker":if("CIMMarkerPlacementAtMeasuredUnits"===e.markerPlacement?.type)r??=!0}}));return{returnZ:t,returnM:r}}let Ie;export{A as addAttachment,O as applyEdits,ne as checkServiceCurrentUserSupport,W as computeDomainFromSubtypes,_ as computeDomainFromTypes,ae as computeEffectiveEditingEnabled,le as createDefaultRenderer,G as createQuery,D as deleteAttachments,te as ensureCredentialIfSignedIn,re as ensureLayerCredential,T as fetchRecomputedExtents,q as geometryTypeKebabDict,H as getFeatureSubtype,de as getFeatureType,J as getFieldDomain,pe as getGlobalIdToObjectIdMap,ee as getSignedInUser,se as hasCurrentUser,N as hasDataChanged,ce as isLayerCacheStale,ge as layerRequiresGeometryZM,z as queryAttachments,B as queryExtent,k as queryFeatureCount,U as queryObjectIds,V as queryRelatedFeatures,R as queryRelatedFeaturesCount,Q as readGlobalIdField,Z as readObjectIdField,$ as readVersion,fe as supportsQueryOnly,K as typesHaveUniqueIdsAndNames,M as updateAttachment,C as uploadAssets,me as validateBinsQuery};
+import{id as e}from"../../kernel.js";import{isPopupTemplate as t}from"../../popupTemplateUtils.js";import{resultOrAbort as r}from"../../core/asyncUtils.js";import n from"../../core/Error.js";import{JSONMap as o}from"../../core/jsonMap.js";import i from"../../core/Logger.js";import{parseWhereClause as s}from"../../core/sql.js";import{normalizeGlobalID as a}from"../../core/uuid.js";import{createTypeReader as u}from"../../core/accessorSupport/extensions/serializableProperty/reader.js";import{isHostedAgolService as l}from"./arcgisLayerUrl.js";import c from"./CodedValue.js";import p from"./CodedValueDomain.js";import{queryAllJSON as d}from"./featureQueryAll.js";import{isStringField as f,isIntegerField as y}from"./fieldUtils.js";import{isLabelClass as m}from"./labelUtils.js";import{isLayerWithFeatureCapabilities as b,getOwningPortalUrl as h}from"./layerUtils.js";import w from"../../renderers/SimpleRenderer.js";import g from"../../renderers/UniqueValueRenderer.js";import{isSizeVariable as I}from"../../renderers/visualVariables/support/sizeVariableUtils.js";import j from"../../rest/support/AttachmentQuery.js";import{normalizationTypeJsonMap as x}from"../../rest/support/NormalizationBinParametersMixin.js";import v from"../../rest/support/Query.js";import F from"../../rest/support/RelationshipQuery.js";import{loadArcade as S}from"../../support/loadArcade.js";import{symbolTypesRenderer as P}from"../../symbols/support/typeUtils.js";const L=()=>i.getLogger("esri.layers.support.featureLayerUtils"),q=new o({esriGeometryPoint:"point",esriGeometryMultipoint:"multipoint",esriGeometryPolyline:"polyline",esriGeometryPolygon:"polygon",esriGeometryMultiPatch:"multipatch"});async function A(e,t,r,o,i){const s=await Y(e);if(await E(e,t,o),!s.addAttachment)throw new n(o,"Layer source does not support addAttachment capability");return s.addAttachment(t,r,i)}function E(e,t,r){const{attributes:o}=t,{objectIdField:i}=e;return e.capabilities?.data?.supportsAttachment?t?o?i&&null!=o[i]?Promise.resolve():Promise.reject(new n(r,`feature is missing the identifying attribute ${i}`)):Promise.reject(new n(r,"'attributes' are required on a feature to query attachments")):Promise.reject(new n(r,"A feature is required to add/delete/update attachments")):Promise.reject(new n(r,"this layer doesn't support attachments"))}async function M(e,t,r,o,i,s){const a=await Y(e);if(await E(e,t,i),!a.updateAttachment)throw new n(i,"Layer source does not support updateAttachment capability");return a.updateAttachment(t,r,o,s)}async function O(e,t,r){const{applyEdits:n}=await import("../graphics/editingSupport.js"),o=await e.load();let i=r;const{url:s,type:a,globalIdField:u}=o;return"feature"===a&&l(s)&&o.infoFor3D&&null!=t.deleteFeatures&&null!=u&&(i={...i,globalIdToObjectId:await pe(o,t.deleteFeatures,u)}),n(o,o.source,t,i)}async function C(e,t,r){const{uploadAssets:n}=await import("../graphics/editingSupport.js"),o=await e.load();return n(o,o.source,t,r)}async function D(e,t,r,o,i){const s=await Y(e);if(await E(e,t,o),!s.deleteAttachments)throw new n(o,"Layer source does not support deleteAttachments capability");return s.deleteAttachments(t,r,i)}async function T(e,t,r){const o=(await e.load({signal:t?.signal})).source;if(!o.fetchRecomputedExtents)throw new n(r,"Layer source does not support fetchUpdates capability");return o.fetchRecomputedExtents(t)}async function z(e,t,r,o){let i=j.from(t);const s=await e.load(),a=s.source,u=s.capabilities;if(!u?.data?.supportsAttachment)throw new n(o,"this layer doesn't support attachments");const{attachmentTypes:l,objectIds:c,globalIds:p,num:d,size:f,start:y,where:m}=i;if(!u?.operations?.supportsQueryAttachments){if(l?.length>0||p?.length>0||f?.length>0||d||y||m)throw new n(o,"when 'capabilities.operations.supportsQueryAttachments' is false, only objectIds is supported",i)}if(!(c?.length||p?.length||m))throw new n(o,"'objectIds', 'globalIds', or 'where' are required to perform attachment query",i);if(!a.queryAttachments)throw new n(o,"Layer source does not support queryAttachments capability",i);return!u?.attachment?.supportsOrderByFields&&i.orderByFields?.length&&(i=i.clone(),i.orderByFields=null),a.queryAttachments(i)}async function U(e,t,r,o){const i=await Y(e);if(!i.queryObjectIds)throw new n(o,"Layer source does not support queryObjectIds capability");return i.queryObjectIds(v.from(t)??e.createQuery(),r)}async function k(e,t,r,o){const i=await Y(e);if(!i.queryFeatureCount)throw new n(o,"Layer source does not support queryFeatureCount capability");return i.queryFeatureCount(v.from(t)??e.createQuery(),r)}async function B(e,t,r,o){const i=await Y(e);if(!i.queryExtent)throw new n(o,"Layer source does not support queryExtent capability");return i.queryExtent(v.from(t)??e.createQuery(),r)}async function V(e,t,r,o){const i=await Y(e);if(!i.queryRelatedFeatures)throw new n(o,"Layer source does not support queryRelatedFeatures capability");return i.queryRelatedFeatures(F.from(t),r)}async function R(e,t,r,o){const i=await Y(e);if(!i.queryRelatedFeaturesCount)throw new n(o,"Layer source does not support queryRelatedFeaturesCount capability");return i.queryRelatedFeaturesCount(F.from(t),r)}async function N(e){const t=e.source;if(t?.refresh)try{const{dataChanged:r,updates:n}=await t.refresh();if(null!=n&&(e.sourceJSON={...e.sourceJSON,...n},e.read(n,{origin:"service",url:e.parsedUrl})),r)return!0}catch{}if(e.definitionExpression)try{return(await s(e.definitionExpression,e.fieldsIndex)).hasDateFunctions}catch{}return!1}function G(e){const t=new v;t.historicMoment=e.historicMoment,t.gdbVersion=e.gdbVersion,t.returnGeometry=!0,t.outFields=["*"],t.multipatchOption="multipatch"===e.geometryType?"xyFootprint":null;const r=e.capabilities?.query;r&&(t.compactGeometryEnabled=r.supportsCompactGeometry,t.defaultSpatialReferenceEnabled=r.supportsDefaultSpatialReference);const n=e.capabilities?.data;n?.supportsZ&&null!=e.returnZ&&(t.returnZ=e.returnZ),n?.supportsM&&null!=e.returnM&&(t.returnM=e.returnM);const{timeOffset:o,timeExtent:i}=e;return t.timeExtent=null!=o&&null!=i?i.offset(-o.value,o.unit):i||null,t}function Q(e){const{globalIdField:t,fields:r}=e;if(t)return t;if(r)for(const n of r)if("esriFieldTypeGlobalID"===n.type)return n.name}function Z(e){const{objectIdField:t,fields:r}=e;if(t)return t;if(r)for(const n of r)if("esriFieldTypeOID"===n.type)return n.name}function $(e){return e.currentVersion?e.currentVersion:e.hasOwnProperty("capabilities")||e.hasOwnProperty("drawingInfo")||e.hasOwnProperty("hasAttachments")||e.hasOwnProperty("htmlPopupType")||e.hasOwnProperty("relationships")||e.hasOwnProperty("timeInfo")||e.hasOwnProperty("typeIdField")||e.hasOwnProperty("types")?10:9.3}function J(e,t,r,n){const o=r?.feature,i=!!e.subtypes?.length;if(i&&!r?.excludeImpliedDomains){const r=W(e,t);if(r)return r}const s=i&&H(e,o);if(s){const e=s?.domains?.[t];return"inherited"===e?.type?n:e}const a=de(e.types,e.typeIdField,o);if(a){const e=a.domains&&a.domains[t];if(e&&"inherited"!==e?.type)return e}if(n)return n;if(!r?.excludeImpliedDomains){const r=_(e,t);if(r)return r}return null}function H(e,t){const{subtypes:r,subtypeField:n}=e;if(!t?.attributes||!r?.length||!n)return null;const o=t.attributes[n];return null==o?null:r.find(e=>e.code===o)}function W(e,t){const{fieldsIndex:r,subtypeField:n}=e,{name:o,type:i}=r.get(t)??{};if(!o)return null;if((n&&r.get(n)?.name)===o&&e.subtypes?.length){const t=e.subtypes.map(e=>new c({code:X(e.code,i),name:e.name}));if(t?.length)return new p({codedValues:t})}return null}function _(e,t){const{fieldsIndex:r}=e,{name:n,type:o}=r.get(t)??{};if(!n)return null;if(("typeIdField"in e?r.get(e.typeIdField)?.name:null)===n&&"types"in e&&e.types?.length&&K(e.types)){const t=e.types?.map(e=>new c({code:X(e.id,o),name:e.name}));return new p({codedValues:t})}return null}function K(e){const t=new Set,r=new Set;for(const n of e){if(t.has(n.id)||r.has(n.name))return!1;t.add(n.id),r.add(n.name)}return!0}function X(e,t){return t?f({type:t})&&"number"==typeof e?`${e}`:y({type:t})&&"string"==typeof e?Number.parseInt(e,10):e:e}async function Y(e){return(await e.load()).source}async function ee(t,r){if(!e)return;const n=e.findCredential(t);if(n)return n.userId;let o;try{const n=await h(t,r);n&&(o=await e.checkSignInStatus(`${n}/sharing`))}catch(i){}return o?o.userId:null}async function te(t,r){if(!e)return;if(e.findCredential(t))return;let n;try{const o=await h(t,r);o&&(n=await e.checkSignInStatus(`${o}/sharing`))}catch(o){}if(n)try{const n=null!=r?r.signal:null;await e.getCredential(t,{signal:n})}catch(o){}}async function re(e,t,r){const n=e.parsedUrl?.path;n&&e.authenticationTriggerEvent===t&&await te(n,r)}async function ne(e){const t=e.parsedUrl?.path;t&&oe(e)&&await te(t)}function oe(e){return ie(e)&&("serviceDefinitionExpression"in e&&se(e.serviceDefinitionExpression)||"definitionExpression"in e&&se(e.definitionExpression))}function ie(e){return!(!b(e)||!e.capabilities?.query.supportsCurrentUser)}function se(e){return!!e?.toLowerCase().includes("current_user")}function ae(e){return!fe(e)&&(e.userHasUpdateItemPrivileges||e.editingEnabled)}const ue=u({types:P});function le(e,t){if(e.defaultSymbol)return e.types?.length?new g({defaultSymbol:ue(e.defaultSymbol,e,t),field:e.typeIdField,uniqueValueInfos:e.types.map(e=>({id:e.id,symbol:ue(e.symbol,e,t)}))}):new w({symbol:ue(e.defaultSymbol,e,t)})}function ce(e){let t=e.sourceJSON?.cacheMaxAge;if(!t)return!1;const r=e.editingInfo?.lastEditDate?.getTime();return null==r||(t*=1e3,Date.now()-r<t)}async function pe(e,t,n){if(null==t)return null;const o=[],{objectIdField:i}=e;if(t.forEach(e=>{let t=null;if("attributes"in e){const{attributes:r}=e;t={globalId:r[n],objectId:null!=r[i]&&-1!==r[i]?r[i]:null}}else t={globalId:e.globalId,objectId:null!=e.objectId&&-1!==e.objectId?e.objectId:null};null!=t.globalId&&(null!=t.objectId&&-1!==t.objectId||o.push(t.globalId))}),0===o.length)return null;const s=e.createQuery();s.where=o.map(e=>`${n}='${e}'`).join(" OR "),s.returnGeometry=!1,s.outFields=[i,n],s.cacheHint=!1;const u=await r(d(e,s));if(!u.ok)return null;const l=new Map,c=u.value.features;for(const r of c){const e=r.attributes[n],t=r.attributes[i];null!=e&&null!=t&&-1!==t&&l.set(a(e),t)}return l}function de(e,t,r){if(!t||!r||!e)return null;const n=r.getAttribute(t);if(null==n)return null;const o=e.filter(e=>{const{id:t}=e;return null!=t&&t.toString()===n.toString()});return o.length>1&&L().warn("getFeatureType",`Cannot unambiguously determine feature type because multiple types have the id ${n}.`),o[0]??null}function fe(e){return e.sourceJSON?.isMultiServicesView||ye(e)}function ye(e){return!!e.sourceJSON?.capabilities?.toLowerCase().split(",").map(e=>e.trim()).includes("map")}function me(e,t,r){const o=t?.queryAttributeBins;if(!t?.operations?.supportsQueryBins||!o)throw new n(r,"Layer source does not support binning");switch(e.binParameters?.type){case"auto-interval":if(!o.supportsAutoInterval)throw new n(r,"Layer source does not support auto-interval binning");if(e.binParameters.normalizationType&&(!o.supportsNormalization||!be(e.binParameters.normalizationType,o.supportedNormalizationTypes)))throw new n(r,"Layer source does not support normalization binning");break;case"date":if(!o.supportsDate)throw new n(r,"Layer source does not support date binning");if(e.binParameters.snapToData&&!o.supportsSnapToData)throw new n(r,"Layer source does not support snapToData binning");if(e.binParameters.returnFullIntervalBin&&!o.supportsReturnFullIntervalBin)throw new n(r,"Layer source does not support returnFullIntervalBin binning");break;case"fixed-boundaries":if(!o.supportsFixedBoundaries)throw new n(r,"Layer source does not support fixed-boundaries binning");break;case"fixed-interval":if(!o.supportsFixedInterval)throw new n(r,"Layer source does not support fixed-interval binning");if(e.binParameters.normalizationType&&(!o.supportsNormalization||!be(e.binParameters.normalizationType,o.supportedNormalizationTypes)))throw new n(r,"Layer source does not support normalization binning")}if(e.binParameters?.stackBy&&!o.supportsStackBy)throw new n(r,"Layer source does not support stackBy binning");if(e.binParameters?.splitBy&&!o.supportsSplitBy)throw new n(r,"Layer source does not support splitBy binning");if(e.binParameters?.firstDayOfWeek&&!o.supportsFirstDayOfWeek)throw new n(r,"Layer source does not support firstDayOfWeek binning");const i=o?.supportedStatistics;if(e.outStatistics&&i){const t=new Map([["count","count"],["sum","sum"],["min","min"],["max","max"],["avg","avg"],["stddev","stddev"],["var","var"],["percentile-continuous","percentileContinuous"],["percentile-discrete","percentileDiscrete"],["centroid-aggregate","centroid"],["convex-hull-aggregate","convexHull"],["envelope-aggregate","envelope"]]);for(const{statisticType:o}of e.outStatistics){const e=t.get(o);if(e&&!i[e])throw new n(r,`Layer source does not support ${o} statistic type`)}}}function be(e,t){return null!=e&&!!t?.[x.toJSON(e)]}function he(e){return m(e)?Boolean(e.labelExpressionInfo?.expression):t(e)?!!e.expressionInfos?.some(e=>e.expression)||!!Array.isArray(e.content)&&e.content.some(e=>"expression"===e.type&&e.expressionInfo?.expression):!("dot-density"!==e.type||!e.attributes?.some(e=>e.valueExpression))||(!(!("valueExpression"in e)||!e.valueExpression)||"visualVariables"in e&&null!=e.visualVariables&&e.visualVariables.some(e=>!!e.valueExpression||"size"===e.type&&(I(e.minSize)&&e.minSize.valueExpression||I(e.maxSize)&&e.maxSize.valueExpression)))}function we(e){if("renderer"in e&&e.renderer&&he(e.renderer))return!0;if("labelingInfo"in e&&e.labelingInfo)for(const t of e.labelingInfo)if(m(t)&&he(t))return!0;return!1}async function ge(e){let t="returnZ"in e?e.returnZ:void 0,r="returnM"in e?e.returnM:void 0;if(null!=t&&null!=r)return{returnZ:t,returnM:r};if(we(e)){const{arcadeUtils:n}=await S();n.layerHasGeometryFunctions(e)&&(t??=!0,r??=!0)}if("renderer"in e&&e.renderer?.symbols)for(const n of e.renderer.symbols)"cim"===n.type&&(Ie??=(await import("../../symbols/cim/CIMSymbolHelper.js")).forEachSymbolLayer,Ie(n.data.symbol,e=>{switch(e.type){case"CIMPictureMarker":case"CIMVectorMarker":if("CIMMarkerPlacementAtMeasuredUnits"===e.markerPlacement?.type)r??=!0}}));return{returnZ:t,returnM:r}}let Ie;export{A as addAttachment,O as applyEdits,ne as checkServiceCurrentUserSupport,W as computeDomainFromSubtypes,_ as computeDomainFromTypes,ae as computeEffectiveEditingEnabled,le as createDefaultRenderer,G as createQuery,D as deleteAttachments,te as ensureCredentialIfSignedIn,re as ensureLayerCredential,T as fetchRecomputedExtents,q as geometryTypeKebabDict,H as getFeatureSubtype,de as getFeatureType,J as getFieldDomain,pe as getGlobalIdToObjectIdMap,ee as getSignedInUser,se as hasCurrentUser,N as hasDataChanged,ce as isLayerCacheStale,ge as layerRequiresGeometryZM,z as queryAttachments,B as queryExtent,k as queryFeatureCount,U as queryObjectIds,V as queryRelatedFeatures,R as queryRelatedFeaturesCount,Q as readGlobalIdField,Z as readObjectIdField,$ as readVersion,fe as supportsQueryOnly,K as typesHaveUniqueIdsAndNames,M as updateAttachment,C as uploadAssets,me as validateBinsQuery};

package/networks/CircuitManager.d.ts

@@ -57,7 +57,6 @@ export type CircuitVerifyProperties = Pick<VerifyCircuitsParametersProperties, "
  * A CircuitManager provides access to circuit management capabilities for a telecom domain network
  * in a utility network.
  *
- * @beta
  * @since 4.34
  * @see [UtilityNetwork](https://developers.arcgis.com/javascript/latest/references/core/networks/UtilityNetwork/)
  * @see [UnitIdentifierManager](https://developers.arcgis.com/javascript/latest/references/core/networks/UnitIdentifierManager/)
@@ -124,6 +123,12 @@ export default class CircuitManager extends JSONSupport {
    *
    * @param circuit - The circuit to be altered.
    * @returns Resolves when the circuit is successfully altered.
+   * @example
+   * ```ts
+   * const circuits = await circuitManager.queryCircuits(["FIRSTCIRCUIT"]);
+   * circuits[0].name = "NewCircuitName";
+   * await circuitManager.alter(circuits[0]);
+   * ```
    */
   alter(circuit: Circuit): Promise<void>;
   /**
@@ -135,6 +140,122 @@ export default class CircuitManager extends JSONSupport {
    *
    * @param circuit - The circuit to create.
    * @returns Resolves when the circuit is successfully created.
+   * @example
+   * ```ts
+   * // Create a non-sectioned circuit with user-defined attributes.
+   * const startingLocation = new CircuitLocation({
+   *   sourceId: 20,
+   *   globalId: "{8A1B5A33-3EBA-42CC-9085-31B22DAFE5DC}",
+   *   firstUnit: 1,
+   *   lastUnit: 1,
+   * });
+   *
+   * const stoppingLocation = new CircuitLocation({
+   *   sourceId: 20,
+   *   globalId: "{F081B917-499E-43FC-AEC9-7C1B313BF128}",
+   *   firstUnit: 1,
+   *   lastUnit: 1,
+   * });
+   *
+   * const attributes = {
+   *   attributeOne: 1,
+   *   attributeTwo: "Two",
+   *   attributeThree: new Date().getTime(),
+   *   attributeFour: null,
+   * };
+   *
+   * const circuit = new Circuit({
+   *   name: "FIRSTCIRCUIT",
+   *   circuitType: "physical",
+   *   startLocation: startingLocation,
+   *   stopLocation: stoppingLocation,
+   *   attributes: attributes,
+   * });
+   *
+   * await circuitManager.create(circuit);
+   * ```
+   * @example
+   * To create a sectioned circuit, provide a `Map` to represent the logical connectivity between
+   * sections in a circuit. This map should represent a directed adjacency list where each key is
+   * a `CircuitSection` that connects to other `CircuitSection` instances indicated by the key's
+   * value. The map type is `Map<CircuitSection, CircuitSection[]>`.
+   *
+   * In this example, section 1 connects to 2 and 3 (where sections 2 and 3 are in parallel),
+   * 2 connects to 4, 3 connects to 4, and 4 connects to nothing (it is the end of the circuit).
+   * ```ts
+   * // Create a sectioned circuit.
+   * const sectionOne = new CircuitSection({
+   *   sectionId: 1,
+   *   sectionType: "physical",
+   *   startLocation: new CircuitLocation({
+   *     sourceId: 20,
+   *     globalId: "{6B0A0E4E-80EF-4688-B463-253063A5B4B2}",
+   *     firstUnit: 1,
+   *     lastUnit: 4,
+   *   }),
+   *   stopLocation: new CircuitLocation({
+   *     sourceId: 20,
+   *     globalId: "{3A557124-4243-4615-96DF-51991E6B9766}",
+   *     firstUnit: 1,
+   *     lastUnit: 4,
+   *   }),
+   * });
+   *
+   * const sectionTwo = new CircuitSection({
+   *   sectionId: 2,
+   *   sectionType: "physical",
+   *   subcircuit: new Subcircuit({ name: "SUBCIRCUITVALUE2" }),
+   * });
+   *
+   * const sectionThree = new CircuitSection({
+   *   sectionId: 3,
+   *   sectionType: "physical",
+   *   startLocation: new CircuitLocation({
+   *     sourceId: 20,
+   *     globalId: "{7C874691-D659-4311-B19C-D33027B6F48A}",
+   *     firstUnit: 1,
+   *     lastUnit: 4,
+   *   }),
+   *   stopLocation: new CircuitLocation({
+   *     sourceId: 20,
+   *     globalId: "{BF34887C-359E-4E00-A695-8D92BF41FE37}",
+   *     firstUnit: 1,
+   *     lastUnit: 4,
+   *   }),
+   * });
+   *
+   * const sectionFour = new CircuitSection({
+   *   sectionId: 4,
+   *   sectionType: "physical",
+   *   startLocation: new CircuitLocation({
+   *     sourceId: 20,
+   *     globalId: "{E4ECA4B4-F9F7-4AB2-B2FD-6CDAB1A9506B}",
+   *     firstUnit: 1,
+   *     lastUnit: 4,
+   *   }),
+   *   stopLocation: new CircuitLocation({
+   *     sourceId: 20,
+   *     globalId: "{18DE7259-FDC6-4788-B13B-3F6210CCCB56}",
+   *     firstUnit: 1,
+   *     lastUnit: 4,
+   *   }),
+   * });
+   *
+   * const sections = new Map([
+   *   [sectionOne, [sectionTwo, sectionThree]],
+   *   [sectionTwo, [sectionFour]],
+   *   [sectionThree, [sectionFour]],
+   *   [sectionFour, []],
+   * ]);
+   *
+   * const sectionedCircuit = new Circuit({
+   *   name: "CIRCUIT - 1749681983401",
+   *   circuitType: "physical",
+   *   sections: sections,
+   * });
+   *
+   * await circuitManager.create(sectionedCircuit);
+   * ```
    */
   create(circuit: Circuit): Promise<void>;
   /**
@@ -142,6 +263,11 @@ export default class CircuitManager extends JSONSupport {
    *
    * @param circuitNames - The names of the circuit or circuits to be deleted.
    * @returns Resolves when the specified circuits are successfully deleted.
+   * @example
+   * ```ts
+   * const circuitNames = ["FIRSTCIRCUIT"];
+   * await circuitManager.delete(circuitNames);
+   * ```
    */
   delete(circuitNames: string[]): Promise<void>;
   /**
@@ -151,6 +277,29 @@ export default class CircuitManager extends JSONSupport {
    * @param props - An object specifying configuration settings for the export.
    * @returns Resolves to an object
    *   specifying the export location and status for each circuit.
+   * @example
+   * ```ts
+   * const circuits = await circuitManager.export({
+   *   circuitNames: ["FIRSTCIRCUIT"],
+   *   exportAcknowledgement: true,
+   *   outSpatialReference: {
+   *     wkid: 4326
+   *   },
+   *   resultTypes: [
+   *     {
+   *       type: "features",
+   *       includeGeometry: true,
+   *       includeDomainDescriptions: true,
+   *       networkAttributeNames: ["Asset group", "Asset type"],
+   *       diagramTemplateName: "",
+   *       resultTypeFields: [
+   *         { networkSourceId: 20, fieldName: "FIRSTUNIT" },
+   *         { networkSourceId: 20, fieldName: "LASTUNIT" },
+   *       ],
+   *     },
+   *   ],
+   * });
+   * ```
    */
   export(props: CircuitExportProperties): Promise<CircuitExportResult[]>;
   /**
@@ -185,6 +334,30 @@ export default class CircuitManager extends JSONSupport {
    *
    * @param query - The query specifying the criteria for the circuits to return.
    * @returns The queried circuit names.
+   * @example
+   * ```ts
+   * const props: QueryCircuitByLocationsProperties = {
+   *   locations: [
+   *     new CircuitLocation({
+   *       sourceId: 20,
+   *       globalId: "{8A1B5A33-3EBA-42CC-9085-31B22DAFE5DC}",
+   *       firstUnit: 1,
+   *       lastUnit: 1,
+   *     }),
+   *   ],
+   *   locationType: "all",
+   * };
+   *
+   * const circuitNames = await circuitManager.queryCircuitNames(props);
+   * ```
+   * @example
+   * ```ts
+   * const props: QueryCircuitByIdsProperties = {
+   *   globalIds: ["{8A1B5A33-3EBA-42CC-9085-31B22DAFE5DC}"],
+   * };
+   *
+   * const circuitNames = await circuitManager.queryCircuitNames(props);
+   * ```
    */
   queryCircuitNames(query: QueryCircuitByLocationsProperties | QueryCircuitByIdsProperties): Promise<string[]>;
   /**
@@ -193,6 +366,31 @@ export default class CircuitManager extends JSONSupport {
    *
    * @param query - The names, globalIds, or start/stop locations of the circuits to query.
    * @returns The queried circuits.
+   * @example
+   * ```ts
+   * // Query circuits by locations.
+   * const circuits = await circuitManager?.queryCircuits({
+   *   hierarchy: "consumers-and-providers",
+   *   locations: [
+   *     new CircuitLocation({
+   *       firstUnit: 1,
+   *       globalId: "{B8E64696-E9C5-4349-ADC8-E72BBF2797D1}",
+   *       lastUnit: 1,
+   *       sourceId: 20,
+   *     }),
+   *   ],
+   * });
+   * ```
+   * @example
+   * ```ts
+   * // Query circuits by name.
+   * const circuits = await circuitManager.queryCircuits({ names: ["MULTISECTIONCIRCUIT"] });
+   * ```
+   * @example
+   * ```ts
+   * // Query circuits by globalIds.
+   * const circuits = await circuitManager.queryCircuits({ globalIds: ["{8A1B5A33-3EBA-42CC-9085-31B22DAFE5DC}"] });
+   * ```
    */
   queryCircuits(query: QueryCircuitByNamesProperties | QueryCircuitByLocationsProperties | QueryCircuitByIdsProperties): Promise<Circuit[]>;
   /**
@@ -202,6 +400,31 @@ export default class CircuitManager extends JSONSupport {
    * @param options - The request options specified by the user in the data request.
    * @returns Resolves to a [CircuitExportJobInfo](https://developers.arcgis.com/javascript/latest/references/core/networks/support/CircuitExportJobInfo/) object with the results of the export job.
    * @since 5.1
+   * @example
+   * ```ts
+   * const exportJob = await circuitManager.submitExportJob({
+   *   circuitNames: ["MULTISECTIONCIRCUIT"],
+   *   exportAcknowledgement: true,
+   *   outSpatialReference: {
+   *     wkid: 4326,
+   *   },
+   *   resultTypes: [
+   *     {
+   *       type: "features",
+   *       includeGeometry: true,
+   *       includeDomainDescriptions: true,
+   *       networkAttributeNames: ["Asset group", "Asset type"],
+   *       diagramTemplateName: "",
+   *       resultTypeFields: [
+   *         { networkSourceId: 20, fieldName: "FIRSTUNIT" },
+   *         { networkSourceId: 20, fieldName: "LASTUNIT" },
+   *       ],
+   *     },
+   *   ],
+   * });
+   *
+   * await exportJob.waitForJobCompletion();
+   * ```
    */
   submitExportJob(props: CircuitExportProperties, options?: RequestOptions | null | undefined): Promise<CircuitExportJobInfo>;
   /**
@@ -211,6 +434,16 @@ export default class CircuitManager extends JSONSupport {
    * @param options - The request options specified by the user in the data request.
    * @returns Resolves to a [CircuitVerifyJobInfo](https://developers.arcgis.com/javascript/latest/references/core/networks/support/CircuitVerifyJobInfo/) object with the results of the verify job.
    * @since 5.1
+   * @example
+   * ```ts
+   * const props: VerifyCircuitsProperties = {
+   *   circuitNames: ["FIRSTCIRCUIT"],
+   *   forceVerify: true,
+   *   synthesizeGeometries: true,
+   * };
+   *
+   * const verifyCircuitsResult = await circuitManager.submitVerifyJob(props);
+   * ```
    */
   submitVerifyJob(props: CircuitVerifyProperties, options?: RequestOptions | null | undefined): Promise<CircuitVerifyJobInfo>;
   /**
@@ -220,6 +453,19 @@ export default class CircuitManager extends JSONSupport {
    *
    * @param props - An object specifying configuration settings for the verify operation.
    * @returns Resolves to an array of objects specifying the verification status for each circuit.
+   * @example
+   * ```ts
+   * const props: VerifyCircuitsProperties = {
+   *   circuitNames: ["FIRSTCIRCUIT"],
+   *   outSpatialReference: {
+   *     wkid: 4326,
+   *   },
+   *   forceVerify: true,
+   *   synthesizeGeometries: true,
+   * };
+   *
+   * const verifyCircuitsResult = await circuitManager.verify(props);
+   * ```
    */
   verify(props: CircuitVerifyProperties): Promise<CircuitVerifyResult[]>;
 }

package/networks/UnitIdentifierManager.d.ts

@@ -18,7 +18,6 @@ export interface UnitIdentifierManagerProperties {
  * A UnitIdentifierManager provides access to unit identifier management capabilities for a
  * telecom domain network in a utility network.
  *
- * @beta
  * @since 4.34
  * @see [UtilityNetwork](https://developers.arcgis.com/javascript/latest/references/core/networks/UtilityNetwork/)
  * @see [CircuitManager](https://developers.arcgis.com/javascript/latest/references/core/networks/CircuitManager/)
@@ -71,7 +70,6 @@ export default class UnitIdentifierManager extends JSONSupport {
    *
    * @param networkElements - The network elements to combine in a telecom domain network.
    * @returns `ServiceEdits` for combining network elements in a telecom domain network.
-   * @beta
    * @since 5.1
    * @example
    * const networkElementA = new NetworkElement({
@@ -108,7 +106,6 @@ export default class UnitIdentifierManager extends JSONSupport {
    *   Each number in this array describes the number of units to assign an object resulting from the division.
    *   E.g., to divide one object with 6 units into an object with 5 units and another object with 1 unit, specify [5, 1].
    * @returns `ServiceEdits` for dividing a network element in a telecom domain network.
-   * @beta
    * @since 5.1
    * @example
    * const networkElement = new NetworkElement({
@@ -128,6 +125,17 @@ export default class UnitIdentifierManager extends JSONSupport {
    * @param containers - The unit container features or objects to query.
    * @returns Resolves to an array of objects describing
    *   the unit identifiers and gaps for the specified unit containers.
+   * @example
+   * ```ts
+   * const containers: UnitIdentifier[] = [
+   *   {
+   *     sourceId: 16,
+   *     globalId: "{25B5F11B-70A2-4A61-9284-F0CE4C1E2111}",
+   *   },
+   * ];
+   *
+   * const results = await unitIdentifierManager.query(containers);
+   * ```
    */
   query(containers: UnitIdentifier[]): Promise<UnitQueryResult[]>;
   /**
@@ -143,6 +151,15 @@ export default class UnitIdentifierManager extends JSONSupport {
    * @param firstUnit - The first unit for the gap to be introduced.
    * @param lastUnit - The last unit for the gap to be introduced.
    * @returns Resolves when the gap is successfully inserted.
+   * @example
+   * ```ts
+   * const container: UnitIdentifier = {
+   *   sourceId: 16,
+   *   globalId: "{25B5F11B-70A2-4A61-9284-F0CE4C1E2111}",
+   * };
+   *
+   * await unitIdentifierManager.reserve(container, 2, 5);
+   * ```
    */
   reserve(container: UnitIdentifier, firstUnit: number, lastUnit: number): Promise<void>;
   /**
@@ -151,6 +168,17 @@ export default class UnitIdentifierManager extends JSONSupport {
    *
    * @param containers - The unit container features or objects to be reset.
    * @returns Resolves when the containers are successfully reset.
+   * @example
+   * ```ts
+   * const containers: UnitIdentifier[] = [
+   *   {
+   *     sourceId: 16,
+   *     globalId: "{25B5F11B-70A2-4A61-9284-F0CE4C1E2111}",
+   *   },
+   * ];
+   *
+   * await unitIdentifierManager.reset(containers);
+   * ```
    */
   reset(containers: UnitIdentifier[]): Promise<void>;
   /**
@@ -159,6 +187,15 @@ export default class UnitIdentifierManager extends JSONSupport {
    * @param content - The unit identifiable feature or object being resized.
    * @param lastUnit - The last unit for the feature or object to be resized to.
    * @returns Resolves when the feature or object is successfully resized.
+   * @example
+   * ```ts
+   * const content: UnitIdentifier = {
+   *   sourceId: 16,
+   *   globalId: "{25B5F11B-70A2-4A61-9284-F0CE4C1E2111}",
+   * };
+   *
+   * await unitIdentifierManager.resize(content, 8);
+   * ```
    */
   resize(content: UnitIdentifier, lastUnit: number): Promise<void>;
 }