@arcgis/map-components 5.0.0-next.13 → 5.0.0-next.131

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

@@ -1,194 +1,263 @@
-import { c as $ } from "../../chunks/runtime.js";
-import { css as T, html as b } from "lit";
-import v from "@arcgis/core/geometry/Polyline.js";
-import x from "@arcgis/core/geometry/SpatialReference.js";
-import { LitElement as C, createEvent as w, safeClassMap as y } from "@arcgis/lumina";
-import { u as A } from "../../chunks/useT9n.js";
+import { c as v } from "../../chunks/runtime.js";
+import { css as x, html as b } from "lit";
+import * as S from "@arcgis/core/geometry/operators/cutOperator.js";
+import * as m from "@arcgis/core/geometry/operators/lengthOperator.js";
+import * as w from "@arcgis/core/geometry/operators/projectOperator.js";
+import A from "@arcgis/core/geometry/Polyline.js";
+import I from "@arcgis/core/geometry/SpatialReference.js";
+import C from "@arcgis/core/Graphic.js";
 import _ from "@arcgis/core/rest/networks/support/TraceLocation.js";
-import F from "@arcgis/core/Graphic.js";
-import { SimpleMarkerSymbol as S } from "@arcgis/core/symbols.js";
-import * as k from "@arcgis/core/geometry/operators/projectOperator.js";
-import * as N from "@arcgis/core/geometry/operators/cutOperator.js";
-import * as L from "@arcgis/core/geometry/operators/lengthOperator.js";
+import L from "@arcgis/core/symbols/SimpleMarkerSymbol.js";
+import { LitElement as F, createEvent as k, safeClassMap as p } from "@arcgis/lumina";
+import { u as $ } from "../../chunks/useT9n.js";
+import { log as c } 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.13 */
-const R = T`.arcgis-utility-network-trace-location calcite-block{--calcite-block-content-space: 0;--calcite-block-border-color: transparent;margin:0}.arcgis-utility-network-trace-location calcite-notice{padding:var(--calcite-spacing-xs)}.arcgis-utility-network-trace-location__add-location-button{--calcite-button-border-color: var(--calcite-color-border-1);--calcite-button-icon-color: var(--calcite-color-text-1);--calcite-button-text-color: var(--calcite-color-text-1)}.arcgis-utility-network-trace-location__button-container{justify-content:center;display:grid}.arcgis-utility-network-trace-location__clear-button{--calcite-button-border-color: transparent}`, g = "arcgis-utility-network-trace-location", f = {
+v5.0.0-next.131 */
+const G = x`.arcgis-utility-network-trace-location calcite-block{--calcite-block-content-space: 0;--calcite-block-border-color: transparent;margin:0}.arcgis-utility-network-trace-location calcite-notice{padding:var(--calcite-spacing-xs)}.arcgis-utility-network-trace-location__add-location-button{--calcite-button-border-color: var(--calcite-color-border-1);--calcite-button-icon-color: var(--calcite-color-text-1);--calcite-button-text-color: var(--calcite-color-text-1)}.arcgis-utility-network-trace-location__button-container{justify-content:center;display:grid}.arcgis-utility-network-trace-location__clear-button{--calcite-button-border-color: transparent}`, g = "arcgis-utility-network-trace-location", f = {
   // popup renderer
   base: g,
   // containers and content
   buttonContainer: `${g}__button-container`,
   clearButton: `${g}__clear-button`,
   addLocationButton: `${g}__add-location-button`
-}, n = "map-components:utility-network-trace-location";
-class B extends C {
+};
+class P extends F {
   constructor() {
-    super(...arguments), this.messages = A({ blocking: !0 }), this.traceLocationType = "starting-point", this.arcgisTraceLocationChange = w(), this.arcgisTraceLocationSelectEnd = w(), this.arcgisTraceLocationSelectStart = w();
+    super(...arguments), this.messages = $({ blocking: !0 }), this.isSelectWaiting = !1, this.traceLocationType = "starting-point", this.spatialTolerance = 0.05, this.arcgisTraceLocationChange = k(), this.arcgisTraceLocationSelectEnd = k(), this.arcgisTraceLocationSelectStart = k();
   }
   static {
-    this.properties = { view: 0, traceLocationType: 1, traceLocations: 0, filterLayers: 0, sketchViewModel: 0, flagLayer: 0, utilityNetwork: 0 };
+    this.properties = { isSelectWaiting: 16, beforeTraceLocationSelectStart: 0, view: 0, traceLocationType: 1, traceLocations: 0, filterLayers: 0, sketchViewModel: 0, flagLayer: 0, spatialTolerance: 9, utilityNetwork: 0 };
   }
   static {
-    this.styles = R;
+    this.styles = G;
   }
   async load() {
-    k.isLoaded() || await k.load();
+    w.isLoaded() || await w.load();
   }
   _createPolyline(t, e) {
-    return new v({
+    return new A({
       hasZ: !1,
       hasM: !0,
       paths: t,
-      spatialReference: new x({ wkid: e })
+      spatialReference: new I({ wkid: e })
     });
   }
   _calculatePercentAlong(t, e) {
-    const o = t.spatialReference, r = this._createPolyline(t.paths, o.wkid), a = e.x - 0.5, s = e.x + 0.5, i = e.y - 0.5, c = e.y + 0.5, l = [
+    const r = t.spatialReference, a = this._createPolyline(t.paths, r.wkid), s = e.x - 0.5, o = e.x + 0.5, n = e.y - 0.5, i = e.y + 0.5, l = [
       [
-        [a, i],
-        [s, c]
+        [s, n],
+        [o, i]
       ]
-    ], p = this._createPolyline(l, e.spatialReference.wkid), d = k.execute(p, o);
-    if (!d)
-      return console.error(`${n} - Unable to project flag geometry to source geometry spatial reference.`), 0.5;
-    const u = N.execute(r, d);
-    if (u.length > 0) {
-      const h = L.execute(r, { unit: "feet" });
-      let m;
-      return u[0].paths[0][0][0] === r.paths[0][0][0] ? m = L.execute(u[0], { unit: "feet" }) : m = L.execute(u[1], { unit: "feet" }), m / h;
+    ], d = this._createPolyline(l, e.spatialReference.wkid), u = w.execute(d, r);
+    if (!u)
+      return c("error", this, "Unable to project flag geometry to source geometry spatial reference."), 0.5;
+    const h = S.execute(a, u);
+    if (h.length > 0) {
+      const T = m.execute(a, { unit: "feet" });
+      let y;
+      return h[0].paths[0][0][0] === a.paths[0][0][0] ? y = m.execute(h[0], { unit: "feet" }) : y = m.execute(h[1], { unit: "feet" }), y / T;
     }
-    return console.warn(`${n} - Unable to cut the source geometry with the flag geometry.`), 0.5;
+    return c("warn", this, "Unable to cut the source geometry with the flag geometry."), 0.5;
   }
   async _ensureNecessaryAttributes(t) {
-    const e = (t.layer?.type === "feature", t.layer), o = e.fieldsIndex?.get("assetgroup") ?? !1, r = e.fieldsIndex?.get("assetgroup")?.name ?? "assetgroup", a = e.fieldsIndex?.get("assettype") ?? !1, s = e.fieldsIndex?.get("assettype")?.name ?? "assettype", i = t.getGlobalId(), c = t.getObjectId(), l = o ? !!t.getAttribute(r) : !0, p = a ? !!t.getAttribute(s) : !0;
-    if (i && c && l && p)
+    const e = (t.layer?.type === "feature", t.layer), r = e.fieldsIndex?.get("assetgroup") ?? !1, a = e.fieldsIndex?.get("assetgroup")?.name ?? "assetgroup", s = e.fieldsIndex?.get("assettype") ?? !1, o = e.fieldsIndex?.get("assettype")?.name ?? "assettype", n = t.getGlobalId(), i = t.getObjectId(), l = r ? !!t.getAttribute(a) : !0, d = s ? !!t.getAttribute(o) : !0;
+    if (n && i && l && d)
       return t;
-    const d = e.createQuery();
-    return d.objectIds = [c], (await e.queryFeatures(d))?.features[0] || null;
+    const u = e.createQuery();
+    return u.objectIds = [i], (await e.queryFeatures(u))?.features[0] || null;
   }
   async _ensureNecessaryAttributesAndGenerateTraceLocation(t, e) {
-    const { view: o } = this;
-    if (!o || t.length === 0) {
-      console.log(`${n} - No view or results to process.`);
+    const { view: r } = this;
+    if (!r || t.length === 0) {
+      c("error", this, "`view` is unavailable or there are no results to process.");
       return;
     }
-    const a = t[0].graphic, s = await this._ensureNecessaryAttributes(a);
-    if (!s) {
-      console.error(`${n} - Unable to get necessary attributes for trace location.`);
+    const s = t[0].graphic, o = await this._ensureNecessaryAttributes(s);
+    if (!o) {
+      c("error", this, "Unable to ensure necessary attributes on the selected graphic.");
       return;
     }
-    this._generateTraceLocation(s, e);
-  }
-  _addFlagGraphic(t, e, o) {
-    const { flagLayer: r, view: a, traceLocationType: s } = this;
-    if (!r || !a)
-      return console.error(`${n} - Flag layer or view is not available.`), null;
-    const i = e.geometry?.type;
-    if (this.traceLocations?.some((h) => h.traceLocation.globalId === t) && i !== "polyline")
-      return console.warn(`${n} - A flag with the same globalId already exists.`), null;
-    const p = s === "starting-point" ? [21, 244, 21, 0.6] : [227, 27, 21, 0.6], d = new S({
-      color: p,
+    this._generateTraceLocation(o, e);
+  }
+  _createFlagSymbol() {
+    const { traceLocationType: t } = this, e = [244, 21, 21, 0.6], r = [21, 244, 21, 0.6];
+    return t === "stopping-point" ? new L({
+      color: e,
+      style: "x",
+      size: 12,
+      outline: {
+        color: e,
+        width: 2
+      }
+    }) : t === "barrier" ? new L({
+      color: e,
+      style: "square",
+      size: 12,
+      outline: {
+        color: e,
+        width: 0
+      }
+    }) : new L({
+      color: r,
+      style: "circle",
       size: 12,
       outline: {
-        color: p,
+        color: r,
         width: 0
       }
-    }), u = new F({
-      geometry: o,
-      symbol: d,
+    });
+  }
+  _addFlagGraphic(t, e, r) {
+    const { flagLayer: a, view: s } = this;
+    if (!a || !s)
+      return c("error", this, "The properties `flagLayer` and `view` are required but either one or both are missing."), null;
+    const o = e.geometry?.type;
+    if (this.traceLocations?.some((l) => l.traceLocation.globalId === t) && o !== "polyline")
+      return c("warn", this, "A flag with the same globalId already exists."), null;
+    const n = this._createFlagSymbol(), i = new C({
+      geometry: r,
+      symbol: n,
       attributes: e.attributes
     });
-    return r.add(u), u;
+    return a.add(i), i;
   }
-  _generateTraceLocation(t, e) {
-    const { traceLocationType: o, traceLocations: r, utilityNetwork: a } = this, s = t.getGlobalId() ?? "", i = t.geometry?.type, c = this._addFlagGraphic(s, t, e);
-    if (!c) {
-      console.warn(`${n} - Unable to add flag graphic.`);
-      return;
-    }
-    if (i === "point" || i === "polygon") {
-      const l = a?.getTerminalConfiguration(t);
-      r?.add({
+  async _generateItemTitle(t) {
+    const { messages: e } = this, r = (t.layer?.type === "feature", t.layer);
+    return ("getFeatureTitle" in r ? await r.getFeatureTitle(t) : null) || t?.getObjectId()?.toString() || e.labels.unknown;
+  }
+  async _generateFlagInfo(t, e) {
+    const { traceLocationType: r, utilityNetwork: a } = this, s = t.getGlobalId() ?? "", o = t.geometry?.type, n = await this._generateItemTitle(t);
+    if (o === "point" || o === "polygon") {
+      const i = a?.getTerminalConfiguration(t), l = i ? i.terminals[0].id : 1;
+      return {
         traceLocation: new _({
-          type: o,
+          type: r,
           isFilterBarrier: !1,
           globalId: s,
-          terminalId: l ? l.terminals[0].id || void 0 : 1
+          terminalId: l
         }),
-        mapPoint: e,
-        details: t,
-        mapGraphic: c
-      });
-    } else if (i === "polyline") {
-      const l = this._calculatePercentAlong(t.geometry, e);
-      r?.add({
+        flagProperties: {
+          title: n,
+          expanded: !1,
+          terminalConfiguration: i ?? void 0,
+          selectedTerminals: i ? /* @__PURE__ */ new Set([l]) : void 0
+        },
+        spatialProperties: {
+          mapPoint: e,
+          mapGraphic: t
+        }
+      };
+    } else if (o === "polyline") {
+      const i = this._calculatePercentAlong(t.geometry, e);
+      return {
         traceLocation: new _({
-          type: o,
+          type: r,
           isFilterBarrier: !1,
           globalId: s,
-          percentAlong: l
+          percentAlong: i
         }),
-        mapPoint: e,
-        details: t,
-        mapGraphic: c
-      });
+        flagProperties: {
+          title: n,
+          expanded: !1
+        },
+        spatialProperties: {
+          mapPoint: e,
+          mapGraphic: t
+        }
+      };
     }
+    return null;
+  }
+  async _generateTraceLocation(t, e) {
+    const { traceLocations: r } = this, a = t.getGlobalId() ?? "", s = t.geometry?.type, o = await this._generateFlagInfo(t, e);
+    if (!o) {
+      c("error", this, "Unable to generate flag info for trace location.");
+      return;
+    }
+    const n = r?.filter((i) => i.spatialProperties.mapGraphic?.getGlobalId() === a) ?? [];
+    if (n.length === 0 || s === "polyline") {
+      if (s === "polyline" && n.length > 0 && n.some((l) => Math.abs(l.traceLocation.percentAlong - o.traceLocation.percentAlong) <= this.spatialTolerance)) {
+        c("warn", this, "A flag with the same globalId already exists within tolerance.");
+        return;
+      }
+      const i = this._addFlagGraphic(a, t, e);
+      if (!i) {
+        c("warn", this, "Unable to add flag graphic.");
+        return;
+      }
+      o.spatialProperties.flagGraphic = i, r?.add(o);
+      return;
+    }
+    c("warn", this, "A flag with the same globalId already exists.");
   }
   async _hitTest(t) {
-    const { view: e, utilityNetwork: o } = this;
-    if (!e || !o) {
-      console.error(`${n} - View or utility network is not available for hit test.`);
+    const { view: e, utilityNetwork: r } = this;
+    if (!e || !r) {
+      c("error", this, "Either `utilityNetwork` or `view` is unavailable for hit test.");
       return;
     }
-    const r = t.graphic?.geometry, a = this.view?.toScreen(r);
-    if (!a) {
-      console.warn(`${n} - No screen point available for hit test.`);
+    const a = t.graphic?.geometry, s = this.view?.toScreen(a);
+    if (!s) {
+      c("warn", this, "No screen point available for hit test.");
       return;
     }
-    const i = (await e.hitTest(a, {
+    const n = (await e.hitTest(s, {
       include: this.filterLayers
-    })).results.filter((c) => c.type === "graphic" && c?.layer && c.graphic);
-    if (i.length === 0) {
-      console.log(`${n} - No usable hit test results found.`);
+    })).results.filter((i) => i.type === "graphic" && i?.layer && i.graphic);
+    if (n.length === 0) {
+      c("info", this, "No usable hit test results found.");
       return;
     }
-    this._ensureNecessaryAttributesAndGenerateTraceLocation(i, r);
+    this._ensureNecessaryAttributesAndGenerateTraceLocation(n, a);
   }
   _resetAfterSketch() {
     const { view: t } = this;
     if (!t) {
-      console.error(`${n} - View is not available to reset after sketch.`);
+      c("error", this, "View is not available to reset after sketch.");
       return;
     }
     this._clickHandler?.remove(), this._clickHandler = void 0, "acquireCursor" in t && t.acquireCursor("default"), this.arcgisTraceLocationSelectEnd.emit();
   }
   _handleSketchComplete(t) {
-    const { sketchViewModel: e, view: o } = this;
-    if (!e || !o) {
-      console.error(`${n} - SketchViewModel or view is not available on sketch complete.`);
+    const { sketchViewModel: e, view: r } = this;
+    if (!e || !r) {
+      c("error", this, "Either `sketchViewModel` or `view` is not available in sketch complete handler.");
       return;
     }
     t.state === "complete" && t.graphic && (e.layer.remove(t.graphic), this._hitTest(t)), (t.state === "cancel" || t.state === "complete") && this._resetAfterSketch();
   }
-  _handleAddButtonClick() {
+  async _handleAddButtonClick() {
     const { view: t, sketchViewModel: e } = this;
-    t && e && (this._clickHandler?.remove(), this._clickHandler = e.on("create", this._handleSketchComplete.bind(this)), "acquireCursor" in t && t.acquireCursor("crosshair"), this.sketchViewModel?.create("point"), this.arcgisTraceLocationSelectStart.emit());
+    if (!(t && e)) {
+      c("error", this, "Cannot add trace location; `view` not found.");
+      return;
+    }
+    if (this.beforeTraceLocationSelectStart) {
+      this.isSelectWaiting = !0;
+      try {
+        await this.beforeTraceLocationSelectStart();
+      } finally {
+        this.isSelectWaiting = !1;
+      }
+    }
+    this.arcgisTraceLocationSelectStart.emit({ cancelSelect: () => e.cancel() }).defaultPrevented || (this._clickHandler?.remove(), this._clickHandler = e.on("create", this._handleSketchComplete.bind(this)), "acquireCursor" in t && t.acquireCursor("crosshair"), this.sketchViewModel?.create("point"));
   }
   _handleClearButtonClick() {
     const { flagLayer: t, traceLocations: e } = this;
-    e?.forEach((o) => {
-      o.mapGraphic && t && t.remove(o.mapGraphic);
+    e?.forEach((r) => {
+      r.spatialProperties.flagGraphic && t && t.remove(r.spatialProperties.flagGraphic);
     }), e?.removeAll();
   }
   renderAddLocationBlock() {
-    const { traceLocationType: t, messages: e, traceLocations: o } = this, r = t === "starting-point" ? e.types.startingPoint : t === "barrier" ? e.types.barrier : e.types.stoppingPoint, a = r.heading, s = r.description, i = r.buttonText;
-    return b`<calcite-block .heading=${a} .label=${a} expanded .description=${s}>${o?.length ? b`<calcite-button class=${y(f.clearButton)} slot=actions-end appearance=transparent .label=${e.buttons.clear} @click=${() => this._handleClearButtonClick()}>${e.buttons.clear}</calcite-button>` : null}<div class=${y(f.buttonContainer)}><calcite-button class=${y(f.addLocationButton)} icon-start=select appearance=outline .label=${i} @click=${() => this._handleAddButtonClick()}>${i}</calcite-button></div></calcite-block>`;
+    const { traceLocationType: t, messages: e, traceLocations: r } = this, a = t === "starting-point" ? e.types.startingPoint : t === "barrier" ? e.types.barrier : e.types.stoppingPoint, s = a.heading, o = a.description, n = a.buttonText;
+    return b`<calcite-block .heading=${s} .label=${s} expanded .description=${o}>${r?.length ? b`<calcite-button class=${p(f.clearButton)} slot=actions-end appearance=transparent .label=${e.buttons.clear} @click=${() => this._handleClearButtonClick()}>${e.buttons.clear}</calcite-button>` : null}<arcgis-utility-network-trace-location-list .traceLocations=${r} .traceLocationType=${t}></arcgis-utility-network-trace-location-list><div class=${p(f.buttonContainer)}><calcite-button .loading=${this.isSelectWaiting} class=${p(f.addLocationButton)} icon-start=select appearance=outline .label=${n} @click=${() => this._handleAddButtonClick()}>${n}</calcite-button></div></calcite-block>`;
   }
   render() {
-    return b`<div class=${y(f.base)}>${this.renderAddLocationBlock()}</div>`;
+    return b`<div class=${p(f.base)}>${this.renderAddLocationBlock()}</div>`;
   }
 }
-$("arcgis-utility-network-trace-location", B);
+v("arcgis-utility-network-trace-location", P);
 export {
-  B as ArcgisUtilityNetworkTraceLocation
+  P as ArcgisUtilityNetworkTraceLocation
 };

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

@@ -1,3 +1,4 @@
 import "@esri/calcite-components/components/calcite-block";
 import "@esri/calcite-components/components/calcite-button";
+import "../arcgis-utility-network-trace-location-list/index.js";
 export * from "./customElement.js";

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

@@ -1,3 +1,4 @@
 import "@esri/calcite-components/components/calcite-block";
 import "@esri/calcite-components/components/calcite-button";
+import "../arcgis-utility-network-trace-location-list/index.js";
 export * from "./customElement.js";

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

@@ -0,0 +1,21 @@
+/// <reference path="../../index.d.ts" />
+import { default as Collection } from '@arcgis/core/core/Collection.js';
+import { JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
+import { FlagInfo, TraceLocationType } from '../arcgis-utility-network-trace-location/customElement.js';
+
+/**
+ * This is a sub-component used by the **ArcgisUtilityNetworkTraceAnalysis** component.
+ *
+ * This sub-component renders a collection of trace locations as a list.
+ *
+ * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-utility-network-trace-location-list/)
+ *
+ * @since 4.34
+ * @internal
+ */
+export declare class ArcgisUtilityNetworkTraceLocationList extends LitElement {
+    /** @required */
+    traceLocations: Collection<FlagInfo>;
+    /** @default "starting-point" */
+    traceLocationType: TraceLocationType;
+}

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

@@ -0,0 +1,76 @@
+import { c as g } from "../../chunks/runtime.js";
+import { css as b, html as n } from "lit";
+import f from "@arcgis/core/core/Collection.js";
+import { substitute as y } from "@arcgis/core/intl.js";
+import { LitElement as _, safeClassMap as s } from "@arcgis/lumina";
+import { u as w } from "../../chunks/useT9n.js";
+import { log as d, composeEmptyPropertyMessage as $ } 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.131 */
+const v = b`.arcgis-utility-network-trace-location-list{margin-block-start:0;padding:0 var(--calcite-spacing-sm) var(--calcite-spacing-sm) var(--calcite-spacing-sm);background-color:var(--calcite-color-foreground-1)}.arcgis-utility-network-trace-location-list calcite-list{border:solid 1px var(--calcite-color-border-3);border-radius:var(--calcite-corner-radius-sm);overflow:hidden}.arcgis-utility-network-trace-location-list__warning{color:var(--calcite-color-status-danger)}.arcgis-utility-network-trace-location-list__terminals{padding-block:var(--calcite-spacing-sm);padding-inline-start:var(--calcite-spacing-xl);padding-inline-end:var(--calcite-spacing-sm);display:flex;flex-direction:column}.arcgis-utility-network-trace-location-list__filter-barrier-container{display:flex;width:100%;calcite-label{width:100%}}.arcgis-utility-network-trace-location-list__filter-barrier{display:flex;justify-content:space-between;align-items:center;width:100%}.arcgis-utility-network-trace-location-list calcite-list-item [slot=content-bottom]{background-color:transparent;display:none}.arcgis-utility-network-trace-location-list calcite-list-item[expanded] [slot=content-bottom]{display:unset}`, o = "arcgis-utility-network-trace-location-list", l = {
+  base: o,
+  terminals: `${o}__terminals`,
+  filterBarrierContainer: `${o}__filter-barrier-container`,
+  filterBarrier: `${o}__filter-barrier`,
+  warning: `${o}__warning`
+};
+class k extends _ {
+  constructor() {
+    super(...arguments), this._messages = w({ blocking: !0 }), this.traceLocations = new f(), this.traceLocationType = "starting-point";
+  }
+  static {
+    this.properties = { traceLocations: 0, traceLocationType: 1 };
+  }
+  static {
+    this.styles = v;
+  }
+  _handleTraceLocationItemRemoved(t) {
+    const i = t.spatialProperties.flagGraphic?.layer, { traceLocations: e } = this;
+    t.spatialProperties.flagGraphic && i && i.remove(t.spatialProperties.flagGraphic), e?.remove(t);
+  }
+  _renderTerminal(t, i) {
+    const { flagProperties: e } = t, { selectedTerminals: r } = e;
+    if (!t)
+      return d("warn", this, "One or more elements in `traceLocations` are missing the required property `flag`."), null;
+    const { name: c, id: a } = i, m = r?.has(a) ?? !1;
+    return n`<calcite-label layout=inline><calcite-checkbox .value=${a} .checked=${m} @calciteCheckboxChange=${(p) => {
+      p.target.checked ? r?.add(a) : r?.delete(a), this.requestUpdate();
+    }}></calcite-checkbox>${c}</calcite-label>`;
+  }
+  _renderTerminalError() {
+    const { _messages: t } = this;
+    return n`<calcite-notice kind=danger open scale=s width=auto><div slot=message>${t.errors.noTerminalSelected}</div></calcite-notice>`;
+  }
+  _renderFilterBarrier(t) {
+    const { _messages: i } = this, { traceLocation: e } = t;
+    return n`<div class=${s(l.filterBarrierContainer)}><calcite-label layout=inline><div class=${s(l.filterBarrier)}>${i.labels.filterBarrier}<calcite-switch .checked=${e.isFilterBarrier} @calciteSwitchChange=${(r) => {
+      e.isFilterBarrier = r.target.checked;
+    }}></calcite-switch></div></calcite-label></div>`;
+  }
+  _renderContents(t) {
+    const { flagProperties: i } = t, { terminalConfiguration: e, selectedTerminals: r } = i, c = t.traceLocation.type === "barrier", a = e && e.terminals.length > 0 && r?.size === 0;
+    return n`<calcite-action .icon=${i.expanded ? "chevron-up" : "chevron-down"} slot=actions-end scale=s text @click=${() => {
+      i.expanded = !i.expanded, this.requestUpdate();
+    }}></calcite-action>${a && n`<calcite-icon class=${s(l.warning)} icon=exclamation-mark-triangle scale=s slot=content-start></calcite-icon>` || ""}${i.expanded && n`<div class=${s(l.terminals)} slot=content-bottom>${c && this._renderFilterBarrier(t) || ""}${e && this._renderTerminals(t) || ""}${a && this._renderTerminalError() || ""}</div>` || ""}`;
+  }
+  _renderTerminals(t) {
+    const { flagProperties: i } = t, { terminalConfiguration: e } = i;
+    if (!e)
+      return d("warn", this, "One or more locations are missing the required flag property `terminalConfiguration`."), [];
+    const r = e.terminals;
+    return !r || r.length === 0 ? (d("warn", this, "`terminalConfiguration.terminals` is required but either missing or empty.`"), []) : r.map((a) => this._renderTerminal(t, a));
+  }
+  _renderListItem(t) {
+    const { flagProperties: i } = t, { terminalConfiguration: e, expanded: r, title: c } = i, a = c, m = e && e.id !== 0, p = t.traceLocation.type === "barrier", h = m || p, u = e?.name ?? void 0;
+    return n`<calcite-list-item .label=${a} .description=${u} .value=${a} .expanded=${r}>${h ? this._renderContents(t) : n`<div slot=content-bottom></div>`}<calcite-action icon=x slot=actions-end scale=s text @click=${() => this._handleTraceLocationItemRemoved(t)}></calcite-action></calcite-list-item>`;
+  }
+  render() {
+    const { _messages: t, traceLocationType: i } = this, e = y(t.labels.list, { traceLocationType: i }), r = this.traceLocations?.map((c) => this._renderListItem(c)).toArray() ?? [];
+    return r.length === 0 ? (d("warn", this, $("traceLocations")), null) : n`<div class=${s(l.base)}><calcite-list interaction-mode=static selection-mode=none .label=${e}>${r}</calcite-list></div>`;
+  }
+}
+g("arcgis-utility-network-trace-location-list", k);
+export {
+  k as ArcgisUtilityNetworkTraceLocationList
+};

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

@@ -0,0 +1,9 @@
+import "@esri/calcite-components/components/calcite-label";
+import "@esri/calcite-components/components/calcite-checkbox";
+import "@esri/calcite-components/components/calcite-notice";
+import "@esri/calcite-components/components/calcite-switch";
+import "@esri/calcite-components/components/calcite-action";
+import "@esri/calcite-components/components/calcite-icon";
+import "@esri/calcite-components/components/calcite-list-item";
+import "@esri/calcite-components/components/calcite-list";
+export * from "./customElement.js";

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

@@ -0,0 +1,9 @@
+import "@esri/calcite-components/components/calcite-label";
+import "@esri/calcite-components/components/calcite-checkbox";
+import "@esri/calcite-components/components/calcite-notice";
+import "@esri/calcite-components/components/calcite-switch";
+import "@esri/calcite-components/components/calcite-action";
+import "@esri/calcite-components/components/calcite-icon";
+import "@esri/calcite-components/components/calcite-list-item";
+import "@esri/calcite-components/components/calcite-list";
+export * from "./customElement.js";

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

@@ -1,19 +1,33 @@
+/// <reference types="@arcgis/core/interfaces.d.ts" />
 /// <reference path="../../index.d.ts" />
+import { default as EsriError } from '@arcgis/core/core/Error.js';
+import { default as Graphic } from '@arcgis/core/Graphic.js';
+import { default as FeatureLayer } from '@arcgis/core/layers/FeatureLayer.js';
 import { default as Layer } from '@arcgis/core/layers/Layer.js';
+import { default as SubtypeSublayer } from '@arcgis/core/layers/support/SubtypeSublayer.js';
 import { default as UtilityNetwork } from '@arcgis/core/networks/UtilityNetwork.js';
 import { default as TraceResult } from '@arcgis/core/rest/networks/support/TraceResult.js';
 import { JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { PropertyValues } from 'lit';
+import { ArcgisReferenceElement } from '../../utils/component-utils';
 
-type ResultType = "features" | "functions";
+type State = "loading" | "ready";
+export interface FeatureWithLabel {
+    feature: Graphic;
+    label: string;
+}
+interface TraceErrorDetails {
+    url?: string;
+    raw?: {
+        extendedCode?: number;
+        message?: string;
+    };
+}
 /**
  * This is a sub-component used by the **ArcgisUtilityNetworkTraceAnalysis** component.
  *
  * This sub-component takes a `TraceResult` instance as input.
- * Optionally, the title of a trace configuration can be provided.
- *
- * It displays a list of result types returned by a trace in the provided `TraceResult`.
- * Selecting a trace result type renders a flow item for that result type.
+ * Optionally, the title of a trace configuration can be provided as a heading to display.
  *
  * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-utility-network-trace-results/)
  *
@@ -21,13 +35,35 @@ type ResultType = "features" | "functions";
  * @internal
  */
 export declare class ArcgisUtilityNetworkTraceResults extends LitElement {
+    get featuresFromSelectedLayer(): Graphic[];
+    /** @default false */
+    isElementsSelected: boolean;
     layers: Layer[];
     messageOverrides?: typeof this._messages._overrides;
-    get selectedResultType(): ResultType | undefined;
+    /**
+     * By assigning the `id` attribute of the Map or Scene component to this property, you can position a child component anywhere in the DOM while still maintaining a connection to the Map or Scene.
+     *
+     * @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)
+     */
+    referenceElement?: ArcgisReferenceElement | string;
+    selectedFeature?: Graphic;
+    selectedLayer?: FeatureLayer | Layer | SubtypeSublayer;
+    /** @default "ready" */
+    state: State;
     traceConfigTitle?: string;
+    traceError?: EsriError<TraceErrorDetails>;
     traceResult?: TraceResult;
+    traceResultFeatures: Graphic[];
     utilityNetwork?: UtilityNetwork;
+    view?: __esri.MapView;
+    readonly arcgisSelectedLayerChange: TargetedEvent<this, void>;
     readonly arcgisSelectedResultTypeChange: TargetedEvent<this, void>;
+    readonly arcgisTraceResultFeaturesReady: TargetedEvent<this, void>;
     private _messages;
+    "@eventTypes": {
+        "arcgisSelectedLayerChange": ArcgisUtilityNetworkTraceResults["arcgisSelectedLayerChange"]["detail"];
+        "arcgisSelectedResultTypeChange": ArcgisUtilityNetworkTraceResults["arcgisSelectedResultTypeChange"]["detail"];
+        "arcgisTraceResultFeaturesReady": ArcgisUtilityNetworkTraceResults["arcgisTraceResultFeaturesReady"]["detail"];
+    };
 }
 export {};