@arcgis/map-components 5.2.0-next.11 → 5.2.0-next.110

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

@@ -0,0 +1,175 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/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 {
+  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();
+  }
+  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 };
+  }
+  static {
+    this.styles = $;
+  }
+  #l;
+  #e;
+  get #o() {
+    if (!this.traceResult)
+      return !1;
+    const { elements: e, globalFunctionResults: t, aggregatedGeometry: r } = this.traceResult;
+    return e.length > 0 && !t.length && !r;
+  }
+  #t;
+  #s;
+  #n;
+  #i;
+  #r;
+  #a;
+  get isFeaturesListShown() {
+    return (this._isFeaturesSelected || this.#o) && !this.hideFeatureResults && !this._featuresComponentElement?.manager?.destroyed;
+  }
+  get numResults() {
+    return this.features.length + this.#e.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();
+  }
+  async destroy() {
+    this.clearResult(), 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"));
+  }
+  willUpdate(e) {
+    e.has("_isFeaturesSelected") && (this.#o || (e.get("_isFeaturesSelected") ?? !1)) !== this.isFeaturesListShown && this.arcgisPropertyChange.emit({ name: "isFeaturesListShown" });
+  }
+  #u() {
+    this.#t.forEach((e) => e.remove()), this.#t = [];
+  }
+  #h(e) {
+    e && (this._featuresComponentElement = e);
+  }
+  #c(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)
+      return;
+    const s = r.find((i) => "layerId" in i && i.layerId === e);
+    return s && t.set(e, s), s;
+  }
+  #m() {
+    const { traceResult: e, utilityNetwork: t, view: r } = this;
+    if (!t || !e?.elements?.length || !r)
+      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);
+      }
+    });
+  }
+  async #f() {
+    const { layers: e, utilityNetwork: t } = this;
+    if (!t)
+      return;
+    try {
+      t.loaded || (this.state = "loading", await t.load());
+    } catch (s) {
+      I(s, this, "Error while loading the selected utility network");
+    }
+    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);
+      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)
+      return;
+    this.state = "loading";
+    const t = e.map((i) => this.#y(i));
+    (await Promise.allSettled(t)).forEach((i, o) => {
+      if (i.status === "rejected") {
+        const [l] = e[o];
+        n("error", this, `Failed to query features for source ${l}. 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);
+    });
+  }
+  #F(e) {
+    const { detail: t } = e;
+    (t.name === "selectedDrillInFeature" || t.name === "selectedFeature") && (e.stopPropagation(), this.arcgisPropertyChange.emit({ name: "selectedResultFeature" }));
+  }
+  #w(e) {
+    e.stopPropagation(), this.arcgisTriggerAction.emit(e.detail);
+  }
+  #R() {
+    return d`<div class="features-hidden">${this._messages.resultFeaturesAreHidden}</div>`;
+  }
+  #b() {
+    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>`;
+  }
+  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();
+  }
+}
+F("arcgis-utility-network-elements-result-item", A);
+export {
+  A as ArcgisUtilityNetworkElementsResultItem
+};

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

@@ -0,0 +1 @@
+export * from "./customElement.js";

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

@@ -0,0 +1,6 @@
+import "@esri/calcite-components/components/calcite-list";
+import "@esri/calcite-components/components/calcite-list-item";
+import "@esri/calcite-components/components/calcite-chip";
+import "@esri/calcite-components/components/calcite-icon";
+import "../arcgis-features-next/index.js";
+export * from "./customElement.js";

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

@@ -0,0 +1,56 @@
+/// <reference path="../../index.d.ts" />
+import type UtilityNetwork from "@arcgis/core/networks/UtilityNetwork.js";
+import type MapView from "@arcgis/core/views/MapView.js";
+import type { PublicLitElement as LitElement } from "@arcgis/lumina";
+import type { T9nMeta } from "@arcgis/lumina/controllers";
+
+/**
+ * This is a sub-component used by the **ArcgisUtilityNetworkTraceAnalysis** component.
+ * It allows users to select utility networks from the map.
+ *
+ * @since 5.2
+ * @internal
+ */
+export abstract class ArcgisUtilityNetworkPicker extends LitElement {
+  /** @internal */
+  protected _messages: {
+      componentLabel: string;
+      errors: {
+          mapLoadFailed: string;
+          noUtilityNetwork: string;
+          noView: string;
+          utilityNetworkLoadFailed: string;
+      };
+      labels: { utilityNetwork: string; };
+  } & T9nMeta<{
+      componentLabel: string;
+      errors: {
+          mapLoadFailed: string;
+          noUtilityNetwork: string;
+          noView: string;
+          utilityNetworkLoadFailed: string;
+      };
+      labels: { utilityNetwork: string; };
+  }>;
+  accessor error: string | undefined;
+  accessor heading: string | undefined;
+  /** @default false */
+  accessor hideErrors: boolean;
+  /** @default false */
+  accessor hideLoader: boolean;
+  accessor selectedUtilityNetwork: UtilityNetwork | undefined;
+  /** @default "loading" */
+  accessor state: "error" | "loading" | "ready";
+  /**
+   * 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-picker component will be associated with a map or scene component rather than using the `view` property.
+   */
+  accessor view: MapView | undefined;
+  /** Fires when an error occurs while loading the utility networks from the map. */
+  readonly arcgisError: import("@arcgis/lumina").TargetedEvent<this, void>;
+  readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "selectedUtilityNetwork" | "state"; }>;
+  readonly "@eventTypes": {
+    arcgisError: ArcgisUtilityNetworkPicker["arcgisError"]["detail"];
+    arcgisPropertyChange: ArcgisUtilityNetworkPicker["arcgisPropertyChange"]["detail"];
+  };
+}

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

@@ -0,0 +1,94 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
+import { c } from "../../chunks/runtime.js";
+import h from "@arcgis/core/core/Collection.js";
+import { watch as d } from "@arcgis/core/core/reactiveUtils.js";
+import { LitElement as n, createEvent as m } from "@arcgis/lumina";
+import { usePropertyChange as w } from "@arcgis/lumina/controllers";
+import { log as o } from "@arcgis/toolkit/log";
+import { css as y, html as s } from "lit";
+import { l } from "../../chunks/async-utils.js";
+import { u as g } from "../../chunks/useT9n.js";
+const k = y`:host{height:100%;flex-grow:1}calcite-block{--calcite-block-content-space: 0;--calcite-block-border-color: transparent;margin:0}calcite-block :is(calcite-combobox,calcite-label,calcite-notice){margin:0 var(--calcite-space-md) var(--calcite-space-md)}calcite-block :last-child{margin-bottom:0}calcite-notice{margin:var(--calcite-space-md)}`;
+class u extends n {
+  constructor() {
+    super(...arguments), this._messages = g({ blocking: !0 }), this.hideErrors = !1, this.hideLoader = !1, this.state = "loading", this.arcgisPropertyChange = w()("selectedUtilityNetwork", "state"), this.arcgisError = m();
+  }
+  static {
+    this.properties = { _utilityNetworks: 16, view: 0, hideErrors: 5, hideLoader: 5, state: 1, error: 1, selectedUtilityNetwork: 0, heading: 1 };
+  }
+  static {
+    this.styles = k;
+  }
+  load() {
+    this.#e(), this.manager.onLifecycle(() => [
+      d(() => this.view?.map, () => this.#e())
+    ]);
+  }
+  willUpdate(t) {
+    t.has("_utilityNetworks") && this.#s(), t.has("selectedUtilityNetwork") && this.#o();
+  }
+  #t(t) {
+    this.error = t, this.state = "error", this.arcgisError.emit();
+  }
+  #i() {
+    this.error = void 0, this.state = "ready";
+  }
+  #e() {
+    if (this.error = void 0, this.state = "loading", !this.view?.map) {
+      o("error", this, this._messages.errors.noView), this._utilityNetworks = void 0, this.#t(this._messages.errors.noView);
+      return;
+    }
+    const t = this.view.map;
+    this.#r(t);
+  }
+  async #r(t) {
+    try {
+      t.loaded || await t.load();
+    } catch (e) {
+      this.#t(this._messages.errors.mapLoadFailed), l(e, this, this._messages.errors.mapLoadFailed);
+    } finally {
+      this._utilityNetworks = t.utilityNetworks || new h();
+    }
+  }
+  #s() {
+    const { selectedUtilityNetwork: t, _utilityNetworks: e } = this;
+    e?.length ? (!t || !e.includes(t)) && (this.selectedUtilityNetwork = e.at(0), this.arcgisPropertyChange.emit({ name: "selectedUtilityNetwork" })) : (this.#t(this._messages.errors.noUtilityNetwork), o("error", this, this._messages.errors.noUtilityNetwork), this.selectedUtilityNetwork = void 0);
+  }
+  async #o() {
+    const { selectedUtilityNetwork: t } = this;
+    try {
+      t && !t.loaded && await t.load(), this.#i();
+    } catch (e) {
+      l(e, this, this._messages.errors.utilityNetworkLoadFailed), this.#t(this._messages.errors.utilityNetworkLoadFailed);
+    }
+  }
+  #l() {
+    return this.hideLoader ? null : s`<calcite-loader label=loading></calcite-loader>`;
+  }
+  #a(t, e = !1, i) {
+    return this.hideErrors ? null : s`<calcite-notice .closable=${e} kind=danger open scale=s width=auto .icon=${i}><div slot=message>${t}</div></calcite-notice>`;
+  }
+  #c() {
+    const t = this._messages.labels.utilityNetwork, e = this._utilityNetworks?.map((i) => s`<calcite-combobox-item .value=${i.id} .heading=${i.title || i.id} .selected=${i.id === this.selectedUtilityNetwork?.id}></calcite-combobox-item>`);
+    return s`<calcite-combobox .label=${t} selection-mode=single-persist @calciteComboboxChange=${({ currentTarget: i }) => {
+      const r = i.selectedItems[0]?.value;
+      this.selectedUtilityNetwork?.id !== r && (this.selectedUtilityNetwork = this._utilityNetworks?.find((a) => a.id === r));
+    }}>${e}</calcite-combobox>`;
+  }
+  #h() {
+    const { selectedUtilityNetwork: t } = this;
+    return s`<calcite-label>${t?.title}</calcite-label>`;
+  }
+  #d(t) {
+    const e = this._messages.labels.utilityNetwork, i = this.heading || e, r = this._utilityNetworks?.length ? this._utilityNetworks?.length === 1 ? this.#h() : this.#c() : void 0;
+    return s`<calcite-block .heading=${i} .label=${e} expanded>${r}${t}</calcite-block>`;
+  }
+  render() {
+    const { error: t, state: e, selectedUtilityNetwork: i } = this, r = e === "error" && t ? this.#a(t, !1, "exclamation-mark-triangle") : void 0;
+    return !r && !i?.loaded && !i?.loadError ? this.#l() : e === "error" && r && !this._utilityNetworks?.length ? r : this.#d(r);
+  }
+}
+c("arcgis-utility-network-picker", u);
+export {
+  u as ArcgisUtilityNetworkPicker
+};

package/dist/components/arcgis-utility-network-picker/index.d.ts

@@ -0,0 +1 @@
+export * from "./customElement.js";

package/dist/components/arcgis-utility-network-picker/index.js

@@ -0,0 +1,7 @@
+import "@esri/calcite-components/components/calcite-loader";
+import "@esri/calcite-components/components/calcite-notice";
+import "@esri/calcite-components/components/calcite-combobox-item";
+import "@esri/calcite-components/components/calcite-combobox";
+import "@esri/calcite-components/components/calcite-label";
+import "@esri/calcite-components/components/calcite-block";
+export * from "./customElement.js";

package/dist/components/arcgis-utility-network-subnetwork-info/customElement.d.ts

@@ -25,5 +25,5 @@ export abstract class ArcgisUtilityNetworkSubnetworkInfo extends LitElement {
       tier: string;
   }; }>;
   /** @required */
-  accessor namedTraceConfig: NamedTraceConfiguration | undefined;
+  accessor namedTraceConfiguration: NamedTraceConfiguration | undefined;
 }

package/dist/components/arcgis-utility-network-subnetwork-info/customElement.js

@@ -1,35 +1,35 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import { c as l } from "../../chunks/runtime.js";
-import { css as c, html as o } from "lit";
-import { LitElement as d } from "@arcgis/lumina";
-import { u } from "../../chunks/useT9n.js";
-import { log as s, composeMissingPropertyMessage as n } from "@arcgis/toolkit/log";
-const m = c`.subnetwork-details{border-radius:var(--calcite-border-radius);border:solid 1px var(--calcite-color-border-3)}.key-value-pair{padding:var(--calcite-spacing-sm)}.key-value-pair__key{font-size:var(--calcite-font-size--2);color:var(--calcite-color-text-3)}.key-value-pair__value{font-size:var(--calcite-font-size--1);color:var(--calcite-color-text-1)}`;
-class g extends d {
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
+import { c } from "../../chunks/runtime.js";
+import { css as l, html as s } from "lit";
+import { LitElement as u } from "@arcgis/lumina";
+import { u as d } from "../../chunks/useT9n.js";
+import { log as o, composeMissingPropertyMessage as n } from "@arcgis/toolkit/log";
+const m = l`.subnetwork-details{border-radius:var(--calcite-border-radius);border:solid 1px var(--calcite-color-border-3)}.key-value-pair{padding:var(--calcite-spacing-sm)}.key-value-pair__key{font-size:var(--calcite-font-size--2);color:var(--calcite-color-text-3)}.key-value-pair__value{font-size:var(--calcite-font-size--1);color:var(--calcite-color-text-1)}`;
+class g extends u {
   constructor() {
-    super(...arguments), this._messages = u({ blocking: !0 });
+    super(...arguments), this._messages = d({ blocking: !0 });
   }
   static {
-    this.properties = { namedTraceConfig: 0 };
+    this.properties = { namedTraceConfiguration: 0 };
   }
   static {
     this.styles = m;
   }
   loaded() {
-    this.namedTraceConfig || s("warn", this, n("namedTraceConfig"));
+    this.namedTraceConfiguration || o("warn", this, n("namedTraceConfiguration"));
+  }
+  #e(e, r) {
+    return s`<div class="key-value-pair"><div class="key-value-pair__key">${e}</div><div class="key-value-pair__value">${r}</div></div>`;
   }
   render() {
-    const { _messages: e, namedTraceConfig: r } = this;
+    const { _messages: e, namedTraceConfiguration: r } = this;
     if (!r?.traceConfiguration)
-      return s("error", this, n("namedTraceConfig.traceConfiguration")), null;
-    const { domainNetworkName: a, tierName: i, targetTierName: t } = r.traceConfiguration;
-    return !a && !i && !t ? (s("warn", this, "`namedTraceConfig.traceConfiguration` has no `domainNetworkName`, `tierName`, or `targetTierName`."), null) : o`<div class="subnetwork-details">${a ? this._renderKeyValuePair(e.headings.domainNetwork, a) : null}${i ? this._renderKeyValuePair(e.headings.tier, i) : null}${t ? this._renderKeyValuePair(e.headings.targetTier, t) : null}</div>`;
-  }
-  _renderKeyValuePair(e, r) {
-    return o`<div class="key-value-pair"><div class="key-value-pair__key">${e}</div><div class="key-value-pair__value">${r}</div></div>`;
+      return o("error", this, n("namedTraceConfig.traceConfiguration")), null;
+    const { domainNetworkName: i, tierName: a, targetTierName: t } = r.traceConfiguration;
+    return !i && !a && !t ? (o("warn", this, "`namedTraceConfig.traceConfiguration` has no `domainNetworkName`, `tierName`, or `targetTierName`."), null) : s`<div class="subnetwork-details">${i ? this.#e(e.headings.domainNetwork, i) : null}${a ? this.#e(e.headings.tier, a) : null}${t ? this.#e(e.headings.targetTier, t) : null}</div>`;
   }
 }
-l("arcgis-utility-network-subnetwork-info", g);
+c("arcgis-utility-network-subnetwork-info", g);
 export {
   g as ArcgisUtilityNetworkSubnetworkInfo
 };

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

@@ -29,6 +29,15 @@ export abstract class ArcgisUtilityNetworkTrace extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-utility-network-trace auto-destroy-disabled></arcgis-utility-network-trace>
+   * ```
+   *
+   * ```js
+   * utilityNetworkTraceElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**
@@ -121,7 +130,7 @@ export abstract class ArcgisUtilityNetworkTrace extends LitElement {
    */
   accessor referenceElement: ArcgisReferenceElement | string | undefined;
   /**
-   * The properties to determine the size and color of the result area convex hull or buffer, and determines if it displays on the map when the trace completes.
+   * These properties determine the size and color of the result area convex hull or buffer, and determine whether it displays on the map when the trace completes.
    *
    * @default
    * {
@@ -205,8 +214,8 @@ export abstract class ArcgisUtilityNetworkTrace extends LitElement {
    */
   get traceResults(): TraceResultExtend[];
   /**
-   * 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 component will be associated with a map or scene component rather than using the `view` property.
+   * The view associated with the component.
+   * > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the arcgis-utility-network-trace component will be associated with a map or scene component rather than using the `view` property.
    */
   accessor view: MapView | null | undefined;
   checkCanTrace(): Promise<void>;

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

@@ -1,4 +1,4 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
 import { c as t } from "../../chunks/runtime.js";
 import { usePropertyChange as i } from "@arcgis/lumina/controllers";
 import { reEmitEvent as e } from "@arcgis/lumina/controllers/accessor";

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

@@ -68,7 +68,7 @@ import type { UtilityNetworkTraceAnalysisState } from "@arcgis/core/networks/Uti
  *
  * ```html
  * <calcite-shell>
- *   <calcite-shell-panel slot="panel-start" position="start" width-scale="l">
+ *   <calcite-shell-panel slot="panel-start" position="start" width="l">
  *     <arcgis-utility-network-trace-analysis reference-element="#map-element"></arcgis-utility-network-trace-analysis>
  *   </calcite-shell-panel>
  *   <arcgis-map id="map-element" item-id="471eb0bf37074b1fbb972b1da70fb310"></arcgis-map>
@@ -159,6 +159,15 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-utility-network-trace-analysis auto-destroy-disabled></arcgis-utility-network-trace-analysis>
+   * ```
+   *
+   * ```js
+   * utilityNetworkTraceAnalysisElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**
@@ -228,7 +237,7 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
    *
    * _**Note**: Individual message keys may change between releases._
    */
-  accessor messageOverrides: Pick<ArcgisUtilityNetworkTraceResults["_messages"], "resultFeaturesAreHidden"> & {
+  accessor messageOverrides: NonNullable<ArcgisUtilityNetworkTraceResults["messageOverrides"]> & {
       buttons?: {
           clearResultsCustom?: string | undefined;
           clearResultsGeneric?: string | undefined;
@@ -276,8 +285,8 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
    */
   get traceResultFeatures(): Graphic[];
   /**
-   * The view associated with the component. 
-   *   > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the arcgis-utility-network-trace-analysis component will be associated with a map or scene component rather than using the `view` property.
+   * The view associated with the component.
+   * > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the arcgis-utility-network-trace-analysis component will be associated with a map or scene component rather than using the `view` property.
    */
   accessor view: MapView | null | undefined;
   /** Permanently destroy the component. */