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

package/networks/UtilityNetwork.d.ts

@@ -99,7 +99,6 @@ export default class UtilityNetwork extends Network {
   /**
    * Returns true if the utility network data element includes a telecom domain network.
    *
-   * @beta
    * @since 4.34
    * @see [Telecom domain network](https://doc.esri.com/en/arcgis-pro/latest/help/data/utility-network/telecom-domain-networks.html)
    */
@@ -268,7 +267,6 @@ export default class UtilityNetwork extends Network {
    * @param telecomDomainNetworkName - The name of the telecom domain network to return a `CircuitManager` for.
    * @returns Resolves to a [CircuitManager](https://developers.arcgis.com/javascript/latest/references/core/networks/CircuitManager/)
    *   for the utility network's telecom domain network, or null if no such domain network exists.
-   * @beta
    * @since 4.34
    */
   getCircuitManager(telecomDomainNetworkName: string): Promise<CircuitManager | null>;
@@ -305,7 +303,6 @@ export default class UtilityNetwork extends Network {
    *
    * @returns Resolves to a [UnitIdentifierManager](https://developers.arcgis.com/javascript/latest/references/core/networks/UnitIdentifierManager/)
    *   for the utility network's telecom domain networks, or null if no such domain network exists.
-   * @beta
    * @since 4.34
    */
   getUnitIdentifierManager(): Promise<UnitIdentifierManager | null>;
@@ -354,10 +351,6 @@ export default class UtilityNetwork extends Network {
    * The submitTraceJob method takes a set of parameters, executes the asynchronous trace on the backend, and returns trace results.
    * The `gdbVersion` and `moment` properties of the `props` parameter will be hydrated from this [UtilityNetwork](https://developers.arcgis.com/javascript/latest/references/core/networks/UtilityNetwork/).
    *
-   * > [!WARNING]
-   * >
-   * > The `path` and `circuit` trace types are reserved for future use.
-   *
    * @param props - Props consists of namedTraceConfigurationGlobalId, traceLocations, outSpatialReference, traceConfiguration, resultTypes, and traceType.
    * @returns Returns a Promise of TraceJobInfo.
    * @since 4.27
@@ -376,10 +369,6 @@ export default class UtilityNetwork extends Network {
    * The trace method takes a set of parameters, executes the trace on the backend, and returns trace results.
    * The `gdbVersion` and `moment` properties of the `props` parameter will be hydrated from this [UtilityNetwork](https://developers.arcgis.com/javascript/latest/references/core/networks/UtilityNetwork/).
    *
-   * > [!WARNING]
-   * >
-   * > The `path` and `circuit` trace types are reserved for future use.
-   *
    * @param props - Props consists of namedTraceConfigurationGlobalId, traceLocations, outSpatialReference, traceConfiguration, resultTypes, and traceType.
    * @returns Returns a Promise of TraceResult.
    * @since 4.27

package/networks/UtilityNetwork.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{__decorate as e}from"tslib";import t from"../Graphic.js";import r from"../core/Error.js";import{getOrCreateMapValue as s}from"../core/MapUtils.js";import{watch as o}from"../core/reactiveUtils.js";import{property as i,subclass as a}from"../core/accessorSupport/decorators.js";import n from"../layers/FeatureLayer.js";import{queryAllJSON as l}from"../layers/support/featureQueryAll.js";import u from"./Network.js";import d from"./RulesTable.js";import m from"./support/NamedTraceConfiguration.js";import{getAssociationsTableFields as c}from"./support/networkFieldUtils.js";import y from"./support/NetworkSystemLayers.js";import h from"./support/TerminalConfiguration.js";import p from"./support/TraceJobInfo.js";import{AssociationTypeEnum as f,nullGuid as w,associationTypeKebabDict as b}from"./support/typeUtils.js";import{doesRuleAllowAssociation as I}from"./support/utils.js";import g from"../rest/networks/support/TelecomNetworkElement.js";import T from"../rest/support/Query.js";let k=class extends u{constructor(e){super(e),this.sharedNamedTraceConfigurations=[],this.type="utility",this._circuitManagerMap=new Map,this._terminalById=new Map,this._unitIdentifierManager=null}initialize(){this.addHandles(o(()=>[this.gdbVersion,this.historicMoment],()=>{this.networkSystemLayers.associationsTable&&(this.networkSystemLayers.associationsTable.gdbVersion!==this.gdbVersion&&(this.networkSystemLayers.associationsTable.gdbVersion=this.gdbVersion),this.networkSystemLayers.associationsTable.historicMoment!==this.historicMoment&&(this.networkSystemLayers.associationsTable.historicMoment=this.historicMoment))}))}get _rulesLayer(){const{gdbVersion:e,historicMoment:t}=this,r=this.networkSystemLayers.rulesTableUrl;return new n({url:r,gdbVersion:e,historicMoment:t})}get _telecomSourceSet(){const e=new Set;return this.dataElement?.domainNetworks.forEach(t=>{t.isTelecomNetwork&&(t.edgeSources?.forEach(t=>e.add(t.sourceId)),t.junctionSources?.forEach(t=>e.add(t.sourceId)))}),e}get _utilityLayerList(){const e=new Set;return this.dataElement?.domainNetworks?.map(t=>{t?.edgeSources?.map(({layerId:t,sourceId:r})=>{this._layerIdBySourceId.set(r,t),this._sourceIdByLayerId.set(t,r),e.add(t)}),t?.junctionSources?.map(({layerId:t,sourceId:r})=>{this._layerIdBySourceId.set(r,t),this._sourceIdByLayerId.set(t,r),e.add(t)})}),e}get serviceTerritoryFeatureLayerId(){return this.dataElement?.serviceTerritoryFeatureLayerId??null}get networkSystemLayers(){return new y({rulesTableId:this.sourceJSON?.systemLayers.rulesTableId,rulesTableUrl:this.sourceJSON?`${this.featureServiceUrl}/${this.sourceJSON?.systemLayers.rulesTableId}`:null,subnetworksTableId:this.sourceJSON?.systemLayers.subnetworksTableId,subnetworksTableUrl:this.sourceJSON?`${this.featureServiceUrl}/${this.sourceJSON?.systemLayers.subnetworksTableId}`:null,dirtyAreasLayerId:this.sourceJSON?.systemLayers.dirtyAreasLayerId,dirtyAreasLayerUrl:this.sourceJSON?`${this.featureServiceUrl}/${this.sourceJSON?.systemLayers.dirtyAreasLayerId}`:null,associationsTableId:this.sourceJSON?.systemLayers.associationsTableId,associationsTableUrl:this.sourceJSON?`${this.featureServiceUrl}/${this.sourceJSON?.systemLayers.associationsTableId}`:null})}get terminalConfigurations(){return this.dataElement?.terminalConfigurations.map(e=>h.fromJSON(e))||[]}get domainNetworkNames(){return this.dataElement?.domainNetworks.map(e=>e.domainNetworkName)||[]}get hasTelecomNetwork(){return this.dataElement?.domainNetworks.some(e=>e.isTelecomNetwork)??!1}get associationsTable(){return this.networkSystemLayers.associationsTable}async load(e){return this.addResolvingPromise(this._load(e)),this}async _load(e){await super._load(e);const{dataElement:t,layerId:s,sourceJSON:o}=this;if(!(t&&"domainNetworks"in t&&Array.isArray(t.domainNetworks)))throw new r("network:invalid-data-element",`The data element for layer ${s} does not have the expected properties for a utility network.`);if(!o||!("type"in o)||"string"!=typeof o.type||"Utility Network Layer"!==o.type)throw new r("network:invalid-layer",`The metadata for layer ${s} does not have the expected properties for a utility network.`);await Promise.all([this._loadNamedTraceConfigurationsFromNetwork(e),this.networkSystemLayers.loadAssociationsTable(e)])}getTerminalConfiguration(e){let t=null,r=null;const s=e.sourceLayer??e.origin??e.layer??null;let o=null;if("feature"===s?.type){if(o=s.layerId,null===o)return null}else{if("subtype-sublayer"!==s?.type)return null;if(o=s?.parent?.layerId??null,null===o)return null}const i=e.attributes;if(null==i)return null;for(const l of Object.keys(i))"ASSETGROUP"===l.toUpperCase()&&(t=e.getAttribute(l)),"ASSETTYPE"===l.toUpperCase()&&(r=e.getAttribute(l));if(!this.dataElement)return null;let a=null;const n=this.dataElement.domainNetworks;for(const l of n){const e=l.junctionSources?.find(e=>e.layerId===o);if(e){const s=e.assetGroups?.find(e=>e.assetGroupCode===t);if(s){const e=s.assetTypes?.find(e=>e.assetTypeCode===r);if(e?.isTerminalConfigurationSupported){a=e.terminalConfigurationId;break}}}}if(null!=a){const e=this.dataElement.terminalConfigurations,t=e?.find(e=>e.terminalConfigurationId===a);return t?h.fromJSON(t):null}return null}getTierNames(e){const t=this.dataElement?.domainNetworks.find(t=>t.domainNetworkName===e);return t?.tiers?.map(e=>e.name)||[]}async getRulesTable(){const e=this._rulesLayer;e.loaded||await e.load();const t=this.dataElement?.domainNetworks;if(!t)return null;const r=t.flatMap(e=>[...e.edgeSources||[],...e.junctionSources||[]]),s=(await this._queryRulesTable(e)).map(t=>this._hydrateRuleInfo(e,r,t));return new d({rulesLayer:e,rules:s})}async getCircuitManager(e){if(!this.hasTelecomNetwork)return null;const t=this.dataElement?.domainNetworks.find(t=>t.domainNetworkName===e&&t.isTelecomNetwork);if(!t)return null;const{default:r}=await import("./CircuitManager.js");return s(this._circuitManagerMap,e,()=>new r({utilityNetwork:this,telecomDomainNetwork:t}))}async getUnitIdentifierManager(){if(!this.hasTelecomNetwork)return null;if(this._unitIdentifierManager)return this._unitIdentifierManager;const{default:e}=await import("./UnitIdentifierManager.js");return this._unitIdentifierManager=new e({utilityNetwork:this}),this._unitIdentifierManager}getTerminalById(e){if(!this.dataElement||null==e)return null;const t=this._terminalById.get(e);return null!=t?t:(this.terminalConfigurations.forEach(e=>{e.terminals.forEach(e=>{this._terminalById.set(e.id,e)})}),this._terminalById.get(e))}isUtilityLayer(e){return"layerId"in e?null!=e.layerId&&this._utilityLayerList.has(e.layerId)&&(e.url?.startsWith(this.featureServiceUrl)??!1):!("subtype-sublayer"!==e.type||!e.parent)&&(this._utilityLayerList.has(e.parent.layerId)&&(e.parent.url?.startsWith(this.featureServiceUrl)??!1))}async queryAssociations(e,t){const[{queryAssociations:r},{default:s}]=await Promise.all([import("../rest/networks/queryAssociations.js"),import("../rest/networks/support/QueryAssociationsParameters.js")]),o=s.from(e);o.gdbVersion=this.gdbVersion,o.moment=this.historicMoment;return(await r(this.networkServiceUrl,o,t)).associations}async synthesizeAssociationGeometries(e){const[{synthesizeAssociationGeometries:t},{default:r}]=await Promise.all([import("../rest/networks/synthesizeAssociationGeometries.js"),import("../rest/networks/support/SynthesizeAssociationGeometriesParameters.js")]),s=r.from(e);return s.gdbVersion=this.gdbVersion,s.moment=this.historicMoment,t(this.networkServiceUrl,s)}async trace(e){const[{trace:t},{default:r}]=await Promise.all([import("../rest/networks/trace.js"),import("../rest/networks/support/TraceParameters.js")]),s=r.from({...e,telecomSourceSet:this._telecomSourceSet});return s.gdbVersion=this.gdbVersion,s.moment=this.historicMoment,t(this.networkServiceUrl,s)}async submitTraceJob(e){const[{submitTraceJob:t},{default:r}]=await Promise.all([import("../rest/networks/trace.js"),import("../rest/networks/support/TraceParameters.js")]),s=r.from(e);s.gdbVersion=this.gdbVersion,s.moment=this.historicMoment;const o=await t(this.networkServiceUrl,s);return new p({statusUrl:o,telecomSourceSet:this._telecomSourceSet})}async canAddAssociation(e){const t=await this.getRulesTable();if(!t)return!1;const{fromNetworkElement:r,toNetworkElement:s}=e;if(!r||!s)return!1;await t.load();let o=null;switch(e.associationType){case"containment":o=t.rulesCategorized.containment;break;case"attachment":o=t.rulesCategorized.attachment;break;default:o=t.rulesCategorized.connectivity}return o.some(e=>I(e,r,s))}generateAddAssociations(e){const{associationsTable:r}=this.networkSystemLayers,{fromNetworkSourceId:s,fromGlobalId:o,fromTerminalId:i,fromFirstUnit:a,fromLastUnit:n,toNetworkSourceId:l,toGlobalId:u,toTerminalId:d,toFirstUnit:m,toLastUnit:y,associationType:h,isContentVisible:p,percentAlong:w,globalId:b}=c(r);return{addFeatures:e.map(e=>{const r=new t({attributes:{[s]:e.fromNetworkElement?.networkSourceId,[o]:e.fromNetworkElement?.globalId,[i]:e.fromNetworkElement?.terminalId,[l]:e.toNetworkElement?.networkSourceId,[u]:e.toNetworkElement?.globalId,[d]:e.toNetworkElement?.terminalId,[h]:f[e.associationType],[p]:null==e.isContentVisible?void 0:e.isContentVisible?1:0,[w]:e.percentAlong,[b]:e.globalId}}),c=e.associationType.includes("connectivity");return e.fromNetworkElement instanceof g&&(r.attributes[a]=e.fromNetworkElement?.firstUnit,r.attributes[n]=e.fromNetworkElement?.lastUnit,c&&(r.attributes[i]=1)),e.toNetworkElement instanceof g&&(r.attributes[m]=e.toNetworkElement?.firstUnit,r.attributes[y]=e.toNetworkElement?.lastUnit,c&&(r.attributes[d]=1)),r}),id:this.networkSystemLayers.associationsTableId,identifierFields:{globalIdField:r?.globalIdField??"globalid",objectIdField:r?.objectIdField??"objectid"}}}generateDeleteAssociations(e){const{associationsTable:t,associationsTableId:r}=this.networkSystemLayers,s={id:r,identifierFields:{globalIdField:t?.globalIdField??"globalid",objectIdField:t?.objectIdField??"objectid"}};if(-8===this.dataElement?.schemaGeneration){const t=this._generateDeleteTelecomAssociationPayload(e);return{...s,deleteAssociations:t}}const o=e.map(e=>({globalId:e.globalId}));return{...s,deleteFeatures:o}}async loadAssociationsTable(){return this.networkSystemLayers.loadAssociationsTable()}async loadSubnetworksTable(){return this.networkSystemLayers.loadSubnetworksTable()}async _loadNamedTraceConfigurationsFromNetwork(e){if(0===this.sharedNamedTraceConfigurations?.length)return;const t=this.sharedNamedTraceConfigurations.map(e=>e.globalId),r=await this.queryNamedTraceConfigurations({globalIds:t},e);for(const s of this.sharedNamedTraceConfigurations){const e=r?.find(e=>e.globalId===s.globalId);if(e){const t=e.write({},{origin:"service"});s.read(t,{origin:"service"})}}}_hydrateRuleInfo(e,t,r){const s=e.fieldsIndex,o=s.get("RULETYPE"),i=s.get("CREATIONDATE"),a=s.get("FROMNETWORKSOURCEID"),n=s.get("FROMASSETGROUP"),l=s.get("FROMASSETTYPE"),u=s.get("FROMTERMINALID"),d=s.get("TONETWORKSOURCEID"),m=s.get("TOASSETGROUP"),c=s.get("TOASSETTYPE"),y=s.get("TOTERMINALID"),h=s.get("VIANETWORKSOURCEID"),p=s.get("VIAASSETGROUP"),f=s.get("VIAASSETTYPE"),w=s.get("VIATERMINALID"),b=r.attributes[o.name],I=new Date(r.attributes[i.name]),g=[{networkSourceId:r.attributes[a.name],assetGroupId:r.attributes[n.name],assetTypeId:r.attributes[l.name],terminalId:r.attributes[u.name]},{networkSourceId:r.attributes[d.name],assetGroupId:r.attributes[m.name],assetTypeId:r.attributes[c.name],terminalId:r.attributes[y.name]},{networkSourceId:r.attributes[h.name],assetGroupId:r.attributes[p.name],assetTypeId:r.attributes[f.name],terminalId:r.attributes[w.name]}],T={ruleType:b,creationDate:I};for(const k of[0,1,2]){if(5!==b&&2===k)continue;const e=g[k],r=t.find(t=>t.sourceId===e.networkSourceId),s=r?.assetGroups.find(t=>t.assetGroupCode===e.assetGroupId),o=s?.assetTypes.find(t=>t.assetTypeCode===e.assetTypeId),i=this._getTerminal(o,e);let a="";switch(k){case 0:a="from";break;case 1:a="to";break;case 2:a="via"}T[`${a}NetworkSource`]=r,T[`${a}AssetGroup`]=s,T[`${a}AssetType`]=o,T[`${a}Terminal`]=i?.toJSON()}return T}_getTerminal(e,t){const r=e?.terminalConfigurationId,s=this.terminalConfigurations?.find(e=>e.id===r);return s?.terminals?.find(e=>e.id===t.terminalId)??null}async _queryRulesTable(e){const{gdbVersion:t,historicMoment:r}=this,s=new T({where:"1=1",outFields:["*"],gdbVersion:t,historicMoment:r});return(await l(e,s)).features}_generateDeleteTelecomAssociationPayload(e){return e.map(e=>({globalId:e.globalId??w,associationType:b.toJSON(e.associationType),fromSourceId:e.fromNetworkElement.networkSourceId,fromGlobalId:e.fromNetworkElement.globalId,fromTerminalId:e.fromNetworkElement.terminalId,toSourceId:e.toNetworkElement.networkSourceId,toGlobalId:e.toNetworkElement.globalId,toTerminalId:e.toNetworkElement.terminalId}))}};e([i({readOnly:!0})],k.prototype,"_rulesLayer",null),e([i({readOnly:!0})],k.prototype,"_telecomSourceSet",null),e([i({type:[m],json:{origins:{"web-map":{read:{source:"traceConfigurations"},write:{target:"traceConfigurations"}},service:{read:{source:"traceConfigurations"}}},read:!1}})],k.prototype,"sharedNamedTraceConfigurations",void 0),e([i({type:["utility"],readOnly:!0,json:{read:!1,write:!1}})],k.prototype,"type",void 0),e([i({readOnly:!0})],k.prototype,"serviceTerritoryFeatureLayerId",null),e([i({readOnly:!0})],k.prototype,"networkSystemLayers",null),e([i({readOnly:!0})],k.prototype,"terminalConfigurations",null),e([i({readOnly:!0})],k.prototype,"domainNetworkNames",null),e([i({readOnly:!0})],k.prototype,"hasTelecomNetwork",null),e([i({readOnly:!0,json:{read:!1}})],k.prototype,"associationsTable",null),k=e([a("esri.networks.UtilityNetwork")],k);const S=k;export{S as default};
+import{__decorate as e}from"tslib";import t from"../Graphic.js";import r from"../core/Error.js";import{getOrCreateMapValue as s}from"../core/MapUtils.js";import{watch as o}from"../core/reactiveUtils.js";import{property as i,subclass as a}from"../core/accessorSupport/decorators.js";import n from"../layers/FeatureLayer.js";import{queryAllJSON as l}from"../layers/support/featureQueryAll.js";import u from"./Network.js";import d from"./RulesTable.js";import m from"./support/NamedTraceConfiguration.js";import{getAssociationsTableFields as c}from"./support/networkFieldUtils.js";import y from"./support/NetworkSystemLayers.js";import h from"./support/TerminalConfiguration.js";import f from"./support/TraceJobInfo.js";import{AssociationTypeEnum as p,nullGuid as w,associationTypeKebabDict as I}from"./support/typeUtils.js";import{doesRuleAllowAssociation as b}from"./support/utils.js";import g from"../rest/networks/support/TelecomNetworkElement.js";import T from"../rest/support/Query.js";let k=class extends u{constructor(e){super(e),this.sharedNamedTraceConfigurations=[],this.type="utility",this._circuitManagerMap=new Map,this._terminalById=new Map,this._unitIdentifierManager=null}initialize(){this.addHandles(o(()=>[this.gdbVersion,this.historicMoment],()=>{this.networkSystemLayers.associationsTable&&(this.networkSystemLayers.associationsTable.gdbVersion!==this.gdbVersion&&(this.networkSystemLayers.associationsTable.gdbVersion=this.gdbVersion),this.networkSystemLayers.associationsTable.historicMoment!==this.historicMoment&&(this.networkSystemLayers.associationsTable.historicMoment=this.historicMoment))}))}get _rulesLayer(){const{gdbVersion:e,historicMoment:t}=this,r=this.networkSystemLayers.rulesTableUrl;return new n({url:r,gdbVersion:e,historicMoment:t})}get _telecomSourceSet(){const e=new Set;return this.dataElement?.domainNetworks.forEach(t=>{t.isTelecomNetwork&&(t.edgeSources?.forEach(t=>e.add(t.sourceId)),t.junctionSources?.forEach(t=>e.add(t.sourceId)))}),e}get _utilityLayerList(){const e=new Set;return this.dataElement?.domainNetworks?.map(t=>{t?.edgeSources?.map(({layerId:t,sourceId:r})=>{this._layerIdBySourceId.set(r,t),this._sourceIdByLayerId.set(t,r),e.add(t)}),t?.junctionSources?.map(({layerId:t,sourceId:r})=>{this._layerIdBySourceId.set(r,t),this._sourceIdByLayerId.set(t,r),e.add(t)})}),e}get serviceTerritoryFeatureLayerId(){return this.dataElement?.serviceTerritoryFeatureLayerId??null}get networkSystemLayers(){return new y({rulesTableId:this.sourceJSON?.systemLayers.rulesTableId,rulesTableUrl:this.sourceJSON?`${this.featureServiceUrl}/${this.sourceJSON?.systemLayers.rulesTableId}`:null,subnetworksTableId:this.sourceJSON?.systemLayers.subnetworksTableId,subnetworksTableUrl:this.sourceJSON?`${this.featureServiceUrl}/${this.sourceJSON?.systemLayers.subnetworksTableId}`:null,dirtyAreasLayerId:this.sourceJSON?.systemLayers.dirtyAreasLayerId,dirtyAreasLayerUrl:this.sourceJSON?`${this.featureServiceUrl}/${this.sourceJSON?.systemLayers.dirtyAreasLayerId}`:null,associationsTableId:this.sourceJSON?.systemLayers.associationsTableId,associationsTableUrl:this.sourceJSON?`${this.featureServiceUrl}/${this.sourceJSON?.systemLayers.associationsTableId}`:null})}get terminalConfigurations(){return this.dataElement?.terminalConfigurations.map(e=>h.fromJSON(e))||[]}get domainNetworkNames(){return this.dataElement?.domainNetworks.map(e=>e.domainNetworkName)||[]}get hasTelecomNetwork(){return this.dataElement?.domainNetworks.some(e=>e.isTelecomNetwork)??!1}get associationsTable(){return this.networkSystemLayers.associationsTable}async load(e){return this.addResolvingPromise(this._load(e)),this}async _load(e){await super._load(e);const{dataElement:t,layerId:s,sourceJSON:o}=this;if(!(t&&"domainNetworks"in t&&Array.isArray(t.domainNetworks)))throw new r("network:invalid-data-element",`The data element for layer ${s} does not have the expected properties for a utility network.`);if(!o||!("type"in o)||"string"!=typeof o.type||"Utility Network Layer"!==o.type)throw new r("network:invalid-layer",`The metadata for layer ${s} does not have the expected properties for a utility network.`);await Promise.all([this._loadNamedTraceConfigurationsFromNetwork(e),this.networkSystemLayers.loadAssociationsTable(e)])}getTerminalConfiguration(e){let t=null,r=null;const s=e.sourceLayer??e.origin??e.layer??null;let o=null;if("feature"===s?.type){if(o=s.layerId,null===o)return null}else{if("subtype-sublayer"!==s?.type)return null;if(o=s?.parent?.layerId??null,null===o)return null}const i=e.attributes;if(null==i)return null;for(const l of Object.keys(i))"ASSETGROUP"===l.toUpperCase()&&(t=e.getAttribute(l)),"ASSETTYPE"===l.toUpperCase()&&(r=e.getAttribute(l));if(!this.dataElement)return null;let a=null;const n=this.dataElement.domainNetworks;for(const l of n){const e=l.junctionSources?.find(e=>e.layerId===o);if(e){const s=e.assetGroups?.find(e=>e.assetGroupCode===t);if(s){const e=s.assetTypes?.find(e=>e.assetTypeCode===r);if(e?.isTerminalConfigurationSupported){a=e.terminalConfigurationId;break}}}}if(null!=a){const e=this.dataElement.terminalConfigurations,t=e?.find(e=>e.terminalConfigurationId===a);return t?h.fromJSON(t):null}return null}getTierNames(e){const t=this.dataElement?.domainNetworks.find(t=>t.domainNetworkName===e);return t?.tiers?.map(e=>e.name)||[]}async getRulesTable(){const e=this._rulesLayer;e.loaded||await e.load();const t=this.dataElement?.domainNetworks;if(!t)return null;const r=t.flatMap(e=>[...e.edgeSources||[],...e.junctionSources||[]]),s=(await this._queryRulesTable(e)).map(t=>this._hydrateRuleInfo(e,r,t));return new d({rulesLayer:e,rules:s})}async getCircuitManager(e){if(!this.hasTelecomNetwork)return null;const t=this.dataElement?.domainNetworks.find(t=>t.domainNetworkName===e&&t.isTelecomNetwork);if(!t)return null;const{default:r}=await import("./CircuitManager.js");return s(this._circuitManagerMap,e,()=>new r({utilityNetwork:this,telecomDomainNetwork:t}))}async getUnitIdentifierManager(){if(!this.hasTelecomNetwork)return null;if(this._unitIdentifierManager)return this._unitIdentifierManager;const{default:e}=await import("./UnitIdentifierManager.js");return this._unitIdentifierManager=new e({utilityNetwork:this}),this._unitIdentifierManager}getTerminalById(e){if(!this.dataElement||null==e)return null;const t=this._terminalById.get(e);return null!=t?t:(this.terminalConfigurations.forEach(e=>{e.terminals.forEach(e=>{this._terminalById.set(e.id,e)})}),this._terminalById.get(e))}isUtilityLayer(e){return"layerId"in e?null!=e.layerId&&this._utilityLayerList.has(e.layerId)&&(e.url?.startsWith(this.featureServiceUrl)??!1):!("subtype-sublayer"!==e.type||!e.parent)&&(this._utilityLayerList.has(e.parent.layerId)&&(e.parent.url?.startsWith(this.featureServiceUrl)??!1))}async queryAssociations(e,t){const[{queryAssociations:r},{default:s}]=await Promise.all([import("../rest/networks/queryAssociations.js"),import("../rest/networks/support/QueryAssociationsParameters.js")]),o=s.from(e);o.gdbVersion=this.gdbVersion,o.moment=this.historicMoment;return(await r(this.networkServiceUrl,o,t)).associations}async synthesizeAssociationGeometries(e){const[{synthesizeAssociationGeometries:t},{default:r}]=await Promise.all([import("../rest/networks/synthesizeAssociationGeometries.js"),import("../rest/networks/support/SynthesizeAssociationGeometriesParameters.js")]),s=r.from(e);return s.gdbVersion=this.gdbVersion,s.moment=this.historicMoment,t(this.networkServiceUrl,s)}async trace(e){const[{trace:t},{default:r}]=await Promise.all([import("../rest/networks/trace.js"),import("../rest/networks/support/TraceParameters.js")]),s=r.from({...e,telecomSourceSet:this._telecomSourceSet});return s.gdbVersion=this.gdbVersion,s.moment=this.historicMoment,t(this.networkServiceUrl,s)}async submitTraceJob(e){const[{submitTraceJob:t},{default:r}]=await Promise.all([import("../rest/networks/trace.js"),import("../rest/networks/support/TraceParameters.js")]),s=r.from(e);s.gdbVersion=this.gdbVersion,s.moment=this.historicMoment;const o=await t(this.networkServiceUrl,s);return new f({statusUrl:o,telecomSourceSet:this._telecomSourceSet})}async canAddAssociation(e){const t=await this.getRulesTable();if(!t)return!1;const{fromNetworkElement:r,toNetworkElement:s}=e;if(!r||!s)return!1;await t.load();let o=null;switch(e.associationType){case"containment":o=t.rulesCategorized.containment;break;case"attachment":o=t.rulesCategorized.attachment;break;default:o=t.rulesCategorized.connectivity}return o.some(e=>b(e,r,s))}generateAddAssociations(e){const{associationsTable:r}=this.networkSystemLayers,{fromNetworkSourceId:s,fromGlobalId:o,fromTerminalId:i,fromFirstUnit:a,fromLastUnit:n,toNetworkSourceId:l,toGlobalId:u,toTerminalId:d,toFirstUnit:m,toLastUnit:y,associationType:h,isContentVisible:f,percentAlong:w,globalId:I}=c(r);return{addFeatures:e.map(e=>{const r=new t({attributes:{[s]:e.fromNetworkElement?.networkSourceId,[o]:e.fromNetworkElement?.globalId,[i]:e.fromNetworkElement?.terminalId,[l]:e.toNetworkElement?.networkSourceId,[u]:e.toNetworkElement?.globalId,[d]:e.toNetworkElement?.terminalId,[h]:p[e.associationType],[f]:null==e.isContentVisible?void 0:e.isContentVisible?1:0,[w]:e.percentAlong,[I]:e.globalId}}),c=e.associationType.includes("connectivity");return e.fromNetworkElement instanceof g&&(r.attributes[a]=e.fromNetworkElement?.firstUnit,r.attributes[n]=e.fromNetworkElement?.lastUnit),e.toNetworkElement instanceof g&&(r.attributes[m]=e.toNetworkElement?.firstUnit,r.attributes[y]=e.toNetworkElement?.lastUnit),c&&(r.attributes[i]=e.fromNetworkElement?.terminalId??1,r.attributes[d]=e.toNetworkElement?.terminalId??1),r}),id:this.networkSystemLayers.associationsTableId,identifierFields:{globalIdField:r?.globalIdField??"globalid",objectIdField:r?.objectIdField??"objectid"}}}generateDeleteAssociations(e){const{associationsTable:t,associationsTableId:r}=this.networkSystemLayers,s={id:r,identifierFields:{globalIdField:t?.globalIdField??"globalid",objectIdField:t?.objectIdField??"objectid"}};if(-8===this.dataElement?.schemaGeneration){const t=this._generateDeleteTelecomAssociationPayload(e);return{...s,deleteAssociations:t}}const o=e.map(e=>({globalId:e.globalId}));return{...s,deleteFeatures:o}}async loadAssociationsTable(){return this.networkSystemLayers.loadAssociationsTable()}async loadSubnetworksTable(){return this.networkSystemLayers.loadSubnetworksTable()}async _loadNamedTraceConfigurationsFromNetwork(e){if(0===this.sharedNamedTraceConfigurations?.length)return;const t=this.sharedNamedTraceConfigurations.map(e=>e.globalId),r=await this.queryNamedTraceConfigurations({globalIds:t},e);for(const s of this.sharedNamedTraceConfigurations){const e=r?.find(e=>e.globalId===s.globalId);if(e){const t=e.write({},{origin:"service"});s.read(t,{origin:"service"})}}}_hydrateRuleInfo(e,t,r){const s=e.fieldsIndex,o=s.get("RULETYPE"),i=s.get("CREATIONDATE"),a=s.get("FROMNETWORKSOURCEID"),n=s.get("FROMASSETGROUP"),l=s.get("FROMASSETTYPE"),u=s.get("FROMTERMINALID"),d=s.get("TONETWORKSOURCEID"),m=s.get("TOASSETGROUP"),c=s.get("TOASSETTYPE"),y=s.get("TOTERMINALID"),h=s.get("VIANETWORKSOURCEID"),f=s.get("VIAASSETGROUP"),p=s.get("VIAASSETTYPE"),w=s.get("VIATERMINALID"),I=r.attributes[o.name],b=new Date(r.attributes[i.name]),g=[{networkSourceId:r.attributes[a.name],assetGroupId:r.attributes[n.name],assetTypeId:r.attributes[l.name],terminalId:r.attributes[u.name]},{networkSourceId:r.attributes[d.name],assetGroupId:r.attributes[m.name],assetTypeId:r.attributes[c.name],terminalId:r.attributes[y.name]},{networkSourceId:r.attributes[h.name],assetGroupId:r.attributes[f.name],assetTypeId:r.attributes[p.name],terminalId:r.attributes[w.name]}],T={ruleType:I,creationDate:b};for(const k of[0,1,2]){if(5!==I&&2===k)continue;const e=g[k],r=t.find(t=>t.sourceId===e.networkSourceId),s=r?.assetGroups.find(t=>t.assetGroupCode===e.assetGroupId),o=s?.assetTypes.find(t=>t.assetTypeCode===e.assetTypeId),i=this._getTerminal(o,e);let a="";switch(k){case 0:a="from";break;case 1:a="to";break;case 2:a="via"}T[`${a}NetworkSource`]=r,T[`${a}AssetGroup`]=s,T[`${a}AssetType`]=o,T[`${a}Terminal`]=i?.toJSON()}return T}_getTerminal(e,t){const r=e?.terminalConfigurationId,s=this.terminalConfigurations?.find(e=>e.id===r);return s?.terminals?.find(e=>e.id===t.terminalId)??null}async _queryRulesTable(e){const{gdbVersion:t,historicMoment:r}=this,s=new T({where:"1=1",outFields:["*"],gdbVersion:t,historicMoment:r});return(await l(e,s)).features}_generateDeleteTelecomAssociationPayload(e){return e.map(e=>({globalId:e.globalId??w,associationType:I.toJSON(e.associationType),fromSourceId:e.fromNetworkElement.networkSourceId,fromGlobalId:e.fromNetworkElement.globalId,fromTerminalId:e.fromNetworkElement.terminalId,toSourceId:e.toNetworkElement.networkSourceId,toGlobalId:e.toNetworkElement.globalId,toTerminalId:e.toNetworkElement.terminalId}))}};e([i({readOnly:!0})],k.prototype,"_rulesLayer",null),e([i({readOnly:!0})],k.prototype,"_telecomSourceSet",null),e([i({type:[m],json:{origins:{"web-map":{read:{source:"traceConfigurations"},write:{target:"traceConfigurations"}},service:{read:{source:"traceConfigurations"}}},read:!1}})],k.prototype,"sharedNamedTraceConfigurations",void 0),e([i({type:["utility"],readOnly:!0,json:{read:!1,write:!1}})],k.prototype,"type",void 0),e([i({readOnly:!0})],k.prototype,"serviceTerritoryFeatureLayerId",null),e([i({readOnly:!0})],k.prototype,"networkSystemLayers",null),e([i({readOnly:!0})],k.prototype,"terminalConfigurations",null),e([i({readOnly:!0})],k.prototype,"domainNetworkNames",null),e([i({readOnly:!0})],k.prototype,"hasTelecomNetwork",null),e([i({readOnly:!0,json:{read:!1}})],k.prototype,"associationsTable",null),k=e([a("esri.networks.UtilityNetwork")],k);const S=k;export{S as default};

package/networks/support/Circuit.d.ts

@@ -131,7 +131,6 @@ export interface CircuitEvents {}
  *
  * </details>
  *
- * @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/)

package/networks/support/CircuitLocation.d.ts

@@ -5,7 +5,6 @@ export interface CircuitLocationProperties extends Partial<Pick<CircuitLocation,
 /**
  * Represents a circuit start or stop location in a telecom domain 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/)

package/networks/support/CircuitPath.d.ts

@@ -21,7 +21,6 @@ export interface CircuitPathProperties extends Partial<Pick<CircuitPath, "order"
  * Represents a path in the telecom domain network.
  * Paths are returned by path and circuit traces in a telecom domain network.
  *
- * @beta
  * @since 4.34
  */
 export default class CircuitPath extends JSONSupport {

package/networks/support/CircuitPathConnectivityElement.d.ts

@@ -13,7 +13,6 @@ export interface CircuitPathConnectivityElementProperties {
  * Represents the junction and edge that comprise one hop in a path.
  * Used for [paths](https://developers.arcgis.com/javascript/latest/references/core/networks/support/CircuitPath/) in the telecom domain network.
  *
- * @beta
  * @since 4.34
  */
 export default class CircuitPathConnectivityElement extends JSONSupport {

package/networks/support/CircuitSection.d.ts

@@ -98,7 +98,6 @@ export interface CircuitSectionEvents {}
  *
  * </details>
  *
- * @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/)

package/networks/support/NamedTraceConfiguration.d.ts

@@ -60,13 +60,7 @@ export default class NamedTraceConfiguration extends NamedTraceConfigurationSupe
   /** The full definition of the trace configuration. Only available when fully loading a utility network. */
   get traceConfiguration(): TraceConfiguration | null | undefined;
   set traceConfiguration(value: TraceConfigurationProperties | null | undefined);
-  /**
-   * The trace type defined in this trace configuration.
-   *
-   * > [!WARNING]
-   * >
-   * > The `path` and `circuit` types is reserved for future use.
-   */
+  /** The trace type defined in this trace configuration. */
   accessor traceType: TraceType | null | undefined;
   /**
    * Creates a deep clone of the named trace configuration.

package/networks/support/Subcircuit.d.ts

@@ -9,7 +9,6 @@ export interface SubcircuitEvents {}
 /**
  * Represents a subcircuit in a telecom domain 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/)

package/networks/support/UNTraceConfiguration.d.ts

@@ -57,7 +57,6 @@ export default class UNTraceConfiguration extends UNTraceConfigurationSuperclass
    *
    * This option is only honored for circuit traces.
    *
-   * @beta
    * @since 4.34
    */
   accessor circuitName: string | null | undefined;
@@ -102,7 +101,6 @@ export default class UNTraceConfiguration extends UNTraceConfigurationSuperclass
    *
    * This option is only honored for path traces.
    *
-   * @beta
    * @since 4.34
    */
   accessor inferConnectivity: boolean | null | undefined;
@@ -113,7 +111,6 @@ export default class UNTraceConfiguration extends UNTraceConfigurationSuperclass
    *
    * This option is only honored for path or circuit traces.
    *
-   * @beta
    * @since 4.34
    */
   accessor maxHops: number | null | undefined;
@@ -125,7 +122,6 @@ export default class UNTraceConfiguration extends UNTraceConfigurationSuperclass
    *
    * This option is only honored for path traces.
    *
-   * @beta
    * @since 4.34
    */
   accessor numPaths: number | null | undefined;

package/networks/support/jsonTypes.d.ts

@@ -977,7 +977,7 @@ export interface PropagatorJSON {
  */
 export interface ResultType {
   /**
-   * Specifies the return type for the trace. `paths` and `circuits` are reserved for future use.
+   * Specifies the return type for the trace.
    *
    * @since 5.0
    */

package/networks/support/typeUtils.d.ts

@@ -43,4 +43,13 @@ export type AssociationJsonType = "connectivity" | "junctionJunctionConnectivity
 export type AssociationListPopupType = "attachment" | "connectivity" | "container" | "content" | "structure";
 
 /** @since 5.0 */
-export type ValidationType = "normal" | "rebuild" | "force-rebuild";
+export type ValidationType = "normal" | "rebuild" | "force-rebuild";
+
+/** @since 5.2 */
+export type TraverseType = "unspecified" | "dirty-area-expansion" | "first-containers" | "spatial-parents" | "top-containers" | "errors-not-modified" | "modified-objects";
+
+/** @since 5.2 */
+export type DirtyStatusFilterType = "none" | "dirty" | "notDirty";
+
+/** @since 5.2 */
+export type ErrorStatusFilterType = "none" | "inError" | "notInError";

package/networks/support/typeUtils.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{JSONMap as n}from"../../core/jsonMap.js";const t=new n({Clean:"clean",Dirty:"dirty",Invalid:"invalid",Deleted:"deleted"}),e=new n({Physical:"physical",Virtual:"virtual"}),i=new n({consumers:"consumers",providers:"providers","consumers and providers":"consumers-and-providers",none:"none"}),o=new n({"Start and End":"start-and-end",Start:"start",Midspan:"midspan",End:"end"}),c=new n({Available:"available",Consumed:"consumed",Reserved:"reserved"}),r=new n({startingPoint:"starting-point",barrier:"barrier",stoppingPoint:"stopping-point"}),a=new n({connected:"connected",upstream:"upstream",downstream:"downstream",shortestPath:"shortest-path",subnetwork:"subnetwork",subnetworkController:"subnetwork-controller",loops:"loops",isolation:"isolation",path:"path",circuit:"circuit"}),s="{00000000-0000-0000-0000-000000000000}",d=new n({junctionJunctionConnectivity:"junction-junction-connectivity",connectivity:"connectivity",attachment:"attachment",containment:"containment",junctionEdgeFromConnectivity:"junction-edge-from-connectivity",junctionEdgeMidspanConnectivity:"junction-edge-midspan-connectivity",junctionEdgeToConnectivity:"junction-edge-to-connectivity"}),u={connectivity:1,"junction-junction-connectivity":1,containment:2,attachment:3,"junction-edge-from-connectivity":4,"junction-edge-midspan-connectivity":5,"junction-edge-to-connectivity":6},l=new n({normal:"normal",rebuild:"rebuild",forceRebuild:"force-rebuild"});export{u as AssociationTypeEnum,i as CircuitHierarchyKebabDict,o as CircuitSectionRoleKebabDict,t as CircuitStatusKebabDict,e as CircuitTypeKebabDict,d as associationTypeKebabDict,s as nullGuid,c as subcircuitStateKebabDict,r as traceLocationTypeKebabDict,a as traceTypeKebabDict,l as validationTypeKebabDict};
+import{JSONMap as n}from"../../core/jsonMap.js";const t=new n({Clean:"clean",Dirty:"dirty",Invalid:"invalid",Deleted:"deleted"}),e=new n({Physical:"physical",Virtual:"virtual"}),i=new n({consumers:"consumers",providers:"providers","consumers and providers":"consumers-and-providers",none:"none"}),o=new n({"Start and End":"start-and-end",Start:"start",Midspan:"midspan",End:"end"}),r=new n({Available:"available",Consumed:"consumed",Reserved:"reserved"}),c=new n({startingPoint:"starting-point",barrier:"barrier",stoppingPoint:"stopping-point"}),a=new n({connected:"connected",upstream:"upstream",downstream:"downstream",shortestPath:"shortest-path",subnetwork:"subnetwork",subnetworkController:"subnetwork-controller",loops:"loops",isolation:"isolation",path:"path",circuit:"circuit"}),s="{00000000-0000-0000-0000-000000000000}",d=new n({junctionJunctionConnectivity:"junction-junction-connectivity",connectivity:"connectivity",attachment:"attachment",containment:"containment",junctionEdgeFromConnectivity:"junction-edge-from-connectivity",junctionEdgeMidspanConnectivity:"junction-edge-midspan-connectivity",junctionEdgeToConnectivity:"junction-edge-to-connectivity"}),u={connectivity:1,"junction-junction-connectivity":1,containment:2,attachment:3,"junction-edge-from-connectivity":4,"junction-edge-midspan-connectivity":5,"junction-edge-to-connectivity":6},p=new n({normal:"normal",rebuild:"rebuild",forceRebuild:"force-rebuild"}),l=new n({unspecified:"unspecified",dirtyAreaExpansion:"dirty-area-expansion",firstContainers:"first-containers",spatialParents:"spatial-parents",topContainers:"top-containers",errorsNotModified:"errors-not-modified",modifiedObjects:"modified-objects"}),m=new n({none:"none",dirty:"dirty",notDirty:"not-dirty"}),v=new n({none:"none",inError:"in-error",notInError:"not-in-error"});export{u as AssociationTypeEnum,i as CircuitHierarchyKebabDict,o as CircuitSectionRoleKebabDict,t as CircuitStatusKebabDict,e as CircuitTypeKebabDict,d as associationTypeKebabDict,m as dirtyStatusFilterTypeKebabDict,v as errorStatusFilterTypeKebabDict,s as nullGuid,r as subcircuitStateKebabDict,c as traceLocationTypeKebabDict,a as traceTypeKebabDict,l as traverseTypeKebabDict,p as validationTypeKebabDict};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcgis/core",
-  "version": "5.2.0-next.15",
+  "version": "5.2.0-next.17",
   "homepage": "https://js.arcgis.com",
   "description": "ArcGIS Maps SDK for JavaScript: A complete 2D and 3D mapping and data visualization API",
   "keywords": [
@@ -19,9 +19,9 @@
   "license": "SEE LICENSE IN LICENSE.md",
   "dependencies": {
     "@amcharts/amcharts5": "~5.18.0",
-    "@arcgis/toolkit": "^5.1.0-next.130",
+    "@arcgis/toolkit": "^5.1.0-next.132",
     "@esri/arcgis-html-sanitizer": "~4.1.0",
-    "@esri/calcite-components": "^5.1.1-next.3",
+    "@esri/calcite-components": "^5.1.1",
     "@vaadin/grid": "~25.1.4",
     "@zip.js/zip.js": "~2.8.26",
     "luxon": "~3.7.2",

package/popup/Feature.d.ts

@@ -13,12 +13,18 @@ import type { FeatureAbilitiesProperties } from "./support/FeatureAbilities.js";
 import type { GraphicProperties } from "../Graphic.js";
 import type { PointProperties } from "../geometry/Point.js";
 
+/** @internal */
 export interface FeatureProperties extends IdentifiableMixinProperties, Partial<Pick<Feature, "defaultPopupTemplateEnabled" | "map" | "view">> {
-  /** Defines the specific [FeatureAbilities](https://developers.arcgis.com/javascript/latest/references/core/popup/support/FeatureAbilities/) that the [Feature](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature/) component should use when querying and displaying its content. */
+  /**
+   * Defines the specific [FeatureAbilities](https://developers.arcgis.com/javascript/latest/references/core/popup/support/FeatureAbilities/) that the [Feature](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature/) component should use when querying and displaying its content.
+   *
+   * @internal
+   */
   abilities?: FeatureAbilitiesProperties;
   /**
    * The [Graphic](https://developers.arcgis.com/javascript/latest/references/core/Graphic/) used to represent the feature.
    *
+   * @internal
    * @see [PopupTemplate.content](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/#content)
    * @example
    * let graphic = new Graphic({
@@ -50,6 +56,7 @@ export interface FeatureProperties extends IdentifiableMixinProperties, Partial<
    * This value should be set when executing Arcade expressions in the Feature component that
    * expect the `$userInput` profile variable to have a value.
    *
+   * @internal
    * @see [PopupTemplate.content](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/#content)
    * @see [Arcade Profiles: Popup](https://developers.arcgis.com/arcade/profiles/popup/)
    */
@@ -58,6 +65,7 @@ export interface FeatureProperties extends IdentifiableMixinProperties, Partial<
    * The spatial reference used for [Arcade](https://developers.arcgis.com/arcade) operations.
    * This property should be set if executing Arcade expressions that contain [geometry functions](https://developers.arcgis.com/arcade/function-reference/geometry_functions/).
    *
+   * @internal
    * @see [Type system](https://developers.arcgis.com/arcade/guide/types/#featuresetcollection)
    * @see [Arcade Profiles: Popup](https://developers.arcgis.com/arcade/profiles/popup/)
    */
@@ -73,10 +81,13 @@ export interface FeatureProperties extends IdentifiableMixinProperties, Partial<
    * system  | Dates and times will be displayed in the timezone of the device or browser.
    * unknown | Dates and time are not adjusted for any timezone.
    * Specified IANA timezone | Dates and times will be displayed in the specified IANA time zone. See [wikipedia - List of tz database time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones).
+   *
+   * @internal
    */
   timeZone?: TimeZone | null;
 }
 
+/** @internal */
 export type PopupViewModelContent = PopupTemplateContentResolved;
 
 /**
@@ -84,6 +95,7 @@ export type PopupViewModelContent = PopupTemplateContentResolved;
  *
  * The class resolves popup template content for the current [Graphic](https://developers.arcgis.com/javascript/latest/references/core/Graphic/), including evaluating Arcade expressions, formatting attribute values, and fetching related feature information.
  *
+ * @internal
  * @see [Feature component](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature/)
  * @see [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/)
  * @see [Arcade Profiles: Popup](https://developers.arcgis.com/arcade/profiles/popup/)
@@ -91,11 +103,20 @@ export type PopupViewModelContent = PopupTemplateContentResolved;
  * @since 5.1
  */
 export default class Feature extends FeatureSuperclass {
+  /** @internal */
   constructor(properties?: FeatureProperties);
-  /** Defines the specific [FeatureAbilities](https://developers.arcgis.com/javascript/latest/references/core/popup/support/FeatureAbilities/) that the [Feature](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature/) component should use when querying and displaying its content. */
+  /**
+   * Defines the specific [FeatureAbilities](https://developers.arcgis.com/javascript/latest/references/core/popup/support/FeatureAbilities/) that the [Feature](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature/) component should use when querying and displaying its content.
+   *
+   * @internal
+   */
   get abilities(): FeatureAbilities;
   set abilities(value: FeatureAbilitiesProperties);
-  /** The [PopupTemplate.content](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/#content) of the feature. */
+  /**
+   * The [PopupTemplate.content](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/#content) of the feature.
+   *
+   * @internal
+   */
   get content(): PopupViewModelContent | null | undefined;
   /**
    * Enables automatic creation of a popup template for layers that have popups enabled but no
@@ -121,9 +142,14 @@ export default class Feature extends FeatureSuperclass {
    * [WFSLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/WFSLayer/)).
    *
    * @default false
+   * @internal
    */
   accessor defaultPopupTemplateEnabled: boolean;
-  /** A read-only map of Arcade expression names to their evaluated values for the current feature. */
+  /**
+   * A read-only map of Arcade expression names to their evaluated values for the current feature.
+   *
+   * @internal
+   */
   get expressionAttributes(): Record<string, any> | null | undefined;
   /**
    * The formatted attributes calculated from `fieldInfo` [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/)
@@ -133,11 +159,14 @@ export default class Feature extends FeatureSuperclass {
    *    directly at the root level of the [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/), or
    *  * per an individual content element. This element is defined with a [FieldsContent](https://developers.arcgis.com/javascript/latest/references/core/popup/content/FieldsContent/)
    *    popup element set on the PopupTemplate [PopupTemplate.content](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/#content) property.
+   *
+   * @internal
    */
   get formattedAttributes(): FeatureFormattedAttributes | null | undefined;
   /**
    * The [Graphic](https://developers.arcgis.com/javascript/latest/references/core/Graphic/) used to represent the feature.
    *
+   * @internal
    * @see [PopupTemplate.content](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/#content)
    * @example
    * let graphic = new Graphic({
@@ -167,13 +196,20 @@ export default class Feature extends FeatureSuperclass {
    * The heading for the feature.
    *
    * @default ""
+   * @internal
    */
   get heading(): string;
-  /** Indicates whether the current [graphic](#graphic) resides in a non-spatial table. */
+  /**
+   * Indicates whether the current [graphic](#graphic) resides in a non-spatial table.
+   *
+   * @internal
+   */
   get isFeatureFromTable(): boolean;
   /**
    * A read-only property containing metadata regarding the last edit performed on a feature.
    * This object has the following properties:
+   *
+   * @internal
    */
   get lastEditInfo(): LastEditInfo | null | undefined;
   /**
@@ -183,6 +219,7 @@ export default class Feature extends FeatureSuperclass {
    * This value should be set when executing Arcade expressions in the Feature component that
    * expect the `$userInput` profile variable to have a value.
    *
+   * @internal
    * @see [PopupTemplate.content](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/#content)
    * @see [Arcade Profiles: Popup](https://developers.arcgis.com/arcade/profiles/popup/)
    */
@@ -193,6 +230,7 @@ export default class Feature extends FeatureSuperclass {
    *
    * Alternatively, the [view](#view) property can be used to provide the map instance for this property.
    *
+   * @internal
    * @see [Type system](https://developers.arcgis.com/arcade/guide/types/#featuresetcollection)
    * @see [Arcade Profiles: Popup](https://developers.arcgis.com/arcade/profiles/popup/)
    * @example
@@ -204,12 +242,15 @@ export default class Feature extends FeatureSuperclass {
    * A read-only map containing information about related features for the current feature.
    * The keys are related layer IDs as strings, and the values are [RelatedInfo](https://developers.arcgis.com/javascript/latest/references/core/popup/types/#RelatedInfo) objects.
    * This property is populated when the feature has related fields and is used to manage and display related feature information.
+   *
+   * @internal
    */
   get relatedInfos(): Map<string, RelatedInfo>;
   /**
    * The spatial reference used for [Arcade](https://developers.arcgis.com/arcade) operations.
    * This property should be set if executing Arcade expressions that contain [geometry functions](https://developers.arcgis.com/arcade/function-reference/geometry_functions/).
    *
+   * @internal
    * @see [Type system](https://developers.arcgis.com/arcade/guide/types/#featuresetcollection)
    * @see [Arcade Profiles: Popup](https://developers.arcgis.com/arcade/profiles/popup/)
    */
@@ -219,6 +260,7 @@ export default class Feature extends FeatureSuperclass {
    * The current state of the Feature component.
    *
    * @default "disabled"
+   * @internal
    */
   get state(): State;
   /**
@@ -232,6 +274,8 @@ export default class Feature extends FeatureSuperclass {
    * system  | Dates and times will be displayed in the timezone of the device or browser.
    * unknown | Dates and time are not adjusted for any timezone.
    * Specified IANA timezone | Dates and times will be displayed in the specified IANA time zone. See [wikipedia - List of tz database time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones).
+   *
+   * @internal
    */
   get timeZone(): TimeZone;
   set timeZone(value: TimeZone | null | undefined);
@@ -244,9 +288,15 @@ export default class Feature extends FeatureSuperclass {
    * > - The [graphic](#graphic) has a popupTemplate containing Arcade expressions in [ExpressionInfo](https://developers.arcgis.com/javascript/latest/references/core/popup/ExpressionInfo/) or [ExpressionContent](https://developers.arcgis.com/javascript/latest/references/core/popup/content/ExpressionContent/) that may use [geometry functions](https://developers.arcgis.com/arcade/function-reference/geometry_functions/) or reference the `$map` profile variable (i.e. access data from layers within a map).
    * > - Content is displayed from the popup template of an [aggregate feature](https://developers.arcgis.com/javascript/latest/references/core/Graphic/#isAggregate) (i.e. a [cluster](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureReductionCluster/) or [bin](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureReductionBinning/)).
    * > - Values from `date` and `timestamp-offset` [fields](https://developers.arcgis.com/javascript/latest/references/core/layers/support/Field/#type) should respect the view's [time zone](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#timeZone).
+   *
+   * @internal
    */
   accessor view: MapViewOrSceneView | null | undefined;
-  /** Indicates whether the feature is currently waiting for all of its content to finish loading. */
+  /**
+   * Indicates whether the feature is currently waiting for all of its content to finish loading.
+   *
+   * @internal
+   */
   get waitingForContent(): boolean;
   /**
    * Fetches and updates the geometry of the [graphic](#graphic).
@@ -254,6 +304,7 @@ export default class Feature extends FeatureSuperclass {
    * [View2D.goTo()](https://developers.arcgis.com/javascript/latest/references/core/views/View2D/#goTo) with the graphic as the `target`.
    *
    * @returns A promise that resolves when the geometry update attempt has completed.
+   * @internal
    */
   updateGeometry(): Promise<void>;
 }