@arcgis/map-components 5.2.0-next.120 → 5.2.0-next.122

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

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

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

@@ -14,6 +14,12 @@ import type { UtilityNetworkTraceAnalysisState } from "@arcgis/core/networks/Uti
 /**
  * ## Overview
  *
+ * > [!WARNING]
+ * > This component is the successor to the `utility-network-trace-analysis` component.
+ * > The `utility-network-trace-analysis` component is being substantially refactored to expose public trace sub-components in release 5.2 and 6.0.
+ * > To avoid destabilizing the public version of `utility-network-trace-analysis`, the refactoring work is being performed in this component.
+ * > At release, this "next" component will replace the original.
+ *
  * 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).
@@ -79,6 +85,9 @@ import type { UtilityNetworkTraceAnalysisState } from "@arcgis/core/networks/Uti
  *
  * Note: Sign in to access the data in this demo, U/P: `viewer01`/`I68VGU^nMurF`
  *
+ * @slot
+ * [results] - Slot for instances of [arcgis-utility-network-trace-results](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results/),
+ * for displaying the results of one or more traces.
  * @internal
  * @since 5.0
  */
@@ -218,11 +227,10 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
   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.
+   * [arcgis-features-next.actions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#actions) when selecting trace locations
+   * and viewing trace result features.
    *
    * @default false
-   * @internal
    */
   accessor hideActionBar: boolean;
   /**

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

@@ -1,27 +1,41 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import { c as u } from "../../chunks/runtime.js";
-import { css as d, html as a } from "lit";
+import { c as m } from "../../chunks/runtime.js";
 import { ref as c } from "lit/directives/ref.js";
-import { keyed as l } from "lit/directives/keyed.js";
-import p from "@arcgis/core/Color.js";
-import { when as m } from "@arcgis/core/core/reactiveUtils.js";
-import f from "@arcgis/core/networks/UtilityNetworkTraceAnalysis.js";
-import { LitElement as y, createEvent as r } from "@arcgis/lumina";
-import { usePropertyChange as b } from "@arcgis/lumina/controllers";
-import { log as w } from "@arcgis/toolkit/log";
-import { u as v } from "../../chunks/useT9n.js";
-import { m as T } from "../../chunks/useViewModel.js";
-import { l as $ } from "../../chunks/async-utils.js";
-const R = d`:host{--arcgis-internal-color-black-30: color-mix(in srgb, #000000 30.2%, transparent);--arcgis-internal-box-shadow: var(--calcite-spacing-none) var(--calcite-spacing-px) var(--calcite-spacing-base) var(--arcgis-internal-color-black-30);--arcgis-internal-top-max-width: calc(min(100cqw, 100vw) - var(--calcite-spacing-xxxl));--arcgis-internal-panel-width: 300px;--arcgis-internal-panel-height: 100%;--arcgis-internal-panel-height-sm: 240px;--arcgis-internal-panel-height-md: 420px;--arcgis-internal-panel-height-lg: 540px;--arcgis-internal-panel-height-xl: 680px;--arcgis-internal-panel-gap: var(--calcite-spacing-lg);--arcgis-internal-panel-actions-gap: var(--calcite-spacing-sm);--arcgis-internal-basemap-gallery-width-lg: 450px;--arcgis-internal-collapse-icon-flip: scaleX(1);--arcgis-internal-row-direction: row;--arcgis-internal-legend-width: 300px;--arcgis-internal-layout-overlay-space-top: var(--arcgis-layout-overlay-space-top, 0px);--arcgis-internal-layout-overlay-space-bottom: var(--arcgis-layout-overlay-space-bottom, 0px);--arcgis-internal-layout-overlay-space-left: var(--arcgis-layout-overlay-space-left, 0px);--arcgis-internal-layout-overlay-space-right: var(--arcgis-layout-overlay-space-right, 0px);--arcgis-internal-view-color-focus: var(--arcgis-view-color-focus, var(--calcite-color-brand));--arcgis-internal-attribution-space-bottom: var(--arcgis-internal-layout-overlay-space-bottom);--arcgis-internal-attribution-space-left: var(--arcgis-internal-layout-overlay-space-left);--arcgis-internal-attribution-space-right: var(--arcgis-internal-layout-overlay-space-right);--arcgis-internal-attribution-font-size: var(--calcite-font-size-sm);--arcgis-internal-attribution-font-size-sm: var(--calcite-font-size-xs);--arcgis-internal-sketch-justify-content: flex-start}:host{display:flex;flex-direction:column;height:var(--arcgis-internal-panel-height, 100%)}arcgis-utility-network-trace-inputs[mode=default]{height:auto}calcite-tabs{display:flex;flex-direction:column;height:100%}calcite-tab{--calcite-tab-content-space-y: 0;min-height:var(--arcgis-internal-panel-height-sm, 240px)}calcite-tab:not([selected]){flex:0}calcite-panel{--calcite-panel-background-color: var(--calcite-color-foreground-1)}calcite-notice{margin:var(--calcite-spacing-md)}.inputs-tab-container{display:flex;flex-direction:column;height:100%}.trace-inputs-warning{flex:none;height:fit-content;calcite-notice{margin:var(--calcite-spacing-md) var(--calcite-spacing-md) 0}}`, _ = T(f);
-class x extends y {
+import y from "@arcgis/core/Color.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 r } from "@arcgis/lumina";
+import { usePropertyChange as v } from "@arcgis/lumina/controllers";
+import { slotChangeGetAssignedElements as h } from "@arcgis/toolkit/dom/slots";
+import { log as o } from "@arcgis/toolkit/log";
+import { css as T, html as a } from "lit";
+import { u as R } from "../../chunks/useT9n.js";
+import { m as $ } from "../../chunks/useViewModel.js";
+import { l as _ } from "../../chunks/async-utils.js";
+const k = T`: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;--calcite-panel-background-color: var(--calcite-color-background);min-height:var(--arcgis-internal-panel-height-sm, 240px)}calcite-panel{--calcite-panel-background-color: var(--calcite-color-foreground-1)}calcite-notice{margin:var(--calcite-spacing-md)}slot[name=results]::slotted(:not(arcgis-utility-network-trace-results)){display:none}slot[name=results]::slotted([arcgis-hidden-results-slot-item]){display:none}.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}}`, x = $(b), g = "arcgis-utility-network-trace-results", u = "arcgis-hidden-results-slot-item", C = [
+  "actions",
+  "autoDestroyDisabled",
+  "aggregatedGeometryGraphicsColor",
+  "disableHighlightFeatureResults",
+  "hideActionBar",
+  "hideFeatureResults",
+  "hidePlaceholder",
+  "includeDefaultActionsDisabled",
+  "messageOverrides",
+  "referenceElement",
+  "view",
+  "_traceError",
+  "_traceResult"
+];
+class S extends w {
   constructor() {
-    super(...arguments), this._messages = v({ blocking: !0 }), this.#e = _(this), this._activeTab = "input", this._showMissingTerminalWarning = !1, this._showNoStartingPointsWarning = !1, this._mode = "default", this.autoDestroyDisabled = !1, this.aggregatedGeometryGraphicsColor = new p([255, 255, 0, 0.6]), this.disableHighlightFeatureResults = !1, this.hideActionBar = !1, this.hideGraphics = !1, this.hidePlaceholder = !1, this.hideFeatureResults = !1, this.includeDefaultActionsDisabled = !1, this.state = this.#e.state, this.view = this.#e.view, this.arcgisHideGraphicsChange = r(), this.arcgisPropertyChange = b()("aggregatedGeometryGraphicsColor", "hideGraphics"), this.arcgisReady = r(), this.arcgisTriggerAction = r(), this.arcgisTraceLocationSelectEnd = r(), this.arcgisTraceLocationSelectStart = r(), this.arcgisTraceResultClear = r(), this.arcgisTraceResultFeaturesReady = r();
+    super(...arguments), this._messages = R({ blocking: !0 }), this.#e = x(this), this._activeTab = "input", this._showMissingTerminalWarning = !1, this._showNoStartingPointsWarning = !1, this._slottedElements = [], this._mode = "default", this.autoDestroyDisabled = !1, this.aggregatedGeometryGraphicsColor = new y([255, 255, 0, 0.6]), this.disableHighlightFeatureResults = !1, this.hideActionBar = !1, this.hideGraphics = !1, this.hidePlaceholder = !1, this.hideFeatureResults = !1, this.includeDefaultActionsDisabled = !1, this.state = this.#e.state, this.view = this.#e.view, this.arcgisHideGraphicsChange = r(), this.arcgisPropertyChange = v()("aggregatedGeometryGraphicsColor", "hideGraphics"), this.arcgisReady = r(), this.arcgisTriggerAction = r(), this.arcgisTraceLocationSelectEnd = r(), this.arcgisTraceLocationSelectStart = r(), this.arcgisTraceResultClear = r(), this.arcgisTraceResultFeaturesReady = r();
   }
   static {
-    this.properties = { _activeTab: 16, _traceError: 16, _traceResult: 16, _showMissingTerminalWarning: 16, _showNoStartingPointsWarning: 16, _mode: 16, actions: 0, autoDestroyDisabled: 5, beforeTraceLocationSelectStart: 0, aggregatedGeometryGraphicsColor: 0, disableHighlightFeatureResults: 5, hideActionBar: 5, hideGraphics: 5, hidePlaceholder: 5, hideFeatureResults: 5, includeDefaultActionsDisabled: 5, label: 3, messageOverrides: 0, traceResultFeatures: 32, referenceElement: 1, state: 32, view: 0 };
+    this.properties = { _activeTab: 16, _traceError: 16, _traceResult: 16, _showMissingTerminalWarning: 16, _showNoStartingPointsWarning: 16, _slottedElements: 16, _mode: 16, actions: 0, autoDestroyDisabled: 5, beforeTraceLocationSelectStart: 0, aggregatedGeometryGraphicsColor: 0, disableHighlightFeatureResults: 5, hideActionBar: 5, hideGraphics: 5, hidePlaceholder: 5, hideFeatureResults: 5, includeDefaultActionsDisabled: 5, label: 3, messageOverrides: 0, traceResultFeatures: 32, referenceElement: 1, state: 32, view: 0 };
   }
   static {
-    this.styles = R;
+    this.styles = k;
   }
   #e;
   #t;
@@ -30,7 +44,9 @@ class x extends y {
     const { view: e } = this;
     return e?.map ? e.map.allLayers.toArray().concat(e.map.allTables.toArray()) : [];
   }
-  #n;
+  get #o() {
+    return Array.from(this.el.children).some((e) => e.slot === "results" && e.matches(g));
+  }
   get traceResultFeatures() {
     return this.#i?.traceResultFeatures ?? [];
   }
@@ -39,22 +55,48 @@ class x extends y {
   }
   load() {
     this.manager.onLifecycle(() => [
-      m(() => !this.#e.utilityNetwork, () => this.#a("input"))
+      f(() => !this.#e.utilityNetwork, () => this.#s("input"))
     ]);
   }
-  #s() {
+  willUpdate(e) {
+    C.some((t) => e.has(t)) && this.#a();
+  }
+  #n() {
     this._traceResult = void 0, this.#i?.clearResults();
   }
-  #o() {
+  #c() {
     if (!this.#t)
       return;
-    const { traceLocations: e, traceLocationDetails: t, traceConfiguration: i, isSubnetworkNameTraceSelected: s } = this.#t, n = !!i?.subnetworkName, h = e?.some((o) => o.type === "starting-point"), g = t?.some((o) => !!o.flagProperties.terminalConfiguration && !o.flagProperties.selectedTerminals?.size) ?? !1;
-    this._traceError = void 0, this._showNoStartingPointsWarning = !s && !h || s && !n, this._showMissingTerminalWarning = g;
+    const { traceLocations: e, traceLocationDetails: t, traceConfiguration: i, isSubnetworkNameTraceSelected: s } = this.#t, n = !!i?.subnetworkName, d = e?.some((l) => l.type === "starting-point"), p = t?.some((l) => !!l.flagProperties.terminalConfiguration && !l.flagProperties.selectedTerminals?.size) ?? !1;
+    this._traceError = void 0, this._showNoStartingPointsWarning = !s && !d || s && !n, this._showMissingTerminalWarning = p;
   }
-  #a(e) {
+  #s(e) {
     this._activeTab = e;
   }
-  #c(e) {
+  #a() {
+    if (!this.#i)
+      return;
+    const e = {
+      actions: this.actions,
+      autoDestroyDisabled: this.autoDestroyDisabled,
+      aggregatedGeometryGraphicsColor: this.aggregatedGeometryGraphicsColor,
+      disableHighlightFeatureResults: this.disableHighlightFeatureResults,
+      expanded: !0,
+      hideActionBar: this.hideActionBar,
+      hideFeatureResults: this.hideFeatureResults,
+      hidePlaceholder: this.hidePlaceholder,
+      includeDefaultActionsDisabled: this.includeDefaultActionsDisabled,
+      layers: this.#r,
+      messageOverrides: this.messageOverrides,
+      referenceElement: this.referenceElement,
+      traceError: this._traceError,
+      traceResult: this._traceResult,
+      utilityNetwork: this.#e.utilityNetwork ?? void 0,
+      view: this.view ?? void 0
+    };
+    Object.assign(this.#i, e);
+  }
+  #h(e) {
     const { _messages: t } = this;
     switch (e) {
       case "no-user-type-extension":
@@ -69,10 +111,10 @@ class x extends y {
         return e;
     }
   }
-  async #l() {
+  async #g() {
     const e = this.#t?.selectedNamedTraceConfiguration, t = this.#t?.traceConfiguration;
     if (!(e?.traceType && t)) {
-      w("error", this, "Trace configuration not found");
+      o("error", this, "Trace configuration not found");
       return;
     }
     const i = this.#t?.traceLocations;
@@ -85,72 +127,84 @@ class x extends y {
         outSpatialReference: this.view?.spatialReference
       });
     } catch (s) {
-      $(s, this, "Error while running trace"), this._traceError = s, this._traceResult = void 0;
+      _(s, this, "Error while running trace"), this._traceError = s, this._traceResult = void 0;
     }
   }
-  #h() {
-    this.#o(), !(this._showNoStartingPointsWarning || this._showMissingTerminalWarning) && (this._showNoStartingPointsWarning = !1, this._showMissingTerminalWarning = !1, this.#s(), this.#a("results"), this.#l());
+  #u() {
+    this.#c(), !(this._showNoStartingPointsWarning || this._showMissingTerminalWarning) && (this._showNoStartingPointsWarning = !1, this._showMissingTerminalWarning = !1, this.#n(), this.#s("results"), this.#g());
   }
-  #g(e) {
+  #d(e) {
     e && (this.#t = e);
   }
-  #u(e) {
+  #l(e) {
     e && (this.#i = e);
   }
-  #d(e) {
+  #p(e) {
+    this._slottedElements = h(e);
+    const t = h(e, g);
+    t.length < this._slottedElements.length && o("warn", this, "The trace results pane only renders instances of `arcgis-utility-network-trace-results` in the `results` slot."), t.length > 1 && o("warn", this, "Multiple `arcgis-utility-network-trace-results` elements were provided in the `results` slot. Only the first will render.");
+    const [i] = t;
+    for (const s of t)
+      s === i ? s.removeAttribute(u) : s.setAttribute(u, "");
+    this.#l(i), this.#a();
+  }
+  #m(e) {
     const { detail: t, target: i } = e;
     t.name === "aggregatedGeometryGraphicsColor" ? (e.stopPropagation(), this.aggregatedGeometryGraphicsColor = i[t.name]) : t.name === "hideGraphics" && (e.stopPropagation(), this.hideGraphics = i[t.name], this.arcgisHideGraphicsChange.emit(this.hideGraphics));
   }
-  #p(e) {
+  #y(e) {
     e.stopPropagation(), this.arcgisTraceLocationSelectStart.emit(e.detail).defaultPrevented && e.preventDefault();
   }
-  #m(e) {
+  #f(e) {
     e.stopPropagation(), this.arcgisTraceLocationSelectEnd.emit();
   }
-  #f(e) {
+  #b(e) {
+    e.stopPropagation(), this.arcgisTraceResultClear.emit();
+  }
+  #w(e) {
     e.stopPropagation(), this.arcgisTraceResultFeaturesReady.emit();
   }
-  #y(e) {
+  #v(e) {
     e.stopPropagation(), this.arcgisTriggerAction.emit(e.detail);
   }
-  #b(e) {
+  #T(e) {
     const { detail: t, target: i } = e;
-    e.stopPropagation(), t.name === "selectedUtilityNetwork" && (this.#e.utilityNetwork = i.selectedUtilityNetwork), t.name === "selectedNamedTraceConfiguration" && (this._showNoStartingPointsWarning = !1, this._showMissingTerminalWarning = !1), t.name === "mode" && (this._mode = i.mode);
+    e.stopPropagation(), t.name === "selectedUtilityNetwork" && (this.#e.utilityNetwork = i.selectedUtilityNetwork, this.#a()), t.name === "selectedNamedTraceConfiguration" && (this._showNoStartingPointsWarning = !1, this._showMissingTerminalWarning = !1), t.name === "mode" && (this._mode = i.mode);
   }
-  #w() {
+  #R() {
     const { _messages: e } = this;
     return a`<calcite-panel class="trace-inputs-warning"><calcite-notice open icon=exclamation-mark-triangle closable kind=danger scale=s @calciteNoticeClose=${() => this._showMissingTerminalWarning = !1}><div slot=title>${e.errors.missingTerminalTitle}</div><div slot=message>${e.errors.missingTerminalBody}</div></calcite-notice></calcite-panel>`;
   }
-  #v() {
+  #$() {
     const { _messages: e } = this;
     return a`<calcite-panel class="trace-inputs-warning"><calcite-notice open icon=exclamation-mark-triangle closable kind=danger scale=s @calciteNoticeClose=${() => this._showNoStartingPointsWarning = !1}><div slot=title>${e.errors.noStartingPointsTitle}</div><div slot=message>${e.errors.noStartingPointsBody}</div></calcite-notice></calcite-panel>`;
   }
-  #T() {
-    return l(`${this.el.id}__results-tab-item`, a`<calcite-tab .selected=${this._activeTab === "results"}>${this.state === "executing" ? a`<calcite-panel><calcite-loader .label=${this._messages.runningTrace} .text=${this._messages.runningTrace}></calcite-loader></calcite-panel>` : a`<arcgis-utility-network-trace-results .actions=${this.actions} .autoDestroyDisabled=${this.autoDestroyDisabled} .aggregatedGeometryGraphicsColor=${this.aggregatedGeometryGraphicsColor} .disableHighlightFeatureResults=${this.disableHighlightFeatureResults} .heading=${this.#n?.title} .hideActionBar=${this.hideActionBar} .hideFeatureResults=${this.hideFeatureResults} .hidePlaceholder=${this.hidePlaceholder} .includeDefaultActionsDisabled=${this.includeDefaultActionsDisabled} .layers=${this.#r} .messageOverrides=${this.messageOverrides} .referenceElement=${this.referenceElement} .traceError=${this._traceError} .traceResult=${this._traceResult} .utilityNetwork=${this.#e.utilityNetwork ?? void 0} .view=${this.view ?? void 0} @arcgisPropertyChange=${this.#d} @arcgisTraceResultFeaturesReady=${this.#f} @arcgisTriggerAction=${this.#y} ${c(this.#u)}></arcgis-utility-network-trace-results>`}</calcite-tab>`);
+  #_() {
+    return 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>` || ""}<arcgis-utility-network-trace-results-pane hide-warnings .hidden=${this.state === "executing"}><slot name=results @slotchange=${this.#p}></slot>${this.#o ? null : a`<arcgis-utility-network-trace-results .actions=${this.actions} .autoDestroyDisabled=${this.autoDestroyDisabled} .aggregatedGeometryGraphicsColor=${this.aggregatedGeometryGraphicsColor} .disableHighlightFeatureResults=${this.disableHighlightFeatureResults} expanded .hideActionBar=${this.hideActionBar} .hideFeatureResults=${this.hideFeatureResults} .hidePlaceholder=${this.hidePlaceholder} .includeDefaultActionsDisabled=${this.includeDefaultActionsDisabled} .layers=${this.#r} .messageOverrides=${this.messageOverrides} .referenceElement=${this.referenceElement} .traceError=${this._traceError} .traceResult=${this._traceResult} .utilityNetwork=${this.#e.utilityNetwork ?? void 0} .view=${this.view ?? void 0} @arcgisPropertyChange=${this.#m} @arcgisResultsReady=${this.#w} @arcgisTraceResultClear=${this.#b} @arcgisTriggerAction=${this.#v} ${c(this.#l)}></arcgis-utility-network-trace-results>`}</arcgis-utility-network-trace-results-pane></calcite-tab>`;
   }
-  #$() {
+  #k() {
     const { _messages: e, _traceResult: t } = this, s = !!(t?.elements.length || t?.globalFunctionResults.length || t?.aggregatedGeometry) && this.#i?.state === "ready", n = this.#i?.numFeatureResults ?? 0;
     return a`<calcite-button appearance=outline width=full @click=${() => {
-      this.#a("input"), this.#s(), this.arcgisTraceResultClear.emit();
+      this.#s("input"), this.#n();
     }} .disabled=${!s} slot=footer>${n > 0 && !this.hideFeatureResults && this.state !== "executing" ? e.buttons.clearResultsCustom.replace("{number}", n.toString()) : e.buttons.clearResultsGeneric}</calcite-button>`;
   }
-  #R() {
-    const { _mode: e } = this, { loadError: t } = this.#e, s = (t === "no-user-type-extension" || t === "sceneView-not-supported" ? a`<calcite-notice kind=danger open scale=s slot=content-top width=auto><div slot=message>${this.#c(t)}</div></calcite-notice>` : void 0) ?? a`${this._showNoStartingPointsWarning && e === "default" && this.#v() || ""}${this._showMissingTerminalWarning && e === "default" && this.#w() || ""}<arcgis-utility-network-trace-inputs .autoDestroyDisabled=${this.autoDestroyDisabled} .hideFeaturesActionBar=${this.hideActionBar} .referenceElement=${this.referenceElement} .view=${this.view ?? void 0} .beforeTraceLocationSelectStart=${this.beforeTraceLocationSelectStart} @arcgisPropertyChange=${this.#b} @arcgisTraceLocationSelectEnd=${this.#m} @arcgisTraceLocationSelectStart=${this.#p} ${c(this.#g)}></arcgis-utility-network-trace-inputs>`;
-    return l(`${this.el.id}__inputs-tab-item`, a`<calcite-tab .selected=${this._activeTab === "input"}><div class="inputs-tab-container">${s}</div></calcite-tab>`);
+  #x() {
+    const { _mode: e } = this, { loadError: t } = this.#e, s = (t === "no-user-type-extension" || t === "sceneView-not-supported" ? a`<calcite-notice kind=danger open scale=s slot=content-top width=auto><div slot=message>${this.#h(t)}</div></calcite-notice>` : void 0) ?? a`${this._showNoStartingPointsWarning && e === "default" && this.#$() || ""}${this._showMissingTerminalWarning && e === "default" && this.#R() || ""}<arcgis-utility-network-trace-inputs .autoDestroyDisabled=${this.autoDestroyDisabled} .hideFeaturesActionBar=${this.hideActionBar} .referenceElement=${this.referenceElement} .view=${this.view ?? void 0} .beforeTraceLocationSelectStart=${this.beforeTraceLocationSelectStart} @arcgisPropertyChange=${this.#T} @arcgisTraceLocationSelectEnd=${this.#f} @arcgisTraceLocationSelectStart=${this.#y} ${c(this.#d)}></arcgis-utility-network-trace-inputs>`;
+    return a`<calcite-tab .selected=${this._activeTab === "input"}><div class="inputs-tab-container">${s}</div></calcite-tab>`;
   }
-  #_() {
+  #C() {
     const { state: e } = this;
     if (this._mode !== "default")
       return null;
     const t = e === "disabled" || e === "loading" || !this.#t?.traceConfiguration;
-    return a`<calcite-button appearance=solid width=full @click=${this.#h} slot=footer .disabled=${t}>${this._messages.buttons.getResults}</calcite-button>`;
+    return a`<calcite-button appearance=solid width=full @click=${this.#u} slot=footer .disabled=${t}>${this._messages.buttons.getResults}</calcite-button>`;
   }
   render() {
     const { _activeTab: e, state: t } = this;
-    return a`<calcite-panel><calcite-tabs layout=center position=top><calcite-tab-nav slot=title-group><calcite-tab-title @click=${() => this.#a("input")} .selected=${e === "input"}>${this._messages.tabs.inputTab}</calcite-tab-title><calcite-tab-title @click=${() => this.#a("results")} .selected=${e === "results"} .disabled=${t === "disabled" || t === "loading"}>${this._messages.tabs.resultsTab}</calcite-tab-title></calcite-tab-nav>${this.#R()}${this.#T()}</calcite-tabs>${e === "input" ? this.#_() : null}${e === "results" ? this.#$() : null}</calcite-panel>`;
+    return a`<calcite-panel><calcite-tabs layout=center position=top><calcite-tab-nav slot=title-group><calcite-tab-title @click=${() => this.#s("input")} .selected=${e === "input"}>${this._messages.tabs.inputTab}</calcite-tab-title><calcite-tab-title @click=${() => this.#s("results")} .selected=${e === "results"} .disabled=${t === "disabled" || t === "loading"}>${this._messages.tabs.resultsTab}</calcite-tab-title></calcite-tab-nav>${this.#x()}${this.#_()}</calcite-tabs>${e === "input" ? this.#C() : null}${e === "results" ? this.#k() : null}</calcite-panel>`;
   }
 }
-u("arcgis-utility-network-trace-analysis", x);
+m("arcgis-utility-network-trace-analysis", S);
 export {
-  x as ArcgisUtilityNetworkTraceAnalysis
+  S as ArcgisUtilityNetworkTraceAnalysis
 };

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

@@ -2,6 +2,7 @@ import "@esri/calcite-components/components/calcite-panel";
 import "@esri/calcite-components/components/calcite-notice";
 import "@esri/calcite-components/components/calcite-tab";
 import "@esri/calcite-components/components/calcite-loader";
+import "../arcgis-utility-network-trace-results-pane/index.js";
 import "../arcgis-utility-network-trace-results/index.js";
 import "@esri/calcite-components/components/calcite-button";
 import "../arcgis-utility-network-trace-inputs/index.js";

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

@@ -5,6 +5,8 @@ import type MapView from "@arcgis/core/views/MapView.js";
 
 export type UtilityNetworkTraceAnalysisDisplayMode = "add-spatial-feature" | "add-spatial-instructions" | "default";
 
+export type UtilityNetworkTraceResultItemState = "disabled" | "loading" | "ready";
+
 /**
  * Defines the common properties shared by all children of [arcgis-utility-network-trace-results](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results/).
  *
@@ -22,6 +24,8 @@ export interface UtilityNetworkTraceResultItem {
   utilityNetwork?: UtilityNetwork;
   /** The MapView used by the result item. */
   view?: MapView;
+  /** Whether the result item intends to emit event `arcgisResultReady`. */
+  emitsArcgisResultReady: boolean;
   /** A method to clean up side effects from the result item. */
-  clearResult?: () => void;
+  clearResult: () => void;
 }

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

@@ -8,6 +8,7 @@ import type { ActionEvent } from "@arcgis/core/widgets/Popup/types.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 import type { ArcgisFeaturesNext } from "../arcgis-features-next/customElement.js";
 import type { ArcgisReferenceElement } from "../types.js";
+import type { UtilityNetworkTraceResultItemState } from "../arcgis-utility-network-trace-analysis/types.js";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
 
 /**
@@ -63,7 +64,14 @@ export abstract class ArcgisUtilityNetworkTraceElementsResultItem extends LitEle
    *
    * @default false
    */
-  accessor disableHighlightFeatureResults: boolean;
+  accessor disableHighlight: boolean;
+  /**
+   * Whether the component emits event [@arcgisResultReady](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/#event-arcgisResultReady).
+   * This property is always `true` for [arcgis-utility-network-trace-elements-result-item](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/).
+   *
+   * @default false
+   */
+  get emitsArcgisResultReady(): true;
   /** The features corresponding to the trace result elements. */
   get features(): Graphic[];
   /** The heading of the result item. */
@@ -115,10 +123,10 @@ export abstract class ArcgisUtilityNetworkTraceElementsResultItem extends LitEle
    */
   get isFeaturesListShown(): boolean;
   /**
-   * The map layers to derive utility network layers from.
+   * The utility network layers used to query trace result features.
    *
-   * These layers are filtered by those belonging to the specified utility network.
-   * The utility network layers are used for querying the trace result features.
+   * If none are provided, the component uses all layers in the map belonging to
+   * the specified [utilityNetwork](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/#utilityNetwork).
    */
   accessor layers: Layer[];
   /**
@@ -153,9 +161,9 @@ export abstract class ArcgisUtilityNetworkTraceElementsResultItem extends LitEle
   /**
    * Whether the component has finished querying trace result features.
    *
-   * @default "loading"
+   * @default "ready"
    */
-  accessor state: State;
+  get state(): UtilityNetworkTraceResultItemState;
   /**
    * The trace result containing the element results to render features for.
    *
@@ -173,7 +181,10 @@ export abstract class ArcgisUtilityNetworkTraceElementsResultItem extends LitEle
    * > **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-elements-result-item component will be associated with a map or scene component rather than using the `view` property.
    */
   accessor view: MapView | undefined;
-  /** Destroys the `arcgis-features-next` component used to render the trace result features. */
+  /**
+   * Cancels any feature queries in progress, removes feature highlights from the map,
+   * and clears [features](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/#features).
+   */
   clearResult(): void;
   /** Permanently destroy the component. */
   destroy(): Promise<void>;
@@ -187,7 +198,4 @@ export abstract class ArcgisUtilityNetworkTraceElementsResultItem extends LitEle
     arcgisResultReady: ArcgisUtilityNetworkTraceElementsResultItem["arcgisResultReady"]["detail"];
     arcgisTriggerAction: ArcgisUtilityNetworkTraceElementsResultItem["arcgisTriggerAction"]["detail"];
   };
-}
-
-/** @internal */
-export type State = "loading" | "ready";
+}