@arcgis/map-components 5.1.0-next.103 → 5.1.0-next.105

package/dist/components/arcgis-utility-network-trace-inputs/customElement.js

@@ -1,23 +1,23 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
-import { c as w } from "../../chunks/runtime.js";
-import { ref as h } from "lit/directives/ref.js";
+import { c as y } from "../../chunks/runtime.js";
+import { ref as d } from "lit/directives/ref.js";
 import c from "@arcgis/core/core/Collection.js";
 import { watch as _ } from "@arcgis/core/core/reactiveUtils.js";
 import { substitute as k } from "@arcgis/core/intl.js";
 import S from "@arcgis/core/layers/GraphicsLayer.js";
 import T from "@arcgis/core/networks/support/UNTraceConfiguration.js";
 import C from "@arcgis/core/rest/networks/support/TraceLocation.js";
-import p from "@arcgis/core/views/interactive/snapping/FeatureSnappingLayerSource.js";
+import m from "@arcgis/core/views/interactive/snapping/FeatureSnappingLayerSource.js";
 import L from "@arcgis/core/widgets/Sketch/SketchViewModel.js";
 import { LitElement as N, createEvent as l } from "@arcgis/lumina";
 import { usePropertyChange as $ } from "@arcgis/lumina/controllers";
-import { log as d, composeMissingPropertyMessage as v, composeEmptyPropertyMessage as E } from "@arcgis/toolkit/log";
-import { css as P, html as r } from "lit";
+import { log as h, composeMissingPropertyMessage as v, composeEmptyPropertyMessage as P } from "@arcgis/toolkit/log";
+import { css as E, html as r } from "lit";
 import { u as I } from "../../chunks/useT9n.js";
-import { b as U, a as g, c as F, q as m, i as x } from "../../chunks/layer-utils.js";
-import { l as f } from "../../chunks/async-utils.js";
-const A = P`:host{height:100%;flex-grow:1}calcite-flow{min-height:var(--arcgis-internal-panel-height-sm, 240px)}calcite-block-group{flex-grow:1;padding-bottom:var(--calcite-spacing-md);background-color:var(--calcite-color-foreground-1)}calcite-block{--calcite-block-content-space: 0;--calcite-block-border-color: transparent;margin:0}calcite-block calcite-combobox,calcite-block calcite-input{margin:0 var(--calcite-spacing-md)}calcite-block calcite-input-message{padding:var(--calcite-spacing-sm) var(--calcite-spacing-md) 0 var(--calcite-spacing-md)}calcite-notice{margin:var(--calcite-spacing-md)}#subnetwork-info-block{margin:var(--calcite-spacing-md) var(--calcite-spacing-md) 0 var(--calcite-spacing-md)}#results-limited-message{padding:var(--calcite-spacing-sm)}.inline-loader{--calcite-loader-spacing: var(--calcite-spacing-md)}.add-spatial-mode{display:flex;flex-direction:column;gap:var(--calcite-spacing-md);margin:var(--calcite-spacing-md)}.heading{color:var(--calcite-color-text-1);margin:0 0 var(--calcite-spacing-md) 0;font-size:var(--calcite-font-size);font-style:normal;font-weight:var(--calcite-font-weight-medium)}`, u = `utility-network-trace-inputs-sketch-${Date.now()}`, M = 20;
-class D extends N {
+import { b as F, a as g, c as U, q as f, i as x } from "../../chunks/layer-utils.js";
+import { l as b } from "../../chunks/async-utils.js";
+const A = E`:host{height:100%;flex-grow:1}calcite-flow{min-height:var(--arcgis-internal-panel-height-sm, 240px)}calcite-block-group{flex-grow:1;padding-bottom:var(--calcite-spacing-md);background-color:var(--calcite-color-foreground-1)}calcite-block{--calcite-block-content-space: 0;--calcite-block-border-color: transparent;margin:0}calcite-block calcite-combobox,calcite-block calcite-input{margin:0 var(--calcite-spacing-md)}calcite-block calcite-input-message{padding:var(--calcite-spacing-sm) var(--calcite-spacing-md) 0 var(--calcite-spacing-md)}calcite-notice{margin:var(--calcite-spacing-md)}#subnetwork-info-block{margin:var(--calcite-spacing-md) var(--calcite-spacing-md) 0 var(--calcite-spacing-md)}#results-limited-message{padding:var(--calcite-spacing-sm)}.inline-loader{--calcite-loader-spacing: var(--calcite-spacing-md)}.add-spatial-mode{display:flex;flex-direction:column;gap:var(--calcite-spacing-md);margin:var(--calcite-spacing-md)}.heading{color:var(--calcite-color-text-1);margin:0 0 var(--calcite-spacing-md) 0;font-size:var(--calcite-font-size);font-style:normal;font-weight:var(--calcite-font-weight-medium)}`, p = `utility-network-trace-inputs-sketch-${Date.now()}`, D = 20;
+class M extends N {
   constructor() {
     super(...arguments), this._defaultPopupTemplateEnabled = !0, this._messages = I({ blocking: !0 }), this._layerIdToLayer = /* @__PURE__ */ new Map(), this._startingPoints = new c(), this._barriers = new c(), this._stoppingPoints = new c(), this._subnetworkTraceTypes = /* @__PURE__ */ new Set([
       "subnetwork",
@@ -27,12 +27,12 @@ class D extends N {
       "isolation"
     ]), this._setUpMap = () => {
       if (this._error = void 0, !this.view?.map) {
-        d("error", this, "The property `view.map` is required to load utility networks but is missing."), this._error = this._messages.errors.noMapError, this.utilityNetworks = void 0;
+        this._error = this._messages.errors.noView, this.utilityNetworks = void 0;
         return;
       }
       const e = this.view.map;
       this._setupUtilityNetworks(e), this._setupSketchViewModel(e);
-    }, this._removeDuplicateSubnetworkNames = (e, t, i) => t === 0 || e.getAttribute("SUBNETWORKNAME") !== i[t - 1].getAttribute("SUBNETWORKNAME"), this._hitTestPromise = null, this._displayLimit = 20, this._traceLocationStartingRefChange = (e) => {
+    }, this._hitTestPromise = null, this._displayLimit = 20, this._traceLocationStartingRefChange = (e) => {
       e && (this._traceLocationStartingElement = e);
     }, this._traceLocationBarrierRefChange = (e) => {
       e && (this._traceLocationBarrierElement = e);
@@ -45,14 +45,11 @@ class D extends N {
     }, this.candidateFeatures = [], this.compatibleSubnetworkNames = [], this.traceConfigurations = [], this._subnetworkNamesState = "ready", this._exceedDisplayLimit = !1, this.autoDestroyDisabled = !1, this.hideActionBar = !1, this.mode = "default", this.arcgisPropertyChange = $()("mode"), this.arcgisSelectedNamedTraceConfigurationChange = l(), this.arcgisTraceInputsChange = l(), this.arcgisTraceLocationSelectEnd = l(), this.arcgisTraceLocationSelectStart = l(), this.arcgisUtilityNetworkChange = l();
   }
   static {
-    this.properties = { selectedFeature: 16, candidateFeatures: 16, compatibleSubnetworkNames: 16, subnetworksTable: 16, traceConfigurations: 16, utilityNetworks: 16, _unTraceConfiguration: 16, _error: 16, _subnetworkNamesState: 16, _activeTraceLocationType: 16, _exceedDisplayLimit: 16, beforeTraceLocationSelectStart: 0, view: 0, selectedUtilityNetwork: 0, selectedNamedTraceConfiguration: 0, autoDestroyDisabled: 5, hideActionBar: 5, unTraceConfiguration: 32, referenceElement: 1, mode: 3, traceLocationFlagInfos: 32, traceLocations: 32 };
+    this.properties = { selectedFeature: 16, candidateFeatures: 16, compatibleSubnetworkNames: 16, subnetworksTable: 16, traceConfigurations: 16, utilityNetworks: 16, _unTraceConfiguration: 16, _error: 16, _subnetworkNamesState: 16, _activeTraceLocationType: 16, _exceedDisplayLimit: 16, beforeTraceLocationSelectStart: 0, view: 0, selectedUtilityNetwork: 0, selectedNamedTraceConfiguration: 0, autoDestroyDisabled: 5, hideActionBar: 5, unTraceConfiguration: 32, isSubnetworkNameTraceSelected: 32, referenceElement: 1, mode: 3, traceLocationFlagInfos: 32, traceLocations: 32 };
   }
   static {
     this.styles = A;
   }
-  get isSubnetworkNameTraceSelected() {
-    return !!this.selectedSubnetworkName && this.selectedNamedTraceConfiguration?.traceType === "subnetwork";
-  }
   get selectedSubnetworkName() {
     return this._unTraceConfiguration?.subnetworkName ?? void 0;
   }
@@ -77,6 +74,10 @@ class D extends N {
   get unTraceConfiguration() {
     return this._unTraceConfiguration;
   }
+  get isSubnetworkNameTraceSelected() {
+    const { selectedNamedTraceConfiguration: e } = this;
+    return !!e?.traceConfiguration?.subnetworkName && e?.traceType === "subnetwork";
+  }
   get traceLocationFlagInfos() {
     return new c([...this._startingPoints, ...this._barriers, ...this._stoppingPoints]);
   }
@@ -85,7 +86,7 @@ class D extends N {
     return this.showStartingPoints && this._startingPoints.forEach((t) => e.push(...this._createTraceLocations(t))), this.showStoppingPoints && this._stoppingPoints.forEach((t) => e.push(...this._createTraceLocations(t))), this._barriers.forEach((t) => e.push(...this._createTraceLocations(t))), e;
   }
   async destroy() {
-    this._removeGraphicLayer(u), this._clearTraceLocations(), this._sketchViewModel?.cancel(), this._featuresComponentElement?.destroy(), this._traceLocationStartingElement?.destroy(), this._traceLocationBarrierElement?.destroy(), this._traceLocationStoppingElement?.destroy(), await this.manager.destroy();
+    this._removeGraphicLayer(p), this._clearTraceLocations(), this._sketchViewModel?.cancel(), this._featuresComponentElement?.destroy(), this._traceLocationStartingElement?.destroy(), this._traceLocationBarrierElement?.destroy(), this._traceLocationStoppingElement?.destroy(), await this.manager.destroy();
   }
   load() {
     this._setUpMap(), this.manager.onLifecycle(() => [
@@ -124,7 +125,7 @@ class D extends N {
         listMode: "hide",
         title: t
       });
-      U(this.view, a);
+      F(this.view, a);
     }
   }
   _getGraphicLayer(e, t) {
@@ -138,35 +139,34 @@ class D extends N {
     i && g(i) && t?.remove(i);
   }
   _setSnappingOption() {
-    const { _sketchViewModel: e, _unLayers: t } = this;
-    if (e && t && t.length > 0) {
-      const i = new c();
-      t.forEach((a) => {
-        F(a) ? a.sublayers.forEach((s) => {
-          i.add(new p({
-            layer: s,
-            enabled: !0
-          }));
-        }) : i.add(new p({
-          layer: a,
+    if (!this._sketchViewModel)
+      return;
+    const e = new c();
+    this._unLayers?.forEach((t) => {
+      U(t) ? t.sublayers.forEach((i) => {
+        e.add(new m({
+          layer: i,
           enabled: !0
         }));
-      }), e.snappingOptions = {
-        enabled: !0,
-        featureEnabled: !0,
-        featureSources: i
-      };
-    }
+      }) : e.add(new m({
+        layer: t,
+        enabled: !0
+      }));
+    }), this._sketchViewModel.snappingOptions = {
+      enabled: !0,
+      featureEnabled: !0,
+      featureSources: e
+    };
   }
   _initializeSketchViewModel(e) {
-    const { view: t } = this, i = this._getGraphicLayer(e, u);
+    const { view: t } = this, i = this._getGraphicLayer(e, p);
     return new L({
       layer: i,
       view: t
     });
   }
   _setupSketchViewModel(e) {
-    this._createGraphicLayer(e, u), this._sketchViewModel = this._initializeSketchViewModel(e), this._setSnappingOption();
+    this._createGraphicLayer(e, p), this._sketchViewModel = this._initializeSketchViewModel(e), this._setSnappingOption();
   }
   _clearSubnetworks() {
     this.selectedSubnetworkName = void 0, this.subnetworksTable = void 0, this.compatibleSubnetworkNames = [];
@@ -178,10 +178,10 @@ class D extends N {
     const { subnetworksTable: e } = this;
     if (!e)
       return;
-    const t = e.createQuery();
-    t.gdbVersion = this.selectedUtilityNetwork?.gdbVersion, t.where = this._getSubnetworkQueryWhereClause(), t.outFields = ["SUBNETWORKNAME"], t.orderByFields = ["SUBNETWORKNAME"];
-    const { features: i } = await m(e, t, void 0, !1);
-    this.compatibleSubnetworkNames = i.filter(this._removeDuplicateSubnetworkNames).map((a) => a.getAttribute("SUBNETWORKNAME"));
+    const t = e.fieldsIndex.get("SUBNETWORKNAME"), i = (o, n, u) => n === 0 || o.getAttribute(t.name) !== u[n - 1].getAttribute(t.name), a = e.createQuery();
+    a.gdbVersion = this.selectedUtilityNetwork?.gdbVersion, a.where = this._getSubnetworkQueryWhereClause(), a.outFields = [t.name], a.orderByFields = [t.name];
+    const { features: s } = await f(e, a, void 0, !1);
+    this.compatibleSubnetworkNames = s.filter(i).map((o) => o.getAttribute(t.name));
   }
   _getSubnetworkQueryWhereClause() {
     const e = this._unTraceConfiguration, t = `DOMAINNETWORKNAME = '${e.domainNetworkName}'`, i = `TIERNAME = '${e.tierName}'`;
@@ -195,7 +195,7 @@ class D extends N {
   _selectTraceConfigurationByGuid(e) {
     const t = this.selectedUtilityNetwork?.sharedNamedTraceConfigurations.find((i) => i.globalId === e);
     if (!t) {
-      d("error", this, "`traceConfig` not found in `selectedUtilityNetwork.sharedNamedTraceConfigurations`");
+      h("error", this, "`traceConfig` not found in `selectedUtilityNetwork.sharedNamedTraceConfigurations`");
       return;
     }
     this.selectedNamedTraceConfiguration = t;
@@ -203,22 +203,22 @@ class D extends N {
   async _handleTraceConfigChange() {
     const { selectedNamedTraceConfiguration: e } = this;
     if (!(e?.traceConfiguration instanceof T)) {
-      d("error", this, v("selectedNamedTraceConfiguration.traceConfiguration")), this._unTraceConfiguration = void 0;
+      h("error", this, v("selectedNamedTraceConfiguration.traceConfiguration")), this._unTraceConfiguration = void 0;
       return;
     }
-    this._unTraceConfiguration = e.traceConfiguration.clone(), e.traceType === "subnetwork" && (this._subnetworkNamesState = "loading", await this._handleSubnetworkTraceConfigChange(this._unTraceConfiguration), this._subnetworkNamesState = "ready");
+    this._unTraceConfiguration = e.traceConfiguration.clone(), this.isSubnetworkNameTraceSelected && (this._subnetworkNamesState = "loading", await this._handleSubnetworkTraceConfigChange(this._unTraceConfiguration), this._subnetworkNamesState = "ready");
   }
   async _handleSelectedUtilityNetworkChange() {
     const { selectedUtilityNetwork: e } = this;
     try {
       e && !e.loaded && await e.load();
     } catch (t) {
-      f(t, this, "Error while loading the selected utility network");
+      b(t, this, "Error while loading the selected utility network");
     }
     this._clearSubnetworks(), this._setupTraceConfigurations(), this._filterUnLayers(), this._clearTraceLocations();
   }
   _setupTraceConfigurations() {
-    this._unTraceConfiguration = void 0, this.selectedNamedTraceConfiguration = void 0, this.traceConfigurations = this.selectedUtilityNetwork?.sharedNamedTraceConfigurations.filter(Boolean).filter((e) => e.traceType !== "circuit").sort((e, t) => e.title.localeCompare(t.title)) || [], this.traceConfigurations.length ? this.selectedNamedTraceConfiguration = this.traceConfigurations.at(0) : d("error", this, "The selected utility network has no compatible named trace configurations.");
+    this._unTraceConfiguration = void 0, this.selectedNamedTraceConfiguration = void 0, this.traceConfigurations = this.selectedUtilityNetwork?.sharedNamedTraceConfigurations.filter(Boolean).filter((e) => e.traceType !== "circuit").sort((e, t) => e.title.localeCompare(t.title)) || [], this.traceConfigurations.length ? this.selectedNamedTraceConfiguration = this.traceConfigurations.at(0) : h("error", this, "The selected utility network has no compatible named trace configurations.");
   }
   _filterUnLayers() {
     const { selectedUtilityNetwork: e } = this;
@@ -226,13 +226,13 @@ class D extends N {
   }
   _handleUtilityNetworksChange() {
     const { utilityNetworks: e, selectedUtilityNetwork: t } = this;
-    e?.length ? (!t || !e.includes(t)) && (this.selectedUtilityNetwork = e.at(0)) : (d("error", this, E("utilityNetworks")), this.selectedUtilityNetwork = void 0, this._error = this._messages.errors.noUtilityNetworkError);
+    e?.length ? (!t || !e.includes(t)) && (this.selectedUtilityNetwork = e.at(0)) : (h("error", this, P("utilityNetworks")), this.selectedUtilityNetwork = void 0, this._error = this._messages.errors.noUtilityNetwork);
   }
   async _setupUtilityNetworks(e) {
     try {
       e.loaded || await e.load();
     } catch (t) {
-      f(t, this, "Error while loading `view.map`");
+      b(t, this, "Error while loading `view.map`");
     } finally {
       this.utilityNetworks = e.utilityNetworks || new c();
     }
@@ -258,7 +258,7 @@ class D extends N {
   async _queryFeaturesOnLayer(e, t) {
     const i = e.createQuery();
     i.gdbVersion = this.selectedUtilityNetwork?.gdbVersion, i.objectIds = t.map((s) => s.getObjectId()), i.outFields = ["*"];
-    const { features: a } = await m(e, i);
+    const { features: a } = await f(e, i);
     return a.forEach((s) => {
       if (!s.getEffectivePopupTemplate(this._defaultPopupTemplateEnabled)) {
         const o = s.layer;
@@ -322,7 +322,7 @@ class D extends N {
     }}>${i}</calcite-combobox></calcite-block>`;
   }
   renderDefaultMode() {
-    const { selectedUtilityNetwork: e } = this, { noMapError: t, noUtilityNetworkError: i } = this._messages.errors;
+    const { selectedUtilityNetwork: e } = this, { noView: t, noUtilityNetwork: i } = this._messages.errors;
     let a;
     return this._error === t || this._error === i ? a = this.renderError(this._error, !1, "exclamation-mark-triangle") : !e?.loaded && !e?.loadError ? a = this.renderLoader() : a = this.renderContent(), r`<calcite-flow-item .selected=${this.mode === "default"}>${a}</calcite-flow-item>`;
   }
@@ -335,7 +335,7 @@ class D extends N {
     if (!e.length)
       return this.mode = "default", null;
     const t = this._activeTraceLocationType === "starting-point" ? this._messages.labels.addSpatial.startingPoint : this._activeTraceLocationType === "barrier" ? this._messages.labels.addSpatial.barrier : this._messages.labels.addSpatial.stoppingPoint, i = e.length === 1 ? "feature" : "list";
-    return r`<arcgis-features .autoDestroyDisabled=${this.autoDestroyDisabled} .defaultPopupTemplateEnabled=${this._defaultPopupTemplateEnabled} .features=${e} .featureMenuTitle=${t} .hideActionBar=${this.hideActionBar} hide-select-feature .initialDisplayMode=${i} @arcgisClose=${() => this._handleFeaturesClose()} @arcgisPropertyChange=${this._handleFeaturesPropertyChange} open .referenceElement=${this.referenceElement} .view=${this.view} ${h(this._featuresComponentRefChange)}></arcgis-features>`;
+    return r`<arcgis-features .autoDestroyDisabled=${this.autoDestroyDisabled} .defaultPopupTemplateEnabled=${this._defaultPopupTemplateEnabled} .features=${e} .featureMenuTitle=${t} .hideActionBar=${this.hideActionBar} hide-select-feature .initialDisplayMode=${i} @arcgisClose=${() => this._handleFeaturesClose()} @arcgisPropertyChange=${this._handleFeaturesPropertyChange} open .referenceElement=${this.referenceElement} .view=${this.view} ${d(this._featuresComponentRefChange)}></arcgis-features>`;
   }
   renderAddSpatialFooter() {
     const { mode: e, _messages: t, selectedFeature: i, selectedUtilityNetwork: a } = this, s = e === "add-spatial-feature" && this._exceedDisplayLimit && !i, o = k(t.warnings.exceededDisplayLimit, {
@@ -344,13 +344,13 @@ class D extends N {
     return r`${s && r`<calcite-input-message id=results-limited-message icon=exclamation-mark-circle status=idle>${o}</calcite-input-message>` || ""}<calcite-button appearance=outline width=full @click=${() => this._handleAddSpatialCancelClick()} slot=footer>${t.buttons.cancel}</calcite-button>${e === "add-spatial-feature" && r`<calcite-button width=full slot=footer appearance=solid @click=${() => this._handleAddSpatialAddClick()} .disabled=${n}>${t.buttons.add}</calcite-button>` || ""}`;
   }
   renderStartingPointSelection() {
-    return r`<arcgis-utility-network-trace-location .view=${this.view} trace-location-type=starting-point .beforeTraceLocationSelectStart=${this.beforeTraceLocationSelectStart} @arcgisTraceLocationSelectStart=${this._handleTraceLocationSelectStart} @arcgisTraceLocationSelectEnd=${this._handleTraceLocationSelectEnd} @arcgisTraceLocationChange=${() => this.arcgisTraceInputsChange.emit()} .sketchViewModel=${this._sketchViewModel} .utilityNetwork=${this.selectedUtilityNetwork} .filterLayers=${this._unLayers} .traceLocations=${this._startingPoints} .afterHitTest=${this._handleHitTestComplete.bind(this)} .autoDestroyDisabled=${this.autoDestroyDisabled} ${h(this._traceLocationStartingRefChange)}></arcgis-utility-network-trace-location>`;
+    return r`<arcgis-utility-network-trace-location .view=${this.view} trace-location-type=starting-point .beforeTraceLocationSelectStart=${this.beforeTraceLocationSelectStart} @arcgisTraceLocationSelectStart=${this._handleTraceLocationSelectStart} @arcgisTraceLocationSelectEnd=${this._handleTraceLocationSelectEnd} @arcgisTraceLocationChange=${() => this.arcgisTraceInputsChange.emit()} .sketchViewModel=${this._sketchViewModel} .utilityNetwork=${this.selectedUtilityNetwork} .filterLayers=${this._unLayers} .traceLocations=${this._startingPoints} .afterHitTest=${this._handleHitTestComplete.bind(this)} .autoDestroyDisabled=${this.autoDestroyDisabled} ${d(this._traceLocationStartingRefChange)}></arcgis-utility-network-trace-location>`;
   }
   renderStoppingPointSelection() {
-    return r`<arcgis-utility-network-trace-location .view=${this.view} trace-location-type=stopping-point .beforeTraceLocationSelectStart=${this.beforeTraceLocationSelectStart} @arcgisTraceLocationSelectStart=${this._handleTraceLocationSelectStart} @arcgisTraceLocationSelectEnd=${this._handleTraceLocationSelectEnd} @arcgisTraceLocationChange=${() => this.arcgisTraceInputsChange.emit()} .sketchViewModel=${this._sketchViewModel} .utilityNetwork=${this.selectedUtilityNetwork} .filterLayers=${this._unLayers} .traceLocations=${this._stoppingPoints} .afterHitTest=${this._handleHitTestComplete.bind(this)} .autoDestroyDisabled=${this.autoDestroyDisabled} ${h(this._traceLocationStoppingRefChange)}></arcgis-utility-network-trace-location>`;
+    return r`<arcgis-utility-network-trace-location .view=${this.view} trace-location-type=stopping-point .beforeTraceLocationSelectStart=${this.beforeTraceLocationSelectStart} @arcgisTraceLocationSelectStart=${this._handleTraceLocationSelectStart} @arcgisTraceLocationSelectEnd=${this._handleTraceLocationSelectEnd} @arcgisTraceLocationChange=${() => this.arcgisTraceInputsChange.emit()} .sketchViewModel=${this._sketchViewModel} .utilityNetwork=${this.selectedUtilityNetwork} .filterLayers=${this._unLayers} .traceLocations=${this._stoppingPoints} .afterHitTest=${this._handleHitTestComplete.bind(this)} .autoDestroyDisabled=${this.autoDestroyDisabled} ${d(this._traceLocationStoppingRefChange)}></arcgis-utility-network-trace-location>`;
   }
   renderBarrierSelection() {
-    return r`<arcgis-utility-network-trace-location .view=${this.view} trace-location-type=barrier .beforeTraceLocationSelectStart=${this.beforeTraceLocationSelectStart} @arcgisTraceLocationSelectStart=${this._handleTraceLocationSelectStart} @arcgisTraceLocationSelectEnd=${this._handleTraceLocationSelectEnd} @arcgisTraceLocationChange=${() => this.arcgisTraceInputsChange.emit()} .sketchViewModel=${this._sketchViewModel} .utilityNetwork=${this.selectedUtilityNetwork} .filterLayers=${this._unLayers} .traceLocations=${this._barriers} .afterHitTest=${this._handleHitTestComplete.bind(this)} .autoDestroyDisabled=${this.autoDestroyDisabled} ${h(this._traceLocationBarrierRefChange)}></arcgis-utility-network-trace-location>`;
+    return r`<arcgis-utility-network-trace-location .view=${this.view} trace-location-type=barrier .beforeTraceLocationSelectStart=${this.beforeTraceLocationSelectStart} @arcgisTraceLocationSelectStart=${this._handleTraceLocationSelectStart} @arcgisTraceLocationSelectEnd=${this._handleTraceLocationSelectEnd} @arcgisTraceLocationChange=${() => this.arcgisTraceInputsChange.emit()} .sketchViewModel=${this._sketchViewModel} .utilityNetwork=${this.selectedUtilityNetwork} .filterLayers=${this._unLayers} .traceLocations=${this._barriers} .afterHitTest=${this._handleHitTestComplete.bind(this)} .autoDestroyDisabled=${this.autoDestroyDisabled} ${d(this._traceLocationBarrierRefChange)}></arcgis-utility-network-trace-location>`;
   }
   renderSubnetworkNameInput() {
     return r`<calcite-input clearable type=text .placeholder=${this._messages.instructions.enterSubnetworkName} max-length=64 .status=${this.selectedSubnetworkName ? "valid" : "invalid"} .value=${this.selectedSubnetworkName} @calciteInputInput=${(e) => this.selectedSubnetworkName = e.target.value}></calcite-input><calcite-input-message icon=exclamation-mark-triangle status=idle>${this._messages.labels.tooManySubnetworks}</calcite-input-message>`;
@@ -362,7 +362,7 @@ class D extends N {
   }
   renderSubnetworkSelection() {
     const { compatibleSubnetworkNames: e } = this, t = this._messages.labels.subnetworkName;
-    return this.isSubnetworkNameTraceSelected ? this._subnetworkNamesState === "loading" ? r`<calcite-loader class="inline-loader" label=loading scale=s></calcite-loader>` : e.length ? r`<calcite-block .heading=${t} .label=${t} expanded>${e.length > M ? this.renderSubnetworkNameInput() : this.renderSubnetworkSelectList()}</calcite-block>` : this.renderError(this._messages.errors.noCompatibleSubnetworks, !1, "exclamation-mark-triangle") : null;
+    return this.isSubnetworkNameTraceSelected ? this._subnetworkNamesState === "loading" ? r`<calcite-loader class="inline-loader" label=loading scale=s></calcite-loader>` : e.length ? r`<calcite-block .heading=${t} .label=${t} expanded>${e.length > D ? this.renderSubnetworkNameInput() : this.renderSubnetworkSelectList()}</calcite-block>` : this.renderError(this._messages.errors.noCompatibleSubnetworks, !1, "exclamation-mark-triangle") : null;
   }
   renderSubnetworkInfo() {
     const { _messages: e, selectedNamedTraceConfiguration: t, _unTraceConfiguration: i } = this;
@@ -372,15 +372,15 @@ class D extends N {
     const { utilityNetworks: e, unTraceConfiguration: t } = this, { noTraceConfiguration: i, noNamedTraceConfigurations: a, utilityNetworkLoadFailed: s } = this._messages.errors, o = e && e.length > 1 ? this.renderUtilityNetworkSelection() : null;
     let n;
     this.selectedUtilityNetwork?.loadError ? n = this.renderError(s, !1, "exclamation-mark-triangle") : this.traceConfigurations.length || (n = this.renderError(a, !1, "exclamation-mark-triangle"));
-    const b = r`${this.renderTraceSelection()}${this.renderSubnetworkInfo()}${this.renderSubnetworkSelection()}`, y = t ? r`${this.showStartingPoints ? this.renderStartingPointSelection() : null}${this.showStoppingPoints ? this.renderStoppingPointSelection() : null}${this.renderBarrierSelection()}` : this.renderError(i, !1, "exclamation-mark-triangle");
-    return r`<calcite-block-group .label=${this._messages.labels.traceInputs}>${o}${n ?? r`${b}${y}`}</calcite-block-group>`;
+    const u = r`${this.renderTraceSelection()}${this.renderSubnetworkInfo()}${this.renderSubnetworkSelection()}`, w = t ? r`${this.showStartingPoints ? this.renderStartingPointSelection() : null}${this.showStoppingPoints ? this.renderStoppingPointSelection() : null}${this.renderBarrierSelection()}` : this.renderError(i, !1, "exclamation-mark-triangle");
+    return r`<calcite-block-group .label=${this._messages.labels.traceInputs}>${o}${n ?? r`${u}${w}`}</calcite-block-group>`;
   }
   render() {
     const { mode: e } = this;
     return r`<calcite-panel>${e === "add-spatial-feature" ? this.renderCandidateFeatures() : null}<calcite-flow .hidden=${e === "add-spatial-feature"}>${this.renderDefaultMode()}${this.renderSpatialSelectInstructions()}</calcite-flow>${e !== "default" ? this.renderAddSpatialFooter() : null}</calcite-panel>`;
   }
 }
-w("arcgis-utility-network-trace-inputs", D);
+y("arcgis-utility-network-trace-inputs", M);
 export {
-  D as ArcgisUtilityNetworkTraceInputs
+  M as ArcgisUtilityNetworkTraceInputs
 };

package/dist/components/arcgis-utility-network-validate-network-topology/customElement.d.ts

@@ -6,6 +6,101 @@ import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 import type { ArcgisReferenceElement } from "../types.js";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
 
+/** Component state when validation is unavailable because the component cannot run. */
+export interface Disabled {
+  type: "disabled";
+}
+
+/** Component state while utility network topology validation is currently running. */
+export interface Executing {
+  type: "executing";
+}
+
+/** Component state while component dependencies are loading. */
+export interface Loading {
+  type: "loading";
+}
+
+/** Component state when component dependencies are loaded and validation can execute. */
+export interface Ready {
+  type: "ready";
+}
+
+/** Component state after validation completes successfully. */
+export interface Success {
+  type: "success";
+  message: string;
+}
+
+/** Component state when validation or setup encounters an error. */
+export interface ValidateNetworkTopologyError {
+  /**
+   * The type of error the component has encountered:
+   *
+   * - `error-disable-component`: The component is disabled because the component could not find a utility network in the map.
+   * - `error-disable-execute`: The component cannot run validation because the user lacks permissions or the dirty areas layer is missing from the map.
+   * - `error-info`: Some other error occurred while running validation. The error is displayed in the component.
+   */
+  type: "error-disable-component" | "error-disable-execute" | "error-info";
+  /** Additional information about the error the component has encountered. */
+  message: string;
+}
+
+/** The extent options for network topology validation. */
+export type ExtentOption = "current" | "entire";
+
+/** The current component workflow state. */
+export type State = Disabled | Executing | Loading | Ready | Success | ValidateNetworkTopologyError;
+
+/**
+ * ## Overview
+ *
+ * The Utility Network Validate Network Topology component validates dirty areas in a utility network after edits have been made.
+ * It provides an interface to choose a utility network (if applicable), choose the [extent](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-validate-network-topology/#extentToValidate) to validate, and perform validation.
+ * If successful, the result of the validation is available as [result](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-validate-network-topology/#result).
+ *
+ * ## Validation requirements
+ *
+ * - The component only supports a 2D [MapView](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/).
+ * - The utility network must be [stored in the map](https://developers.arcgis.com/javascript/latest/references/core/WebMap/#utilityNetworks) and the network topology must be enabled.
+ * - The active portal user must have the required user type extension to validate a network topology.
+ * - Validation fails in cases such as: no dirty areas in the target extent, inability to acquire a version lock, or insufficient permissions on the version.
+ *
+ * > [!WARNING]
+ * >
+ * > The Utility Network Validate Network Topology component does not support proxied feature services or feature services that utilize stored credentials.
+ *
+ * ## Examples
+ *
+ * This component can be used slotted into an [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/):
+ *
+ * ```html
+ * <arcgis-map item-id="471eb0bf37074b1fbb972b1da70fb310">
+ *   <arcgis-utility-network-validate-network-topology slot="top-right"></arcgis-utility-network-validate-network-topology>
+ * </arcgis-map>
+ * ```
+ *
+ * Alternatively, this component can be used outside of a map by providing a [referenceElement](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-validate-network-topology/#referenceElement):
+ *
+ * ```html
+ * <calcite-shell>
+ *   <calcite-shell-panel slot="panel-start" position="start" width-scale="l">
+ *     <arcgis-utility-network-validate-network-topology reference-element="#map-element"></arcgis-utility-network-validate-network-topology>
+ *   </calcite-shell-panel>
+ *   <arcgis-map id="map-element" item-id="471eb0bf37074b1fbb972b1da70fb310"></arcgis-map>
+ * </calcite-shell>
+ * ```
+ *
+ * <video>
+ *   <source src="https://developers.arcgis.com/javascript/latest/assets/references/core/components/utility-network-validate-network-topology/validate-topology-example.webm" autoplay loop muted playsinline type="video/webm">
+ *   Your browser does not support the video tag.
+ * </video>
+ *
+ * @since 5.1
+ * @see [Network topology](https://pro.arcgis.com/en/pro-app/latest/help/data/utility-network/about-network-topology.htm)
+ * @see [Validate a network topology](https://pro.arcgis.com/en/pro-app/latest/help/data/utility-network/validate-a-network-topology.htm)
+ * @see [Dirty areas](https://pro.arcgis.com/en/pro-app/latest/help/data/utility-network/dirty-areas-in-a-utility-network.htm)
+ */
 export abstract class ArcgisUtilityNetworkValidateNetworkTopology extends LitElement {
   /** @internal */
   protected _messages: {
@@ -72,16 +167,41 @@ export abstract class ArcgisUtilityNetworkValidateNetworkTopology extends LitEle
       };
   }>;
   /**
-   * A function to run before validate utility network topology starts.
+   * A function to run before utility network topology validation starts.
+   *
+   * The function is awaited before the [@arcgisValidateNetworkTopologyStart](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-validate-network-topology/#event-arcgisValidateNetworkTopologyStart)
+   * event is emitted and before the validation request is sent.
+   * If the function rejects its Promise, validation does not start and the component displays an error. If the Promise was rejected with an [Error](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error), the component displays the error.
    *
    * @internal
+   * @example
+   * ```js
+   * const validateNetworkTopologyElement = document.querySelector("arcgis-utility-network-validate-network-topology");
+   * validateNetworkTopologyElement.beforeValidateNetworkTopologyStart = async () => await doAsyncWork();
+   * ```
    */
   accessor beforeValidateNetworkTopologyStart: (() => Promise<void>) | undefined;
-  /** @default false */
+  /**
+   * When true, the component is visually withdrawn and cannot receive user interaction.
+   *
+   * @default false
+   */
   accessor disabled: boolean;
-  /** @default "current" */
+  /**
+   * Specifies the area to validate.
+   *
+   * Use `"current"` to validate the current view extent. Use `"entire"` to validate the utility network's full extent.
+   *
+   * @default "current"
+   */
   accessor extentToValidate: ExtentOption;
-  /** @default false */
+  /**
+   * When true, hides the utility network selector.
+   *
+   * The selector is also hidden when the map has one utility network.
+   *
+   * @default false
+   */
   accessor hideUtilityNetworkSelect: boolean;
   /** The component's default label. */
   accessor label: string | undefined;
@@ -128,46 +248,52 @@ export abstract class ArcgisUtilityNetworkValidateNetworkTopology extends LitEle
    * @see [Associate components with a Map or Scene component](https://developers.arcgis.com/javascript/latest/programming-patterns/#associate-components-with-a-map-or-scene-component)
    */
   accessor referenceElement: ArcgisReferenceElement | string | undefined;
+  /**
+   * The result returned from the most recent successful utility network topology validation.
+   * This value is cleared when clicking the "Validate" action.
+   */
   accessor result: ValidateNetworkTopologyResult | undefined;
-  accessor state: State;
+  /** The current component state. */
+  get state(): State;
+  /**
+   * The utility network to validate.
+   *
+   * If not provided, the component uses the first utility network stored in the map. When the map contains multiple
+   * utility networks and the selector is visible, the user can change this value from the component UI.
+   */
   accessor utilityNetwork: UtilityNetwork | undefined;
+  /**
+   * The target [MapView](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/).
+   *
+   * The component only supports 2D map views.
+   */
   accessor view: MapView | undefined;
+  /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
   readonly arcgisReady: import("@arcgis/lumina").TargetedEvent<this, void>;
+  /**
+   * Fires after a validation workflow ends.
+   *
+   * This event fires after validation succeeds, fails, or is canceled by preventing the
+   * [@arcgisValidateNetworkTopologyStart](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-validate-network-topology/#event-arcgisValidateNetworkTopologyStart) event.
+   */
   readonly arcgisValidateNetworkTopologyEnd: import("@arcgis/lumina").TargetedEvent<this, void>;
+  /**
+   * Fires before the validation request is sent.
+   *
+   * This event can be prevented with `event.preventDefault()` to cancel validation.
+   *
+   * @example
+   * ```js
+   * const validateNetworkTopologyElement = document.querySelector("arcgis-utility-network-validate-network-topology");
+   * validateNetworkTopologyElement.addEventListener("arcgisValidateNetworkTopologyStart", (event) => {
+   *   event.preventDefault();
+   * });
+   * ```
+   */
   readonly arcgisValidateNetworkTopologyStart: import("@arcgis/lumina").TargetedEvent<this, void>;
   readonly "@eventTypes": {
     arcgisReady: ArcgisUtilityNetworkValidateNetworkTopology["arcgisReady"]["detail"];
     arcgisValidateNetworkTopologyEnd: ArcgisUtilityNetworkValidateNetworkTopology["arcgisValidateNetworkTopologyEnd"]["detail"];
     arcgisValidateNetworkTopologyStart: ArcgisUtilityNetworkValidateNetworkTopology["arcgisValidateNetworkTopologyStart"]["detail"];
   };
-}
-
-export type ExtentOption = "current" | "entire";
-
-export type State = Disabled | Executing | Loading | Ready | Success | ValidateNetworkTopologyError;
-
-export interface Disabled {
-  type: "disabled";
-}
-
-export interface Executing {
-  type: "executing";
-}
-
-export interface Loading {
-  type: "loading";
-}
-
-export interface Ready {
-  type: "ready";
-}
-
-export interface Success {
-  type: "success";
-  message: string;
-}
-
-export interface ValidateNetworkTopologyError {
-  type: "error-disable-component" | "error-disable-execute" | "error-info";
-  message: string;
 }

package/dist/components/arcgis-utility-network-validate-topology/customElement.d.ts

@@ -8,9 +8,13 @@ import type { Icon } from "@esri/calcite-components/components/calcite-icon";
 import type { UtilityNetworkValidateTopologyViewModelState } from "@arcgis/core/widgets/UtilityNetworkValidateTopology/UtilityNetworkValidateTopologyViewModel.js";
 
 /**
- * The UtilityNetworkValidateTopology component simplifies the process of validating a DirtyArea within a utility network. It offers an intuitive user interface, reducing the complexity of working with utility network associations.
+ * > This component is **deprecated**. [arcgis-utility-network-validate-network-topology](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-validate-network-topology/) is the preferred component for validating utility network topology and should be used for all new development.
+ *
+ * The UtilityNetworkValidateTopology component simplifies the process of validating a DirtyArea within a utility network. It offers an intuitive user interface.
  *
  * > The UtilityNetworkValidateTopology Component does not support proxied feature services or feature services that utilize stored credentials.
+ *
+ * @deprecated since 5.1, use [arcgis-utility-network-validate-network-topology](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-validate-network-topology/) instead.
  */
 export abstract class ArcgisUtilityNetworkValidateTopology extends LitElement {
   /**