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

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

@@ -1,175 +1,189 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import { c as F } from "../../chunks/runtime.js";
-import { ref as w } from "lit/directives/ref.js";
-import { getOrCreateMapValue as f } from "@arcgis/core/applications/Components/featureUtils.js";
-import { LitElement as R, createEvent as y } from "@arcgis/lumina";
-import { usePropertyChange as b, bypassReadOnly as g } from "@arcgis/lumina/controllers";
-import { log as n, composeMissingPropertyMessage as c } from "@arcgis/toolkit/log";
-import { css as E, html as d } from "lit";
-import { u as L } from "../../chunks/useT9n.js";
-import { l as I } from "../../chunks/async-utils.js";
-import { q as S, c as p, d as v } from "../../chunks/layer-utils.js";
-const $ = E`arcgis-features-next{height:100%}.elements-list-item{border:solid 1px var(--calcite-color-border-3);border-radius:var(--calcite-corner-radius-sm);margin:0 var(--calcite-spacing-sm)}.features-hidden{margin:var(--calcite-spacing-md);color:var(--calcite-color-text-3);font-size:var(--calcite-font-size)}`;
-class A extends R {
+import { c as R } from "../../chunks/runtime.js";
+import { ref as b } from "lit/directives/ref.js";
+import { getOrCreateMapValue as E } from "@arcgis/core/applications/Components/featureUtils.js";
+import { LitElement as L, createEvent as m } from "@arcgis/lumina";
+import { usePropertyChange as T, bypassReadOnly as h } from "@arcgis/lumina/controllers";
+import { log as d, composeMissingPropertyMessage as g } from "@arcgis/toolkit/log";
+import { css as v, html as y } from "lit";
+import { u as A } from "../../chunks/useT9n.js";
+import { i as p, l as w, t as u, c as I } from "../../chunks/async-utils.js";
+import { c as $, q as S, d as F, e as P } from "../../chunks/layer-utils.js";
+const D = v`arcgis-features-next{height:100%}.elements-list-item{border:solid 1px var(--calcite-color-border-3);border-radius:var(--calcite-corner-radius-sm)}.features-hidden{color:var(--calcite-color-text-3);font-size:var(--calcite-font-size);overflow-wrap:anywhere}`;
+class k extends L {
   constructor() {
-    super(...arguments), this._messages = L({ blocking: !0 }), this.#l = !0, this.#e = [], this.#t = [], this.#s = /* @__PURE__ */ new Map(), this.#n = /* @__PURE__ */ new Map(), this.#i = /* @__PURE__ */ new Map(), this.#r = /* @__PURE__ */ new Map(), this.#a = [], this._isFeaturesSelected = !1, this.autoDestroyDisabled = !1, this.disableHighlightFeatureResults = !1, this.features = [], this.hideActionBar = !1, this.hideFeatureResults = !1, this.hidePlaceholder = !1, this.includeDefaultActionsDisabled = !1, this.layers = [], this.state = "loading", this.arcgisPropertyChange = b()("isFeaturesListShown", "selectedResultFeature", "state"), this.arcgisTriggerAction = y(), this.arcgisResultReady = y();
+    super(...arguments), this._messages = A({ blocking: !0 }), this.#n = !0, this.#s = [], this.#i = [], this.#r = /* @__PURE__ */ new Map(), this.#a = /* @__PURE__ */ new Map(), this.#l = /* @__PURE__ */ new Map(), this.#o = /* @__PURE__ */ new Map(), this.#e = [], this._isFeaturesSelected = !1, this.autoDestroyDisabled = !1, this.disableHighlight = !1, this.emitsArcgisResultReady = !0, this.features = [], this.hideActionBar = !1, this.hideFeatureResults = !1, this.hidePlaceholder = !1, this.includeDefaultActionsDisabled = !1, this.layers = [], this.state = "ready", this.arcgisPropertyChange = T()("isFeaturesListShown", "selectedResultFeature", "state"), this.arcgisTriggerAction = m(), this.arcgisResultReady = m();
   }
   static {
-    this.properties = { _featuresComponentElement: 16, _isFeaturesSelected: 16, actions: 0, autoDestroyDisabled: 5, disableHighlightFeatureResults: 5, features: 32, heading: 1, hideActionBar: 5, hideFeatureResults: 5, hidePlaceholder: 5, includeDefaultActionsDisabled: 5, isFeaturesListShown: 32, layers: 0, messageOverrides: 0, numResults: 32, referenceElement: 1, selectedResultFeature: 32, state: 1, traceResult: 0, utilityNetwork: 0, view: 0 };
+    this.properties = { _featuresComponentElement: 16, _isFeaturesSelected: 16, actions: 0, autoDestroyDisabled: 5, disableHighlight: 5, emitsArcgisResultReady: 32, features: 32, heading: 1, hideActionBar: 5, hideFeatureResults: 5, hidePlaceholder: 5, includeDefaultActionsDisabled: 5, isFeaturesListShown: 32, layers: 0, messageOverrides: 0, numResults: 32, referenceElement: 1, selectedResultFeature: 32, state: 32, traceResult: 0, utilityNetwork: 0, view: 0 };
   }
   static {
-    this.styles = $;
+    this.styles = D;
   }
-  #l;
-  #e;
-  get #o() {
+  #n;
+  #s;
+  get #h() {
     if (!this.traceResult)
       return !1;
-    const { elements: e, globalFunctionResults: t, aggregatedGeometry: r } = this.traceResult;
-    return e.length > 0 && !t.length && !r;
+    const { elements: e, globalFunctionResults: t, aggregatedGeometry: s } = this.traceResult;
+    return e.length > 0 && !t.length && !s;
   }
-  #t;
-  #s;
-  #n;
   #i;
   #r;
   #a;
+  #t;
+  #l;
+  #o;
+  #e;
   get isFeaturesListShown() {
-    return (this._isFeaturesSelected || this.#o) && !this.hideFeatureResults && !this._featuresComponentElement?.manager?.destroyed;
+    return (this._isFeaturesSelected || this.#h) && !this.hideFeatureResults;
   }
   get numResults() {
-    return this.features.length + this.#e.length;
+    return this.features.length + this.#s.length;
   }
   get selectedResultFeature() {
     return this._featuresComponentElement?.selectedDrillInFeature ?? this._featuresComponentElement?.selectedFeature ?? void 0;
   }
   clearResult() {
-    this._featuresComponentElement?.destroy(), this.#u(), g(() => this.features = []), this.#e = [], this.#s.clear(), this.#n.clear(), this.#i.clear(), this.#r.clear();
+    this._isFeaturesSelected = !1, this.#t?.abort(), this.#c(), h(() => this.features = []), this.#e = [], this.#s = [], this.#r.clear(), this.#a.clear(), this.#l.clear(), this.#o.clear(), h(() => this.state = "ready");
   }
   async destroy() {
-    this.clearResult(), await this.manager.destroy();
+    this.clearResult(), this._featuresComponentElement?.destroy(), await this.manager.destroy();
   }
   load() {
-    const e = this.traceResult?.elements, t = () => {
-      this.arcgisResultReady.emit(), this.state = "ready";
-    };
-    if (!e?.length) {
-      t();
-      return;
-    }
-    this.#p(e), this.#f().then(() => this.#g()).then(() => {
-      this.disableHighlightFeatureResults || this.#m();
-    }).finally(t);
-  }
-  loaded() {
-    this.traceResult ? this.traceResult.elements || n("error", this, c("traceResult.elements")) : n("error", this, c("traceResult")), this.utilityNetwork || n("error", this, c("utilityNetwork"));
+    this.traceResult && this.#u();
   }
   willUpdate(e) {
-    e.has("_isFeaturesSelected") && (this.#o || (e.get("_isFeaturesSelected") ?? !1)) !== this.isFeaturesListShown && this.arcgisPropertyChange.emit({ name: "isFeaturesListShown" });
+    e.has("traceResult") && this.#u(), e.has("_isFeaturesSelected") && (this.#h || (e.get("_isFeaturesSelected") ?? !1)) !== this.isFeaturesListShown && this.arcgisPropertyChange.emit({ name: "isFeaturesListShown" });
   }
-  #u() {
-    this.#t.forEach((e) => e.remove()), this.#t = [];
+  loaded() {
+    this.traceResult && (this.traceResult.elements || d("error", this, g("traceResult.elements")), this.utilityNetwork || d("error", this, g("utilityNetwork")));
   }
-  #h(e) {
+  #c() {
+    this.#i.forEach((e) => e.remove()), this.#i = [];
+  }
+  #d(e) {
     e && (this._featuresComponentElement = e);
   }
-  #c(e) {
+  #f(e) {
     return Array.from(new Map(e.map((t) => [t.globalId, t])).values());
   }
-  #d(e) {
-    if (e == null)
-      return;
-    const t = this.#n, r = this.#a, a = t.get(e);
-    if (a)
-      return a;
-    if (!r)
+  #y(e) {
+    if (e == null || !this.#e.length)
       return;
-    const s = r.find((i) => "layerId" in i && i.layerId === e);
-    return s && t.set(e, s), s;
+    const t = this.#a.get(e);
+    if (t)
+      return t;
+    const s = this.#e.find((r) => "layerId" in r && r.layerId === e);
+    return s && this.#a.set(e, s), s;
   }
   #m() {
-    const { traceResult: e, utilityNetwork: t, view: r } = this;
-    if (!t || !e?.elements?.length || !r)
+    const { traceResult: e, utilityNetwork: t, view: s } = this;
+    if (!t || !e?.elements?.length || !s)
       return;
-    const a = (o) => (v(o.layer) || p(o.layer)) && t.isUtilityLayer(o.layer), s = t.getObjectIdsFromElements(e.elements), i = r.allLayerViews.filter(a);
-    s.forEach(({ layerUrl: o, objectIds: l }) => {
-      const u = Number(o.split("/").pop()), m = i.find(({ layer: h }) => h.layerId === u);
-      if (m) {
-        const h = m.highlight(l);
-        this.#t.push(h);
+    const r = (i) => (P(i.layer) || F(i.layer)) && t.isUtilityLayer(i.layer), o = t.getObjectIdsFromElements(e.elements), n = s.allLayerViews.filter(r);
+    o.forEach(({ layerUrl: i, objectIds: l }) => {
+      const a = Number(i.split("/").pop()), c = n.find(({ layer: f }) => f.layerId === a);
+      if (c) {
+        const f = c.highlight(l);
+        this.#i.push(f);
       }
     });
   }
-  async #f() {
-    const { layers: e, utilityNetwork: t } = this;
-    if (!t)
+  async #g(e) {
+    const { layers: t, utilityNetwork: s, view: r } = this;
+    if (!r || !s)
       return;
     try {
-      t.loaded || (this.state = "loading", await t.load());
+      s.loaded || await s.load({ signal: e });
+    } catch (i) {
+      if (p(i))
+        throw i;
+      w(i, this, "Error while loading the selected utility network");
+    }
+    u(e), this.#e = t.length ? t.filter((i) => s.isUtilityLayer(i)) : $(r, s);
+    const n = this.#e.filter((i) => !i.loaded).map((i) => i.load({ signal: e }));
+    if (n.length > 0) {
+      const i = await Promise.allSettled(n);
+      u(e), i.forEach((l) => {
+        l.status === "rejected" && d("error", this, `Failed to load layer. Reason: ${l.reason}`);
+      });
+    }
+  }
+  async #u() {
+    this.clearResult();
+    const e = () => {
+      h(() => this.state = "ready"), this.arcgisResultReady.emit();
+    }, t = I(async (s) => {
+      const r = this.traceResult?.elements;
+      if (!r?.length) {
+        e();
+        return;
+      }
+      h(() => this.state = "loading"), this.#F(r), await this.#g(s), await this.#w(s), u(s), this.disableHighlight || this.#m(), e();
+    });
+    this.#t = t;
+    try {
+      await t.promise;
     } catch (s) {
-      I(s, this, "Error while loading the selected utility network");
+      p(s) || (w(s, this, "Error while loading trace result"), this.#t === t && e());
+    } finally {
+      this.#t === t && (this.#t = void 0, h(() => this.state = "ready"));
     }
-    this.#a = e.filter((s) => t.isUtilityLayer(s));
-    const a = this.#a.filter((s) => !s.loaded).map((s) => s.load());
-    a.length > 0 && (this.state = "loading", (await Promise.allSettled(a)).forEach((i) => {
-      i.status === "rejected" && n("error", this, `Failed to load layer. Reason: ${i.reason}`);
-    }));
-  }
-  async #y([e, t]) {
-    const r = this.utilityNetwork?.getLayerIdBySourceId(e), a = this.#d(r), s = this.#c(t);
-    if (r == null || !a) {
-      this.#e.push(...s);
+  }
+  async #p([e, t], s) {
+    u(s);
+    const r = this.utilityNetwork?.getLayerIdBySourceId(e), o = this.#y(r), n = this.#f(t);
+    if (r == null || !o) {
+      this.#s.push(...n);
       return;
     }
-    const i = a.createQuery();
-    i.gdbVersion = this.utilityNetwork?.gdbVersion, i.objectIds = s.map((l) => l.objectId), i.outFields = ["*"];
-    const { features: o } = await S(a, i);
-    o.forEach((l) => {
-      const u = l.layer;
-      l.getEffectivePopupTemplate(this.#l) || (l.popupTemplate = u.createPopupTemplate());
-    }), p(a) ? o.forEach((l) => {
-      f(this.#i, l.layer.subtypeCode, () => []).push(l);
-    }) : this.#s.set(r, o);
-  }
-  async #g() {
-    const e = Array.from(this.#r.entries());
-    if (!e.length)
+    const i = o.createQuery();
+    i.gdbVersion = this.utilityNetwork?.gdbVersion, i.objectIds = n.map((a) => a.objectId), i.outFields = ["*"];
+    const { features: l } = await S(o, i, { signal: s });
+    u(s), l.forEach((a) => {
+      const c = a.layer;
+      a.getEffectivePopupTemplate(this.#n) || (a.popupTemplate = c.createPopupTemplate());
+    }), F(o) ? l.forEach((a) => {
+      E(this.#l, a.layer.subtypeCode, () => []).push(a);
+    }) : this.#r.set(r, l);
+  }
+  async #w(e) {
+    const t = Array.from(this.#o.entries());
+    if (!t.length)
       return;
-    this.state = "loading";
-    const t = e.map((i) => this.#y(i));
-    (await Promise.allSettled(t)).forEach((i, o) => {
+    const s = t.map((i) => this.#p(i, e)), r = await Promise.allSettled(s);
+    u(e), r.forEach((i, l) => {
       if (i.status === "rejected") {
-        const [l] = e[o];
-        n("error", this, `Failed to query features for source ${l}. Reason: ${i.reason}`);
+        const [a] = t[l];
+        d("error", this, `Failed to query features for source ${a}. Reason: ${i.reason}`);
       }
     });
-    const a = Array.from(this.#s.values()), s = Array.from(this.#i.values());
-    g(() => this.features = a.concat(s).flat());
-  }
-  #p(e) {
-    e.forEach((t) => {
-      f(this.#r, t.networkSourceId, () => []).push(t);
-    });
+    const o = Array.from(this.#r.values()), n = Array.from(this.#l.values());
+    h(() => this.features = o.concat(n).flat());
   }
   #F(e) {
+    this.#o = Map.groupBy(e, ({ networkSourceId: t }) => t);
+  }
+  #R(e) {
     const { detail: t } = e;
     (t.name === "selectedDrillInFeature" || t.name === "selectedFeature") && (e.stopPropagation(), this.arcgisPropertyChange.emit({ name: "selectedResultFeature" }));
   }
-  #w(e) {
+  #b(e) {
     e.stopPropagation(), this.arcgisTriggerAction.emit(e.detail);
   }
-  #R() {
-    return d`<div class="features-hidden">${this._messages.resultFeaturesAreHidden}</div>`;
+  #E() {
+    return y`<div class="features-hidden">${this._messages.resultFeaturesAreHidden}</div>`;
   }
-  #b() {
+  #L() {
     const { heading: e, _messages: t } = this;
-    return d`<calcite-list .label=${t.headings.features}><calcite-list-item class="elements-list-item" .label=${e || t.headings.features} @calciteListItemSelect=${() => this._isFeaturesSelected = !0}><calcite-chip .label=${t.labels.numFeatures} scale=s slot=content-end>${this.numResults}</calcite-chip><calcite-icon icon=chevron-right slot=content-end></calcite-icon></calcite-list-item></calcite-list>`;
+    return y`<calcite-list .label=${t.headings.features}><calcite-list-item class="elements-list-item" .label=${e || t.headings.features} @calciteListItemSelect=${() => this._isFeaturesSelected = !0}><calcite-chip .label=${t.labels.numFeatures} scale=s slot=content-end>${this.numResults}</calcite-chip><calcite-icon icon=chevron-right slot=content-end></calcite-icon></calcite-list-item></calcite-list>`;
   }
   render() {
-    return this.state === "loading" ? null : this.hideFeatureResults ? this.hidePlaceholder ? null : this.#R() : this.isFeaturesListShown ? d`<arcgis-features-next .actions=${this.actions} .autoDestroyDisabled=${this.autoDestroyDisabled} .defaultPopupTemplateEnabled=${this.#l} .features=${this.features} .hideActionBar=${this.hideActionBar} .hideCloseButton=${this.#o} hide-select-feature .includeDefaultActionsDisabled=${this.includeDefaultActionsDisabled} initial-display-mode=list .messageOverrides=${this.messageOverrides} open .referenceElement=${this.referenceElement} .view=${this.view} @arcgisClose=${() => this._isFeaturesSelected = !1} @arcgisPropertyChange=${this.#F} @arcgisTriggerAction=${this.#w} ${w(this.#h)}></arcgis-features-next>` : this.#b();
+    return !this.traceResult?.elements.length || this.manager.destroyed ? null : this.hideFeatureResults ? this.hidePlaceholder ? null : this.#E() : this.isFeaturesListShown ? y`<arcgis-features-next .actions=${this.actions} .autoDestroyDisabled=${this.autoDestroyDisabled} .defaultPopupTemplateEnabled=${this.#n} .features=${this.features} .hideActionBar=${this.hideActionBar} .hideCloseButton=${this.#h} hide-select-feature .includeDefaultActionsDisabled=${this.includeDefaultActionsDisabled} initial-display-mode=list .messageOverrides=${this.messageOverrides} open .referenceElement=${this.referenceElement} .view=${this.view} @arcgisClose=${() => this._isFeaturesSelected = !1} @arcgisPropertyChange=${this.#R} @arcgisTriggerAction=${this.#b} ${b(this.#d)}></arcgis-features-next>` : this.#L();
   }
 }
-F("arcgis-utility-network-trace-elements-result-item", A);
+R("arcgis-utility-network-trace-elements-result-item", k);
 export {
-  A as ArcgisUtilityNetworkTraceElementsResultItem
+  k as ArcgisUtilityNetworkTraceElementsResultItem
 };

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

@@ -1,6 +1,7 @@
 /// <reference path="../../index.d.ts" />
 import type TraceResult from "@arcgis/core/rest/networks/support/TraceResult.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
+import type { UtilityNetworkTraceResultItemState } from "../arcgis-utility-network-trace-analysis/types.js";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
 
 /**
@@ -19,12 +20,40 @@ export abstract class ArcgisUtilityNetworkTraceFunctionsResultItem extends LitEl
       componentLabel: string;
       labels: { functionResults: string; };
   }>;
+  /**
+   * Whether the component emits event [@arcgisResultReady](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-functions-result-item/#event-arcgisResultReady).
+   * This property is always `true` for [arcgis-utility-network-trace-functions-result-item](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-functions-result-item/).
+   *
+   * @default false
+   */
+  get emitsArcgisResultReady(): true;
   /** The heading displayed above the result item. */
   accessor heading: string | undefined;
+  /**
+   * @default "ready"
+   * @internal
+   */
+  get state(): UtilityNetworkTraceResultItemState;
   /**
    * The trace result containing the function results to render.
    *
    * @required
    */
   accessor traceResult: TraceResult | undefined;
+  /**
+   * Clears the result item.
+   * This result item has no side effects to clear.
+   *
+   * @internal
+   */
+  clearResult(): void;
+  /** Permanently destroy the component. */
+  destroy(): Promise<void>;
+  readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "state"; }>;
+  /** Fires when the component is finished rendering its results. */
+  readonly arcgisResultReady: import("@arcgis/lumina").TargetedEvent<this, void>;
+  readonly "@eventTypes": {
+    arcgisPropertyChange: ArcgisUtilityNetworkTraceFunctionsResultItem["arcgisPropertyChange"]["detail"];
+    arcgisResultReady: ArcgisUtilityNetworkTraceFunctionsResultItem["arcgisResultReady"]["detail"];
+  };
 }

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

@@ -1,34 +1,48 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import { c as m } from "../../chunks/runtime.js";
-import { css as g, html as e } from "lit";
-import { LitElement as b } from "@arcgis/lumina";
-import { log as l, composeMissingPropertyMessage as p, composeEmptyPropertyMessage as h } from "@arcgis/toolkit/log";
-import { u as f } from "../../chunks/useT9n.js";
-const d = g`calcite-table{--calcite-table-border-color: none}calcite-table-row{--calcite-table-row-border-color: var(--calcite-color-border-3)}.functions-heading{margin:var(--calcite-spacing-md) var(--calcite-spacing-md) var(--calcite-spacing-xxs);font-weight:var(--calcite-font-weight-medium);font-size:var(--calcite-font-size);color:var(--calcite-color-text-1)}`;
-class w extends b {
+import { c as u } from "../../chunks/runtime.js";
+import { LitElement as m, createEvent as h } from "@arcgis/lumina";
+import { usePropertyChange as g, bypassReadOnly as d } from "@arcgis/lumina/controllers";
+import { log as b, composeEmptyPropertyMessage as R } from "@arcgis/toolkit/log";
+import { css as f, html as s } from "lit";
+import { u as p } from "../../chunks/useT9n.js";
+const y = f`calcite-table{--calcite-table-border-color: none}calcite-table-row{--calcite-table-row-border-color: var(--calcite-color-border-3)}.functions-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 w extends m {
   constructor() {
-    super(...arguments), this._messages = f({ blocking: !0 });
+    super(...arguments), this._messages = p({ blocking: !0 }), this.emitsArcgisResultReady = !0, this.state = "ready", this.arcgisPropertyChange = g()("state"), this.arcgisResultReady = h();
   }
   static {
-    this.properties = { heading: 1, traceResult: 0 };
+    this.properties = { emitsArcgisResultReady: 32, heading: 1, state: 32, traceResult: 0 };
   }
   static {
-    this.styles = d;
+    this.styles = y;
+  }
+  clearResult() {
+  }
+  async destroy() {
+  }
+  load() {
+    this.traceResult && this.#t();
+  }
+  willUpdate(e) {
+    e.has("traceResult") && this.#t();
   }
   loaded() {
-    this.traceResult ? this.traceResult.globalFunctionResults.length || l("warn", this, h("traceResult")) : l("warn", this, p("traceResult"));
+    this.traceResult && !this.traceResult.globalFunctionResults.length && b("warn", this, R("traceResult.globalFunctionResults"));
+  }
+  #t() {
+    d(() => this.state = "ready"), this.arcgisResultReady.emit();
   }
   render() {
     if (!this.traceResult?.globalFunctionResults.length)
-      return;
-    const { heading: c, _messages: s } = this, { globalFunctionResults: i } = this.traceResult;
-    return e`${c && e`<div class="functions-heading">${c}</div>` || ""}<calcite-table .caption=${s.labels.functionResults}>${i.filter((t) => t.networkAttributeName != null && t.result != null && t.functionType != null).map((t) => {
-      const { functionName: a, networkAttributeName: r, functionType: o, result: n } = t, u = a || `${r} ${o}`;
-      return e`<calcite-table-row><calcite-table-cell>${u}</calcite-table-cell><calcite-table-cell>${n}</calcite-table-cell></calcite-table-row>`;
+      return null;
+    const { heading: e, _messages: l } = this, { globalFunctionResults: a } = this.traceResult;
+    return s`${e && s`<div class="functions-heading">${e}</div>` || ""}<calcite-table .caption=${l.labels.functionResults}>${a.filter((t) => t.networkAttributeName != null && t.result != null && t.functionType != null).map((t) => {
+      const { functionName: i, networkAttributeName: c, functionType: r, result: o } = t, n = i || `${c} ${r}`;
+      return s`<calcite-table-row><calcite-table-cell>${n}</calcite-table-cell><calcite-table-cell>${o}</calcite-table-cell></calcite-table-row>`;
     })}</calcite-table>`;
   }
 }
-m("arcgis-utility-network-trace-functions-result-item", w);
+u("arcgis-utility-network-trace-functions-result-item", w);
 export {
   w as ArcgisUtilityNetworkTraceFunctionsResultItem
 };

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

@@ -14,7 +14,7 @@ import B from "@arcgis/core/widgets/Sketch/SketchViewModel.js";
 import { LitElement as N, createEvent as S } from "@arcgis/lumina";
 import { log as u, composeMissingPropertyMessage as b } from "@arcgis/toolkit/log";
 import { u as q } from "../../chunks/useT9n.js";
-import { a as D, c as j, d as G, i as H } from "../../chunks/layer-utils.js";
+import { a as D, d as j, e as G, i as H } from "../../chunks/layer-utils.js";
 import { css as O, html as p } from "lit";
 import v from "@arcgis/core/views/interactive/snapping/FeatureSnappingLayerSource.js";
 import { substitute as U } from "@arcgis/core/intl.js";

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

@@ -10,12 +10,15 @@ 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 { ArcgisUtilityNetworkTraceElementsResultItem } from "../arcgis-utility-network-trace-elements-result-item/customElement.js";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
 
 /**
  * This is a sub-component used by the **ArcgisUtilityNetworkTraceAnalysis** component.
  * It displays a subset of trace result types.
  *
+ * @slot  - Default slot for adding trace result items or custom content to the component.
  * @since 4.34
  * @internal
  */
@@ -33,6 +36,7 @@ export abstract class ArcgisUtilityNetworkTraceResults extends LitElement {
           functionResults: string;
           numFeatures: string;
       };
+      noMatchingResultItems: string;
       noResultsDescription: string;
       noResultsHeading: string;
       noSelectableFeatures: string;
@@ -58,6 +62,7 @@ export abstract class ArcgisUtilityNetworkTraceResults extends LitElement {
           functionResults: string;
           numFeatures: string;
       };
+      noMatchingResultItems: string;
       noResultsDescription: string;
       noResultsHeading: string;
       noSelectableFeatures: string;
@@ -82,6 +87,14 @@ export abstract class ArcgisUtilityNetworkTraceResults extends LitElement {
    * @see [Popup actions sample](https://developers.arcgis.com/javascript/latest/sample-code/popup-actions/)
    */
   accessor actions: ArcgisFeaturesNext["actions"] | undefined;
+  /**
+   * The color used to render graphics for aggregated geometries in trace results, specified as a
+   * [Color](https://developers.arcgis.com/javascript/latest/references/core/Color/) object.
+   *
+   * Aggregated geometry is only rendered if the trace configuration specifies aggregated geometry as a result type.
+   *
+   * Default color is #FFFF00.
+   */
   accessor aggregatedGeometryGraphicsColor: Color;
   /**
    * If true, the component will not be destroyed automatically when it is
@@ -109,13 +122,36 @@ export abstract class ArcgisUtilityNetworkTraceResults extends LitElement {
    * @default false
    */
   accessor disableHighlightFeatureResults: boolean;
+  /**
+   * When `true`, the component can be expanded and collapsed.
+   *
+   * @default false
+   */
+  accessor expandable: boolean;
+  /**
+   * When `true`, expands the component and its contents.
+   *
+   * @default false
+   */
+  accessor expanded: boolean;
+  /** Specifies the component's heading text. */
   accessor heading: string | undefined;
   /**
+   * Indicates whether to hide the action bar that holds the feature's
+   * [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;
-  /** @default false */
+  /**
+   * Whether to hide feature results.
+   *
+   * A message will be displayed in its place indicating that features were returned by the trace, but are not visible in the component.
+   * This string can be overridden with the [messageOverrides](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results/#messageOverrides) property.
+   *
+   * @default false
+   */
   accessor hideFeatureResults: boolean;
   /**
    * Whether to hide the aggregated geometry [graphics](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-aggregated-geometry-result-item/#geometryGraphics)
@@ -141,13 +177,14 @@ export abstract class ArcgisUtilityNetworkTraceResults extends LitElement {
    * @default false
    */
   accessor includeDefaultActionsDisabled: boolean;
+  /** The layers and tables used to query trace result features. */
   accessor layers: Layer[];
   /**
    * Replace localized message strings with your own strings.
    *
    * _**Note**: Individual message keys may change between releases._
    */
-  accessor messageOverrides: {
+  accessor messageOverrides: NonNullable<ArcgisUtilityNetworkTraceElementsResultItem["messageOverrides"]> & {
       gettingResults?: string | undefined;
       headings?: {
           aggregatedGeometry?: string | undefined;
@@ -159,6 +196,7 @@ export abstract class ArcgisUtilityNetworkTraceResults extends LitElement {
           functionResults?: string | undefined;
           numFeatures?: string | undefined;
       } | undefined;
+      noMatchingResultItems?: string | undefined;
       noResultsDescription?: string | undefined;
       noResultsHeading?: string | undefined;
       noSelectableFeatures?: string | undefined;
@@ -174,11 +212,11 @@ export abstract class ArcgisUtilityNetworkTraceResults extends LitElement {
       traceFailedHeading?: string | undefined;
   };
   /**
-   * The number of unique network element results,
-   * including elements that did not match any layer in the map.
+   * The number of unique network element results, including elements that did not match any layer in the map.
    *
-   * TODO: We can remove this after we allow the result items to be rendered declaratively
-   *  as children of the trace results component.
+   * If multiple slotted instances [arcgis-utility-network-trace-elements-result-item](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/) exist,
+   * this property returns the [number of feature results](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/#numResults)
+   * for the first instance.
    */
   get numFeatureResults(): number;
   /**
@@ -187,11 +225,23 @@ export abstract class ArcgisUtilityNetworkTraceResults 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;
-  /** @default "loading" */
-  accessor state: State;
+  /**
+   * The current state of the trace results component.
+   *
+   * @default "ready"
+   */
+  get state(): UtilityNetworkTraceResultItemState;
+  /** The error returned when the trace could not be completed. */
   accessor traceError: EsriError<TraceErrorDetails> | undefined;
+  /** The trace result to display. */
   accessor traceResult: TraceResult | undefined;
+  /**
+   * The features corresponding to the
+   * [https://developers.arcgis.com/javascript/latest/references/core/rest/networks/support/TraceResult/#elements](https://developers.arcgis.com/javascript/latest/references/core/rest/networks/support/TraceResult/#elements)
+   * returned by the trace result.
+   */
   get traceResultFeatures(): Graphic[];
+  /** The utility network used to query trace result features. */
   accessor utilityNetwork: UtilityNetwork | undefined;
   /**
    * The view associated with the component.
@@ -203,19 +253,18 @@ export abstract class ArcgisUtilityNetworkTraceResults extends LitElement {
   destroy(): Promise<void>;
   /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
   readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "aggregatedGeometryGraphicsColor" | "hideGraphics" | "state" | "traceError"; }>;
-  readonly arcgisTraceResultFeaturesReady: import("@arcgis/lumina").TargetedEvent<this, void>;
+  readonly arcgisResultsReady: import("@arcgis/lumina").TargetedEvent<this, void>;
+  readonly arcgisTraceResultClear: import("@arcgis/lumina").TargetedEvent<this, void>;
   /** Emitted when an action is triggered on the component. */
   readonly arcgisTriggerAction: import("@arcgis/lumina").TargetedEvent<this, ActionEvent>;
   readonly "@eventTypes": {
     arcgisPropertyChange: ArcgisUtilityNetworkTraceResults["arcgisPropertyChange"]["detail"];
-    arcgisTraceResultFeaturesReady: ArcgisUtilityNetworkTraceResults["arcgisTraceResultFeaturesReady"]["detail"];
+    arcgisResultsReady: ArcgisUtilityNetworkTraceResults["arcgisResultsReady"]["detail"];
+    arcgisTraceResultClear: ArcgisUtilityNetworkTraceResults["arcgisTraceResultClear"]["detail"];
     arcgisTriggerAction: ArcgisUtilityNetworkTraceResults["arcgisTriggerAction"]["detail"];
   };
 }
 
-/** @internal */
-export type State = "loading" | "ready";
-
 /** @internal */
 export interface TraceErrorDetails {
   url?: string;