@arcgis/map-components 5.0.0-next.12 → 5.0.0-next.120

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

@@ -1,63 +1,85 @@
-import { c as b } from "../../chunks/runtime.js";
-import { repeat as h } from "lit/directives/repeat.js";
-import { queryAllJSON as m } from "@arcgis/core/applications/Components/featureUtils.js";
-import n from "@arcgis/core/core/Collection.js";
+import { c as y } from "../../chunks/runtime.js";
+import { repeat as d } from "lit/directives/repeat.js";
+import { queryAllJSON as b } from "@arcgis/core/applications/Components/featureUtils.js";
+import s from "@arcgis/core/core/Collection.js";
 import f from "@arcgis/core/layers/GraphicsLayer.js";
-import d from "@arcgis/core/networks/support/UNTraceConfiguration.js";
-import _ from "@arcgis/core/rest/support/FeatureSet.js";
+import S from "@arcgis/core/networks/support/UNTraceConfiguration.js";
+import _ from "@arcgis/core/rest/networks/support/TraceLocation.js";
+import T from "@arcgis/core/rest/support/FeatureSet.js";
 import u from "@arcgis/core/views/interactive/snapping/FeatureSnappingLayerSource.js";
-import S from "@arcgis/core/widgets/Sketch/SketchViewModel.js";
-import { LitElement as T, createEvent as g, safeClassMap as p } from "@arcgis/lumina";
-import { css as N, html as s } from "lit";
-import { u as $ } from "../../chunks/useT9n.js";
+import N from "@arcgis/core/widgets/Sketch/SketchViewModel.js";
+import { LitElement as L, createEvent as c, safeClassMap as h } from "@arcgis/lumina";
+import { css as $, html as r } from "lit";
+import { u as C } from "../../chunks/useT9n.js";
+import { usePropertyChange as v } from "@arcgis/lumina/controllers";
+import { log as l, composeMissingPropertyMessage as U, composeEmptyPropertyMessage as E } from "@arcgis/toolkit/log";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/5.0/esri/copyright.txt for details.
-v5.0.0-next.12 */
-const L = N`:host{min-width:300px}.arcgis-utility-network-trace-inputs calcite-block{--calcite-block-content-space: 0;--calcite-block-border-color: transparent;margin:0}.arcgis-utility-network-trace-inputs calcite-block-group{padding-bottom:var(--calcite-spacing-md);background-color:var(--calcite-color-foreground-1)}.arcgis-utility-network-trace-inputs calcite-block calcite-select{padding:0 var(--calcite-spacing-md)}.arcgis-utility-network-trace-inputs calcite-block calcite-label:last-child{--calcite-label-margin-bottom: 0}.arcgis-utility-network-trace-inputs calcite-notice{padding:var(--calcite-spacing-md)}.arcgis-utility-network-trace-inputs .inline-loader{--calcite-loader-spacing: var(--calcite-spacing-md)}.arcgis-utility-network-trace-inputs__add-spatial-mode{display:flex;padding:var(--calcite-spacing-xxl) var(--calcite-spacing-sm);flex-direction:column;justify-content:center;align-items:center;gap:var(--calcite-spacing-md);align-self:stretch}.arcgis-utility-network-trace-inputs .subnetwork-info-block{padding-top:var(--calcite-spacing-md);padding-left:var(--calcite-spacing-md);padding-right:var(--calcite-spacing-md)}`, w = "arcgis-utility-network-trace-inputs", k = {
+v5.0.0-next.120 */
+const M = $`:host{width:100%}.arcgis-utility-network-trace-inputs calcite-block{--calcite-block-content-space: 0;--calcite-block-border-color: transparent;margin:0}.arcgis-utility-network-trace-inputs calcite-block-group{padding-bottom:var(--calcite-spacing-md);background-color:var(--calcite-color-foreground-1)}.arcgis-utility-network-trace-inputs calcite-block calcite-select,.arcgis-utility-network-trace-inputs calcite-block calcite-input{padding:0 var(--calcite-spacing-md)}.arcgis-utility-network-trace-inputs calcite-block calcite-label:last-child{--calcite-label-margin-bottom: 0}.arcgis-utility-network-trace-inputs calcite-notice{padding:var(--calcite-spacing-md)}.arcgis-utility-network-trace-inputs .inline-loader{--calcite-loader-spacing: var(--calcite-spacing-md)}.arcgis-utility-network-trace-inputs__add-spatial-mode{display:flex;height:300px;padding:var(--calcite-spacing-xxl) var(--calcite-spacing-sm);flex-direction:column;justify-content:center;align-items:center;gap:var(--calcite-spacing-md);align-self:stretch}.arcgis-utility-network-trace-inputs .subnetwork-info-block{padding-top:var(--calcite-spacing-md);padding-left:var(--calcite-spacing-md);padding-right:var(--calcite-spacing-md)}`, g = "arcgis-utility-network-trace-inputs", p = {
   // popup renderer
-  base: w,
+  base: g,
   // containers and content
-  addSpatialMode: `${w}__add-spatial-mode`
-}, c = "map-components:utility-network-trace-inputs", y = `utility-network-trace-inputs-sketch-${Date.now()}`, l = `utility-network-trace-inputs-flags-${Date.now()}`;
-class C extends T {
+  addSpatialMode: `${g}__add-spatial-mode`
+}, w = `utility-network-trace-inputs-sketch-${Date.now()}`, n = `utility-network-trace-inputs-flags-${Date.now()}`, I = 20;
+class P extends L {
   constructor() {
-    super(...arguments), this._messages = $({ blocking: !0 }), this._startingPoints = new n(), this._barriers = new n(), this._stoppingPoints = new n(), this._subnetworkTraceTypes = /* @__PURE__ */ new Set([
+    super(...arguments), this._messages = C({ blocking: !0 }), this._startingPoints = new s(), this._barriers = new s(), this._stoppingPoints = new s(), this._subnetworkTraceTypes = /* @__PURE__ */ new Set([
       "subnetwork",
       "subnetwork-controller",
       "upstream",
       "downstream",
       "isolation"
-    ]), this._removeDuplicateSubnetworkNames = (e, t, i) => t === 0 || e.getAttribute("SUBNETWORKNAME") !== i[t - 1].getAttribute("SUBNETWORKNAME"), this.compatibleSubnetworkNames = [], this.traceConfigurations = [], this._state = "ready", this._mode = "default", this.arcgisTraceInputsChange = g(), this.arcgisUtilityNetworkChange = g();
+    ]), this._removeDuplicateSubnetworkNames = (e, t, i) => t === 0 || e.getAttribute("SUBNETWORKNAME") !== i[t - 1].getAttribute("SUBNETWORKNAME"), this.compatibleSubnetworkNames = [], this.traceConfigurations = [], this._state = "ready", this.mode = "default", this.arcgisTraceInputsChange = c(), this.arcgisUtilityNetworkChange = c(), this.arcgisTraceLocationSelectStart = c(), this.arcgisTraceLocationSelectEnd = c(), this.arcgisPropertyChange = v()("mode");
   }
   static {
-    this.properties = { compatibleSubnetworkNames: 16, subnetworksTable: 16, traceConfigurations: 16, utilityNetworks: 16, _state: 16, _mode: 16, _activeTraceLocationType: 16, view: 0, selectedSubnetworkName: 1, selectedUtilityNetwork: 0, selectedTraceConfiguration: 0, referenceElement: 1, traceLocations: 32 };
+    this.properties = { compatibleSubnetworkNames: 16, subnetworksTable: 16, traceConfigurations: 16, utilityNetworks: 16, _unTraceConfiguration: 16, _state: 16, _activeTraceLocationType: 16, beforeTraceLocationSelectStart: 0, view: 0, selectedUtilityNetwork: 0, selectedNamedTraceConfiguration: 0, unTraceConfiguration: 32, referenceElement: 1, mode: 1, traceLocations: 32 };
   }
   static {
-    this.styles = L;
+    this.styles = M;
+  }
+  get selectedSubnetworkName() {
+    return this._unTraceConfiguration?.subnetworkName ?? void 0;
+  }
+  set selectedSubnetworkName(e) {
+    this._unTraceConfiguration && (this._unTraceConfiguration.subnetworkName = e);
   }
   get _allLayers() {
     const { view: e } = this;
     return e?.map ? e.map.allLayers.toArray().concat(e.map.allTables.toArray()) : [];
   }
+  get unTraceConfiguration() {
+    return this._unTraceConfiguration;
+  }
   get traceLocations() {
-    const e = this._startingPoints.toArray().map((a) => a.traceLocation), t = this._barriers.toArray().map((a) => a.traceLocation), i = this._stoppingPoints.toArray().map((a) => a.traceLocation);
-    return [...e, ...t, ...i];
+    const e = [], t = (i) => {
+      i.flagProperties.terminalConfiguration && i.flagProperties.selectedTerminals ? i.flagProperties.selectedTerminals.forEach((o) => {
+        e.push(new _({
+          type: i.traceLocation.type,
+          isFilterBarrier: i.traceLocation.isFilterBarrier,
+          globalId: i.traceLocation.globalId,
+          percentAlong: i.traceLocation.percentAlong,
+          terminalId: o
+        }));
+      }) : e.push(i.traceLocation);
+    };
+    return this._startingPoints.forEach((i) => t(i)), this._barriers.forEach((i) => t(i)), this._stoppingPoints.forEach((i) => t(i)), e;
   }
   load() {
     this._setupUtilityNetwork(), this._setupSketchViewModel();
   }
   willUpdate(e) {
     const { utilityNetworks: t, selectedUtilityNetwork: i } = this;
-    (e.has("utilityNetworks") || !t || t.length === 0 || !i || !t?.includes(i)) && this._handleUtilityNetworksChange(), e.has("selectedUtilityNetwork") && (this.arcgisUtilityNetworkChange.emit(), this._handleSelectedUtilityNetworkChange()), e.has("selectedTraceConfiguration") && (this.arcgisTraceInputsChange.emit(), this._handleTraceConfigChange()), e.has("selectedSubnetworkName") && this.arcgisTraceInputsChange.emit();
+    (e.has("utilityNetworks") || !t || t.length === 0 || !i || !t?.includes(i)) && this._handleUtilityNetworksChange(), e.has("selectedUtilityNetwork") && (this.arcgisUtilityNetworkChange.emit(), this._handleSelectedUtilityNetworkChange()), e.has("selectedNamedTraceConfiguration") && (this.arcgisTraceInputsChange.emit(), this._handleTraceConfigChange()), e.has("selectedSubnetworkName") && this.arcgisTraceInputsChange.emit();
   }
   _clearTraceLocations() {
-    this._getGraphicLayer(l)?.removeAll(), this._startingPoints.removeAll(), this._barriers.removeAll(), this._stoppingPoints.removeAll();
+    this._getGraphicLayer(n)?.removeAll(), this._startingPoints.removeAll(), this._barriers.removeAll(), this._stoppingPoints.removeAll();
   }
-  _addUniqueLayer(e, t, i) {
+  _addUniqueLayer(e, t) {
     if (!t || !e?.map)
       return;
-    const { map: a } = e, r = a.layers.find((o) => o === t);
-    r || a.add(t, i), r && i != null && a.layers.reorder(r, i);
+    const { map: i } = e;
+    i.layers.find((o) => o === t) || i.add(t), i.reorder(t, i.layers.length - 1);
   }
   _createGraphicLayer(e) {
     const { map: t } = this.view;
@@ -74,19 +96,19 @@ class C extends T {
     const { map: t } = this.view;
     if (t) {
       const i = t.findLayerById(e);
-      if (i && i.type === "graphics")
-        return i;
+      if (i?.type === "graphics")
+        return t.reorder(i, t.layers.length - 1), i;
     }
     return null;
   }
   _setSnappingOption() {
     const { _sketchViewModel: e, _unLayers: t } = this;
     if (e && t && t.length > 0) {
-      const i = new n();
+      const i = new s();
       t.forEach((a) => {
-        a.type === "subtype-group" ? a.sublayers.forEach((r) => {
+        a.type === "subtype-group" ? a.sublayers.forEach((o) => {
           i.add(new u({
-            layer: r,
+            layer: o,
             enabled: !0
           }));
         }) : i.add(new u({
@@ -101,17 +123,17 @@ class C extends T {
     }
   }
   _initializeSketchViewModel() {
-    const { view: e, _unLayers: t } = this, i = this._getGraphicLayer(y), a = new n();
-    return t?.forEach((r) => a.add(new u({
-      layer: r,
+    const { view: e, _unLayers: t } = this, i = this._getGraphicLayer(w), a = new s();
+    return t?.forEach((o) => a.add(new u({
+      layer: o,
       enabled: !0
-    }))), new S({
+    }))), new N({
       layer: i,
       view: e
     });
   }
   _setupSketchViewModel() {
-    this._createGraphicLayer(y), this._createGraphicLayer(l), this._sketchViewModel = this._initializeSketchViewModel();
+    this._createGraphicLayer(w), this._createGraphicLayer(n), this._sketchViewModel = this._initializeSketchViewModel();
   }
   _clearSubnetworks() {
     this.selectedSubnetworkName = void 0, this.subnetworksTable = void 0, this.compatibleSubnetworkNames = [];
@@ -125,54 +147,52 @@ class C extends T {
       return;
     const t = e.createQuery();
     t.gdbVersion = this.selectedUtilityNetwork?.gdbVersion, t.where = this._getSubnetworkQueryWhereClause(), t.outFields = ["SUBNETWORKNAME"], t.orderByFields = ["SUBNETWORKNAME"];
-    const i = _.fromJSON(await m(e, t));
+    const i = T.fromJSON(await b(e, t));
     this.compatibleSubnetworkNames = i.features.filter(this._removeDuplicateSubnetworkNames).map((a) => a.getAttribute("SUBNETWORKNAME"));
   }
   _getSubnetworkQueryWhereClause() {
-    const e = this.selectedTraceConfiguration?.traceConfiguration, t = `DOMAINNETWORKNAME = '${e.domainNetworkName}'`, i = `TIERNAME = '${e.tierName}'`;
+    const e = this._unTraceConfiguration, t = `DOMAINNETWORKNAME = '${e.domainNetworkName}'`, i = `TIERNAME = '${e.tierName}'`;
     return [t, i].join(" AND ");
   }
   async _handleSubnetworkTraceConfigChange(e) {
-    const { traceConfiguration: t } = e;
-    if (!(t instanceof d)) {
-      console.error(`${c} - Trace configuration not found`);
-      return;
-    }
-    await this._loadSubnetworksTable(), await this._querySubnetworks(), this.selectedSubnetworkName = this.compatibleSubnetworkNames.find((i) => i === t.subnetworkName) ?? this.compatibleSubnetworkNames.at(0);
+    await this._loadSubnetworksTable(), await this._querySubnetworks();
+    const { compatibleSubnetworkNames: t } = this;
+    e.subnetworkName && !t.some((i) => i === e.subnetworkName) && (this.selectedSubnetworkName = t.at(0));
   }
   _selectTraceConfigurationByGuid(e) {
     const t = this.selectedUtilityNetwork?.sharedNamedTraceConfigurations.find((i) => i.globalId === e);
     if (!t) {
-      console.error(`${c} - Trace configuration not found`);
+      l("error", this, "`traceConfig` not found in `selectedUtilityNetwork.sharedNamedTraceConfigurations`");
       return;
     }
-    this.selectedTraceConfiguration = t;
+    this.selectedNamedTraceConfiguration = t;
   }
   _handleTraceConfigChange() {
-    const { selectedTraceConfiguration: e } = this;
-    if (e)
-      switch (e.traceType) {
-        case "subnetwork":
-          this._handleSubnetworkTraceConfigChange(e);
-          break;
-        default:
-          console.error(`${c} - Unknown trace configuration type`);
-      }
+    const { selectedNamedTraceConfiguration: e } = this;
+    if (!(e?.traceConfiguration instanceof S)) {
+      l("error", this, U("selectedNamedTraceConfiguration.traceConfiguration")), this._unTraceConfiguration = void 0;
+      return;
+    }
+    switch (this._unTraceConfiguration = e.traceConfiguration.clone(), e.traceType) {
+      case "subnetwork":
+        this._state = "loading", this._handleSubnetworkTraceConfigChange(this._unTraceConfiguration).finally(() => this._state = "ready");
+        break;
+    }
   }
   async _handleSelectedUtilityNetworkChange() {
     await this.selectedUtilityNetwork?.load(), this._clearSubnetworks(), this._setupTraceConfigurations(), this._filterUnLayers(), this._clearTraceLocations();
   }
   _setupTraceConfigurations() {
-    this.traceConfigurations = this.selectedUtilityNetwork?.sharedNamedTraceConfigurations || [], this.selectedTraceConfiguration = this.traceConfigurations.at(0);
+    this._unTraceConfiguration = void 0, this.traceConfigurations = this.selectedUtilityNetwork?.sharedNamedTraceConfigurations.filter((e) => e.traceType !== "path" && e.traceType !== "circuit") || [], this.selectedNamedTraceConfiguration = this.traceConfigurations.at(0);
   }
   _filterUnLayers() {
     const { selectedUtilityNetwork: e } = this;
-    this._unLayers = new n(this._allLayers.filter((t) => e?.isUtilityLayer(t))), this._setSnappingOption();
+    this._unLayers = new s(this._allLayers.filter((t) => e?.isUtilityLayer(t))), this._setSnappingOption();
   }
   _handleUtilityNetworksChange() {
     const { utilityNetworks: e } = this;
     if (!e || e.length === 0) {
-      this._state = "error", console.error(`${c} - No utility networks found in the map`);
+      this._state = "error", l("error", this, E("utilityNetworks"));
       return;
     }
     (!this.selectedUtilityNetwork || !e.includes(this.selectedUtilityNetwork)) && (this.selectedUtilityNetwork = e.at(0));
@@ -182,80 +202,86 @@ class C extends T {
       const e = this.view.map;
       await e.load(), this.utilityNetworks = e.utilityNetworks || void 0;
     } else
-      this._state = "disabled", console.error(`${c} - No view or map available to load utility networks`);
+      this._state = "disabled", l("error", this, "The property `view.map` is required to load utility networks but is missing.");
   }
   _handleTraceLocationSelectStart(e) {
-    this._activeTraceLocationType = e?.target?.traceLocationType, this._mode = "add-spatial";
+    if (e.stopPropagation(), this.arcgisTraceLocationSelectStart.emit(e.detail).defaultPrevented) {
+      e.preventDefault();
+      return;
+    }
+    this._activeTraceLocationType = e?.target?.traceLocationType, this.mode = "add-spatial";
   }
-  _handleTraceLocationSelectEnd() {
-    this._activeTraceLocationType = void 0, this._mode = "default";
+  _handleTraceLocationSelectEnd(e) {
+    e.stopPropagation(), this.arcgisTraceLocationSelectEnd.emit(), this._activeTraceLocationType = void 0, this.mode = "default";
   }
   _handleFlowItemBack() {
-    this._mode = "default", this._activeTraceLocationType = void 0, this._sketchViewModel?.cancel();
+    this._activeTraceLocationType = void 0, this.mode = "default", this._sketchViewModel?.cancel();
   }
   renderError(e, t = !1, i) {
-    return s`<calcite-notice .closable=${t} kind=danger open scale=s width=auto .icon=${i}><div slot=message>${e}</div></calcite-notice>`;
+    return r`<calcite-notice .closable=${t} kind=danger open scale=s width=auto .icon=${i}><div slot=message>${e}</div></calcite-notice>`;
   }
   renderLoader() {
-    return s`<calcite-loader label=loading></calcite-loader>`;
+    return r`<calcite-loader label=loading></calcite-loader>`;
   }
   renderTraceSelection() {
     const { _messages: e, traceConfigurations: t } = this, i = e.labels.traceConfiguration;
     if (t.length === 0)
       return this.renderError(e.errors.noTraceConfigurationError, !0);
-    const a = h(t, (r) => r.globalId, (r) => s`<calcite-option .value=${r.globalId}>${r.title}</calcite-option>`);
-    return s`<calcite-block .heading=${i} .label=${i} expanded><calcite-select .label=${i} .value=${this.selectedTraceConfiguration?.globalId || void 0} @calciteSelectChange=${(r) => {
-      this._selectTraceConfigurationByGuid(r.target.value);
+    const a = d(t, (o) => o.globalId, (o) => r`<calcite-option .value=${o.globalId}>${o.title}</calcite-option>`);
+    return r`<calcite-block .heading=${i} .label=${i} expanded><calcite-select .label=${i} .value=${this.selectedNamedTraceConfiguration?.globalId || void 0} @calciteSelectChange=${(o) => {
+      this._selectTraceConfigurationByGuid(o.target.value);
     }}>${a}</calcite-select></calcite-block>`;
   }
   renderUtilityNetworkSelection() {
-    const { _messages: e } = this, t = e.labels.utilityNetwork, i = h(this.utilityNetworks, (a) => a.id, (a) => s`<calcite-option .value=${a.id}>${a.title}</calcite-option>`);
-    return s`<calcite-block .heading=${t} .label=${t} expanded><calcite-select .label=${t} .value=${this.selectedUtilityNetwork?.id} @calciteSelectChange=${(a) => {
-      this.selectedUtilityNetwork?.id !== a.target.value && (this.selectedUtilityNetwork = this.utilityNetworks?.find((r) => r.id === a.target.value));
+    const { _messages: e } = this, t = e.labels.utilityNetwork, i = d(this.utilityNetworks, (a) => a.id, (a) => r`<calcite-option .value=${a.id}>${a.title}</calcite-option>`).toArray();
+    return r`<calcite-block .heading=${t} .label=${t} expanded><calcite-select .label=${t} .value=${this.selectedUtilityNetwork?.id} @calciteSelectChange=${(a) => {
+      this.selectedUtilityNetwork?.id !== a.target.value && (this.selectedUtilityNetwork = this.utilityNetworks?.find((o) => o.id === a.target.value));
     }}>${i}</calcite-select></calcite-block>`;
   }
   renderDefaultMode() {
-    const { _messages: e, _state: t, _mode: i } = this;
-    return s`<calcite-flow-item .selected=${i === "default"}>${t === "disabled" ? this.renderError(e.errors.noMapError) : this.renderContent()}</calcite-flow-item>`;
+    const { _messages: e, _state: t, mode: i } = this;
+    return r`<calcite-flow-item .selected=${i === "default"}>${t === "disabled" ? this.renderError(e.errors.noMapError) : this.renderContent()}</calcite-flow-item>`;
   }
   renderAddSpatialMode() {
     const { _messages: e, _activeTraceLocationType: t } = this, i = t === "starting-point" ? e.labels.addSpatial.startingPoint : t === "barrier" ? e.labels.addSpatial.barrier : e.labels.addSpatial.stoppingPoint;
-    return s`<calcite-flow-item selected .heading=${i} @calciteFlowItemBack=${() => this._handleFlowItemBack()}><div class=${p(k.addSpatialMode)}><calcite-icon icon=pin-plus scale=l></calcite-icon>${e.instructions.addSpatial}</div></calcite-flow-item>`;
+    return r`<calcite-flow-item selected .heading=${i} @calciteFlowItemBack=${() => this._handleFlowItemBack()}><div class=${h(p.addSpatialMode)}><calcite-icon icon=pin-plus scale=l></calcite-icon>${e.instructions.addSpatial}</div></calcite-flow-item>`;
   }
   renderStartingPointSelection() {
-    return s`<arcgis-utility-network-trace-location .view=${this.view} trace-location-type=starting-point @arcgisTraceLocationSelectStart=${(e) => this._handleTraceLocationSelectStart(e)} @arcgisTraceLocationSelectEnd=${() => this._handleTraceLocationSelectEnd()} @arcgisTraceLocationChange=${() => this.arcgisTraceInputsChange.emit()} .sketchViewModel=${this._sketchViewModel} .utilityNetwork=${this.selectedUtilityNetwork} .filterLayers=${this._unLayers} .flagLayer=${this._getGraphicLayer(l)} .traceLocations=${this._startingPoints}></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} .flagLayer=${this._getGraphicLayer(n)} .traceLocations=${this._startingPoints}></arcgis-utility-network-trace-location>`;
   }
   renderStoppingPointSelection() {
-    return s`<arcgis-utility-network-trace-location .view=${this.view} trace-location-type=stopping-point @arcgisTraceLocationSelectStart=${(e) => this._handleTraceLocationSelectStart(e)} @arcgisTraceLocationSelectEnd=${() => this._handleTraceLocationSelectEnd()} @arcgisTraceLocationChange=${() => this.arcgisTraceInputsChange.emit()} .sketchViewModel=${this._sketchViewModel} .utilityNetwork=${this.selectedUtilityNetwork} .filterLayers=${this._unLayers} .flagLayer=${this._getGraphicLayer(l)} .traceLocations=${this._stoppingPoints}></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} .flagLayer=${this._getGraphicLayer(n)} .traceLocations=${this._stoppingPoints}></arcgis-utility-network-trace-location>`;
   }
   renderBarrierSelection() {
-    return s`<arcgis-utility-network-trace-location .view=${this.view} trace-location-type=barrier @arcgisTraceLocationSelectStart=${(e) => this._handleTraceLocationSelectStart(e)} @arcgisTraceLocationSelectEnd=${() => this._handleTraceLocationSelectEnd()} @arcgisTraceLocationChange=${() => this.arcgisTraceInputsChange.emit()} .sketchViewModel=${this._sketchViewModel} .utilityNetwork=${this.selectedUtilityNetwork} .filterLayers=${this._unLayers} .flagLayer=${this._getGraphicLayer(l)} .traceLocations=${this._barriers}></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} .flagLayer=${this._getGraphicLayer(n)} .traceLocations=${this._barriers}></arcgis-utility-network-trace-location>`;
+  }
+  renderSubnetworkNameInput() {
+    return r`<calcite-input clearable type=text .placeholder=${this._messages.instructions.enterSubnetworkName} max-length=64 .value=${this.selectedSubnetworkName} @calciteInputInput=${(e) => this.selectedSubnetworkName = e.target.value}></calcite-input>`;
   }
   renderSubnetworkSelectList() {
-    const { compatibleSubnetworkNames: e, selectedSubnetworkName: t, _messages: i } = this, a = i.labels.subnetworkName, r = e.map((o) => s`<calcite-option .value=${o}>${o}</calcite-option>`);
-    return s`<calcite-block .heading=${a} .label=${a} expanded><calcite-select .label=${a} .value=${t} @calciteSelectChange=${(o) => this.selectedSubnetworkName = o.target.value}>${r}</calcite-select></calcite-block>`;
+    return r`<calcite-select .label=${this._messages.labels.subnetworkName} .value=${this.selectedSubnetworkName} @calciteSelectChange=${(e) => this.selectedSubnetworkName = e.target.value}>${this.compatibleSubnetworkNames.map((e) => r`<calcite-option .value=${e}>${e}</calcite-option>`)}</calcite-select>`;
   }
   renderSubnetworkSelection() {
-    const { compatibleSubnetworkNames: e, _messages: t, selectedTraceConfiguration: i } = this;
-    return i?.traceConfiguration instanceof d && i.traceType === "subnetwork" && i.traceConfiguration.subnetworkName ? this.subnetworksTable?.loaded ? e.length ? this.renderSubnetworkSelectList() : this.renderError(t.errors.noCompatibleSubnetworks, !1, "exclamation-mark-triangle") : s`<calcite-loader class="inline-loader" label=loading scale=s></calcite-loader>` : null;
+    const { compatibleSubnetworkNames: e, selectedNamedTraceConfiguration: t } = this, i = this._messages.labels.subnetworkName;
+    return t?.traceType !== "subnetwork" || !t.traceConfiguration.subnetworkName ? null : this._state === "loading" ? r`<calcite-loader class="inline-loader" label=loading scale=s></calcite-loader>` : e.length ? r`<calcite-block .heading=${i} .label=${i} expanded>${e.length > I ? this.renderSubnetworkNameInput() : this.renderSubnetworkSelectList()}</calcite-block>` : this.renderError(this._messages.errors.noCompatibleSubnetworks, !1, "exclamation-mark-triangle");
   }
   renderSubnetworkInfo() {
-    const { _messages: e, selectedTraceConfiguration: t } = this;
-    return t?.traceConfiguration instanceof d && t.traceType && this._subnetworkTraceTypes.has(t.traceType) ? s`<calcite-block class="subnetwork-info-block" expanded .label=${e.labels.subnetworkInfo}><arcgis-utility-network-subnetwork-info .namedTraceConfig=${t}></arcgis-utility-network-subnetwork-info></calcite-block>` : null;
+    const { _messages: e, selectedNamedTraceConfiguration: t, _unTraceConfiguration: i } = this;
+    return i && t?.traceType && this._subnetworkTraceTypes.has(t.traceType) ? r`<calcite-block class="subnetwork-info-block" expanded .label=${e.labels.subnetworkInfo}><arcgis-utility-network-subnetwork-info .namedTraceConfig=${t}></arcgis-utility-network-subnetwork-info></calcite-block>` : null;
   }
   renderContent() {
-    const { _messages: e, utilityNetworks: t } = this;
-    if (!t || t.length === 0)
-      return this.renderError(e.errors.noUtilityNetworkError);
-    const i = s`${this.renderTraceSelection()}${this.renderSubnetworkInfo()}${this.renderSubnetworkSelection()}`;
-    return s`<calcite-block-group .label=${e.labels.traceInputs}>${t.length > 1 ? this.renderUtilityNetworkSelection() : null}${this.selectedUtilityNetwork?.loaded ? i : this.renderLoader()}${this.selectedTraceConfiguration ? this.renderStartingPointSelection() : null}${this.selectedTraceConfiguration ? this.renderStoppingPointSelection() : null}${this.selectedTraceConfiguration ? this.renderBarrierSelection() : null}</calcite-block-group>`;
+    const { utilityNetworks: e } = this, t = this.selectedNamedTraceConfiguration?.traceConfiguration;
+    if (!e || e.length === 0)
+      return this.renderError(this._messages.errors.noUtilityNetworkError);
+    const i = r`${this.renderTraceSelection()}${this.renderSubnetworkInfo()}${this.renderSubnetworkSelection()}`, a = this.selectedNamedTraceConfiguration?.traceType, o = !(t?.subnetworkName && a === "subnetwork"), m = a === "path" || a === "circuit", k = r`${o ? this.renderStartingPointSelection() : null}${m ? this.renderStoppingPointSelection() : null}${this.renderBarrierSelection()}`;
+    return r`<calcite-block-group .label=${this._messages.labels.traceInputs}>${e.length > 1 ? this.renderUtilityNetworkSelection() : null}${this.selectedUtilityNetwork?.loaded ? i : this.renderLoader()}${t ? k : null}</calcite-block-group>`;
   }
   render() {
-    const { _mode: e } = this;
-    return s`<div class=${p(k.base)}><calcite-flow>${this.renderDefaultMode()}${e === "add-spatial" ? this.renderAddSpatialMode() : null}</calcite-flow></div>`;
+    const { mode: e } = this;
+    return r`<div class=${h(p.base)}><calcite-flow>${this.renderDefaultMode()}${e === "add-spatial" ? this.renderAddSpatialMode() : null}</calcite-flow></div>`;
   }
 }
-b("arcgis-utility-network-trace-inputs", C);
+y("arcgis-utility-network-trace-inputs", P);
 export {
-  C as ArcgisUtilityNetworkTraceInputs
+  P as ArcgisUtilityNetworkTraceInputs
 };

package/dist/components/arcgis-utility-network-trace-inputs/index.d.ts

@@ -6,6 +6,7 @@ import "@esri/calcite-components/components/calcite-select";
 import "@esri/calcite-components/components/calcite-flow-item";
 import "@esri/calcite-components/components/calcite-icon";
 import "../arcgis-utility-network-trace-location/index.js";
+import "@esri/calcite-components/components/calcite-input";
 import "../arcgis-utility-network-subnetwork-info/index.js";
 import "@esri/calcite-components/components/calcite-block-group";
 import "@esri/calcite-components/components/calcite-flow";

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

@@ -6,6 +6,7 @@ import "@esri/calcite-components/components/calcite-select";
 import "@esri/calcite-components/components/calcite-flow-item";
 import "@esri/calcite-components/components/calcite-icon";
 import "../arcgis-utility-network-trace-location/index.js";
+import "@esri/calcite-components/components/calcite-input";
 import "../arcgis-utility-network-subnetwork-info/index.js";
 import "@esri/calcite-components/components/calcite-block-group";
 import "@esri/calcite-components/components/calcite-flow";

package/dist/components/arcgis-utility-network-trace-location/customElement.d.ts

@@ -1,19 +1,32 @@
 /// <reference path="../../index.d.ts" />
 import { default as Collection } from '@arcgis/core/core/Collection.js';
+import { default as Point } from '@arcgis/core/geometry/Point.js';
+import { default as Graphic } from '@arcgis/core/Graphic.js';
 import { default as GraphicsLayer } from '@arcgis/core/layers/GraphicsLayer.js';
 import { default as Layer } from '@arcgis/core/layers/Layer.js';
-import { default as MapView } from '@arcgis/core/views/MapView.js';
-import { default as SketchViewModel } from '@arcgis/core/widgets/Sketch/SketchViewModel.js';
-import { PublicLitElement as LitElement, TargetedEvent, JsxNode } from '@arcgis/lumina';
+import { default as TerminalConfiguration } from '@arcgis/core/networks/support/TerminalConfiguration.js';
 import { default as UtilityNetwork } from '@arcgis/core/networks/UtilityNetwork.js';
 import { default as TraceLocation } from '@arcgis/core/rest/networks/support/TraceLocation.js';
-import { default as Point } from '@arcgis/core/geometry/Point.js';
-import { default as Graphic } from '@arcgis/core/Graphic.js';
-export interface FlagProperty {
+import { default as MapView } from '@arcgis/core/views/MapView.js';
+import { default as SketchViewModel } from '@arcgis/core/widgets/Sketch/SketchViewModel.js';
+import { JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
+export interface FlagInfo {
     traceLocation: TraceLocation;
-    mapPoint?: Point | null;
-    mapGraphic?: Graphic | null;
-    details?: Graphic | null;
+    flagProperties: {
+        title: string;
+        expanded?: boolean;
+        terminalConfiguration?: TerminalConfiguration;
+        selectedTerminals?: Set<number>;
+    };
+    spatialProperties: {
+        mapPoint?: Point;
+        mapGraphic?: Graphic;
+        flagGraphic?: Graphic;
+    };
+}
+export type TraceLocationType = "barrier" | "starting-point" | "stopping-point";
+export interface SelectStartPayload {
+    cancelSelect: () => void;
 }
 
 /**
@@ -28,17 +41,41 @@ export interface FlagProperty {
  * @internal
  */
 export declare class ArcgisUtilityNetworkTraceLocation extends LitElement {
+    /**
+     * A function to run before trace location selection starts.
+     *
+     * @experimental
+     */
+    beforeTraceLocationSelectStart?: () => Promise<void>;
     /** @required */
     view?: MapView;
     /** @default "starting-point" */
-    traceLocationType: "barrier" | "starting-point" | "stopping-point";
-    traceLocations?: Collection<FlagProperty>;
+    traceLocationType: TraceLocationType;
+    traceLocations?: Collection<FlagInfo>;
     filterLayers?: Collection<Layer>;
     sketchViewModel?: SketchViewModel;
     flagLayer?: GraphicsLayer;
+    /** @default 0.05 */
+    spatialTolerance: number;
     /** @required The utility network to perform the trace on. */
     utilityNetwork?: UtilityNetwork;
     readonly arcgisTraceLocationChange: TargetedEvent<this, void>;
+    /**
+     * Fires when the user completes the selection of a trace location.
+     *
+     * @experimental
+     */
     readonly arcgisTraceLocationSelectEnd: TargetedEvent<this, void>;
-    readonly arcgisTraceLocationSelectStart: TargetedEvent<this, void>;
+    /**
+     * Fires when the user begins selection of a trace location.
+     * Can be prevented to stop the selection.
+     *
+     * @experimental
+     */
+    readonly arcgisTraceLocationSelectStart: TargetedEvent<this, SelectStartPayload>;
+    "@eventTypes": {
+        "arcgisTraceLocationChange": ArcgisUtilityNetworkTraceLocation["arcgisTraceLocationChange"]["detail"];
+        "arcgisTraceLocationSelectEnd": ArcgisUtilityNetworkTraceLocation["arcgisTraceLocationSelectEnd"]["detail"];
+        "arcgisTraceLocationSelectStart": ArcgisUtilityNetworkTraceLocation["arcgisTraceLocationSelectStart"]["detail"];
+    };
 }