@arcgis/map-components 5.2.0-next.12 → 5.2.0-next.121

package/dist/components/arcgis-utility-network-trace-aggregated-geometry-result-item/customElement.js

@@ -0,0 +1,125 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+import { c as p } from "../../chunks/runtime.js";
+import l from "@arcgis/core/Color.js";
+import m from "@arcgis/core/Graphic.js";
+import d from "@arcgis/core/layers/GraphicsLayer.js";
+import n from "@arcgis/core/symbols/SimpleFillSymbol.js";
+import y from "@arcgis/core/symbols/SimpleLineSymbol.js";
+import u from "@arcgis/core/symbols/SimpleMarkerSymbol.js";
+import { LitElement as f, createEvent as w, nothing as v } from "@arcgis/lumina";
+import { usePropertyChange as G, bypassReadOnly as b } from "@arcgis/lumina/controllers";
+import { log as s, composeMissingPropertyMessage as o } from "@arcgis/toolkit/log";
+import { css as R, html as g } from "lit";
+import { createRef as L, ref as C } from "lit/directives/ref.js";
+import { u as S } from "../../chunks/useT9n.js";
+import { a as c, b as $ } from "../../chunks/layer-utils.js";
+const k = R`.aggregated-geometry-container{display:flex;justify-content:space-between;margin:0 var(--calcite-space-md) var(--calcite-space-md)}.geometry-heading{margin:var(--calcite-space-md);font-weight:var(--calcite-font-weight-medium);font-size:var(--calcite-font-size);color:var(--calcite-color-text-1)}`;
+class z extends f {
+  constructor() {
+    super(...arguments), this._messages = S({ blocking: !0 }), this.#t = "arcgis-utility-network-trace-aggregated-geometry-result-item-graphics", this.#e = L(), this.defaultSelectionSize = 12, this.geometryGraphics = [], this.hideGraphics = !1, this.graphicsColor = new l([255, 255, 0, 0.6]), this.autoDestroyDisabled = !1, this.arcgisPropertyChange = G()("defaultSelectionSize", "geometryGraphics", "hideGraphics", "graphicsColor"), this.arcgisResultReady = w();
+  }
+  static {
+    this.properties = { defaultSelectionSize: 9, heading: 1, traceResult: 0, geometryGraphics: 32, hideGraphics: 5, graphicsColor: 0, graphicsLayer: 0, view: 0, autoDestroyDisabled: 5 };
+  }
+  static {
+    this.styles = k;
+  }
+  #t;
+  #e;
+  clearResult() {
+    this.view?.map && this.graphicsLayer && this.view.map.remove(this.graphicsLayer);
+  }
+  async destroy() {
+    this.clearResult(), await this.manager.destroy();
+  }
+  connectedCallback() {
+    super.connectedCallback(), this.view && this.graphicsLayer && (c(this.view, this.graphicsLayer), this.arcgisResultReady.emit());
+  }
+  load() {
+    if (!this.traceResult?.aggregatedGeometry || !this.view?.map) {
+      this.arcgisResultReady.emit();
+      return;
+    }
+    this.graphicsLayer || this.#a(this.view);
+  }
+  willUpdate(e) {
+    if (e.has("hideGraphics") && this.#s(), e.has("graphicsColor") && this.#c(), e.has("traceResult") && (this.graphicsLayer?.removeAll(), this.traceResult?.aggregatedGeometry && this.view && (this.#i(this.traceResult.aggregatedGeometry), this.arcgisResultReady.emit())), e.has("view")) {
+      const t = e.get("view");
+      t?.map && this.graphicsLayer && (t.map.remove(this.graphicsLayer), this.traceResult?.aggregatedGeometry && this.view && (c(this.view, this.graphicsLayer), this.#i(this.traceResult.aggregatedGeometry), this.arcgisResultReady.emit()));
+    }
+  }
+  loaded() {
+    this.traceResult ? this.traceResult.aggregatedGeometry || s("error", this, o("The property `traceResult` was provided, but `traceResult.aggregatedGeometry` is null. Cannot draw aggregated geometry.")) : s("error", this, o("traceResult")), this.view ? this.view.map || s("error", this, o("The property `view` was provided, but `view.map` is null. Cannot draw aggregated geometry.")) : s("error", this, o("view"));
+  }
+  #i(e) {
+    const { line: t, multipoint: i, polygon: r } = e;
+    b(() => {
+      this.geometryGraphics = [t, i, r].filter((a) => a != null).map((a) => this.#o(a));
+    }), this.graphicsLayer?.addMany(this.geometryGraphics);
+  }
+  #a(e) {
+    const t = this.#t, i = e.map?.findLayerById(t);
+    if (i && $(i)) {
+      this.graphicsLayer = i;
+      return;
+    }
+    this.graphicsLayer = new d({
+      id: t,
+      listMode: "hide",
+      title: t
+    }), c(e, this.graphicsLayer);
+  }
+  #s() {
+    this.hideGraphics ? (this.graphicsLayer?.removeAll(), this.#e.value?.open && (this.#e.value.open = !1)) : this.graphicsLayer?.addMany(this.geometryGraphics);
+  }
+  #o(e) {
+    return new m({
+      geometry: e,
+      symbol: this.#r(e)
+    });
+  }
+  #r(e) {
+    const { defaultSelectionSize: t, graphicsColor: i } = this;
+    switch (e.type) {
+      case "multipoint":
+        return new u({
+          color: i,
+          size: t,
+          outline: {
+            color: i,
+            width: 0
+          }
+        });
+      case "polygon":
+        return new n({
+          color: i,
+          outline: {
+            color: i,
+            width: t
+          }
+        });
+      case "polyline":
+        return new y({
+          color: i,
+          width: t
+        });
+    }
+  }
+  #c() {
+    this.graphicsLayer?.graphics.forEach((e) => {
+      const t = e.geometry;
+      e.symbol = this.#r(t);
+    });
+  }
+  render() {
+    const { graphicsColor: e, heading: t, hideGraphics: i, _messages: r } = this;
+    return g`${t && g`<div class="geometry-heading">${t}</div>` || ""}<div class="aggregated-geometry-container"><calcite-switch .checked=${!i} .label=${r.labels.showGraphicsToggle} label-text-end=${r.showGraphics ?? v} @calciteSwitchChange=${() => this.hideGraphics = !this.hideGraphics}></calcite-switch><calcite-swatch .color=${e.toCss()} .disabled=${i} id=geometry-color-swatch .label=${r.labels.aggregatedGeometryGraphicsColor}></calcite-swatch><calcite-popover closable .heading=${r.headings.setColor} .label=${r.headings.setColor} reference-element=geometry-color-swatch ${C(this.#e)}><calcite-color-picker alpha-channel channels-disabled clearable .disabled=${i} hex-disabled saved-disabled .value=${e.toCss(!0)} @calciteColorPickerChange=${(a) => {
+      const h = a.target.value;
+      h && (this.graphicsColor = new l(h));
+    }}></calcite-color-picker></calcite-popover></div>`;
+  }
+}
+p("arcgis-utility-network-trace-aggregated-geometry-result-item", z);
+export {
+  z as ArcgisUtilityNetworkTraceAggregatedGeometryResultItem
+};

package/dist/components/arcgis-utility-network-trace-aggregated-geometry-result-item/index.d.ts

@@ -0,0 +1 @@
+export * from "./customElement.js";

package/dist/components/arcgis-utility-network-trace-aggregated-geometry-result-item/index.js

@@ -0,0 +1,5 @@
+import "@esri/calcite-components/components/calcite-switch";
+import "@esri/calcite-components/components/calcite-swatch";
+import "@esri/calcite-components/components/calcite-popover";
+import "@esri/calcite-components/components/calcite-color-picker";
+export * from "./customElement.js";

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

@@ -2,9 +2,11 @@
 import type Color from "@arcgis/core/Color.js";
 import type Graphic from "@arcgis/core/Graphic.js";
 import type MapView from "@arcgis/core/views/MapView.js";
+import type { ActionEvent } from "@arcgis/core/widgets/Popup/types.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
+import type { ArcgisFeaturesNext } from "../arcgis-features-next/customElement.js";
 import type { ArcgisReferenceElement } from "../types.js";
-import type { SelectStartPayload } from "../arcgis-utility-network-trace-location/customElement.js";
+import type { SelectStartPayload } from "../arcgis-utility-network-trace-locations/customElement.js";
 import type { ArcgisUtilityNetworkTraceResults } from "../arcgis-utility-network-trace-results/customElement.js";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
 import type { UtilityNetworkTraceAnalysisState } from "@arcgis/core/networks/UtilityNetworkTraceAnalysis.js";
@@ -68,7 +70,7 @@ import type { UtilityNetworkTraceAnalysisState } from "@arcgis/core/networks/Uti
  *
  * ```html
  * <calcite-shell>
- *   <calcite-shell-panel slot="panel-start" position="start" width-scale="l">
+ *   <calcite-shell-panel slot="panel-start" position="start" width="l">
  *     <arcgis-utility-network-trace-analysis reference-element="#map-element"></arcgis-utility-network-trace-analysis>
  *   </calcite-shell-panel>
  *   <arcgis-map id="map-element" item-id="471eb0bf37074b1fbb972b1da70fb310"></arcgis-map>
@@ -77,6 +79,7 @@ import type { UtilityNetworkTraceAnalysisState } from "@arcgis/core/networks/Uti
  *
  * Note: Sign in to access the data in this demo, U/P: `viewer01`/`I68VGU^nMurF`
  *
+ * @internal
  * @since 5.0
  */
 export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
@@ -140,6 +143,16 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
           resultsTab: string;
       };
   }>;
+  /**
+   * A [collection](https://developers.arcgis.com/javascript/latest/references/core/core/Collection/) of [action button](https://developers.arcgis.com/javascript/latest/references/core/support/actions/ActionButton/) or [action toggle](https://developers.arcgis.com/javascript/latest/references/core/support/actions/ActionToggle/) objects. Each action may be executed by clicking the icon or image symbolizing them.
+   * There is a default `Zoom To` action styled with a magnifying glass icon to zoom in four LODs and center the map on the selected feature. This default action can be removed by setting [includeDefaultActionsDisabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-analysis/#includeDefaultActionsDisabled) to `true`, or by setting the [`overwriteActions`](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/#overwriteActions) property to `true` in a [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/).
+   *
+   * The order of each action is the order in which they appear in the actions [Collection](https://developers.arcgis.com/javascript/latest/references/core/core/Collection/). The [@arcgisTriggerAction](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-analysis/#event-arcgisTriggerAction) event fires each time an action is clicked.
+   *
+   * @see [@arcgisTriggerAction](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-analysis/#event-arcgisTriggerAction)
+   * @see [Popup actions sample](https://developers.arcgis.com/javascript/latest/sample-code/popup-actions/)
+   */
+  accessor actions: ArcgisFeaturesNext["actions"] | undefined;
   /**
    * The color used to render graphics for aggregated geometries in trace results, specified as a
    * [Color](https://developers.arcgis.com/javascript/latest/references/core/Color/) object.
@@ -148,6 +161,12 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
    *
    * Default color is #FFFF00.
    *
+   * @example
+   * Set the default aggregated geometry graphics color to lime green.
+   * ```js
+   * const traceElement = document.querySelector("arcgis-utility-network-trace-analysis");
+   * traceElement.aggregatedGeometryGraphicsColor = new Color("lime");
+   * ```
    * @see [Color constructor](https://developers.arcgis.com/javascript/latest/references/core/Color/#constructors-summary)
    */
   accessor aggregatedGeometryGraphicsColor: Color;
@@ -159,6 +178,15 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-utility-network-trace-analysis auto-destroy-disabled></arcgis-utility-network-trace-analysis>
+   * ```
+   *
+   * ```js
+   * utilityNetworkTraceAnalysisElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**
@@ -221,6 +249,41 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
    * ```
    */
   accessor hideFeatureResults: boolean;
+  /**
+   * Whether to hide the aggregated geometry [graphics](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-aggregated-geometry-result-item/#geometryGraphics)
+   * from the map when the trace result contains aggregated geometry results.
+   *
+   * @default false
+   */
+  accessor hideGraphics: boolean;
+  /**
+   * Whether to hide the placeholder string when feature results are hidden in the results tab.
+   *
+   * When this property and [hideFeatureResults](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-analysis/#hideFeatureResults) are both set to `true`,
+   * nothing is rendered for trace result elements. However, features are still queried and are available through
+   * [traceResultFeatures](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-analysis/#traceResultFeatures).
+   *
+   * @default false
+   * @example
+   * Hide the placeholder when feature results are hidden.
+   * ```html
+   * <arcgis-map item-id="471eb0bf37074b1fbb972b1da70fb310">
+   *   <arcgis-utility-network-trace-analysis
+   *     hide-feature-results
+   *     hide-placeholder
+   *     slot="top-right"
+   *   ></arcgis-utility-network-trace-analysis>
+   * </arcgis-map>
+   * ```
+   */
+  accessor hidePlaceholder: boolean;
+  /**
+   * Indicates whether default actions are disabled (hidden) when viewing trace result features.
+   * This property must be set to `true` to disable default actions.
+   *
+   * @default false
+   */
+  accessor includeDefaultActionsDisabled: boolean;
   /** The component's default label. */
   accessor label: string | undefined;
   /**
@@ -228,7 +291,7 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
    *
    * _**Note**: Individual message keys may change between releases._
    */
-  accessor messageOverrides: Pick<ArcgisUtilityNetworkTraceResults["_messages"], "resultFeaturesAreHidden"> & {
+  accessor messageOverrides: NonNullable<ArcgisUtilityNetworkTraceResults["messageOverrides"]> & {
       buttons?: {
           clearResultsCustom?: string | undefined;
           clearResultsGeneric?: string | undefined;
@@ -276,8 +339,8 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
    */
   get traceResultFeatures(): Graphic[];
   /**
-   * The view associated with the component. 
-   *   > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the arcgis-utility-network-trace-analysis component will be associated with a map or scene component rather than using the `view` property.
+   * The view associated with the component.
+   * > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the arcgis-utility-network-trace-analysis component will be associated with a map or scene component rather than using the `view` property.
    */
   accessor view: MapView | null | undefined;
   /** Permanently destroy the component. */
@@ -287,6 +350,7 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
    * Event payload contains a boolean representing whether the aggregated geometry graphics are hidden.
    * If true, the aggregated geometry graphics are hidden on the view.
    *
+   * @deprecated since 5.2. Use [@arcgisPropertyChange](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-analysis/#event-arcgisPropertyChange) instead.
    * @example
    * ```js
    * const traceElement = document.querySelector("arcgis-utility-network-trace-analysis");
@@ -297,7 +361,9 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
    * ```
    */
   readonly arcgisHideGraphicsChange: import("@arcgis/lumina").TargetedEvent<this, boolean>;
-  /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
+  /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
+  readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "aggregatedGeometryGraphicsColor" | "hideGraphics"; }>;
+  /** Emitted when the component associated with a map or scene view is ready for user interaction. */
   readonly arcgisReady: import("@arcgis/lumina").TargetedEvent<this, void>;
   /**
    * Fires when the user completes the selection of a trace location.
@@ -365,12 +431,16 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
    * ```
    */
   readonly arcgisTraceResultFeaturesReady: import("@arcgis/lumina").TargetedEvent<this, void>;
+  /** Emitted when an action is triggered on the component. */
+  readonly arcgisTriggerAction: import("@arcgis/lumina").TargetedEvent<this, ActionEvent>;
   readonly "@eventTypes": {
     arcgisHideGraphicsChange: ArcgisUtilityNetworkTraceAnalysis["arcgisHideGraphicsChange"]["detail"];
+    arcgisPropertyChange: ArcgisUtilityNetworkTraceAnalysis["arcgisPropertyChange"]["detail"];
     arcgisReady: ArcgisUtilityNetworkTraceAnalysis["arcgisReady"]["detail"];
     arcgisTraceLocationSelectEnd: ArcgisUtilityNetworkTraceAnalysis["arcgisTraceLocationSelectEnd"]["detail"];
     arcgisTraceLocationSelectStart: ArcgisUtilityNetworkTraceAnalysis["arcgisTraceLocationSelectStart"]["detail"];
     arcgisTraceResultClear: ArcgisUtilityNetworkTraceAnalysis["arcgisTraceResultClear"]["detail"];
     arcgisTraceResultFeaturesReady: ArcgisUtilityNetworkTraceAnalysis["arcgisTraceResultFeaturesReady"]["detail"];
+    arcgisTriggerAction: ArcgisUtilityNetworkTraceAnalysis["arcgisTriggerAction"]["detail"];
   };
 }

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

@@ -1,62 +1,60 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import { c as m } from "../../chunks/runtime.js";
-import { css as y, html as s } from "lit";
-import { ref as g } from "lit/directives/ref.js";
-import { keyed as u } from "lit/directives/keyed.js";
-import d from "@arcgis/core/Color.js";
-import "@arcgis/core/core/Error.js";
-import { when as f } from "@arcgis/core/core/reactiveUtils.js";
-import b from "@arcgis/core/networks/UtilityNetworkTraceAnalysis.js";
-import { LitElement as w, createEvent as l } from "@arcgis/lumina";
-import { log as T } from "@arcgis/toolkit/log";
-import { u as _ } from "../../chunks/useT9n.js";
-import { m as v } from "../../chunks/useViewModel.js";
-import { l as R } from "../../chunks/async-utils.js";
-const $ = y`:host{--arcgis-internal-color-black-30: color-mix(in srgb, #000000 30.2%, transparent);--arcgis-internal-box-shadow: var(--calcite-spacing-none) var(--calcite-spacing-px) var(--calcite-spacing-base) var(--arcgis-internal-color-black-30);--arcgis-internal-top-max-width: calc(min(100cqw, 100vw) - var(--calcite-spacing-xxxl));--arcgis-internal-panel-width: 300px;--arcgis-internal-panel-height: 100%;--arcgis-internal-panel-height-sm: 240px;--arcgis-internal-panel-height-md: 420px;--arcgis-internal-panel-height-lg: 540px;--arcgis-internal-panel-height-xl: 680px;--arcgis-internal-panel-gap: var(--calcite-spacing-lg);--arcgis-internal-panel-actions-gap: var(--calcite-spacing-sm);--arcgis-internal-basemap-gallery-width-lg: 450px;--arcgis-internal-collapse-icon-flip: scaleX(1);--arcgis-internal-row-direction: row;--arcgis-internal-legend-width: 300px;--arcgis-internal-layout-overlay-space-top: var(--arcgis-layout-overlay-space-top, 0px);--arcgis-internal-layout-overlay-space-bottom: var(--arcgis-layout-overlay-space-bottom, 0px);--arcgis-internal-layout-overlay-space-left: var(--arcgis-layout-overlay-space-left, 0px);--arcgis-internal-layout-overlay-space-right: var(--arcgis-layout-overlay-space-right, 0px);--arcgis-internal-view-color-focus: var(--arcgis-view-color-focus, var(--calcite-color-brand));--arcgis-internal-attribution-space-bottom: var(--arcgis-internal-layout-overlay-space-bottom);--arcgis-internal-attribution-space-left: var(--arcgis-internal-layout-overlay-space-left);--arcgis-internal-attribution-space-right: var(--arcgis-internal-layout-overlay-space-right);--arcgis-internal-attribution-font-size: var(--calcite-font-size-sm);--arcgis-internal-attribution-font-size-sm: var(--calcite-font-size-xs);--arcgis-internal-sketch-justify-content: flex-start}:host{display:flex;flex-direction:column;height:var(--arcgis-internal-panel-height, 100%)}.inputs-tab-container{display:flex;flex-direction:column;height:100%}.trace-inputs-warning{flex:none;height:fit-content;--calcite-panel-background-color: var(--calcite-color-foreground-1);calcite-notice{margin:var(--calcite-spacing-md) var(--calcite-spacing-md) 0 var(--calcite-spacing-md)}}arcgis-utility-network-trace-inputs[mode=default]{height:auto}calcite-tabs{display:flex;flex-direction:column;height:100%}calcite-tab{--calcite-tab-content-space-y: 0;min-height:var(--arcgis-internal-panel-height-sm, 240px)}calcite-tab:not([selected]){flex:0}calcite-panel{--calcite-panel-background-color: var(--calcite-color-foreground-1)}calcite-notice{margin:var(--calcite-spacing-md)}`, C = v(b);
-class E extends w {
+import { c as u } from "../../chunks/runtime.js";
+import { css as d, html as a } from "lit";
+import { ref as c } from "lit/directives/ref.js";
+import { keyed as l } from "lit/directives/keyed.js";
+import p from "@arcgis/core/Color.js";
+import { when as m } from "@arcgis/core/core/reactiveUtils.js";
+import f from "@arcgis/core/networks/UtilityNetworkTraceAnalysis.js";
+import { LitElement as y, createEvent as r } from "@arcgis/lumina";
+import { usePropertyChange as b } from "@arcgis/lumina/controllers";
+import { log as w } from "@arcgis/toolkit/log";
+import { u as v } from "../../chunks/useT9n.js";
+import { m as T } from "../../chunks/useViewModel.js";
+import { l as $ } from "../../chunks/async-utils.js";
+const R = d`:host{--arcgis-internal-color-black-30: color-mix(in srgb, #000000 30.2%, transparent);--arcgis-internal-box-shadow: var(--calcite-spacing-none) var(--calcite-spacing-px) var(--calcite-spacing-base) var(--arcgis-internal-color-black-30);--arcgis-internal-top-max-width: calc(min(100cqw, 100vw) - var(--calcite-spacing-xxxl));--arcgis-internal-panel-width: 300px;--arcgis-internal-panel-height: 100%;--arcgis-internal-panel-height-sm: 240px;--arcgis-internal-panel-height-md: 420px;--arcgis-internal-panel-height-lg: 540px;--arcgis-internal-panel-height-xl: 680px;--arcgis-internal-panel-gap: var(--calcite-spacing-lg);--arcgis-internal-panel-actions-gap: var(--calcite-spacing-sm);--arcgis-internal-basemap-gallery-width-lg: 450px;--arcgis-internal-collapse-icon-flip: scaleX(1);--arcgis-internal-row-direction: row;--arcgis-internal-legend-width: 300px;--arcgis-internal-layout-overlay-space-top: var(--arcgis-layout-overlay-space-top, 0px);--arcgis-internal-layout-overlay-space-bottom: var(--arcgis-layout-overlay-space-bottom, 0px);--arcgis-internal-layout-overlay-space-left: var(--arcgis-layout-overlay-space-left, 0px);--arcgis-internal-layout-overlay-space-right: var(--arcgis-layout-overlay-space-right, 0px);--arcgis-internal-view-color-focus: var(--arcgis-view-color-focus, var(--calcite-color-brand));--arcgis-internal-attribution-space-bottom: var(--arcgis-internal-layout-overlay-space-bottom);--arcgis-internal-attribution-space-left: var(--arcgis-internal-layout-overlay-space-left);--arcgis-internal-attribution-space-right: var(--arcgis-internal-layout-overlay-space-right);--arcgis-internal-attribution-font-size: var(--calcite-font-size-sm);--arcgis-internal-attribution-font-size-sm: var(--calcite-font-size-xs);--arcgis-internal-sketch-justify-content: flex-start}:host{display:flex;flex-direction:column;height:var(--arcgis-internal-panel-height, 100%)}arcgis-utility-network-trace-inputs[mode=default]{height:auto}calcite-tabs{display:flex;flex-direction:column;height:100%}calcite-tab{--calcite-tab-content-space-y: 0;min-height:var(--arcgis-internal-panel-height-sm, 240px)}calcite-tab:not([selected]){flex:0}calcite-panel{--calcite-panel-background-color: var(--calcite-color-foreground-1)}calcite-notice{margin:var(--calcite-spacing-md)}.inputs-tab-container{display:flex;flex-direction:column;height:100%}.trace-inputs-warning{flex:none;height:fit-content;calcite-notice{margin:var(--calcite-spacing-md) var(--calcite-spacing-md) 0}}`, _ = T(f);
+class x extends y {
   constructor() {
-    super(...arguments), this._messages = _({ blocking: !0 }), this._viewModel = C(this), this._highlightHandles = [], this._handleRunTraceButtonClick = () => {
-      this._setTraceWarnings(), !(this.showNoStartingPointsWarning || this.showMissingTerminalWarning) && (this.showNoStartingPointsWarning = !1, this.showMissingTerminalWarning = !1, this._clearTraceResult(), this._switchTab("results"), this._runTrace());
-    }, this._handleTraceInputsRefChange = (e) => {
-      e && (this._traceInputsElement = e);
-    }, this._handleTraceResultsRefChange = (e) => {
-      e && (this._traceResultsElement = e);
-    }, this.activeTab = "input", this.showMissingTerminalWarning = !1, this.showNoStartingPointsWarning = !1, this.mode = "default", this.autoDestroyDisabled = !1, this.aggregatedGeometryGraphicsColor = new d([255, 255, 0, 0.6]), this.disableHighlightFeatureResults = !1, this.hideActionBar = !1, this.hideFeatureResults = !1, this.state = this._viewModel.state, this.view = this._viewModel.view, this.arcgisHideGraphicsChange = l(), this.arcgisReady = l(), this.arcgisTraceLocationSelectEnd = l(), this.arcgisTraceLocationSelectStart = l(), this.arcgisTraceResultClear = l(), this.arcgisTraceResultFeaturesReady = l();
+    super(...arguments), this._messages = v({ blocking: !0 }), this.#e = _(this), this._activeTab = "input", this._showMissingTerminalWarning = !1, this._showNoStartingPointsWarning = !1, this._mode = "default", this.autoDestroyDisabled = !1, this.aggregatedGeometryGraphicsColor = new p([255, 255, 0, 0.6]), this.disableHighlightFeatureResults = !1, this.hideActionBar = !1, this.hideGraphics = !1, this.hidePlaceholder = !1, this.hideFeatureResults = !1, this.includeDefaultActionsDisabled = !1, this.state = this.#e.state, this.view = this.#e.view, this.arcgisHideGraphicsChange = r(), this.arcgisPropertyChange = b()("aggregatedGeometryGraphicsColor", "hideGraphics"), this.arcgisReady = r(), this.arcgisTriggerAction = r(), this.arcgisTraceLocationSelectEnd = r(), this.arcgisTraceLocationSelectStart = r(), this.arcgisTraceResultClear = r(), this.arcgisTraceResultFeaturesReady = r();
   }
   static {
-    this.properties = { activeTab: 16, traceError: 16, traceResult: 16, showMissingTerminalWarning: 16, showNoStartingPointsWarning: 16, mode: 16, autoDestroyDisabled: 5, beforeTraceLocationSelectStart: 0, aggregatedGeometryGraphicsColor: 0, disableHighlightFeatureResults: 5, hideActionBar: 5, hideFeatureResults: 5, label: 3, messageOverrides: 0, traceResultFeatures: 32, referenceElement: 1, state: 32, view: 0 };
+    this.properties = { _activeTab: 16, _traceError: 16, _traceResult: 16, _showMissingTerminalWarning: 16, _showNoStartingPointsWarning: 16, _mode: 16, actions: 0, autoDestroyDisabled: 5, beforeTraceLocationSelectStart: 0, aggregatedGeometryGraphicsColor: 0, disableHighlightFeatureResults: 5, hideActionBar: 5, hideGraphics: 5, hidePlaceholder: 5, hideFeatureResults: 5, includeDefaultActionsDisabled: 5, label: 3, messageOverrides: 0, traceResultFeatures: 32, referenceElement: 1, state: 32, view: 0 };
   }
   static {
-    this.styles = $;
+    this.styles = R;
   }
-  get _allLayers() {
+  #e;
+  #t;
+  #i;
+  get #r() {
     const { view: e } = this;
     return e?.map ? e.map.allLayers.toArray().concat(e.map.allTables.toArray()) : [];
   }
+  #n;
   get traceResultFeatures() {
-    return this._traceResultsElement?.traceResultFeatures ?? [];
+    return this.#i?.traceResultFeatures ?? [];
   }
   async destroy() {
-    this._clearHighlights(), this._traceResultsElement?.destroy(), this._traceInputsElement?.destroy(), await this.manager.destroy();
+    await this.#i?.destroy(), await this.#t?.destroy(), await this.manager.destroy();
   }
   load() {
     this.manager.onLifecycle(() => [
-      f(() => !this._viewModel.utilityNetwork, () => this._switchTab("input"))
+      m(() => !this.#e.utilityNetwork, () => this.#a("input"))
     ]);
   }
-  _clearTraceResult() {
-    this.traceResult = void 0, this._clearHighlights(), this._clearAggregatedGeometryGraphics();
+  #s() {
+    this._traceResult = void 0, this.#i?.clearResults();
   }
-  _setTraceWarnings() {
-    if (!this._traceInputsElement)
+  #o() {
+    if (!this.#t)
       return;
-    const { traceLocations: e, traceLocationFlagInfos: t, unTraceConfiguration: a, isSubnetworkNameTraceSelected: i } = this._traceInputsElement, r = !!a?.subnetworkName, c = e?.some((n) => n.type === "starting-point"), o = t?.some((n) => !!n.flagProperties.terminalConfiguration && !n.flagProperties.selectedTerminals?.size) ?? !1;
-    this.traceError = void 0, this.showNoStartingPointsWarning = !i && !c || i && !r, this.showMissingTerminalWarning = o;
+    const { traceLocations: e, traceLocationDetails: t, traceConfiguration: i, isSubnetworkNameTraceSelected: s } = this.#t, n = !!i?.subnetworkName, h = e?.some((o) => o.type === "starting-point"), g = t?.some((o) => !!o.flagProperties.terminalConfiguration && !o.flagProperties.selectedTerminals?.size) ?? !1;
+    this._traceError = void 0, this._showNoStartingPointsWarning = !s && !h || s && !n, this._showMissingTerminalWarning = g;
   }
-  _switchTab(e) {
-    this.activeTab = e;
+  #a(e) {
+    this._activeTab = e;
   }
-  _getLoadError(e) {
+  #c(e) {
     const { _messages: t } = this;
     switch (e) {
       case "no-user-type-extension":
@@ -71,106 +69,88 @@ class E extends w {
         return e;
     }
   }
-  _clearHighlights() {
-    this._highlightHandles.forEach((e) => e.remove()), this._highlightHandles = [];
-  }
-  _clearAggregatedGeometryGraphics() {
-    this._traceResultsElement?.clearAggregatedGeometryGraphics();
-  }
-  _highlightResults() {
-    const { traceResult: e, view: t } = this, a = this._viewModel.utilityNetwork;
-    if (!a || !e?.elements || !t)
-      return;
-    a.getObjectIdsFromElements(e.elements).forEach((r) => {
-      const c = t.allLayerViews.find((n) => {
-        const h = n.layer;
-        if (a.isUtilityLayer(h)) {
-          const p = Number(r.layerUrl.split("/").pop());
-          return h.layerId === p;
-        }
-        return !1;
-      });
-      if (!c)
-        return;
-      const o = c.highlight(r.objectIds);
-      this._highlightHandles.push(o);
-    });
-  }
-  async _runTrace() {
-    const e = this._traceInputsElement?.selectedNamedTraceConfiguration, t = this._traceInputsElement?.unTraceConfiguration;
+  async #l() {
+    const e = this.#t?.selectedNamedTraceConfiguration, t = this.#t?.traceConfiguration;
     if (!(e?.traceType && t)) {
-      T("error", this, "Trace configuration not found");
+      w("error", this, "Trace configuration not found");
       return;
     }
-    const a = this._traceInputsElement?.traceLocations;
+    const i = this.#t?.traceLocations;
     try {
-      this.traceResult = await this._viewModel.executeTraceConfiguration({
+      this._traceResult = await this.#e.executeTraceConfiguration({
         traceType: e.traceType,
         traceConfiguration: t,
-        traceLocations: a ?? [],
+        traceLocations: i ?? [],
         resultTypes: e.resultTypes,
         outSpatialReference: this.view?.spatialReference
-      }), this.disableHighlightFeatureResults || this._highlightResults();
-    } catch (i) {
-      R(i, this, "Error while running trace"), this.traceError = i, this.traceResult = void 0;
+      });
+    } catch (s) {
+      $(s, this, "Error while running trace"), this._traceError = s, this._traceResult = void 0;
     }
   }
-  _handleHideGraphicsChange(e) {
-    e.stopPropagation(), this.arcgisHideGraphicsChange.emit(e.detail);
+  #h() {
+    this.#o(), !(this._showNoStartingPointsWarning || this._showMissingTerminalWarning) && (this._showNoStartingPointsWarning = !1, this._showMissingTerminalWarning = !1, this.#s(), this.#a("results"), this.#l());
   }
-  _handleTraceLocationSelectStart(e) {
+  #g(e) {
+    e && (this.#t = e);
+  }
+  #u(e) {
+    e && (this.#i = e);
+  }
+  #d(e) {
+    const { detail: t, target: i } = e;
+    t.name === "aggregatedGeometryGraphicsColor" ? (e.stopPropagation(), this.aggregatedGeometryGraphicsColor = i[t.name]) : t.name === "hideGraphics" && (e.stopPropagation(), this.hideGraphics = i[t.name], this.arcgisHideGraphicsChange.emit(this.hideGraphics));
+  }
+  #p(e) {
     e.stopPropagation(), this.arcgisTraceLocationSelectStart.emit(e.detail).defaultPrevented && e.preventDefault();
   }
-  _handleTraceLocationSelectEnd(e) {
+  #m(e) {
     e.stopPropagation(), this.arcgisTraceLocationSelectEnd.emit();
   }
-  _handleTraceResultFeaturesReady(e) {
+  #f(e) {
     e.stopPropagation(), this.arcgisTraceResultFeaturesReady.emit();
   }
-  _handleAggregatedGeometryGraphicsColorChange(e) {
-    const t = e.detail;
-    this.aggregatedGeometryGraphicsColor = new d(t);
-  }
-  _handleSelectedNamedTraceConfigurationChange() {
-    this.showNoStartingPointsWarning = !1, this.showMissingTerminalWarning = !1;
+  #y(e) {
+    e.stopPropagation(), this.arcgisTriggerAction.emit(e.detail);
   }
-  _handleUtilityNetworkChange() {
-    this._viewModel.utilityNetwork = this._traceInputsElement?.selectedUtilityNetwork;
+  #b(e) {
+    const { detail: t, target: i } = e;
+    e.stopPropagation(), t.name === "selectedUtilityNetwork" && (this.#e.utilityNetwork = i.selectedUtilityNetwork), t.name === "selectedNamedTraceConfiguration" && (this._showNoStartingPointsWarning = !1, this._showMissingTerminalWarning = !1), t.name === "mode" && (this._mode = i.mode);
   }
-  renderMissingTerminalWarning() {
-    return s`<calcite-panel class="trace-inputs-warning"><calcite-notice open icon=exclamation-mark-triangle closable kind=danger scale=s @calciteNoticeClose=${() => this.showMissingTerminalWarning = !1}><div slot=title>${this._messages.errors.missingTerminalTitle}</div><div slot=message>${this._messages.errors.missingTerminalBody}</div></calcite-notice></calcite-panel>`;
+  #w() {
+    const { _messages: e } = this;
+    return a`<calcite-panel class="trace-inputs-warning"><calcite-notice open icon=exclamation-mark-triangle closable kind=danger scale=s @calciteNoticeClose=${() => this._showMissingTerminalWarning = !1}><div slot=title>${e.errors.missingTerminalTitle}</div><div slot=message>${e.errors.missingTerminalBody}</div></calcite-notice></calcite-panel>`;
   }
-  renderNoStartingPointsWarning() {
-    return s`<calcite-panel class="trace-inputs-warning"><calcite-notice open icon=exclamation-mark-triangle closable kind=danger scale=s @calciteNoticeClose=${() => this.showNoStartingPointsWarning = !1}><div slot=title>${this._messages.errors.noStartingPointsTitle}</div><div slot=message>${this._messages.errors.noStartingPointsBody}</div></calcite-notice></calcite-panel>`;
+  #v() {
+    const { _messages: e } = this;
+    return a`<calcite-panel class="trace-inputs-warning"><calcite-notice open icon=exclamation-mark-triangle closable kind=danger scale=s @calciteNoticeClose=${() => this._showNoStartingPointsWarning = !1}><div slot=title>${e.errors.noStartingPointsTitle}</div><div slot=message>${e.errors.noStartingPointsBody}</div></calcite-notice></calcite-panel>`;
   }
-  renderResultsTab() {
-    return u(`${this.el.id}__results-tab-item`, s`<calcite-tab .selected=${this.activeTab === "results"}>${this.state === "executing" ? s`<calcite-panel><calcite-loader .label=${this._messages.runningTrace} .text=${this._messages.runningTrace}></calcite-loader></calcite-panel>` : s`<arcgis-utility-network-trace-results .autoDestroyDisabled=${this.autoDestroyDisabled} .aggregatedGeometryGraphicsColor=${this.aggregatedGeometryGraphicsColor} .hideActionBar=${this.hideActionBar} .hideFeatureResults=${this.hideFeatureResults} .layers=${this._allLayers} .messageOverrides=${{ resultFeaturesAreHidden: this.messageOverrides?.resultFeaturesAreHidden }} .referenceElement=${this.referenceElement} .traceConfigTitle=${this._selectedTraceConfig?.title} .traceError=${this.traceError} .traceResult=${this.traceResult} .utilityNetwork=${this._viewModel.utilityNetwork ?? void 0} .view=${this.view ?? void 0} @arcgisAggregatedGeometryGraphicsColorChange=${this._handleAggregatedGeometryGraphicsColorChange} @arcgisHideGraphicsChange=${this._handleHideGraphicsChange} @arcgisTraceResultFeaturesReady=${this._handleTraceResultFeaturesReady} ${g(this._handleTraceResultsRefChange)}></arcgis-utility-network-trace-results>`}</calcite-tab>`);
+  #T() {
+    return l(`${this.el.id}__results-tab-item`, a`<calcite-tab .selected=${this._activeTab === "results"}>${this.state === "executing" ? a`<calcite-panel><calcite-loader .label=${this._messages.runningTrace} .text=${this._messages.runningTrace}></calcite-loader></calcite-panel>` : a`<arcgis-utility-network-trace-results .actions=${this.actions} .autoDestroyDisabled=${this.autoDestroyDisabled} .aggregatedGeometryGraphicsColor=${this.aggregatedGeometryGraphicsColor} .disableHighlightFeatureResults=${this.disableHighlightFeatureResults} .heading=${this.#n?.title} .hideActionBar=${this.hideActionBar} .hideFeatureResults=${this.hideFeatureResults} .hidePlaceholder=${this.hidePlaceholder} .includeDefaultActionsDisabled=${this.includeDefaultActionsDisabled} .layers=${this.#r} .messageOverrides=${this.messageOverrides} .referenceElement=${this.referenceElement} .traceError=${this._traceError} .traceResult=${this._traceResult} .utilityNetwork=${this.#e.utilityNetwork ?? void 0} .view=${this.view ?? void 0} @arcgisPropertyChange=${this.#d} @arcgisTraceResultFeaturesReady=${this.#f} @arcgisTriggerAction=${this.#y} ${c(this.#u)}></arcgis-utility-network-trace-results>`}</calcite-tab>`);
   }
-  renderResultsFooter() {
-    const { traceResult: e } = this, a = !!(e?.elements.length || e?.globalFunctionResults.length || e?.aggregatedGeometry) && this._traceResultsElement?.state === "ready", i = this._traceResultsElement?.numResults ?? 0;
-    return s`<calcite-button appearance=outline width=full @click=${() => {
-      this._switchTab("input"), this._clearTraceResult(), this.arcgisTraceResultClear.emit();
-    }} .disabled=${!a} slot=footer>${i > 0 && !this.hideFeatureResults && this.state !== "executing" ? this._messages.buttons.clearResultsCustom.replace("{number}", i.toString()) : this._messages.buttons.clearResultsGeneric}</calcite-button>`;
+  #$() {
+    const { _messages: e, _traceResult: t } = this, s = !!(t?.elements.length || t?.globalFunctionResults.length || t?.aggregatedGeometry) && this.#i?.state === "ready", n = this.#i?.numFeatureResults ?? 0;
+    return a`<calcite-button appearance=outline width=full @click=${() => {
+      this.#a("input"), this.#s(), this.arcgisTraceResultClear.emit();
+    }} .disabled=${!s} slot=footer>${n > 0 && !this.hideFeatureResults && this.state !== "executing" ? e.buttons.clearResultsCustom.replace("{number}", n.toString()) : e.buttons.clearResultsGeneric}</calcite-button>`;
   }
-  renderInputTab() {
-    const { mode: e } = this, { loadError: t } = this._viewModel, i = (t === "no-user-type-extension" || t === "sceneView-not-supported" ? s`<calcite-notice kind=danger open scale=s slot=content-top width=auto><div slot=message>${this._getLoadError(t)}</div></calcite-notice>` : void 0) ?? s`${this.showNoStartingPointsWarning && e === "default" && this.renderNoStartingPointsWarning() || ""}${this.showMissingTerminalWarning && e === "default" && this.renderMissingTerminalWarning() || ""}<arcgis-utility-network-trace-inputs .autoDestroyDisabled=${this.autoDestroyDisabled} .hideActionBar=${this.hideActionBar} .referenceElement=${this.referenceElement} .view=${this.view ?? void 0} .beforeTraceLocationSelectStart=${this.beforeTraceLocationSelectStart} @arcgisPropertyChange=${(r) => {
-      r.stopPropagation(), r.detail.name === "mode" && (this.mode = r.target.mode);
-    }} @arcgisSelectedNamedTraceConfigurationChange=${this._handleSelectedNamedTraceConfigurationChange} @arcgisTraceLocationSelectEnd=${this._handleTraceLocationSelectEnd} @arcgisTraceLocationSelectStart=${this._handleTraceLocationSelectStart} @arcgisUtilityNetworkChange=${this._handleUtilityNetworkChange} ${g(this._handleTraceInputsRefChange)}></arcgis-utility-network-trace-inputs>`;
-    return u(`${this.el.id}__inputs-tab-item`, s`<calcite-tab .selected=${this.activeTab === "input"}><div class="inputs-tab-container">${i}</div></calcite-tab>`);
+  #R() {
+    const { _mode: e } = this, { loadError: t } = this.#e, s = (t === "no-user-type-extension" || t === "sceneView-not-supported" ? a`<calcite-notice kind=danger open scale=s slot=content-top width=auto><div slot=message>${this.#c(t)}</div></calcite-notice>` : void 0) ?? a`${this._showNoStartingPointsWarning && e === "default" && this.#v() || ""}${this._showMissingTerminalWarning && e === "default" && this.#w() || ""}<arcgis-utility-network-trace-inputs .autoDestroyDisabled=${this.autoDestroyDisabled} .hideFeaturesActionBar=${this.hideActionBar} .referenceElement=${this.referenceElement} .view=${this.view ?? void 0} .beforeTraceLocationSelectStart=${this.beforeTraceLocationSelectStart} @arcgisPropertyChange=${this.#b} @arcgisTraceLocationSelectEnd=${this.#m} @arcgisTraceLocationSelectStart=${this.#p} ${c(this.#g)}></arcgis-utility-network-trace-inputs>`;
+    return l(`${this.el.id}__inputs-tab-item`, a`<calcite-tab .selected=${this._activeTab === "input"}><div class="inputs-tab-container">${s}</div></calcite-tab>`);
   }
-  renderInputFooter() {
-    const { mode: e, state: t } = this;
-    if (e !== "default")
+  #_() {
+    const { state: e } = this;
+    if (this._mode !== "default")
       return null;
-    const a = t === "disabled" || t === "loading" || !this._traceInputsElement?.unTraceConfiguration;
-    return s`<calcite-button appearance=solid width=full @click=${this._handleRunTraceButtonClick} slot=footer .disabled=${a}>${this._messages.buttons.getResults}</calcite-button>`;
+    const t = e === "disabled" || e === "loading" || !this.#t?.traceConfiguration;
+    return a`<calcite-button appearance=solid width=full @click=${this.#h} slot=footer .disabled=${t}>${this._messages.buttons.getResults}</calcite-button>`;
   }
   render() {
-    const { activeTab: e, state: t } = this;
-    return s`<calcite-panel><calcite-tabs layout=center position=top><calcite-tab-nav slot=title-group><calcite-tab-title @click=${() => this._switchTab("input")} .selected=${e === "input"}>${this._messages.tabs.inputTab}</calcite-tab-title><calcite-tab-title @click=${() => this._switchTab("results")} .selected=${e === "results"} .disabled=${t === "disabled" || t === "loading"}>${this._messages.tabs.resultsTab}</calcite-tab-title></calcite-tab-nav>${this.renderInputTab()}${t === "ready" || t === "executing" ? this.renderResultsTab() : null}</calcite-tabs>${e === "input" ? this.renderInputFooter() : null}${e === "results" ? this.renderResultsFooter() : null}</calcite-panel>`;
+    const { _activeTab: e, state: t } = this;
+    return a`<calcite-panel><calcite-tabs layout=center position=top><calcite-tab-nav slot=title-group><calcite-tab-title @click=${() => this.#a("input")} .selected=${e === "input"}>${this._messages.tabs.inputTab}</calcite-tab-title><calcite-tab-title @click=${() => this.#a("results")} .selected=${e === "results"} .disabled=${t === "disabled" || t === "loading"}>${this._messages.tabs.resultsTab}</calcite-tab-title></calcite-tab-nav>${this.#R()}${this.#T()}</calcite-tabs>${e === "input" ? this.#_() : null}${e === "results" ? this.#$() : null}</calcite-panel>`;
   }
 }
-m("arcgis-utility-network-trace-analysis", E);
+u("arcgis-utility-network-trace-analysis", x);
 export {
-  E as ArcgisUtilityNetworkTraceAnalysis
+  x as ArcgisUtilityNetworkTraceAnalysis
 };

package/dist/components/arcgis-utility-network-trace-analysis/types.d.ts

@@ -1 +1,27 @@
-export type UtilityNetworkTraceAnalysisDisplayMode = "add-spatial-feature" | "add-spatial-instructions" | "default";
+import type Layer from "@arcgis/core/layers/Layer.js";
+import type UtilityNetwork from "@arcgis/core/networks/UtilityNetwork.js";
+import type TraceResult from "@arcgis/core/rest/networks/support/TraceResult.js";
+import type MapView from "@arcgis/core/views/MapView.js";
+
+export type UtilityNetworkTraceAnalysisDisplayMode = "add-spatial-feature" | "add-spatial-instructions" | "default";
+
+/**
+ * Defines the common properties shared by all children of [arcgis-utility-network-trace-results](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results/).
+ *
+ * @internal
+ * @since 5.2
+ */
+export interface UtilityNetworkTraceResultItem {
+  /** The layers used by the result item. */
+  layers?: Layer[];
+  /** The heading of the result item. */
+  heading?: string;
+  /** The trace result used by the result item. */
+  traceResult?: TraceResult;
+  /** The utility network used by the result item. */
+  utilityNetwork?: UtilityNetwork;
+  /** The MapView used by the result item. */
+  view?: MapView;
+  /** A method to clean up side effects from the result item. */
+  clearResult?: () => void;
+}