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

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 {
@@ -217,7 +221,7 @@ export abstract class ArcgisUtilityNetworkTrace extends LitElement {
   readonly arcgisAddFlagError: import("@arcgis/lumina").TargetedEvent<this, UtilityNetworkTraceViewModelAddFlagErrorEvent>;
   readonly arcgisAddResultArea: import("@arcgis/lumina").TargetedEvent<this, UtilityNetworkTraceViewModelAddResultAreaEvent>;
   /** 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: "state"; }>;
+  readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "state" | "traceResults"; }>;
   /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
   readonly arcgisReady: import("@arcgis/lumina").TargetedEvent<this, void>;
   readonly arcgisRemoveResultArea: import("@arcgis/lumina").TargetedEvent<this, UtilityNetworkTraceViewModelRemoveResultAreaEvent>;

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

@@ -9,7 +9,7 @@ import { css as n } from "lit";
 const l = n`@keyframes esri-basemap-slide{0%{opacity:0;margin-top:0;margin-left:0}75%{opacity:0;margin-top:0;margin-left:0}to{opacity:1;margin-top:5px;margin-left:5px}}@keyframes esri-docking-animation{0%{opacity:0}25%{opacity:0}to{opacity:1}}@keyframes popup-intro-animation-down{0%{opacity:0;transform:translateY(-5px)}to{opacity:1;transform:translate(0)}}@keyframes popup-intro-animation-up{0%{opacity:0;transform:translateY(5px)}to{opacity:1;transform:translate(0)}}@supports (-ms-ime-align: auto){.esri-slider__anchor:focus{outline:1px dotted #000}}@keyframes esri-spinner--start-animation{0%{opacity:0;transform:scale(0)}to{opacity:1;transform:scale(1)}}@keyframes esri-spinner--finish-animation{0%{opacity:1;transform:scale(1)}to{opacity:0;transform:scale(0)}}@keyframes esri-spinner--rotate-animation{0%{transform:rotate(0)}to{transform:rotate(360deg)}}@media(prefers-reduced-motion){.esri-utility-network-trace__reset-prompt{animation:none!important}}@media(prefers-reduced-motion){.esri-popup--aligned-top-center,.esri-popup--aligned-top-left,.esri-popup--aligned-top-right,.esri-popup--aligned-bottom-center,.esri-popup--aligned-bottom-left,.esri-popup--aligned-bottom-right,.esri-popup--is-docked{animation:none!important}}@media(prefers-reduced-motion:reduce){.esri-fov-overlay{animation:none!important}}@keyframes esri-fade-in-down{0%{opacity:0;transform:translateY(-5px)}25%{opacity:0;transform:translateY(-5px)}to{opacity:1;transform:translate(0)}}@keyframes esri-fade-in-up{0%{opacity:0;transform:translateY(5px)}25%{opacity:0;transform:translateY(5px)}to{opacity:1;transform:translate(0)}}@keyframes esri-fade-in{0%{opacity:0}25%{opacity:0}to{opacity:1}}@keyframes esri-fade-in-scale{0%{opacity:0;transform:scale(.95)}to{opacity:1;transform:scale(1)}}@keyframes looping-progresss-bar-ani{0%{width:0;left:0}20%{width:20%;left:0}80%{width:20%;left:80%}to{width:0;left:100%}}@keyframes esri-rotate{0%{transform:rotate(0)}to{transform:rotate(360deg)}}@keyframes panel-advance{0%{opacity:0;transform:translate(50px) scale(.99)}to{opacity:1;transform:translate(0) scale(1)}}@keyframes panel-retreat{0%{opacity:0;transform:translate(-50px) scale(.99)}to{opacity:1;transform:translate(0) scale(1)}}@keyframes panel-advance--rtl{0%{opacity:0;transform:translate(-50px) scale(.99)}to{opacity:1;transform:translate(0) scale(1)}}@keyframes panel-retreat--rtl{0%{opacity:0;transform:translate(50px) scale(.99)}to{opacity:1;transform:translate(0) scale(1)}}.esri-widget__heading{color:var(--calcite-color-text-2);margin:0 0 .5rem;font-weight:var(--calcite-font-weight-semibold)}h1.esri-widget__heading{font-size:var(--calcite-font-size-xl)}h2.esri-widget__heading{font-size:var(--calcite-font-size-md)}h3.esri-widget__heading,h4.esri-widget__heading,h5.esri-widget__heading,h6.esri-widget__heading{font-size:var(--calcite-font-size)}.esri-widget{box-sizing:border-box;color:var(--calcite-color-text-2);background-color:var(--calcite-color-foreground-1);font-size:var(--calcite-font-size);line-height:var(--calcite-font-line-height-relative-tight)}.esri-widget *,.esri-widget :before,.esri-widget :after{box-sizing:inherit}.esri-widget.esri-widget--disabled>*{opacity:.4;pointer-events:none}.esri-widget.esri-widget--compact{--esri-widget-padding-y: 0;--esri-widget-padding-x: 0}.esri-widget__anchor{color:var(--calcite-color-text-2)}.esri-widget__anchor:hover{color:var(--calcite-color-text-3)}.esri-widget__anchor:hover,.esri-widget__anchor:focus{text-decoration:underline}.esri-widget__anchor--disabled{opacity:.4;pointer-events:none}.esri-widget__header{background-color:var(--calcite-color-foreground-1);flex:1 0 100%;justify-content:space-between;align-items:center;width:100%;min-height:48px;padding:12px 0 12px 15px;display:flex}.esri-widget__heading{word-break:break-word}.esri-widget__header .esri-widget__heading{width:calc(100% - 48px);text-align:initial;color:var(--calcite-color-text-1);align-items:center;margin:0;padding:0;display:flex}.esri-widget__header-button{appearance:none;cursor:pointer;color:var(--calcite-color-text-2);background-color:var(--calcite-color-foreground-1);border:none;flex:0 0 48px;justify-content:center;align-self:stretch;align-items:center;width:48px;padding:0;display:flex}.esri-widget__footer{background-color:var(--calcite-color-foreground-1);justify-content:center;align-items:center;width:100%;min-height:48px;display:flex}.esri-widget__footer-pagination{color:var(--calcite-color-text-2);justify-content:space-between;align-items:center;display:flex}.esri-widget__footer-pagination-previous-button,.esri-widget__footer-pagination-next-button{cursor:pointer;background-color:var(--calcite-color-foreground-1);border:0;margin:0 7px;padding:12px 15px;transition:background-color .125s ease-in-out}.esri-widget__footer-pagination-previous-button:hover,.esri-widget__footer-pagination-previous-button:focus,.esri-widget__footer-pagination-next-button:hover,.esri-widget__footer-pagination-next-button:focus{color:var(--calcite-color-text-1);background-color:var(--calcite-color-foreground-1)}.esri-menu{visibility:hidden;z-index:1;background-clip:padding;background-color:var(--calcite-color-foreground-1);background-clip:padding-box;width:100%;max-height:0;margin:2px 0 0;padding:0;font-size:var(--calcite-font-size);line-height:var(--calcite-spacing-xl);position:absolute;top:100%;left:0;overflow:hidden;box-shadow:0 1px 2px #0000004d}.esri-menu .esri-menu__header{color:var(--calcite-color-text-inverse);background-color:var(--calcite-color-inverse);padding:6px 12px}.esri-menu__list{margin:0;padding:0;list-style:none}.esri-menu__list-item{cursor:pointer;border-top:1px solid #adadad4d;border-left:3px solid #0000;padding:.8em 1em}.esri-menu__list-item [class^=esri-icon-],.esri-menu__list-item [class*=" esri-icon-"]{padding-right:2.8px}.esri-menu__list-item:first-child{border-top:none}.esri-menu__list-item--focus,.esri-menu__list-item:hover,.esri-menu__list-item:focus{background-color:var(--calcite-color-foreground-1)}.esri-menu__list-item:active{background-color:var(--calcite-color-foreground-current)}.esri-menu__list-item--active,.esri-menu__list-item--active:hover,.esri-menu__list-item--active:focus{background-color:var(--calcite-color-foreground-1);border-left-color:var(--calcite-color-brand)}.esri-widget__table{border-collapse:collapse;color:var(--calcite-color-text-1);border:none;width:100%;line-height:var(--calcite-font-line-height-relative-tight)}.esri-widget__table tr:nth-child(odd){background-color:var(--calcite-color-transparent)}.esri-widget__table tr:nth-child(2n){background-color:var(--calcite-color-transparent-press)}.esri-widget__table tr a{color:var(--calcite-color-text-2)}.esri-widget__table tr a:hover,.esri-widget__table tr a:focus{color:var(--calcite-color-text-1)}.esri-widget__table tr td,.esri-widget__table tr th{vertical-align:top;word-break:break-word;padding:.5em .7em;font-size:var(--calcite-font-size-sm);font-weight:var(--calcite-font-weight-regular)}.esri-widget__table tr th{text-align:left;border-right:3px solid #0000000d;width:50%}.esri-widget__table tr td{width:50%}.esri-input{color:var(--calcite-color-text-1);background-color:var(--calcite-color-foreground-1);border:1px solid #959595;font-size:var(--calcite-font-size)}.esri-input::-ms-clear{display:none}.esri-input::placeholder{opacity:1;color:var(--calcite-color-text-2)}.esri-input:placeholder-shown{text-overflow:ellipsis}.esri-input[type=text],.esri-input[type=password],.esri-input[type=number]{height:32px;padding:0 .5em}calcite-combobox.esri-input{border:none}.esri-widget__content--empty{text-align:center;color:var(--calcite-color-border-input);flex-flow:column wrap;align-items:center;padding:18px 22px;display:flex}.esri-widget__content--empty h1.esri-widget__heading,.esri-widget__content--empty h2.esri-widget__heading,.esri-widget__content--empty h3.esri-widget__heading,.esri-widget__content--empty h4.esri-widget__heading,.esri-widget__content--empty h5.esri-widget__heading{font-weight:var(--calcite-font-weight-regular)}.esri-widget__content-illustration--empty{width:128px;padding:1rem 0}.esri-widget__content-icon--empty{width:32px;padding:.5rem 0}.esri-select{appearance:none;cursor:pointer;color:var(--calcite-color-text-2);background:var(--calcite-color-foreground-1) url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='-8 -8 32 32' width='32' height='32'%3E%3Cpath d='M8 11.207l-4-4V5.793l4 4 4-4v1.414z' fill='%23adadad' fillrule='nonzero'/%3E%3C/svg%3E") 100% no-repeat;border:1px solid #959595;border-radius:0;width:100%;height:32px;margin:0;padding:0 .5em;font-family:inherit;font-size:.85em;display:block}.esri-select[disabled]{cursor:auto}.esri-select::-ms-expand{display:none}.esri-disabled a,.esri-disabled [role=menu],.esri-disabled [role=checkbox],.esri-disabled [class^=esri-icon-],.esri-disabled [class*=" esri-icon-"]{color:var(--calcite-color-text-3)}.keynav-mode .esri-widget:focus,.keynav-mode .esri-widget :focus{z-index:1;outline-offset:2px;outline:2px solid #adadad}.esri-widget__loader-animation{border:.15em solid #adadad4d;border-top-color:var(--calcite-color-border-input);border-radius:100%;width:1em;height:1em;font-size:var(--calcite-font-size-md);animation:1.25s linear infinite esri-rotate;display:block;transform:translateZ(0)}:dir(rtl) .esri-widget__table th{text-align:right;border-left:3px solid #0000000d;border-right:none}:dir(rtl) .esri-select{background-position:0}:dir(rtl) .esri-menu__list-item{border-left:none;border-right:3px solid #0000}:dir(rtl) .esri-menu__list-item [class^=esri-icon-],:dir(rtl) .esri-menu__list-item [class*=" esri-icon-"]{padding-left:2px;padding-right:0}:dir(rtl) .esri-menu__list-item--active{border-right-color:var(--calcite-color-brand)}.esri-icon-font-fallback-text{clip:rect(0 0 0 0);width:1px;height:1px;position:absolute;overflow:hidden}.esri-rotating{animation:1.25s linear infinite esri-rotate;transform:translateZ(0)}.esri-clearfix:before,.esri-clearfix:after{content:" ";display:table}.esri-clearfix:after{clear:both}.esri-interactive{cursor:pointer}.esri-hidden{display:none!important}.esri-invisible{visibility:hidden!important}.esri-offscreen{position:absolute;top:-999em;left:-999em}.esri-match-height{flex-direction:column;flex:auto;display:flex;overflow:hidden}:host{min-width:300px}.esri-utility-network-trace{flex:auto;width:300px}.esri-utility-network-trace calcite-icon{box-sizing:initial}.esri-utility-network-trace calcite-tab{background-color:var(--calcite-color-foreground-2);padding-top:0;padding-bottom:0}.esri-utility-network-trace calcite-tab:not([selected]){flex:0}.esri-utility-network-trace.esri-component.esri-widget--panel{min-height:120px;width:300px}.esri-utility-network-trace__add-button-container{justify-content:center;margin:18px 0 var(--calcite-spacing-md);display:grid}.esri-utility-network-trace__block-container{margin-top:0;height:95%}.esri-utility-network-trace__block-content{border-bottom:none;margin:0}.esri-utility-network-trace__clear-results-block{position:absolute;bottom:0;left:0;margin:0;border-top:3px solid #6e6e6e26;background-color:#f3f3f3}.esri-utility-network-trace__divider{color:inherit;border-color:var(--calcite-color-border-input);border-bottom-style:solid;border-bottom-width:1px;flex:none;margin:0 0 var(--calcite-spacing-md)}.esri-utility-network-trace__double-pad-top{padding-top:10px}.esri-utility-network-trace__feature-content{height:300px}.esri-utility-network-trace__flow{height:100%}.esri-utility-network-trace__list-container{background-color:var(--calcite-color-foreground-1);padding:3px}.esri-utility-network-trace__notice-container{padding:var(--calcite-spacing-xs)}.esri-utility-network-trace__number-input{width:150px}.esri-utility-network-trace__pad-bottom{padding-bottom:5px}.esri-utility-network-trace__pad-top{padding-top:5px}.esri-utility-network-trace__reset-prompt{background-color:var(--calcite-color-background);color:var(--calcite-color-text-2);border-top:3px solid var(--calcite-color-border-input);flex-flow:column;max-height:85%;padding:var(--calcite-spacing-md) 15px;animation:.1s ease-in-out esri-fade-in-up;display:flex;position:absolute;bottom:0;left:0;right:0;box-shadow:0 1px 2px #0000004d}.esri-utility-network-trace__results-container{height:100%}.esri-utility-network-trace__tabs{min-height:250px;position:relative}`, c = s(r);
 class d extends o {
   constructor() {
-    super(...arguments), this.widget = c(this), this.viewModel = this.widget.viewModel, this.view = this.widget.view, this.autoDestroyDisabled = !1, this.defaultGraphicColor = this.widget.defaultGraphicColor, this.disabled = this.widget.disabled, this.enableResultArea = this.widget.enableResultArea, this.flags = this.widget.flags, this.icon = this.widget.icon, this.inputSettings = this.widget.inputSettings, this.label = this.widget.label, this.resultAreaProperties = this.widget.resultAreaProperties, this.selectOnCompleteDisabled = this.widget.selectOnComplete, this.selectedTraces = this.widget.selectedTraces, this.showGraphicsOnCompleteDisabled = this.widget.showGraphicsOnComplete, this.showSelectionAttributesDisabled = this.widget.showSelectionAttributes, this.state = this.viewModel.state, this.traceResults = this.widget.traceResults, this.arcgisAddFlag = e(() => this.widget, "add-flag"), this.arcgisAddFlagComplete = e(() => this.widget, "add-flag-complete"), this.arcgisAddFlagError = e(() => this.widget, "add-flag-error"), this.arcgisAddResultArea = e(() => this.widget, "add-result-area"), this.arcgisPropertyChange = i()("state"), this.arcgisReady = a(), this.arcgisRemoveResultArea = e(() => this.widget, "remove-result-area");
+    super(...arguments), this.widget = c(this), this.viewModel = this.widget.viewModel, this.view = this.widget.view, this.autoDestroyDisabled = !1, this.defaultGraphicColor = this.widget.defaultGraphicColor, this.disabled = this.widget.disabled, this.enableResultArea = this.widget.enableResultArea, this.flags = this.widget.flags, this.icon = this.widget.icon, this.inputSettings = this.widget.inputSettings, this.label = this.widget.label, this.resultAreaProperties = this.widget.resultAreaProperties, this.selectOnCompleteDisabled = this.widget.selectOnComplete, this.selectedTraces = this.widget.selectedTraces, this.showGraphicsOnCompleteDisabled = this.widget.showGraphicsOnComplete, this.showSelectionAttributesDisabled = this.widget.showSelectionAttributes, this.state = this.viewModel.state, this.traceResults = this.widget.traceResults, this.arcgisAddFlag = e(() => this.widget, "add-flag"), this.arcgisAddFlagComplete = e(() => this.widget, "add-flag-complete"), this.arcgisAddFlagError = e(() => this.widget, "add-flag-error"), this.arcgisAddResultArea = e(() => this.widget, "add-result-area"), this.arcgisPropertyChange = i()("state", "traceResults"), this.arcgisReady = a(), this.arcgisRemoveResultArea = e(() => this.widget, "remove-result-area");
   }
   static {
     this.properties = { view: 0, autoDestroyDisabled: 5, defaultGraphicColor: 0, disabled: 7, enableResultArea: 5, flags: 0, icon: 1, inputSettings: 0, label: 1, referenceElement: 1, resultAreaProperties: 0, selectOnCompleteDisabled: 5, selectedTraces: 0, showGraphicsOnCompleteDisabled: 5, showSelectionAttributesDisabled: 5, state: 32, traceResults: 32 };

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

@@ -9,8 +9,76 @@ import type { ArcgisUtilityNetworkTraceResults } from "../arcgis-utility-network
 import type { T9nMeta } from "@arcgis/lumina/controllers";
 import type { UtilityNetworkTraceAnalysisState } from "@arcgis/core/networks/UtilityNetworkTraceAnalysis.js";
 
-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, stopping 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` (deprecated), `path`, `subnetwork`, `subnetwork-controller`, `loops`, and `isolation`.
+ *
+ * > [!WARNING]
+ * >
+ * > The [shortest path trace type](https://pro.arcgis.com/en/pro-app/latest/help/data/trace-network/discover-the-shortest-path.htm) is deprecated with ArcGIS Pro 3.7 and ArcGIS Enterprise 12.1.
+ * >
+ * > While the shortest path trace will continue to function and be an option until the next major release, it is recommended to use the path trace to return the shortest path.
+ * > The path trace provides the same functionality to return a shortest path result while offering additional capabilities to find paths in your network.
+ *
+ * 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.
+ * If the trace result includes elements that originate from a [feature layer](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/)
+ * that is not included in the map, the Results tab displays an `Unknown` layer with a count of those elements.
+ * The component's [traceResultFeatures](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-analysis/#traceResultFeatures) property also does not include these elements.
+ *
+ * > [!WARNING]
+ * >
+ * > The Utility Network Trace Analysis component does not support the following:
+ * >
+ * > 1. Proxied feature services or feature services that utilize stored credentials.
+ * > 2. The `circuit` trace type or the `paths` and `circuits` result types.
+ * > 3. Setting grouping properties `firstUnit` and `lastUnit` for trace locations in a [telecom domain network](https://pro.arcgis.com/en/pro-app/latest/help/data/utility-network/telecom-domain-networks.htm).
+ * >    If a [grouped object](https://pro.arcgis.com/en/pro-app/latest/help/data/utility-network/grouping.htm) is used as a trace location, its `firstUnit` and `lastUnit` attributes are not used in the trace.
+ *
+ * ## 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: {
@@ -27,6 +95,8 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
               noView: string;
               sceneViewNotSupported: string;
           };
+          missingTerminalBody: string;
+          missingTerminalTitle: string;
           noStartingPointsBody: string;
           noStartingPointsTitle: string;
       };
@@ -54,6 +124,8 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
               noView: string;
               sceneViewNotSupported: string;
           };
+          missingTerminalBody: string;
+          missingTerminalTitle: string;
           noStartingPointsBody: string;
           noStartingPointsTitle: string;
       };
@@ -71,14 +143,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,24 +172,34 @@ 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
    * Disable highlighting trace result features.
    * ```html
    * <arcgis-map item-id="471eb0bf37074b1fbb972b1da70fb310">
-   *   <arcgis-utility-network-trace-analysis disable-highlight-feature-results slot="top-right"/>
+   *   <arcgis-utility-network-trace-analysis disable-highlight-feature-results slot="top-right">
+   *   </arcgis-utility-network-trace-analysis>
    * </arcgis-map>
    * ```
    */
   accessor disableHighlightFeatureResults: boolean;
+  /**
+   * Indicates whether to hide the action bar that holds the feature's
+   * [actions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#actions)
+   * when selecting trace locations and viewing trace result features.
+   *
+   * @default false
+   * @internal
+   */
+  accessor hideActionBar: 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.
@@ -127,7 +209,8 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
    * Do not show features in the results tab.
    * ```html
    * <arcgis-map item-id="471eb0bf37074b1fbb972b1da70fb310">
-   *   <arcgis-utility-network-trace-analysis hide-feature-results slot="top-right"/>
+   *   <arcgis-utility-network-trace-analysis hide-feature-results slot="top-right">
+   *   </arcgis-utility-network-trace-analysis>
    * </arcgis-map>
    * ```
    * @example
@@ -138,7 +221,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.
@@ -159,6 +242,8 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
               noView?: string | undefined;
               sceneViewNotSupported?: string | undefined;
           } | undefined;
+          missingTerminalBody?: string | undefined;
+          missingTerminalTitle?: string | undefined;
           noStartingPointsBody?: string | undefined;
           noStartingPointsTitle?: string | undefined;
       } | undefined;
@@ -179,17 +264,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.
    *
-   * @since 5.0
+   * This array is populated if the trace returned [element](https://developers.arcgis.com/javascript/latest/references/core/rest/networks/support/TraceResult/#elements) results.
+   *
+   * 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 +285,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 +353,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,57 @@
 /* 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 { 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 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 { 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 {
+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 {
   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");
-      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();
+    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();
   }
   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, 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 };
   }
   static {
-    this.styles = R;
+    this.styles = $;
   }
   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";
-  }
   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();
+  }
+  load() {
+    this.manager.onLifecycle(() => [
+      f(() => !this._viewModel.utilityNetwork, () => this._switchTab("input"))
+    ]);
   }
   _clearTraceResult() {
-    this.traceResult = void 0, this._clearHighlights();
+    this.traceResult = void 0, this._clearHighlights(), this._clearAggregatedGeometryGraphics();
+  }
+  _setTraceWarnings() {
+    if (!this._traceInputsElement)
+      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;
   }
   _switchTab(e) {
     this.activeTab = e;
@@ -66,42 +74,45 @@ 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;
-        if (a.isUtilityLayer(c)) {
-          const f = Number(i.layerUrl.split("/").pop());
-          return c.layerId === f;
+    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 (!n)
+      if (!c)
         return;
-      const p = n.highlight(i.objectIds);
-      this._highlightHandles.push(p);
+      const o = c.highlight(r.objectIds);
+      this._highlightHandles.push(o);
     });
   }
   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");
+      T("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,
         traceConfiguration: t,
         traceLocations: a ?? [],
-        resultTypes: e.resultTypes
+        resultTypes: e.resultTypes,
+        outSpatialReference: this.view?.spatialReference
       }), 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;
+    } catch (i) {
+      R(i, this, "Error while running trace"), this.traceError = i, this.traceResult = void 0;
     }
   }
   _handleHideGraphicsChange(e) {
@@ -118,46 +129,48 @@ class C extends w {
   }
   _handleAggregatedGeometryGraphicsColorChange(e) {
     const t = e.detail;
-    this.aggregatedGeometryGraphicsColor = new h(t);
-  }
-  _handleTraceInputsChange() {
+    this.aggregatedGeometryGraphicsColor = new d(t);
   }
   _handleSelectedNamedTraceConfigurationChange() {
-    this.showNoStartingPointsWarning = !1;
+    this.showNoStartingPointsWarning = !1, this.showMissingTerminalWarning = !1;
   }
   _handleUtilityNetworkChange() {
-    this._viewModel.utilityNetwork = this._traceInputsRef.value?.selectedUtilityNetwork;
+    this._viewModel.utilityNetwork = this._traceInputsElement?.selectedUtilityNetwork;
+  }
+  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>`;
   }
   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>`;
+    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>`;
   }
   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 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>`);
   }
   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";
-    return r`<calcite-button appearance=outline width=full @click=${() => {
+    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=${!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>`;
+    }} .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>`;
   }
   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) => {
-      e.stopPropagation(), e.detail.name === "mode" && (this.mode = e.target.mode);
-    }} ${d(this._traceInputsRef)}></arcgis-utility-network-trace-inputs></div></calcite-tab>`);
+    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>`);
   }
   renderInputFooter() {
-    const { mode: e, _viewModel: { state: t } } = this;
-    return e !== "default" ? null : r`<calcite-button appearance=solid width=full @click=${this._handleRunTraceButtonClick} slot=footer .disabled=${t === "disabled"}>${this._messages.buttons.getResults}</calcite-button>`;
+    const { mode: e, state: t } = this;
+    if (e !== "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>`;
   }
   render() {
-    const { _messages: e, _viewModel: { loadError: t, state: a } } = this, s = a === "disabled" && t != null, i = s && t !== "no-utility-network" ? r`<calcite-notice kind=warning open scale=s slot=content-top width=full><div slot=message>${this._getLoadError(t)}</div></calcite-notice>` : void 0;
-    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>`;
+    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>`;
   }
 }
-y("arcgis-utility-network-trace-analysis", C);
+m("arcgis-utility-network-trace-analysis", E);
 export {
-  C as ArcgisUtilityNetworkTraceAnalysis
+  E as ArcgisUtilityNetworkTraceAnalysis
 };

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

@@ -0,0 +1 @@
+export type UtilityNetworkTraceAnalysisDisplayMode = "add-spatial-feature" | "add-spatial-instructions" | "default";