@arcgis/map-components 5.0.0-next.14 → 5.0.0-next.141

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

@@ -1,20 +1,16 @@
 /// <reference path="../../index.d.ts" />
-import { default as Collection } from '@arcgis/core/core/Collection.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 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 {
-    traceLocation: TraceLocation;
-    mapPoint?: Point | null;
-    mapGraphic?: Graphic | null;
-    details?: Graphic | null;
-}
+import type Collection from "@arcgis/core/core/Collection.js";
+import type Point from "@arcgis/core/geometry/Point.js";
+import type Graphic from "@arcgis/core/Graphic.js";
+import type GraphicsLayer from "@arcgis/core/layers/GraphicsLayer.js";
+import type Layer from "@arcgis/core/layers/Layer.js";
+import type TerminalConfiguration from "@arcgis/core/networks/support/TerminalConfiguration.js";
+import type UtilityNetwork from "@arcgis/core/networks/UtilityNetwork.js";
+import type TraceLocation from "@arcgis/core/rest/networks/support/TraceLocation.js";
+import type MapView from "@arcgis/core/views/MapView.js";
+import type SketchViewModel from "@arcgis/core/widgets/Sketch/SketchViewModel.js";
+import type { PublicLitElement as LitElement } from "@arcgis/lumina/PublicLitElement";
+import type { T9nMeta } from "@arcgis/lumina/controllers";
 
 /**
  * This is a sub-component used by the **ArcgisUtilityNetworkTraceAnalysis** component.
@@ -22,23 +18,124 @@ export interface FlagProperty {
  * This sub-component takes a map view as an input.
  * It allows users to select locations on the map to use as trace inputs.
  *
- * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-utility-network-trace-location/)
- *
  * @since 4.34
  * @internal
  */
-export declare class ArcgisUtilityNetworkTraceLocation extends LitElement {
-    /** @required */
-    view?: MapView;
-    /** @default "starting-point" */
-    traceLocationType: "barrier" | "starting-point" | "stopping-point";
-    traceLocations?: Collection<FlagProperty>;
-    filterLayers?: Collection<Layer>;
-    sketchViewModel?: SketchViewModel;
-    flagLayer?: GraphicsLayer;
-    /** @required The utility network to perform the trace on. */
-    utilityNetwork?: UtilityNetwork;
-    readonly arcgisTraceLocationChange: TargetedEvent<this, void>;
-    readonly arcgisTraceLocationSelectEnd: TargetedEvent<this, void>;
-    readonly arcgisTraceLocationSelectStart: TargetedEvent<this, void>;
+export abstract class ArcgisUtilityNetworkTraceLocation extends LitElement {
+  /**
+   * A function to run before trace location selection starts.
+   *
+   * @experimental
+   */
+  accessor beforeTraceLocationSelectStart: (() => Promise<void>) | undefined;
+  accessor filterLayers: Collection<Layer> | undefined;
+  accessor flagLayer: GraphicsLayer | undefined;
+  /** @internal */
+  protected messages: {
+      buttons: { clear: string; };
+      componentLabel: string;
+      errors: {};
+      labels: {
+          close: string;
+          unknown: string;
+      };
+      types: {
+          barrier: {
+              buttonText: string;
+              description: string;
+              heading: string;
+              message: string;
+          };
+          startingPoint: {
+              buttonText: string;
+              description: string;
+              heading: string;
+              message: string;
+          };
+          stoppingPoint: {
+              buttonText: string;
+              description: string;
+              heading: string;
+              message: string;
+          };
+      };
+  } & T9nMeta<{
+      buttons: { clear: string; };
+      componentLabel: string;
+      errors: {};
+      labels: {
+          close: string;
+          unknown: string;
+      };
+      types: {
+          barrier: {
+              buttonText: string;
+              description: string;
+              heading: string;
+              message: string;
+          };
+          startingPoint: {
+              buttonText: string;
+              description: string;
+              heading: string;
+              message: string;
+          };
+          stoppingPoint: {
+              buttonText: string;
+              description: string;
+              heading: string;
+              message: string;
+          };
+      };
+  }>;
+  accessor sketchViewModel: SketchViewModel | undefined;
+  /** @default 0.05 */
+  accessor spatialTolerance: number;
+  accessor traceLocations: Collection<FlagInfo> | undefined;
+  /** @default "starting-point" */
+  accessor traceLocationType: TraceLocationType;
+  /** @required */
+  accessor utilityNetwork: UtilityNetwork | undefined;
+  /** @required */
+  accessor view: MapView | undefined;
+  readonly arcgisTraceLocationChange: import("@arcgis/lumina").TargetedEvent<this, void>;
+  /**
+   * Fires when the user completes the selection of a trace location.
+   *
+   * @experimental
+   */
+  readonly arcgisTraceLocationSelectEnd: import("@arcgis/lumina").TargetedEvent<this, void>;
+  /**
+   * Fires when the user begins selection of a trace location.
+   * Can be prevented to stop the selection.
+   *
+   * @experimental
+   */
+  readonly arcgisTraceLocationSelectStart: import("@arcgis/lumina").TargetedEvent<this, SelectStartPayload>;
+  readonly "@eventTypes": {
+    arcgisTraceLocationChange: ArcgisUtilityNetworkTraceLocation["arcgisTraceLocationChange"]["detail"];
+    arcgisTraceLocationSelectEnd: ArcgisUtilityNetworkTraceLocation["arcgisTraceLocationSelectEnd"]["detail"];
+    arcgisTraceLocationSelectStart: ArcgisUtilityNetworkTraceLocation["arcgisTraceLocationSelectStart"]["detail"];
+  };
+}
+
+export interface FlagInfo {
+  traceLocation: TraceLocation;
+  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;
+}

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.14 */
-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.141 */
+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 @@
-import "@esri/calcite-components/components/calcite-block";
-import "@esri/calcite-components/components/calcite-button";
 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,38 @@
+/// <reference path="../../index.d.ts" />
+import type Collection from "@arcgis/core/core/Collection.js";
+import type { PublicLitElement as LitElement } from "@arcgis/lumina/PublicLitElement";
+import type { FlagInfo, TraceLocationType } from "../arcgis-utility-network-trace-location/customElement.js";
+import type { T9nMeta } from "@arcgis/lumina/controllers";
+
+/**
+ * This is a sub-component used by the **ArcgisUtilityNetworkTraceAnalysis** component.
+ *
+ * This sub-component renders a collection of trace locations as a list.
+ *
+ * @since 4.34
+ * @internal
+ */
+export abstract class ArcgisUtilityNetworkTraceLocationList extends LitElement {
+  /** @internal */
+  protected _messages: {
+      componentLabel: string;
+      errors: { noTerminalSelected: string; };
+      labels: {
+          filterBarrier: string;
+          list: string;
+          unknown: string;
+      };
+  } & T9nMeta<{
+      componentLabel: string;
+      errors: { noTerminalSelected: string; };
+      labels: {
+          filterBarrier: string;
+          list: string;
+          unknown: string;
+      };
+  }>;
+  /** @required */
+  accessor traceLocations: Collection<FlagInfo>;
+  /** @default "starting-point" */
+  accessor traceLocationType: TraceLocationType;
+}