@arcgis/map-components 5.2.0-next.7 → 5.2.0-next.70

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

@@ -40,7 +40,7 @@ import type { UtilityNetworkTraceAnalysisState } from "@arcgis/core/networks/Uti
  * > 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.
+ * >    If a [grouped object](https://doc.esri.com/en/arcgis-pro/latest/help/data/utility-network/grouping.html) is used as a trace location, its `firstUnit` and `lastUnit` attributes are not used in the trace.
  *
  * ## Working with nonspatial objects
  *
@@ -228,7 +228,7 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
    *
    * _**Note**: Individual message keys may change between releases._
    */
-  accessor messageOverrides: Pick<ArcgisUtilityNetworkTraceResults["_messages"], "resultFeaturesAreHidden"> & {
+  accessor messageOverrides: NonNullable<ArcgisUtilityNetworkTraceResults["messageOverrides"]> & {
       buttons?: {
           clearResultsCustom?: string | undefined;
           clearResultsGeneric?: string | undefined;
@@ -276,8 +276,8 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
    */
   get traceResultFeatures(): Graphic[];
   /**
-   * The view associated with the component. 
-   *   > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the arcgis-utility-network-trace-analysis component will be associated with a map or scene component rather than using the `view` property.
+   * The view associated with the component.
+   * > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the arcgis-utility-network-trace-analysis component will be associated with a map or scene component rather than using the `view` property.
    */
   accessor view: MapView | null | undefined;
   /** Permanently destroy the component. */

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

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

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

@@ -13,8 +13,6 @@ import type { T9nMeta } from "@arcgis/lumina/controllers";
 
 /**
  * This is a sub-component used by the **ArcgisUtilityNetworkTraceAnalysis** component.
- *
- * This sub-component takes a map view as an input.
  * It allows users to select utility networks, trace configurations, and input features for tracing.
  *
  * @since 4.34
@@ -131,15 +129,29 @@ export abstract class ArcgisUtilityNetworkTraceInputs extends LitElement {
    */
   accessor hideActionBar: boolean;
   /**
+   * Whether a the user has selected a named trace configuration that executes a
+   * subnetwork trace with a specified subnetwork name.
+   *
    * @default false
    * @internal
    */
   get isSubnetworkNameTraceSelected(): boolean;
   /** @default "default" */
   accessor mode: UtilityNetworkTraceAnalysisDisplayMode;
+  /**
+   * By assigning the `id` attribute of the Map or Scene component to this property, you can position a child component anywhere in the DOM while still maintaining a connection to the Map or Scene.
+   *
+   * @see [Associate components with a Map or Scene component](https://developers.arcgis.com/javascript/latest/programming-patterns/#associate-components-with-a-map-or-scene-component)
+   */
   accessor referenceElement: ArcgisReferenceElement | string | undefined;
   accessor selectedNamedTraceConfiguration: NamedTraceConfiguration | undefined;
   accessor selectedUtilityNetwork: UtilityNetwork | undefined;
+  /**
+   * A clone of the utility network trace configuration associated with
+   * the selected named trace configuration. Updates on this object are
+   * used to reflect the user's changes to the named trace configuration.
+   */
+  get traceConfiguration(): UNTraceConfiguration | undefined;
   /**
    * Supplementary information about the points selected on the map to run the trace.
    * I.e., feature title, terminal configuration, selected terminals, and spatial properties.
@@ -149,19 +161,15 @@ export abstract class ArcgisUtilityNetworkTraceInputs extends LitElement {
   get traceLocationFlagInfos(): Collection<FlagInfo>;
   get traceLocations(): TraceLocation[];
   /**
-   * A clone of the utility network trace configuration associated with
-   * the selected named trace configuration. Updates on this object are
-   * used to reflect the user's changes to the named trace configuration.
+   * 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-inputs component will be associated with a map or scene component rather than using the `view` property.
    */
-  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>;
-  /** There will be more added to this event as we increase the functionality of this component */
   readonly arcgisTraceInputsChange: import("@arcgis/lumina").TargetedEvent<this, void>;
   /**
    * Fires when the user completes the selection of a trace location.
@@ -176,7 +184,7 @@ export abstract class ArcgisUtilityNetworkTraceInputs extends LitElement {
    * @internal
    */
   readonly arcgisTraceLocationSelectStart: import("@arcgis/lumina").TargetedEvent<this, SelectStartPayload>;
-  /** This will be fired less often than above, only when the utility network changes */
+  /** Fires when the user changes the selected utility network. */
   readonly arcgisUtilityNetworkChange: import("@arcgis/lumina").TargetedEvent<this, void>;
   readonly "@eventTypes": {
     arcgisPropertyChange: ArcgisUtilityNetworkTraceInputs["arcgisPropertyChange"]["detail"];