@arcgis/map-components 5.2.0-next.137 → 5.2.0-next.139

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

@@ -14,7 +14,6 @@ import type { T9nMeta } from "@arcgis/lumina/controllers";
 /**
  * Trace result item for displaying [element](https://developers.arcgis.com/javascript/latest/references/core/rest/networks/support/TraceResult/#elements) results from a trace.
  *
- * @internal
  * @since 5.2
  * @see [Result types](https://doc.esri.com/en/arcgis-pro/latest/help/data/utility-network/configure-a-trace.html#DA5)
  */
@@ -115,9 +114,9 @@ export abstract class ArcgisUtilityNetworkTraceElementsResultItem extends LitEle
    *
    * This property is always false when [hideFeatureResults](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/#hideFeatureResults) is true.
    *
-   * If [hideFeatureResults](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/#hideFeatureResults) is not set, then this property is true when
-   * the trace result only includes [elements](https://developers.arcgis.com/javascript/latest/references/core/rest/networks/support/TraceResult/#elements)
-   * or when the user has chosen to view Feature results in the trace component results tab.
+   * If [hideFeatureResults](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/#hideFeatureResults) is not set, the list opens automatically when
+   * a trace result containing only [elements](https://developers.arcgis.com/javascript/latest/references/core/rest/networks/support/TraceResult/#elements) loads,
+   * or when the user chooses to view Feature results. Closing the list sets this property to false.
    *
    * @default false
    */
@@ -164,23 +163,15 @@ export abstract class ArcgisUtilityNetworkTraceElementsResultItem extends LitEle
    * @default "ready"
    */
   get state(): UtilityNetworkTraceResultItemState;
-  /**
-   * The trace result containing the element results to render features for.
-   *
-   * @required
-   */
-  accessor traceResult: TraceResult | undefined;
-  /**
-   * The utility network used to query the trace result features.
-   *
-   * @required
-   */
-  accessor utilityNetwork: UtilityNetwork | undefined;
+  /** The trace result containing the element results to render features for. */
+  get traceResult(): TraceResult | undefined;
+  /** The utility network used to query the trace result features. */
+  get utilityNetwork(): UtilityNetwork | undefined;
   /**
    * 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-elements-result-item component will be associated with a map or scene component rather than using the `view` property.
    */
-  accessor view: MapView | undefined;
+  get view(): MapView | undefined;
   /**
    * 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).
@@ -188,7 +179,8 @@ export abstract class ArcgisUtilityNetworkTraceElementsResultItem extends LitEle
   clearResult(): void;
   /** Permanently destroy the component. */
   destroy(): Promise<void>;
-  readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "isFeaturesListShown" | "selectedResultFeature" | "state"; }>;
+  /** 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: "features" | "isFeaturesListShown" | "selectedResultFeature" | "state"; }>;
   /** Fires when the component finishes querying all features for the trace result elements. */
   readonly arcgisResultReady: import("@arcgis/lumina").TargetedEvent<this, void>;
   /** Emitted when an action is triggered on the component. */

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

@@ -1,74 +1,119 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-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 {
+import { c as F } from "../../chunks/runtime.js";
+import { ref as E } from "lit/directives/ref.js";
+import { getOrCreateMapValue as v } from "@arcgis/core/applications/Components/featureUtils.js";
+import { LitElement as L, createEvent as f } from "@arcgis/lumina";
+import { usePropertyChange as T, bypassReadOnly as o } from "@arcgis/lumina/controllers";
+import { log as d, composeMissingPropertyMessage as m } from "@arcgis/toolkit/log";
+import { css as k, html as y } from "lit";
+import { u as I } from "../../chunks/useT9n.js";
+import { i as g, l as p, t as c, c as A } from "../../chunks/async-utils.js";
+import { c as S, q as P, d as w, e as $ } from "../../chunks/layer-utils.js";
+import { i as R } from "../../chunks/utils5.js";
+const C = k`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 D extends L {
   constructor() {
-    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();
+    super(...arguments), this._messages = I({ blocking: !0 }), this.#n = !0, this.#i = [], this.#t = [], this.#r = /* @__PURE__ */ new Map(), this.#a = /* @__PURE__ */ new Map(), this.#h = !1, 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()("features", "isFeaturesListShown", "selectedResultFeature", "state"), this.arcgisResultReady = f(), this.arcgisTriggerAction = f();
   }
   static {
-    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 };
+    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: 32, utilityNetwork: 32, view: 32 };
   }
   static {
-    this.styles = D;
+    this.styles = C;
   }
   #n;
-  #s;
-  get #h() {
+  #i;
+  get #y() {
     if (!this.traceResult)
       return !1;
     const { elements: e, globalFunctionResults: t, aggregatedGeometry: s } = this.traceResult;
-    return e.length > 0 && !t.length && !s;
+    return e.length > 0 && !t?.length && !s;
   }
-  #i;
+  #t;
   #r;
   #a;
-  #t;
+  #s;
+  #h;
   #l;
   #o;
+  get #c() {
+    const { parentElement: e } = this.el;
+    if (e && R(e))
+      return e;
+    const t = this.el.getRootNode();
+    if (t instanceof ShadowRoot && R(t.host))
+      return t.host;
+  }
   #e;
   get isFeaturesListShown() {
-    return (this._isFeaturesSelected || this.#h) && !this.hideFeatureResults;
+    return this._isFeaturesSelected && !this.hideFeatureResults;
   }
   get numResults() {
-    return this.features.length + this.#s.length;
+    return this.features.length + this.#i.length;
   }
   get selectedResultFeature() {
     return this._featuresComponentElement?.selectedDrillInFeature ?? this._featuresComponentElement?.selectedFeature ?? void 0;
   }
   clearResult() {
-    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");
+    this._isFeaturesSelected = !1, this.#s?.abort(), this.#m(), o(() => this.features = []), this.#e = [], this.#i = [], this.#r.clear(), this.#a.clear(), this.#o.clear(), this.#l.clear(), o(() => this.state = "ready");
   }
   async destroy() {
-    this.clearResult(), this._featuresComponentElement?.destroy(), await this.manager.destroy();
+    this.clearResult(), await this.manager.destroy(), await this._featuresComponentElement?.destroy();
   }
   load() {
-    this.traceResult && this.#u();
+    this.manager.onLifecycle(() => {
+      const e = this.#c;
+      if (!e) {
+        d("warn", this, "This component must be used as a child of `arcgis-utility-network-trace-results`.");
+        return;
+      }
+      const t = (s) => this.#f(s);
+      return e.addEventListener("arcgisPropertyChange", t), o(() => {
+        this.traceResult = e.traceResult, this.utilityNetwork = e.utilityNetwork, this.view = e.view;
+      }), () => {
+        e.removeEventListener("arcgisPropertyChange", t);
+      };
+    }), this.traceResult && this.#d();
   }
   willUpdate(e) {
-    e.has("traceResult") && this.#u(), e.has("_isFeaturesSelected") && (this.#h || (e.get("_isFeaturesSelected") ?? !1)) !== this.isFeaturesListShown && this.arcgisPropertyChange.emit({ name: "isFeaturesListShown" });
+    e.has("traceResult") && this.#d(), e.has("disableHighlight") && this.#u();
+    const t = this.isFeaturesListShown;
+    t !== this.#h && this.arcgisPropertyChange.emit({ name: "isFeaturesListShown" }), this.#h = t;
   }
   loaded() {
-    this.traceResult && (this.traceResult.elements || d("error", this, g("traceResult.elements")), this.utilityNetwork || d("error", this, g("utilityNetwork")));
+    this.traceResult && (this.traceResult.elements || d("error", this, m("traceResult.elements")), this.utilityNetwork || d("error", this, m("utilityNetwork")));
+  }
+  #f(e) {
+    if (e.target !== this.#c)
+      return;
+    const { target: t } = e;
+    switch (e.detail.name) {
+      case "traceResult":
+        o(() => this.traceResult = t.traceResult);
+        break;
+      case "utilityNetwork":
+        o(() => this.utilityNetwork = t.utilityNetwork);
+        break;
+      case "view":
+        o(() => this.view = t.view);
+        break;
+    }
+  }
+  #m() {
+    this.#t.forEach(({ handle: e }) => e?.remove()), this.#t = [];
   }
-  #c() {
-    this.#i.forEach((e) => e.remove()), this.#i = [];
+  #u() {
+    this.#t.forEach((e) => {
+      this.disableHighlight ? (e.handle?.remove(), e.handle = void 0) : e.handle = e.layerView.highlight(e.objectIds);
+    });
   }
-  #d(e) {
+  #g(e) {
     e && (this._featuresComponentElement = e);
   }
-  #f(e) {
+  #p(e) {
     return Array.from(new Map(e.map((t) => [t.globalId, t])).values());
   }
-  #y(e) {
+  #w(e) {
     if (e == null || !this.#e.length)
       return;
     const t = this.#a.get(e);
@@ -77,113 +122,110 @@ class k extends L {
     const s = this.#e.find((r) => "layerId" in r && r.layerId === e);
     return s && this.#a.set(e, s), s;
   }
-  #m() {
+  #R() {
     const { traceResult: e, utilityNetwork: t, view: s } = this;
     if (!t || !e?.elements?.length || !s)
       return;
-    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);
-      }
-    });
+    const r = (i) => ($(i.layer) || w(i.layer)) && t.isUtilityLayer(i.layer), n = t.getObjectIdsFromElements(e.elements), h = s.allLayerViews.filter(r);
+    n.forEach(({ layerUrl: i, objectIds: l }) => {
+      const a = Number(i.split("/").pop()), u = h.find(({ layer: b }) => b.layerId === a);
+      u && this.#t.push({ layerView: u, objectIds: l });
+    }), this.#u();
   }
-  async #g(e) {
+  async #b(e) {
     const { layers: t, utilityNetwork: s, view: r } = this;
     if (!r || !s)
       return;
     try {
       s.loaded || await s.load({ signal: e });
     } catch (i) {
-      if (p(i))
+      if (g(i))
         throw i;
-      w(i, this, "Error while loading the selected utility network");
+      p(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) => {
+    c(e), this.#e = t.length ? t.filter((i) => s.isUtilityLayer(i)) : S(r, s);
+    const h = this.#e.filter((i) => !i.loaded).map((i) => i.load({ signal: e }));
+    if (h.length > 0) {
+      const i = await Promise.allSettled(h);
+      c(e), i.forEach((l) => {
         l.status === "rejected" && d("error", this, `Failed to load layer. Reason: ${l.reason}`);
       });
     }
   }
-  async #u() {
-    this.clearResult();
+  async #d() {
+    this.clearResult(), this._isFeaturesSelected = this.#y;
     const e = () => {
-      h(() => this.state = "ready"), this.arcgisResultReady.emit();
-    }, t = I(async (s) => {
+      o(() => this.state = "ready"), this.arcgisResultReady.emit();
+    }, t = A(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();
+      o(() => this.state = "loading"), this.#v(r), await this.#b(s), await this.#E(s), c(s), this.#R(), e();
     });
-    this.#t = t;
+    this.#s = t;
     try {
       await t.promise;
     } catch (s) {
-      p(s) || (w(s, this, "Error while loading trace result"), this.#t === t && e());
+      g(s) || (p(s, this, "Error while loading trace result"), this.#s === t && e());
     } finally {
-      this.#t === t && (this.#t = void 0, h(() => this.state = "ready"));
+      this.#s === t && (this.#s = void 0, o(() => this.state = "ready"));
     }
   }
-  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);
+  async #F([e, t], s) {
+    c(s);
+    const r = this.utilityNetwork?.getLayerIdBySourceId(e), n = this.#w(r), h = this.#p(t);
+    if (r == null || !n) {
+      this.#i.push(...h);
       return;
     }
-    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);
+    const i = n.createQuery();
+    i.gdbVersion = this.utilityNetwork?.gdbVersion, i.objectIds = h.map((a) => a.objectId), i.outFields = ["*"];
+    const { features: l } = await P(n, i, { signal: s });
+    c(s), l.forEach((a) => {
+      const u = a.layer;
+      a.getEffectivePopupTemplate(this.#n) || (a.popupTemplate = u.createPopupTemplate());
+    }), w(n) ? l.forEach((a) => {
+      v(this.#o, a.layer.subtypeCode, () => []).push(a);
     }) : this.#r.set(r, l);
   }
-  async #w(e) {
-    const t = Array.from(this.#o.entries());
+  async #E(e) {
+    const t = Array.from(this.#l.entries());
     if (!t.length)
       return;
-    const s = t.map((i) => this.#p(i, e)), r = await Promise.allSettled(s);
-    u(e), r.forEach((i, l) => {
+    const s = t.map((i) => this.#F(i, e)), r = await Promise.allSettled(s);
+    c(e), r.forEach((i, l) => {
       if (i.status === "rejected") {
         const [a] = t[l];
         d("error", this, `Failed to query features for source ${a}. Reason: ${i.reason}`);
       }
     });
-    const o = Array.from(this.#r.values()), n = Array.from(this.#l.values());
-    h(() => this.features = o.concat(n).flat());
+    const n = Array.from(this.#r.values()), h = Array.from(this.#o.values());
+    o(() => this.features = n.concat(h).flat());
   }
-  #F(e) {
-    this.#o = Map.groupBy(e, ({ networkSourceId: t }) => t);
+  #v(e) {
+    this.#l = Map.groupBy(e, ({ networkSourceId: t }) => t);
   }
-  #R(e) {
+  #L(e) {
     const { detail: t } = e;
     (t.name === "selectedDrillInFeature" || t.name === "selectedFeature") && (e.stopPropagation(), this.arcgisPropertyChange.emit({ name: "selectedResultFeature" }));
   }
-  #b(e) {
+  #T(e) {
     e.stopPropagation(), this.arcgisTriggerAction.emit(e.detail);
   }
-  #E() {
+  #k() {
     return y`<div class="features-hidden">${this._messages.resultFeaturesAreHidden}</div>`;
   }
-  #L() {
+  #I() {
     const { heading: e, _messages: t } = this;
     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.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();
+    return !this.traceResult?.elements.length || this.manager.destroyed ? null : this.hideFeatureResults ? this.hidePlaceholder ? null : this.#k() : this.isFeaturesListShown ? y`<arcgis-features-next .actions=${this.actions} .autoDestroyDisabled=${this.autoDestroyDisabled} .defaultPopupTemplateEnabled=${this.#n} .features=${this.features} .hideActionBar=${this.hideActionBar} 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.#L} @arcgisTriggerAction=${this.#T} ${E(this.#g)}></arcgis-features-next>` : this.#I();
   }
 }
-R("arcgis-utility-network-trace-elements-result-item", k);
+F("arcgis-utility-network-trace-elements-result-item", D);
 export {
-  k as ArcgisUtilityNetworkTraceElementsResultItem
+  D as ArcgisUtilityNetworkTraceElementsResultItem
 };

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

@@ -7,7 +7,6 @@ import type { T9nMeta } from "@arcgis/lumina/controllers";
 /**
  * Trace result item for displaying [function](https://developers.arcgis.com/javascript/latest/references/core/rest/networks/support/TraceResult/#globalFunctionResults) results from a trace.
  *
- * @internal
  * @since 5.2
  * @see [Set up functions](https://doc.esri.com/en/arcgis-pro/latest/help/data/utility-network/configure-a-trace.html#CBB)
  */
@@ -15,11 +14,32 @@ export abstract class ArcgisUtilityNetworkTraceFunctionsResultItem extends LitEl
   /** @internal */
   protected _messages: {
       componentLabel: string;
+      functions: string;
       labels: { functionResults: string; };
   } & T9nMeta<{
       componentLabel: string;
+      functions: string;
       labels: { functionResults: string; };
   }>;
+  /**
+   * If true, the component will not be destroyed automatically when it is
+   * disconnected from the document. This is useful when you want to move the
+   * component to a different place on the page, or temporarily hide it. If this
+   * is set, make sure to call the [destroy()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-functions-result-item/#destroy) method when you are done to
+   * prevent memory leaks.
+   *
+   * @default false
+   * @example
+   * ```html
+   * <arcgis-utility-network-trace-functions-result-item auto-destroy-disabled></arcgis-utility-network-trace-functions-result-item>
+   * ```
+   *
+   * ```js
+   * utilityNetworkTraceFunctionsResultItemElement.autoDestroyDisabled = true;
+   * ```
+   * 
+   */
+  accessor autoDestroyDisabled: boolean;
   /**
    * 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/).
@@ -29,17 +49,23 @@ export abstract class ArcgisUtilityNetworkTraceFunctionsResultItem extends LitEl
   get emitsArcgisResultReady(): true;
   /** The heading displayed above the result item. */
   accessor heading: string | undefined;
+  /**
+   * Replace localized message strings with your own strings.
+   *
+   * _**Note**: Individual message keys may change between releases._
+   */
+  accessor messageOverrides: {
+      componentLabel?: string | undefined;
+      functions?: string | undefined;
+      labels?: { functionResults?: string | undefined; } | undefined;
+  };
   /**
    * @default "ready"
    * @internal
    */
   get state(): UtilityNetworkTraceResultItemState;
-  /**
-   * The trace result containing the function results to render.
-   *
-   * @required
-   */
-  accessor traceResult: TraceResult | undefined;
+  /** The trace result containing the function results to render. */
+  get traceResult(): TraceResult | undefined;
   /**
    * Clears the result item.
    * This result item has no side effects to clear.
@@ -49,6 +75,7 @@ export abstract class ArcgisUtilityNetworkTraceFunctionsResultItem extends LitEl
   clearResult(): void;
   /** Permanently destroy the component. */
   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: "state"; }>;
   /** Fires when the component is finished rendering its results. */
   readonly arcgisResultReady: import("@arcgis/lumina").TargetedEvent<this, void>;

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

@@ -1,48 +1,76 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-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 {
+import { c as g } from "../../chunks/runtime.js";
+import { LitElement as d, createEvent as R } from "@arcgis/lumina";
+import { usePropertyChange as f, bypassReadOnly as a } from "@arcgis/lumina/controllers";
+import { log as i, composeEmptyPropertyMessage as p } from "@arcgis/toolkit/log";
+import { css as b, html as l } from "lit";
+import { u as y } from "../../chunks/useT9n.js";
+import { i as c } from "../../chunks/utils5.js";
+const w = b`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 v extends d {
   constructor() {
-    super(...arguments), this._messages = p({ blocking: !0 }), this.emitsArcgisResultReady = !0, this.state = "ready", this.arcgisPropertyChange = g()("state"), this.arcgisResultReady = h();
+    super(...arguments), this._messages = y({ blocking: !0 }), this.autoDestroyDisabled = !1, this.emitsArcgisResultReady = !0, this.state = "ready", this.arcgisPropertyChange = f()("state"), this.arcgisResultReady = R();
   }
   static {
-    this.properties = { emitsArcgisResultReady: 32, heading: 1, state: 32, traceResult: 0 };
+    this.properties = { autoDestroyDisabled: 5, emitsArcgisResultReady: 32, heading: 1, messageOverrides: 0, state: 32, traceResult: 32 };
   }
   static {
-    this.styles = y;
+    this.styles = w;
+  }
+  get #t() {
+    const { parentElement: t } = this.el;
+    if (t && c(t))
+      return t;
+    const e = this.el.getRootNode();
+    if (e instanceof ShadowRoot && c(e.host))
+      return e.host;
   }
   clearResult() {
   }
   async destroy() {
+    await this.manager.destroy();
   }
   load() {
-    this.traceResult && this.#t();
+    this.manager.onLifecycle(() => {
+      const t = this.#t;
+      if (!t) {
+        i("warn", this, "This component must be used as a child of `arcgis-utility-network-trace-results`.");
+        return;
+      }
+      const e = (r) => this.#s(r);
+      return t.addEventListener("arcgisPropertyChange", e), a(() => {
+        this.traceResult = t.traceResult;
+      }), () => {
+        t.removeEventListener("arcgisPropertyChange", e);
+      };
+    }), this.traceResult && this.#e();
   }
-  willUpdate(e) {
-    e.has("traceResult") && this.#t();
+  willUpdate(t) {
+    t.has("traceResult") && this.#e();
   }
   loaded() {
-    this.traceResult && !this.traceResult.globalFunctionResults.length && b("warn", this, R("traceResult.globalFunctionResults"));
+    this.traceResult && !this.traceResult.globalFunctionResults.length && i("warn", this, p("traceResult.globalFunctionResults"));
+  }
+  #s(t) {
+    if (t.target !== this.#t)
+      return;
+    const { target: e } = t;
+    t.detail.name === "traceResult" && a(() => this.traceResult = e.traceResult);
   }
-  #t() {
-    d(() => this.state = "ready"), this.arcgisResultReady.emit();
+  #e() {
+    a(() => this.state = "ready"), this.arcgisResultReady.emit();
   }
   render() {
     if (!this.traceResult?.globalFunctionResults.length)
       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>`;
+    const { heading: t, _messages: e } = this, { globalFunctionResults: r } = this.traceResult;
+    return l`<div class="functions-heading">${t || e.functions}</div><calcite-table .caption=${e.labels.functionResults}>${r.filter((s) => s.networkAttributeName != null && s.result != null && s.functionType != null).map((s) => {
+      const { functionName: o, networkAttributeName: n, functionType: u, result: h } = s, m = o || `${n} ${u}`;
+      return l`<calcite-table-row><calcite-table-cell>${m}</calcite-table-cell><calcite-table-cell>${h}</calcite-table-cell></calcite-table-row>`;
     })}</calcite-table>`;
   }
 }
-u("arcgis-utility-network-trace-functions-result-item", w);
+g("arcgis-utility-network-trace-functions-result-item", v);
 export {
-  w as ArcgisUtilityNetworkTraceFunctionsResultItem
+  v as ArcgisUtilityNetworkTraceFunctionsResultItem
 };