@arcgis/map-components 5.1.0-next.12 → 5.1.0-next.14

package/dist/components/arcgis-utility-network-aggregated-geometry/customElement.d.ts

@@ -1,7 +1,7 @@
 /// <reference path="../../index.d.ts" />
 import type Color from "@arcgis/core/Color.js";
-import type AggregatedGeometry from "@arcgis/core/rest/networks/support/AggregatedGeometry";
-import type MapView from "@arcgis/core/views/MapView";
+import type AggregatedGeometry from "@arcgis/core/rest/networks/support/AggregatedGeometry.js";
+import type MapView from "@arcgis/core/views/MapView.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
 
@@ -35,6 +35,16 @@ export abstract class ArcgisUtilityNetworkAggregatedGeometry extends LitElement
       };
       showGraphics: string;
   }>;
+  /**
+   * If true, the component will not be destroyed automatically when it is
+   * disconnected from the document. This is useful when you want to move the
+   * component to a different place on the page, or temporarily hide it. If this
+   * is set, make sure to call the [destroy()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-aggregated-geometry/#destroy) method when you are done to
+   * prevent memory leaks.
+   *
+   * @default false
+   */
+  accessor autoDestroyDisabled: boolean;
   /** @required */
   accessor geometry: AggregatedGeometry | undefined;
   /**
@@ -48,6 +58,8 @@ export abstract class ArcgisUtilityNetworkAggregatedGeometry extends LitElement
   accessor state: State;
   /** @required */
   accessor view: MapView | undefined;
+  /** Permanently destroy the component. */
+  destroy(): Promise<void>;
   readonly arcgisHideGraphicsChange: import("@arcgis/lumina").TargetedEvent<this, boolean>;
   readonly "@eventTypes": {
     arcgisHideGraphicsChange: ArcgisUtilityNetworkAggregatedGeometry["arcgisHideGraphicsChange"]["detail"];

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

@@ -29,31 +29,31 @@ class k extends G {
         listMode: "hide",
         title: e
       }), p(this.view, this._graphicsLayer);
-    }, this.hideGraphics = !1, this.graphicsColor = new n([255, 255, 0, 0.6]), this.state = "ready", this.arcgisHideGraphicsChange = f();
+    }, this.hideGraphics = !1, this.graphicsColor = new n([255, 255, 0, 0.6]), this.state = "ready", this.autoDestroyDisabled = !1, this.arcgisHideGraphicsChange = f();
   }
   static {
-    this.properties = { geometry: 0, hideGraphics: 5, graphicsColor: 0, state: 1, view: 0 };
+    this.properties = { geometry: 0, hideGraphics: 5, graphicsColor: 0, state: 1, view: 0, autoDestroyDisabled: 5 };
   }
   static {
     this.styles = S;
   }
+  async destroy() {
+    this.view?.map && this._graphicsLayer && this.view.map.remove(this._graphicsLayer), await this.manager.destroy();
+  }
   connectedCallback() {
     super.connectedCallback(), this.view && this._graphicsLayer && p(this.view, this._graphicsLayer);
   }
   load() {
     !this.geometry || !this.view?.map || this._loadProjectOperator().then(() => this._createGraphicsLayer());
   }
-  loaded() {
-    this.geometry || a("error", this, o("geometry")), this.view ? this.view.map || a("error", this, o("The property `view` was provided, but `view.map` is null. Cannot draw aggregated geometry.")) : a("error", this, o("view"));
-  }
   willUpdate(i) {
     if (i.has("graphicsColor") && this._updateGraphicSymbols(), i.has("geometry") && (this._graphicsLayer?.removeAll(), this._addAggregatedGeometryToView()), i.has("view")) {
       const e = i.get("view");
       e?.map && this._graphicsLayer && (e.map.remove(this._graphicsLayer), this._createGraphicsLayer(), this._addAggregatedGeometryToView());
     }
   }
-  disconnectedCallback() {
-    super.disconnectedCallback(), this.view?.map && this._graphicsLayer && this.view.map.remove(this._graphicsLayer);
+  loaded() {
+    this.geometry || a("error", this, o("geometry")), this.view ? this.view.map || a("error", this, o("The property `view` was provided, but `view.map` is null. Cannot draw aggregated geometry.")) : a("error", this, o("view"));
   }
   _handleShowGraphicsChange() {
     this.hideGraphics = !this.hideGraphics, this.hideGraphics ? this._graphicsLayer?.removeAll() : this._graphicsLayer?.addMany(this._projectedGraphics), this.arcgisHideGraphicsChange.emit(this.hideGraphics);

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

@@ -2,18 +2,22 @@
 import type MapView from "@arcgis/core/views/MapView.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 import type { ArcgisReferenceElement, IconName } from "../types.js";
-import type { UtilityNetworkTraceViewModelRemoveResultAreaEvent, UtilityNetworkTraceViewModelAddResultAreaEvent, UtilityNetworkTraceViewModelAddFlagErrorEvent, UtilityNetworkTraceViewModelAddFlagCompleteEvent, UtilityNetworkTraceViewModelAddFlagEvent, TraceResultExtend } from "@arcgis/core/widgets/UtilityNetworkTrace/UtilityNetworkTraceViewModel";
-import type { GraphicColor, FlagProperty, ResultAreaPropertiesExtend, UtilityNetworkTraceViewModelState } from "@arcgis/core/widgets/UtilityNetworkTrace/UtilityNetworkTraceViewModel.js";
+import type { UtilityNetworkTraceViewModelRemoveResultAreaEvent, UtilityNetworkTraceViewModelAddResultAreaEvent, UtilityNetworkTraceViewModelAddFlagErrorEvent, UtilityNetworkTraceViewModelAddFlagCompleteEvent, UtilityNetworkTraceViewModelAddFlagEvent, TraceResultExtend, GraphicColor, FlagProperty, ResultAreaPropertiesExtend, UtilityNetworkTraceViewModelState } from "@arcgis/core/widgets/UtilityNetworkTrace/UtilityNetworkTraceViewModel.js";
 import type { Icon } from "@esri/calcite-components/components/calcite-icon";
 import type { InputSetting } from "@arcgis/core/widgets/UtilityNetworkTrace.js";
 
 /**
- * Utility Network Trace component provides a way to run traces in a Utility Network based on connectivity or traversability from set input flags. Input flags (starting points and barriers) can be set by clicking the view.
+ * > [!WARNING]
+ * >
+ * > This component is **deprecated**. [arcgis-utility-network-trace-analysis](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-analysis/) is the preferred component for utility network tracing and should be used for all new development.
+ *
+ * Utility Network Trace component provides a way to run traces in a Utility Network based on connectivity or traversability from set trace locations. Trace locations (starting points and barriers) can be set by clicking the view.
  *
  * > The Utility Network Trace component does not support proxied feature services or feature services that utilize stored credentials.
  *
  * Note: Sign in to access the data in this sample, U/P: `viewer01`/`I68VGU^nMurF`
  *
+ * @deprecated since 5.0, use [arcgis-utility-network-trace-analysis](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-analysis/) instead.
  * @since 4.28
  */
 export abstract class ArcgisUtilityNetworkTrace extends LitElement {

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

@@ -11,6 +11,63 @@ import type { UtilityNetworkTraceAnalysisState } from "@arcgis/core/networks/Uti
 
 export type UtilityNetworkTraceAnalysisDisplayMode = "add-spatial-feature-list" | "add-spatial-feature" | "add-spatial-instructions" | "default";
 
+/**
+ * ## Overview
+ *
+ * The Utility Network Trace Analysis component allows users to run traces and view trace results in a utility network.
+ *
+ * - The component supports selecting a utility network and a named trace configuration in that utility network. Both the utility network and trace configuration must be [stored in the map](https://developers.arcgis.com/javascript/latest/references/core/WebMap/#utilityNetworks).
+ * - Trace locations (starting points and barriers) are set by selecting features on the view.
+ * - When a subnetwork-based trace is selected, the component displays the domain, tier, and target tier specified by the selected named trace configuration.
+ * - If the user selects a subnetwork trace with a specified subnetwork name, the component provides an option to choose a subnetwork name instead of starting location(s) to run the trace with.
+ *
+ * Supported trace types are: `connected`, `upstream`, `downstream`, `shortest-path`, `subnetwork`, `subnetwork-controller`, `loops`, and `isolation`.
+ *
+ * The component can display the following from a trace result: elements (as [features](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-analysis/#traceResultFeatures)), aggregated geometries, and function results.
+ *
+ * > [!WARNING]
+ * >
+ * > The Utility Network Trace Analysis component does not support proxied feature services or feature services that utilize stored credentials.
+ * >
+ * > This component also does not support `path` and `circuit` trace types or the `paths` and `circuits` result types.
+ *
+ * ## Working with nonspatial objects
+ *
+ * The Utility Network Trace Analysis component supports selecting nonspatial objects as trace locations by traversing associations.
+ *
+ * When selecting a trace location or viewing a trace result feature, information about the feature is displayed according to the
+ * [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/) of the layer that the feature belongs to.
+ * If the feature's layer has no PopupTemplate, a default template is used to display the feature's attributes.
+ *
+ * To select a nonspatial object as a trace location, first select a spatial feature on the map that is associated with the target nonspatial object.
+ * The spatial feature's layer must have a PopupTemplate that includes a [UtilityNetworkAssociationsContent](https://developers.arcgis.com/javascript/latest/references/core/popup/content/UtilityNetworkAssociationsContent/).
+ * Navigate through the spatial feature's associations to the target nonspatial object, then add the object as a trace location.
+ *
+ * ## Examples
+ *
+ * This component can be used slotted into an [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/):
+ *
+ * ```html
+ * <arcgis-map item-id="471eb0bf37074b1fbb972b1da70fb310">
+ *   <arcgis-utility-network-trace-analysis slot="bottom-left"></arcgis-utility-network-trace-analysis>
+ * </arcgis-map>
+ * ```
+ *
+ * Alternatively, this component can be used outside of a map by providing a [referenceElement](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-analysis/#referenceElement):
+ *
+ * ```html
+ * <calcite-shell>
+ *   <calcite-shell-panel slot="panel-start" position="start" width-scale="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>
+ * </calcite-shell>
+ * ```
+ *
+ * Note: Sign in to access the data in this demo, U/P: `viewer01`/`I68VGU^nMurF`
+ *
+ * @since 5.0
+ */
 export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
   /** @internal */
   protected _messages: {
@@ -71,14 +128,14 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
   /**
    * 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.
+   *
    * Aggregated geometry is only rendered if the trace configuration specifies aggregated geometry as a result type.
+   *
    * Default color is #FFFF00.
    *
    * @see [Color constructor](https://developers.arcgis.com/javascript/latest/references/core/Color/#constructors-summary)
    */
   accessor aggregatedGeometryGraphicsColor: Color;
-  /** @default false */
-  accessor allowEditingDisabled: boolean;
   /**
    * If true, the component will not be destroyed automatically when it is
    * disconnected from the document. This is useful when you want to move the
@@ -100,11 +157,10 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
    * ```
    */
   accessor beforeTraceLocationSelectStart: (() => Promise<void>) | undefined;
-  /** @default false */
-  accessor closable: boolean;
   /**
    * Whether to disable highlighting trace result features on the map.
-   * If set to true, the features returned by a trace will not be highlighted on the map.
+   *
+   * If true, the features returned by a trace will not be highlighted on the map.
    *
    * @default false
    * @example
@@ -118,6 +174,7 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
   accessor disableHighlightFeatureResults: boolean;
   /**
    * Whether to hide feature results in the results tab.
+   *
    * If true, when features are returned by a trace, they will not be visible in the results tab.
    * A message will be displayed in its place indicating that features were returned by the trace, but are not visible in the results pane.
    * This string can be overridden with the `messageOverrides` property.
@@ -138,7 +195,7 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
    * ```
    */
   accessor hideFeatureResults: boolean;
-  accessor icon: string | undefined;
+  /** The component's default label. */
   accessor label: string | undefined;
   /**
    * Replace localized message strings with your own strings.
@@ -179,17 +236,20 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
    * @see [Associate components with a Map or Scene component](https://developers.arcgis.com/javascript/latest/programming-patterns/#associate-components-with-a-map-or-scene-component)
    */
   accessor referenceElement: ArcgisReferenceElement | string | undefined;
+  /** The current state of the component. */
+  get state(): UtilityNetworkTraceAnalysisState;
   /**
-   * The current state of the component.
+   * An array of features returned by the trace result.
+   *
+   * This array is populated if the trace returned [element](https://developers.arcgis.com/javascript/latest/references/core/rest/networks/support/TraceResult/#elements) results.
    *
-   * @since 5.0
+   * When [@arcgisTraceResultFeaturesReady](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-analysis/#event-arcgisTraceResultFeaturesReady) is raised, trace result features are available.
+   * When a new trace has been run, or the trace results are cleared, this array is cleared.
    */
-  get state(): UtilityNetworkTraceAnalysisState;
   get traceResultFeatures(): Graphic[];
   /**
-   * This property defines the target [MapView](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/).
-   *
-   * @since 5.0
+   * 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. */
@@ -197,7 +257,7 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
   /**
    * Fires when the user toggles displaying aggregated geometry results in the result pane.
    * Event payload contains a boolean representing whether the aggregated geometry graphics are hidden.
-   * If true, the user has hidden the graphics on the view's map.
+   * If true, the aggregated geometry graphics are hidden on the view.
    *
    * @example
    * ```js
@@ -265,7 +325,7 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
   readonly arcgisTraceResultClear: import("@arcgis/lumina").TargetedEvent<this, void>;
   /**
    * Fires when the trace result features are ready.
-   * Check property `traceResultFeatures` for the trace result features.
+   * Check property [traceResultFeatures](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-analysis/#traceResultFeatures) for the trace result features.
    *
    * @example
    * ```js

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

@@ -1,49 +1,53 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
 import { c as y } from "../../chunks/runtime.js";
-import { css as v, html as r } from "lit";
-import { keyed as o } from "lit/directives/keyed.js";
-import h from "@arcgis/core/Color.js";
+import { css as f, html as r } from "lit";
+import { ref as o } from "lit/directives/ref.js";
+import { keyed as h } from "lit/directives/keyed.js";
+import g from "@arcgis/core/Color.js";
 import "@arcgis/core/core/Error.js";
 import b from "@arcgis/core/networks/UtilityNetworkTraceAnalysis.js";
-import { LitElement as w, createEvent as l } from "@arcgis/lumina";
-import { log as g } from "@arcgis/toolkit/log";
-import { createRef as u, ref as d } from "lit/directives/ref.js";
-import { u as T } from "../../chunks/useT9n.js";
+import { LitElement as v, createEvent as n } from "@arcgis/lumina";
+import { log as u } from "@arcgis/toolkit/log";
+import { u as w } from "../../chunks/useT9n.js";
 import { m as _ } from "../../chunks/useViewModel.js";
-const R = v`: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%}#no-starting-points-panel{flex:none;height:fit-content;--calcite-panel-background-color: var(--calcite-color-foreground-1)}#no-starting-points-notice{margin:var(--calcite-spacing-md) var(--calcite-spacing-md) 0 var(--calcite-spacing-md)}calcite-tabs{display:flex;flex-direction:column;height:100%}calcite-tab{--calcite-tab-content-space-y: 0}calcite-tab:not([selected]){flex:0}calcite-panel{--calcite-panel-background-color: var(--calcite-color-foreground-1)}calcite-notice{margin:var(--calcite-spacing-md)}`, $ = _(b);
-class C extends w {
+const T = f`: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%}#no-starting-points-panel{flex:none;height:fit-content;--calcite-panel-background-color: var(--calcite-color-foreground-1)}#no-starting-points-notice{margin:var(--calcite-spacing-md) var(--calcite-spacing-md) 0 var(--calcite-spacing-md)}calcite-tabs{display:flex;flex-direction:column;height:100%}calcite-tab{--calcite-tab-content-space-y: 0}calcite-tab:not([selected]){flex:0}calcite-panel{--calcite-panel-background-color: var(--calcite-color-foreground-1)}calcite-notice{margin:var(--calcite-spacing-md)}`, R = _(b);
+class $ extends v {
   constructor() {
-    super(...arguments), this._messages = T({ blocking: !0 }), this._viewModel = $(this), this._traceInputsRef = u(), this._traceResultsRef = u(), this._highlightHandles = [], this._handleRunTraceButtonClick = () => {
-      const t = this._traceInputsRef.value?.traceLocations?.some((a) => a.type === "starting-point");
+    super(...arguments), this._messages = w({ blocking: !0 }), this._viewModel = R(this), this._highlightHandles = [], this._handleRunTraceButtonClick = () => {
+      const t = this._traceInputsElement?.traceLocations?.some((a) => a.type === "starting-point");
       if (this.traceError = void 0, !this._isSubnetworkNameTraceSelected && !t) {
         this.showNoStartingPointsWarning = !0;
         return;
       }
-      this.showNoStartingPointsWarning = !1, this._clearHighlights(), this._switchTab("results"), this._runTrace();
-    }, this.activeTab = "input", this.showNoStartingPointsWarning = !1, this.mode = "default", this.allowEditingDisabled = !1, this.autoDestroyDisabled = !1, this.aggregatedGeometryGraphicsColor = new h([255, 255, 0, 0.6]), this.disableHighlightFeatureResults = !1, this.hideFeatureResults = !1, this.closable = !1, this.state = this._viewModel.state, this.view = this._viewModel.view, this.arcgisHideGraphicsChange = l(), this.arcgisTraceLocationSelectStart = l(), this.arcgisTraceLocationSelectEnd = l(), this.arcgisTraceResultFeaturesReady = l(), this.arcgisTraceResultClear = l(), this.arcgisReady = l();
+      this.showNoStartingPointsWarning = !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.showNoStartingPointsWarning = !1, this.mode = "default", this.autoDestroyDisabled = !1, this.aggregatedGeometryGraphicsColor = new g([255, 255, 0, 0.6]), this.disableHighlightFeatureResults = !1, this.hideFeatureResults = !1, this.state = this._viewModel.state, this.view = this._viewModel.view, this.arcgisHideGraphicsChange = n(), this.arcgisTraceLocationSelectStart = n(), this.arcgisTraceLocationSelectEnd = n(), this.arcgisTraceResultFeaturesReady = n(), this.arcgisTraceResultClear = n(), this.arcgisReady = n();
   }
   static {
-    this.properties = { activeTab: 16, traceError: 16, traceResult: 16, showNoStartingPointsWarning: 16, mode: 16, allowEditingDisabled: 5, autoDestroyDisabled: 5, beforeTraceLocationSelectStart: 0, aggregatedGeometryGraphicsColor: 0, disableHighlightFeatureResults: 5, hideFeatureResults: 5, closable: 7, icon: 1, label: 3, messageOverrides: 0, traceResultFeatures: 32, referenceElement: 1, state: 32, view: 0 };
+    this.properties = { activeTab: 16, traceError: 16, traceResult: 16, showNoStartingPointsWarning: 16, mode: 16, autoDestroyDisabled: 5, beforeTraceLocationSelectStart: 0, aggregatedGeometryGraphicsColor: 0, disableHighlightFeatureResults: 5, hideFeatureResults: 5, label: 3, messageOverrides: 0, traceResultFeatures: 32, referenceElement: 1, state: 32, view: 0 };
   }
   static {
-    this.styles = R;
+    this.styles = T;
   }
   get _allLayers() {
     const { view: e } = this;
     return e?.map ? e.map.allLayers.toArray().concat(e.map.allTables.toArray()) : [];
   }
   get _isSubnetworkNameTraceSelected() {
-    const e = this._traceInputsRef.value?.selectedNamedTraceConfiguration?.traceType;
-    return !!this._traceInputsRef.value?.selectedNamedTraceConfiguration?.traceConfiguration?.subnetworkName && e === "subnetwork";
+    const e = this._traceInputsElement?.selectedNamedTraceConfiguration?.traceType;
+    return !!this._traceInputsElement?.selectedNamedTraceConfiguration?.traceConfiguration?.subnetworkName && e === "subnetwork";
   }
   get traceResultFeatures() {
-    return this._traceResultsRef.value?.traceResultFeatures ?? [];
+    return this._traceResultsElement?.traceResultFeatures ?? [];
   }
   async destroy() {
-    await this.manager.destroy(), this._clearHighlights();
+    this._clearHighlights(), this._traceResultsElement?.destroy(), this._traceInputsElement?.destroy(), await this.manager.destroy();
   }
   _clearTraceResult() {
-    this.traceResult = void 0, this._clearHighlights();
+    this.traceResult = void 0, this._clearHighlights(), this._clearAggregatedGeometryGraphics();
   }
   _switchTab(e) {
     this.activeTab = e;
@@ -66,32 +70,35 @@ class C extends w {
   _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((i) => {
-      const n = t.allLayerViews.find((m) => {
-        const c = m.layer;
+      const l = t.allLayerViews.find((p) => {
+        const c = p.layer;
         if (a.isUtilityLayer(c)) {
-          const f = Number(i.layerUrl.split("/").pop());
-          return c.layerId === f;
+          const m = Number(i.layerUrl.split("/").pop());
+          return c.layerId === m;
         }
         return !1;
       });
-      if (!n)
+      if (!l)
         return;
-      const p = n.highlight(i.objectIds);
-      this._highlightHandles.push(p);
+      const d = l.highlight(i.objectIds);
+      this._highlightHandles.push(d);
     });
   }
   async _runTrace() {
-    const e = this._traceInputsRef.value?.selectedNamedTraceConfiguration, t = this._traceInputsRef.value?.unTraceConfiguration;
+    const e = this._traceInputsElement?.selectedNamedTraceConfiguration, t = this._traceInputsElement?.unTraceConfiguration;
     if (!(e?.traceType && t)) {
-      g("error", this, "Trace configuration not found");
+      u("error", this, "Trace configuration not found");
       return;
     }
-    const a = this._traceInputsRef.value?.traceLocations;
+    const a = this._traceInputsElement?.traceLocations;
     try {
       this.traceResult = await this._viewModel.executeTraceConfiguration({
         traceType: e.traceType,
@@ -100,8 +107,8 @@ class C extends w {
         resultTypes: e.resultTypes
       }), this.disableHighlightFeatureResults || this._highlightResults();
     } catch (s) {
-      const i = s, n = i.details ? { detail: i.details } : void 0;
-      g("error", this, `Error while running trace: ${String(i)}`, n), this.traceError = i, this.traceResult = void 0;
+      const i = s, l = i.details ? { detail: i.details } : void 0;
+      u("error", this, `Error while running trace: ${String(i)}`, l), this.traceError = i, this.traceResult = void 0;
     }
   }
   _handleHideGraphicsChange(e) {
@@ -118,7 +125,7 @@ class C extends w {
   }
   _handleAggregatedGeometryGraphicsColorChange(e) {
     const t = e.detail;
-    this.aggregatedGeometryGraphicsColor = new h(t);
+    this.aggregatedGeometryGraphicsColor = new g(t);
   }
   _handleTraceInputsChange() {
   }
@@ -126,27 +133,27 @@ class C extends w {
     this.showNoStartingPointsWarning = !1;
   }
   _handleUtilityNetworkChange() {
-    this._viewModel.utilityNetwork = this._traceInputsRef.value?.selectedUtilityNetwork;
+    this._viewModel.utilityNetwork = this._traceInputsElement?.selectedUtilityNetwork;
   }
   renderNoStartingPointsWarning() {
     return r`<calcite-panel id=no-starting-points-panel><calcite-notice id=no-starting-points-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>`;
   }
   renderResultsTab() {
-    return o(`${this.el.id}__results-tab-item`, r`<calcite-tab .selected=${this.activeTab === "results"}>${this._viewModel.state === "executing" ? r`<calcite-panel><calcite-loader .label=${this._messages.runningTrace} .text=${this._messages.runningTrace}></calcite-loader></calcite-panel>` : r`<arcgis-utility-network-trace-results .aggregatedGeometryGraphicsColor=${this.aggregatedGeometryGraphicsColor} .hideFeatureResults=${this.hideFeatureResults} .referenceElement=${this.referenceElement} .layers=${this._allLayers} .traceConfigTitle=${this._selectedTraceConfig?.title} .traceError=${this.traceError} .traceResult=${this.traceResult} .utilityNetwork=${this._viewModel.utilityNetwork ?? void 0} .view=${this.view ?? void 0} .messageOverrides=${{ resultFeaturesAreHidden: this.messageOverrides?.resultFeaturesAreHidden }} @arcgisHideGraphicsChange=${this._handleHideGraphicsChange} @arcgisTraceResultFeaturesReady=${this._handleTraceResultFeaturesReady} @arcgisAggregatedGeometryGraphicsColorChange=${this._handleAggregatedGeometryGraphicsColorChange} ${d(this._traceResultsRef)}></arcgis-utility-network-trace-results>`}</calcite-tab>`);
+    return h(`${this.el.id}__results-tab-item`, r`<calcite-tab .selected=${this.activeTab === "results"}>${this._viewModel.state === "executing" ? r`<calcite-panel><calcite-loader .label=${this._messages.runningTrace} .text=${this._messages.runningTrace}></calcite-loader></calcite-panel>` : r`<arcgis-utility-network-trace-results .aggregatedGeometryGraphicsColor=${this.aggregatedGeometryGraphicsColor} .hideFeatureResults=${this.hideFeatureResults} .referenceElement=${this.referenceElement} .layers=${this._allLayers} .traceConfigTitle=${this._selectedTraceConfig?.title} .traceError=${this.traceError} .traceResult=${this.traceResult} .utilityNetwork=${this._viewModel.utilityNetwork ?? void 0} .view=${this.view ?? void 0} .messageOverrides=${{ resultFeaturesAreHidden: this.messageOverrides?.resultFeaturesAreHidden }} @arcgisHideGraphicsChange=${this._handleHideGraphicsChange} @arcgisTraceResultFeaturesReady=${this._handleTraceResultFeaturesReady} @arcgisAggregatedGeometryGraphicsColorChange=${this._handleAggregatedGeometryGraphicsColorChange} .autoDestroyDisabled=${this.autoDestroyDisabled} ${o(this._handleTraceResultsRefChange)}></arcgis-utility-network-trace-results>`}</calcite-tab>`);
   }
   renderResultsFooter() {
     const { mode: e } = this;
     if (e !== "default")
       return null;
-    const { traceResult: t } = this, s = !!(t?.elements.length || t?.globalFunctionResults.length || t?.aggregatedGeometry) && this._traceResultsRef.value?.state === "ready";
+    const { traceResult: t } = this, s = !!(t?.elements.length || t?.globalFunctionResults.length || t?.aggregatedGeometry) && this._traceResultsElement?.state === "ready";
     return r`<calcite-button appearance=outline width=full @click=${() => {
       this._switchTab("input"), this._clearTraceResult(), this.arcgisTraceResultClear.emit();
     }} .disabled=${!s} slot=footer>${this.traceResultFeatures.length > 0 && !this.hideFeatureResults ? this._messages.buttons.clearResultsCustom.replace("{number}", this.traceResultFeatures.length.toString()) : this._messages.buttons.clearResultsGeneric}</calcite-button>`;
   }
   renderInputTab() {
-    return o(`${this.el.id}__inputs-tab-item`, r`<calcite-tab .selected=${this.activeTab === "input"}><div class="inputs-tab-container">${this.showNoStartingPointsWarning && this.mode === "default" ? this.renderNoStartingPointsWarning() : null}<arcgis-utility-network-trace-inputs .view=${this.view || void 0} .beforeTraceLocationSelectStart=${this.beforeTraceLocationSelectStart} @arcgisTraceInputsChange=${this._handleTraceInputsChange} @arcgisSelectedNamedTraceConfigurationChange=${this._handleSelectedNamedTraceConfigurationChange} @arcgisUtilityNetworkChange=${this._handleUtilityNetworkChange} @arcgisTraceLocationSelectStart=${this._handleTraceLocationSelectStart} @arcgisTraceLocationSelectEnd=${this._handleTraceLocationSelectEnd} @arcgisPropertyChange=${(e) => {
+    return h(`${this.el.id}__inputs-tab-item`, r`<calcite-tab .selected=${this.activeTab === "input"}><div class="inputs-tab-container">${this.showNoStartingPointsWarning && this.mode === "default" ? this.renderNoStartingPointsWarning() : null}<arcgis-utility-network-trace-inputs .view=${this.view || void 0} .referenceElement=${this.referenceElement} .beforeTraceLocationSelectStart=${this.beforeTraceLocationSelectStart} @arcgisTraceInputsChange=${this._handleTraceInputsChange} @arcgisSelectedNamedTraceConfigurationChange=${this._handleSelectedNamedTraceConfigurationChange} @arcgisUtilityNetworkChange=${this._handleUtilityNetworkChange} @arcgisTraceLocationSelectStart=${this._handleTraceLocationSelectStart} @arcgisTraceLocationSelectEnd=${this._handleTraceLocationSelectEnd} @arcgisPropertyChange=${(e) => {
       e.stopPropagation(), e.detail.name === "mode" && (this.mode = e.target.mode);
-    }} ${d(this._traceInputsRef)}></arcgis-utility-network-trace-inputs></div></calcite-tab>`);
+    }} .autoDestroyDisabled=${this.autoDestroyDisabled} ${o(this._handleTraceInputsRefChange)}></arcgis-utility-network-trace-inputs></div></calcite-tab>`);
   }
   renderInputFooter() {
     const { mode: e, _viewModel: { state: t } } = this;
@@ -157,7 +164,7 @@ class C extends w {
     return r`<calcite-panel .loading=${this.view === void 0}><calcite-tabs layout=center position=top><calcite-tab-nav slot=title-group><calcite-tab-title @click=${() => this._switchTab("input")} .selected=${this.activeTab === "input"}>${e.tabs.inputTab}</calcite-tab-title><calcite-tab-title @click=${() => this._switchTab("results")} .selected=${this.activeTab === "results"} .disabled=${s}>${e.tabs.resultsTab}</calcite-tab-title></calcite-tab-nav>${this.view ? this.renderInputTab() : null}${this.view && this._viewModel.utilityNetwork ? this.renderResultsTab() : null}</calcite-tabs>${i}${this.activeTab === "input" ? this.renderInputFooter() : null}${this.activeTab === "results" ? this.renderResultsFooter() : null}</calcite-panel>`;
   }
 }
-y("arcgis-utility-network-trace-analysis", C);
+y("arcgis-utility-network-trace-analysis", $);
 export {
-  C as ArcgisUtilityNetworkTraceAnalysis
+  $ as ArcgisUtilityNetworkTraceAnalysis
 };

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

@@ -104,6 +104,16 @@ export abstract class ArcgisUtilityNetworkTraceInputs extends LitElement {
       unknown: string;
       warnings: { exceededDisplayLimit: string; };
   }>;
+  /**
+   * If true, the component will not be destroyed automatically when it is
+   * disconnected from the document. This is useful when you want to move the
+   * component to a different place on the page, or temporarily hide it. If this
+   * is set, make sure to call the [destroy()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-inputs/#destroy) method when you are done to
+   * prevent memory leaks.
+   *
+   * @default false
+   */
+  accessor autoDestroyDisabled: boolean;
   /**
    * A function to run before trace location selection starts.
    *
@@ -124,6 +134,8 @@ export abstract class ArcgisUtilityNetworkTraceInputs extends LitElement {
   get unTraceConfiguration(): UNTraceConfiguration | undefined;
   /** @required */
   accessor view: MapView | undefined;
+  /** Permanently destroy the component. */
+  destroy(): Promise<void>;
   readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "mode"; }>;
   /** Fires when the user changes the selected named trace configuration. */
   readonly arcgisSelectedNamedTraceConfigurationChange: import("@arcgis/lumina").TargetedEvent<this, void>;