@arcgis/map-components 5.1.0-next.6 → 5.1.0-next.61

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

@@ -1,16 +1,16 @@
 /// <reference path="../../index.d.ts" />
 import type Color from "@arcgis/core/Color.js";
-import type AggregatedGeometry from "@arcgis/core/rest/networks/support/AggregatedGeometry";
-import type MapView from "@arcgis/core/views/MapView";
+import type AggregatedGeometry from "@arcgis/core/rest/networks/support/AggregatedGeometry.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.
  *
- * This sub-component renders the aggregated geometry from a `TraceResult` on a view
- * in the spatial reference of the view. This sub-component also renders a "Show graphics"
- * toggle which show or hides the aggregated geometry graphics.
+ * This sub-component renders the aggregated geometry from a `TraceResult` on a view.
+ * The component does not project the geometry on the client.
+ * This sub-component also renders a "Show graphics" toggle which shows or hides the aggregated geometry graphics.
  *
  * The user can specify a color to render the aggregated geometry graphics in.
  *
@@ -35,6 +35,16 @@ export abstract class ArcgisUtilityNetworkAggregatedGeometry extends LitElement
       };
       showGraphics: 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-aggregated-geometry/#destroy) method when you are done to
+   * prevent memory leaks.
+   *
+   * @default false
+   */
+  accessor autoDestroyDisabled: boolean;
   /** @required */
   accessor geometry: AggregatedGeometry | undefined;
   /**
@@ -44,14 +54,12 @@ export abstract class ArcgisUtilityNetworkAggregatedGeometry extends LitElement
   accessor graphicsColor: Color;
   /** @default false */
   accessor hideGraphics: boolean;
-  /** @default "ready" */
-  accessor state: State;
   /** @required */
   accessor view: MapView | undefined;
+  /** Permanently destroy the component. */
+  destroy(): Promise<void>;
   readonly arcgisHideGraphicsChange: import("@arcgis/lumina").TargetedEvent<this, boolean>;
   readonly "@eventTypes": {
     arcgisHideGraphicsChange: ArcgisUtilityNetworkAggregatedGeometry["arcgisHideGraphicsChange"]["detail"];
   };
-}
-
-export type State = "loading" | "ready";
+}

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

@@ -1,111 +1,106 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
 import { c as m } from "../../chunks/runtime.js";
-import n from "@arcgis/core/Color.js";
-import * as s from "@arcgis/core/geometry/operators/shapePreservingProjectOperator.js";
-import d from "@arcgis/core/Graphic.js";
+import p from "@arcgis/core/Color.js";
+import l from "@arcgis/core/Graphic.js";
 import g from "@arcgis/core/layers/GraphicsLayer.js";
 import y from "@arcgis/core/symbols/SimpleFillSymbol.js";
-import w from "@arcgis/core/symbols/SimpleLineSymbol.js";
-import _ from "@arcgis/core/symbols/SimpleMarkerSymbol.js";
-import { LitElement as G, createEvent as f, nothing as u } from "@arcgis/lumina";
-import { log as a, composeMissingPropertyMessage as o } from "@arcgis/toolkit/log";
-import { css as L, html as c } from "lit";
-import { u as v } from "../../chunks/useT9n.js";
-import { i as b, a as p } from "../../chunks/layer-utils.js";
-const S = L`.loader-container{display:flex;justify-content:center;padding-bottom:var(--calcite-spacing-md)}`, h = 12;
-class k extends G {
+import n from "@arcgis/core/symbols/SimpleLineSymbol.js";
+import d from "@arcgis/core/symbols/SimpleMarkerSymbol.js";
+import { LitElement as w, createEvent as _, nothing as f } from "@arcgis/lumina";
+import { log as s, composeMissingPropertyMessage as a } from "@arcgis/toolkit/log";
+import { css as G, html as u } from "lit";
+import { u as L } from "../../chunks/useT9n.js";
+import { a as v, b as o } from "../../chunks/layer-utils.js";
+const b = G`.loader-container{display:flex;justify-content:center;padding-bottom:var(--calcite-spacing-md)}`, h = 12;
+class S extends w {
   constructor() {
-    super(...arguments), this._graphicsLayerName = `arcgis-utility-network-aggregated-geometry-${Date.now()}`, this._messages = v({ blocking: !0 }), this._projectedGraphics = [], this._addAggregatedGeometryToView = () => {
-      const i = this.geometry, { line: e, multipoint: t, polygon: l } = i;
-      this._projectedGraphics = [e, t, l].filter((r) => r != null).map((r) => this._makeGraphicFromGeometry(r)), this._graphicsLayer.addMany(this._projectedGraphics);
+    super(...arguments), this._graphicsLayerName = "arcgis-utility-network-aggregated-geometry-graphics", this._messages = L({ blocking: !0 }), this._graphics = [], this._addAggregatedGeometryToView = () => {
+      const e = this.geometry, { line: i, multipoint: r, polygon: c } = e;
+      this._graphics = [i, r, c].filter((t) => t != null).map((t) => this._makeGraphicFromGeometry(t)), this._graphicsLayer.addMany(this._graphics);
     }, this._createGraphicsLayer = () => {
-      const i = this.view.map, e = this._graphicsLayerName, t = i.findLayerById(e);
-      if (t && b(t)) {
-        this._graphicsLayer = t;
+      const e = this.view.map, i = this._graphicsLayerName, r = e.findLayerById(i);
+      if (r && v(r)) {
+        this._graphicsLayer = r;
         return;
       }
       this._graphicsLayer = new g({
-        id: e,
+        id: i,
         listMode: "hide",
-        title: e
-      }), p(this.view, this._graphicsLayer);
-    }, this.hideGraphics = !1, this.graphicsColor = new n([255, 255, 0, 0.6]), this.state = "ready", this.arcgisHideGraphicsChange = f();
+        title: i
+      }), o(this.view, this._graphicsLayer);
+    }, this.hideGraphics = !1, this.graphicsColor = new p([255, 255, 0, 0.6]), this.autoDestroyDisabled = !1, this.arcgisHideGraphicsChange = _();
   }
   static {
-    this.properties = { geometry: 0, hideGraphics: 5, graphicsColor: 0, state: 1, view: 0 };
+    this.properties = { geometry: 0, hideGraphics: 5, graphicsColor: 0, view: 0, autoDestroyDisabled: 5 };
   }
   static {
-    this.styles = S;
+    this.styles = b;
+  }
+  async destroy() {
+    this.view?.map && this._graphicsLayer && this.view.map.remove(this._graphicsLayer), await this.manager.destroy();
   }
   connectedCallback() {
-    super.connectedCallback(), this.view && this._graphicsLayer && p(this.view, this._graphicsLayer);
+    super.connectedCallback(), this.view && this._graphicsLayer && o(this.view, this._graphicsLayer);
   }
   load() {
-    !this.geometry || !this.view?.map || this._loadProjectOperator().then(() => this._createGraphicsLayer());
-  }
-  loaded() {
-    this.geometry || a("error", this, o("geometry")), this.view ? this.view.map || a("error", this, o("The property `view` was provided, but `view.map` is null. Cannot draw aggregated geometry.")) : a("error", this, o("view"));
+    !this.geometry || !this.view?.map || this._createGraphicsLayer();
   }
-  willUpdate(i) {
-    if (i.has("graphicsColor") && this._updateGraphicSymbols(), i.has("geometry") && (this._graphicsLayer?.removeAll(), this._addAggregatedGeometryToView()), i.has("view")) {
-      const e = i.get("view");
-      e?.map && this._graphicsLayer && (e.map.remove(this._graphicsLayer), this._createGraphicsLayer(), this._addAggregatedGeometryToView());
+  willUpdate(e) {
+    if (e.has("graphicsColor") && this._updateGraphicSymbols(), e.has("geometry") && (this._graphicsLayer?.removeAll(), this._addAggregatedGeometryToView()), e.has("view")) {
+      const i = e.get("view");
+      i?.map && this._graphicsLayer && (i.map.remove(this._graphicsLayer), this._createGraphicsLayer(), this._addAggregatedGeometryToView());
     }
   }
-  disconnectedCallback() {
-    super.disconnectedCallback(), this.view?.map && this._graphicsLayer && this.view.map.remove(this._graphicsLayer);
+  loaded() {
+    this.geometry || s("error", this, a("geometry")), this.view ? this.view.map || s("error", this, a("The property `view` was provided, but `view.map` is null. Cannot draw aggregated geometry.")) : s("error", this, a("view"));
   }
   _handleShowGraphicsChange() {
-    this.hideGraphics = !this.hideGraphics, this.hideGraphics ? this._graphicsLayer?.removeAll() : this._graphicsLayer?.addMany(this._projectedGraphics), this.arcgisHideGraphicsChange.emit(this.hideGraphics);
-  }
-  async _loadProjectOperator() {
-    s.isLoaded() || (this.state = "loading", await s.load(), this.state = "ready");
+    this.hideGraphics = !this.hideGraphics, this.hideGraphics ? this._graphicsLayer?.removeAll() : this._graphicsLayer?.addMany(this._graphics), this.arcgisHideGraphicsChange.emit(this.hideGraphics);
   }
-  _makeGraphicFromGeometry(i) {
-    const e = s.execute(i, this.view.spatialReference);
-    return new d({
+  _makeGraphicFromGeometry(e) {
+    return new l({
       geometry: e,
-      symbol: this._makeSymbolForGeometry(i)
+      symbol: this._makeSymbolForGeometry(e)
     });
   }
-  _makeSymbolForGeometry(i) {
-    const e = this.graphicsColor;
-    switch (i.type) {
+  _makeSymbolForGeometry(e) {
+    const i = this.graphicsColor;
+    switch (e.type) {
       case "multipoint":
-        return new _({
-          color: e,
+        return new d({
+          color: i,
           size: h,
           outline: {
-            color: e,
+            color: i,
             width: 0
           }
         });
       case "polygon":
         return new y({
-          color: e,
+          color: i,
           outline: {
-            color: e,
+            color: i,
             width: h
           }
         });
       case "polyline":
-        return new w({
-          color: e,
+        return new n({
+          color: i,
           width: h
         });
     }
   }
   _updateGraphicSymbols() {
-    this._graphicsLayer?.graphics.forEach((i) => {
-      const e = i.geometry;
-      i.symbol = this._makeSymbolForGeometry(e);
+    this._graphicsLayer?.graphics.forEach((e) => {
+      const i = e.geometry;
+      e.symbol = this._makeSymbolForGeometry(i);
     });
   }
   render() {
-    return this.state === "loading" ? c`<div class="loader-container"><calcite-loader .label=${this._messages.labels.loadingDependencies} inline></calcite-loader></div>` : c`<calcite-switch .checked=${!this.hideGraphics} .label=${this._messages.labels.showGraphicsToggle} label-text-end=${this._messages.showGraphics ?? u} @calciteSwitchChange=${this._handleShowGraphicsChange}></calcite-switch>`;
+    return u`<calcite-switch .checked=${!this.hideGraphics} .label=${this._messages.labels.showGraphicsToggle} label-text-end=${this._messages.showGraphics ?? f} @calciteSwitchChange=${this._handleShowGraphicsChange}></calcite-switch>`;
   }
 }
-m("arcgis-utility-network-aggregated-geometry", k);
+m("arcgis-utility-network-aggregated-geometry", S);
 export {
-  k as ArcgisUtilityNetworkAggregatedGeometry
+  S as ArcgisUtilityNetworkAggregatedGeometry
 };

package/dist/components/arcgis-utility-network-aggregated-geometry/index.js

@@ -1,3 +1,2 @@
-import "@esri/calcite-components/components/calcite-loader";
 import "@esri/calcite-components/components/calcite-switch";
 export * from "./customElement.js";

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

@@ -3,8 +3,7 @@ import type MapView from "@arcgis/core/views/MapView.js";
 import type SimpleLineSymbol from "@arcgis/core/symbols/SimpleLineSymbol.js";
 import type UtilityNetwork from "@arcgis/core/networks/UtilityNetwork.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
-import type { ArcgisReferenceElement } from "../../utils/component-utils.js";
-import type { IconName } from "../../utils/action-utils.js";
+import type { ArcgisReferenceElement, IconName } from "../types.js";
 import type { Icon } from "@esri/calcite-components/components/calcite-icon";
 
 /**
@@ -34,7 +33,7 @@ export abstract class ArcgisUtilityNetworkAssociations extends LitElement {
    */
   accessor autoRefreshAssociationsDisabled: boolean;
   /**
-   * A [SimpleLineSymbol](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-SimpleLineSymbol.html) used for representing the polyline geometry that is being
+   * A [SimpleLineSymbol](https://developers.arcgis.com/javascript/latest/references/core/symbols/SimpleLineSymbol/) used for representing the polyline geometry that is being
    * drawn for connectivity associations.
    *
    * @since 4.26
@@ -123,7 +122,7 @@ export abstract class ArcgisUtilityNetworkAssociations extends LitElement {
    * The maximum value or upper bound of the Maximum allowable associations slider.
    *
    * If the value in the constructor is less than or equal to the value set for
-   * [maxAllowableAssociationsSliderMin](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-UtilityNetworkAssociations.html#maxAllowableAssociationsSliderMin), the property will be set to a default value (1000).
+   * [maxAllowableAssociationsSliderMin](https://developers.arcgis.com/javascript/latest/references/core/widgets/UtilityNetworkAssociations/#maxAllowableAssociationsSliderMin), the property will be set to a default value (1000).
    *
    * @since 4.26
    */
@@ -132,7 +131,7 @@ export abstract class ArcgisUtilityNetworkAssociations extends LitElement {
    * The minimum value or lower bound of the Maximum allowable associations slider.
    *
    * If the value in the constructor is less than 0, the property will be set to a default value (250).
-   * If the value in the constructor is greater than or equal to [maxAllowableAssociationsSliderMax](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-UtilityNetworkAssociations.html#maxAllowableAssociationsSliderMax),
+   * If the value in the constructor is greater than or equal to [maxAllowableAssociationsSliderMax](https://developers.arcgis.com/javascript/latest/references/core/widgets/UtilityNetworkAssociations/#maxAllowableAssociationsSliderMax),
    * the property will be set to a default value (250).
    *
    * @since 4.26
@@ -208,7 +207,7 @@ export abstract class ArcgisUtilityNetworkAssociations extends LitElement {
    */
   accessor showStructuralAttachmentAssociationsSettingsCapSelect: boolean;
   /**
-   * A [SimpleLineSymbol](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-SimpleLineSymbol.html) used for representing the polyline geometry that is being drawn for structural attachment associations.
+   * A [SimpleLineSymbol](https://developers.arcgis.com/javascript/latest/references/core/symbols/SimpleLineSymbol/) used for representing the polyline geometry that is being drawn for structural attachment associations.
    *
    * @since 4.26
    */

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

@@ -1,20 +1,23 @@
 /// <reference path="../../index.d.ts" />
 import type MapView from "@arcgis/core/views/MapView.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
-import type { ArcgisReferenceElement } from "../../utils/component-utils.js";
-import type { IconName } from "../../utils/action-utils.js";
-import type { UtilityNetworkTraceViewModelRemoveResultAreaEvent, UtilityNetworkTraceViewModelAddResultAreaEvent, UtilityNetworkTraceViewModelAddFlagErrorEvent, UtilityNetworkTraceViewModelAddFlagCompleteEvent, UtilityNetworkTraceViewModelAddFlagEvent, TraceResultExtend } from "@arcgis/core/widgets/UtilityNetworkTrace/UtilityNetworkTraceViewModel";
-import type { GraphicColor, FlagProperty, ResultAreaPropertiesExtend, UtilityNetworkTraceViewModelState } from "@arcgis/core/widgets/UtilityNetworkTrace/UtilityNetworkTraceViewModel.js";
+import type { ArcgisReferenceElement, IconName } from "../types.js";
+import type { UtilityNetworkTraceViewModelRemoveResultAreaEvent, UtilityNetworkTraceViewModelAddResultAreaEvent, UtilityNetworkTraceViewModelAddFlagErrorEvent, UtilityNetworkTraceViewModelAddFlagCompleteEvent, UtilityNetworkTraceViewModelAddFlagEvent, TraceResultExtend, GraphicColor, FlagProperty, ResultAreaPropertiesExtend, UtilityNetworkTraceViewModelState } from "@arcgis/core/widgets/UtilityNetworkTrace/UtilityNetworkTraceViewModel.js";
 import type { Icon } from "@esri/calcite-components/components/calcite-icon";
 import type { InputSetting } from "@arcgis/core/widgets/UtilityNetworkTrace.js";
 
 /**
- * Utility Network Trace component provides a way to run traces in a Utility Network based on connectivity or traversability from set input flags. Input flags (starting points and barriers) can be set by clicking the view.
+ * > [!WARNING]
+ * >
+ * > This component is **deprecated**. [arcgis-utility-network-trace-analysis](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-analysis/) is the preferred component for utility network tracing and should be used for all new development.
+ *
+ * Utility Network Trace component provides a way to run traces in a Utility Network based on connectivity or traversability from set trace locations. Trace locations (starting points and barriers) can be set by clicking the view.
  *
  * > The Utility Network Trace component does not support proxied feature services or feature services that utilize stored credentials.
  *
  * Note: Sign in to access the data in this sample, U/P: `viewer01`/`I68VGU^nMurF`
  *
+ * @deprecated since 5.0, use [arcgis-utility-network-trace-analysis](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-analysis/) instead.
  * @since 4.28
  */
 export abstract class ArcgisUtilityNetworkTrace extends LitElement {
@@ -42,7 +45,7 @@ export abstract class ArcgisUtilityNetworkTrace extends LitElement {
    */
   accessor defaultGraphicColor: GraphicColor;
   /**
-   * When true, the component is visually withdrawn and cannot be interacted with.
+   * When true, the component is visually withdrawn and cannot receive user interaction.
    *
    * @default false
    * @since 4.22
@@ -99,7 +102,7 @@ export abstract class ArcgisUtilityNetworkTrace extends LitElement {
   get icon(): Icon["icon"];
   set icon(value: IconName);
   /**
-   * Custom labels, descriptions, and symbol for the input [flags](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-UtilityNetworkTrace.html#flags).
+   * Custom labels, descriptions, and symbol for the input [flags](https://developers.arcgis.com/javascript/latest/references/core/widgets/UtilityNetworkTrace/#flags).
    *
    * @default []
    * @since 4.23
@@ -218,7 +221,7 @@ export abstract class ArcgisUtilityNetworkTrace extends LitElement {
   readonly arcgisAddFlagError: import("@arcgis/lumina").TargetedEvent<this, UtilityNetworkTraceViewModelAddFlagErrorEvent>;
   readonly arcgisAddResultArea: import("@arcgis/lumina").TargetedEvent<this, UtilityNetworkTraceViewModelAddResultAreaEvent>;
   /** 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"; }>;
+  readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "state" | "traceResults"; }>;
   /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
   readonly arcgisReady: import("@arcgis/lumina").TargetedEvent<this, void>;
   readonly arcgisRemoveResultArea: import("@arcgis/lumina").TargetedEvent<this, UtilityNetworkTraceViewModelRemoveResultAreaEvent>;

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

@@ -9,7 +9,7 @@ import { css as n } from "lit";
 const l = n`@keyframes esri-basemap-slide{0%{opacity:0;margin-top:0;margin-left:0}75%{opacity:0;margin-top:0;margin-left:0}to{opacity:1;margin-top:5px;margin-left:5px}}@keyframes esri-docking-animation{0%{opacity:0}25%{opacity:0}to{opacity:1}}@keyframes popup-intro-animation-down{0%{opacity:0;transform:translateY(-5px)}to{opacity:1;transform:translate(0)}}@keyframes popup-intro-animation-up{0%{opacity:0;transform:translateY(5px)}to{opacity:1;transform:translate(0)}}@supports (-ms-ime-align: auto){.esri-slider__anchor:focus{outline:1px dotted #000}}@keyframes esri-spinner--start-animation{0%{opacity:0;transform:scale(0)}to{opacity:1;transform:scale(1)}}@keyframes esri-spinner--finish-animation{0%{opacity:1;transform:scale(1)}to{opacity:0;transform:scale(0)}}@keyframes esri-spinner--rotate-animation{0%{transform:rotate(0)}to{transform:rotate(360deg)}}@media(prefers-reduced-motion){.esri-utility-network-trace__reset-prompt{animation:none!important}}@media(prefers-reduced-motion){.esri-popup--aligned-top-center,.esri-popup--aligned-top-left,.esri-popup--aligned-top-right,.esri-popup--aligned-bottom-center,.esri-popup--aligned-bottom-left,.esri-popup--aligned-bottom-right,.esri-popup--is-docked{animation:none!important}}@media(prefers-reduced-motion:reduce){.esri-fov-overlay{animation:none!important}}@keyframes esri-fade-in-down{0%{opacity:0;transform:translateY(-5px)}25%{opacity:0;transform:translateY(-5px)}to{opacity:1;transform:translate(0)}}@keyframes esri-fade-in-up{0%{opacity:0;transform:translateY(5px)}25%{opacity:0;transform:translateY(5px)}to{opacity:1;transform:translate(0)}}@keyframes esri-fade-in{0%{opacity:0}25%{opacity:0}to{opacity:1}}@keyframes esri-fade-in-scale{0%{opacity:0;transform:scale(.95)}to{opacity:1;transform:scale(1)}}@keyframes looping-progresss-bar-ani{0%{width:0;left:0}20%{width:20%;left:0}80%{width:20%;left:80%}to{width:0;left:100%}}@keyframes esri-rotate{0%{transform:rotate(0)}to{transform:rotate(360deg)}}@keyframes panel-advance{0%{opacity:0;transform:translate(50px) scale(.99)}to{opacity:1;transform:translate(0) scale(1)}}@keyframes panel-retreat{0%{opacity:0;transform:translate(-50px) scale(.99)}to{opacity:1;transform:translate(0) scale(1)}}@keyframes panel-advance--rtl{0%{opacity:0;transform:translate(-50px) scale(.99)}to{opacity:1;transform:translate(0) scale(1)}}@keyframes panel-retreat--rtl{0%{opacity:0;transform:translate(50px) scale(.99)}to{opacity:1;transform:translate(0) scale(1)}}.esri-widget__heading{color:var(--calcite-color-text-2);margin:0 0 .5rem;font-weight:var(--calcite-font-weight-semibold)}h1.esri-widget__heading{font-size:var(--calcite-font-size-xl)}h2.esri-widget__heading{font-size:var(--calcite-font-size-md)}h3.esri-widget__heading,h4.esri-widget__heading,h5.esri-widget__heading,h6.esri-widget__heading{font-size:var(--calcite-font-size)}.esri-widget{box-sizing:border-box;color:var(--calcite-color-text-2);background-color:var(--calcite-color-foreground-1);font-size:var(--calcite-font-size);line-height:var(--calcite-font-line-height-relative-tight)}.esri-widget *,.esri-widget :before,.esri-widget :after{box-sizing:inherit}.esri-widget.esri-widget--disabled>*{opacity:.4;pointer-events:none}.esri-widget.esri-widget--compact{--esri-widget-padding-y: 0;--esri-widget-padding-x: 0}.esri-widget__anchor{color:var(--calcite-color-text-2)}.esri-widget__anchor:hover{color:var(--calcite-color-text-3)}.esri-widget__anchor:hover,.esri-widget__anchor:focus{text-decoration:underline}.esri-widget__anchor--disabled{opacity:.4;pointer-events:none}.esri-widget__header{background-color:var(--calcite-color-foreground-1);flex:1 0 100%;justify-content:space-between;align-items:center;width:100%;min-height:48px;padding:12px 0 12px 15px;display:flex}.esri-widget__heading{word-break:break-word}.esri-widget__header .esri-widget__heading{width:calc(100% - 48px);text-align:initial;color:var(--calcite-color-text-1);align-items:center;margin:0;padding:0;display:flex}.esri-widget__header-button{appearance:none;cursor:pointer;color:var(--calcite-color-text-2);background-color:var(--calcite-color-foreground-1);border:none;flex:0 0 48px;justify-content:center;align-self:stretch;align-items:center;width:48px;padding:0;display:flex}.esri-widget__footer{background-color:var(--calcite-color-foreground-1);justify-content:center;align-items:center;width:100%;min-height:48px;display:flex}.esri-widget__footer-pagination{color:var(--calcite-color-text-2);justify-content:space-between;align-items:center;display:flex}.esri-widget__footer-pagination-previous-button,.esri-widget__footer-pagination-next-button{cursor:pointer;background-color:var(--calcite-color-foreground-1);border:0;margin:0 7px;padding:12px 15px;transition:background-color .125s ease-in-out}.esri-widget__footer-pagination-previous-button:hover,.esri-widget__footer-pagination-previous-button:focus,.esri-widget__footer-pagination-next-button:hover,.esri-widget__footer-pagination-next-button:focus{color:var(--calcite-color-text-1);background-color:var(--calcite-color-foreground-1)}.esri-menu{visibility:hidden;z-index:1;background-clip:padding;background-color:var(--calcite-color-foreground-1);background-clip:padding-box;width:100%;max-height:0;margin:2px 0 0;padding:0;font-size:var(--calcite-font-size);line-height:var(--calcite-spacing-xl);position:absolute;top:100%;left:0;overflow:hidden;box-shadow:0 1px 2px #0000004d}.esri-menu .esri-menu__header{color:var(--calcite-color-text-inverse);background-color:var(--calcite-color-inverse);padding:6px 12px}.esri-menu__list{margin:0;padding:0;list-style:none}.esri-menu__list-item{cursor:pointer;border-top:1px solid #adadad4d;border-left:3px solid #0000;padding:.8em 1em}.esri-menu__list-item [class^=esri-icon-],.esri-menu__list-item [class*=" esri-icon-"]{padding-right:2.8px}.esri-menu__list-item:first-child{border-top:none}.esri-menu__list-item--focus,.esri-menu__list-item:hover,.esri-menu__list-item:focus{background-color:var(--calcite-color-foreground-1)}.esri-menu__list-item:active{background-color:var(--calcite-color-foreground-current)}.esri-menu__list-item--active,.esri-menu__list-item--active:hover,.esri-menu__list-item--active:focus{background-color:var(--calcite-color-foreground-1);border-left-color:var(--calcite-color-brand)}.esri-widget__table{border-collapse:collapse;color:var(--calcite-color-text-1);border:none;width:100%;line-height:var(--calcite-font-line-height-relative-tight)}.esri-widget__table tr:nth-child(odd){background-color:var(--calcite-color-transparent)}.esri-widget__table tr:nth-child(2n){background-color:var(--calcite-color-transparent-press)}.esri-widget__table tr a{color:var(--calcite-color-text-2)}.esri-widget__table tr a:hover,.esri-widget__table tr a:focus{color:var(--calcite-color-text-1)}.esri-widget__table tr td,.esri-widget__table tr th{vertical-align:top;word-break:break-word;padding:.5em .7em;font-size:var(--calcite-font-size-sm);font-weight:var(--calcite-font-weight-regular)}.esri-widget__table tr th{text-align:left;border-right:3px solid #0000000d;width:50%}.esri-widget__table tr td{width:50%}.esri-input{color:var(--calcite-color-text-1);background-color:var(--calcite-color-foreground-1);border:1px solid #959595;font-size:var(--calcite-font-size)}.esri-input::-ms-clear{display:none}.esri-input::placeholder{opacity:1;color:var(--calcite-color-text-2)}.esri-input:placeholder-shown{text-overflow:ellipsis}.esri-input[type=text],.esri-input[type=password],.esri-input[type=number]{height:32px;padding:0 .5em}calcite-combobox.esri-input{border:none}.esri-widget__content--empty{text-align:center;color:var(--calcite-color-border-input);flex-flow:column wrap;align-items:center;padding:18px 22px;display:flex}.esri-widget__content--empty h1.esri-widget__heading,.esri-widget__content--empty h2.esri-widget__heading,.esri-widget__content--empty h3.esri-widget__heading,.esri-widget__content--empty h4.esri-widget__heading,.esri-widget__content--empty h5.esri-widget__heading{font-weight:var(--calcite-font-weight-regular)}.esri-widget__content-illustration--empty{width:128px;padding:1rem 0}.esri-widget__content-icon--empty{width:32px;padding:.5rem 0}.esri-select{appearance:none;cursor:pointer;color:var(--calcite-color-text-2);background:var(--calcite-color-foreground-1) url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='-8 -8 32 32' width='32' height='32'%3E%3Cpath d='M8 11.207l-4-4V5.793l4 4 4-4v1.414z' fill='%23adadad' fillrule='nonzero'/%3E%3C/svg%3E") 100% no-repeat;border:1px solid #959595;border-radius:0;width:100%;height:32px;margin:0;padding:0 .5em;font-family:inherit;font-size:.85em;display:block}.esri-select[disabled]{cursor:auto}.esri-select::-ms-expand{display:none}.esri-disabled a,.esri-disabled [role=menu],.esri-disabled [role=checkbox],.esri-disabled [class^=esri-icon-],.esri-disabled [class*=" esri-icon-"]{color:var(--calcite-color-text-3)}.keynav-mode .esri-widget:focus,.keynav-mode .esri-widget :focus{z-index:1;outline-offset:2px;outline:2px solid #adadad}.esri-widget__loader-animation{border:.15em solid #adadad4d;border-top-color:var(--calcite-color-border-input);border-radius:100%;width:1em;height:1em;font-size:var(--calcite-font-size-md);animation:1.25s linear infinite esri-rotate;display:block;transform:translateZ(0)}:dir(rtl) .esri-widget__table th{text-align:right;border-left:3px solid #0000000d;border-right:none}:dir(rtl) .esri-select{background-position:0}:dir(rtl) .esri-menu__list-item{border-left:none;border-right:3px solid #0000}:dir(rtl) .esri-menu__list-item [class^=esri-icon-],:dir(rtl) .esri-menu__list-item [class*=" esri-icon-"]{padding-left:2px;padding-right:0}:dir(rtl) .esri-menu__list-item--active{border-right-color:var(--calcite-color-brand)}.esri-icon-font-fallback-text{clip:rect(0 0 0 0);width:1px;height:1px;position:absolute;overflow:hidden}.esri-rotating{animation:1.25s linear infinite esri-rotate;transform:translateZ(0)}.esri-clearfix:before,.esri-clearfix:after{content:" ";display:table}.esri-clearfix:after{clear:both}.esri-interactive{cursor:pointer}.esri-hidden{display:none!important}.esri-invisible{visibility:hidden!important}.esri-offscreen{position:absolute;top:-999em;left:-999em}.esri-match-height{flex-direction:column;flex:auto;display:flex;overflow:hidden}:host{min-width:300px}.esri-utility-network-trace{flex:auto;width:300px}.esri-utility-network-trace calcite-icon{box-sizing:initial}.esri-utility-network-trace calcite-tab{background-color:var(--calcite-color-foreground-2);padding-top:0;padding-bottom:0}.esri-utility-network-trace calcite-tab:not([selected]){flex:0}.esri-utility-network-trace.esri-component.esri-widget--panel{min-height:120px;width:300px}.esri-utility-network-trace__add-button-container{justify-content:center;margin:18px 0 var(--calcite-spacing-md);display:grid}.esri-utility-network-trace__block-container{margin-top:0;height:95%}.esri-utility-network-trace__block-content{border-bottom:none;margin:0}.esri-utility-network-trace__clear-results-block{position:absolute;bottom:0;left:0;margin:0;border-top:3px solid #6e6e6e26;background-color:#f3f3f3}.esri-utility-network-trace__divider{color:inherit;border-color:var(--calcite-color-border-input);border-bottom-style:solid;border-bottom-width:1px;flex:none;margin:0 0 var(--calcite-spacing-md)}.esri-utility-network-trace__double-pad-top{padding-top:10px}.esri-utility-network-trace__feature-content{height:300px}.esri-utility-network-trace__flow{height:100%}.esri-utility-network-trace__list-container{background-color:var(--calcite-color-foreground-1);padding:3px}.esri-utility-network-trace__notice-container{padding:var(--calcite-spacing-xs)}.esri-utility-network-trace__number-input{width:150px}.esri-utility-network-trace__pad-bottom{padding-bottom:5px}.esri-utility-network-trace__pad-top{padding-top:5px}.esri-utility-network-trace__reset-prompt{background-color:var(--calcite-color-background);color:var(--calcite-color-text-2);border-top:3px solid var(--calcite-color-border-input);flex-flow:column;max-height:85%;padding:var(--calcite-spacing-md) 15px;animation:.1s ease-in-out esri-fade-in-up;display:flex;position:absolute;bottom:0;left:0;right:0;box-shadow:0 1px 2px #0000004d}.esri-utility-network-trace__results-container{height:100%}.esri-utility-network-trace__tabs{min-height:250px;position:relative}`, c = s(r);
 class d extends o {
   constructor() {
-    super(...arguments), this.widget = c(this), this.viewModel = this.widget.viewModel, this.view = this.widget.view, this.autoDestroyDisabled = !1, this.defaultGraphicColor = this.widget.defaultGraphicColor, this.disabled = this.widget.disabled, this.enableResultArea = this.widget.enableResultArea, this.flags = this.widget.flags, this.icon = this.widget.icon, this.inputSettings = this.widget.inputSettings, this.label = this.widget.label, this.resultAreaProperties = this.widget.resultAreaProperties, this.selectOnCompleteDisabled = this.widget.selectOnComplete, this.selectedTraces = this.widget.selectedTraces, this.showGraphicsOnCompleteDisabled = this.widget.showGraphicsOnComplete, this.showSelectionAttributesDisabled = this.widget.showSelectionAttributes, this.state = this.viewModel.state, this.traceResults = this.widget.traceResults, this.arcgisAddFlag = e(() => this.widget, "add-flag"), this.arcgisAddFlagComplete = e(() => this.widget, "add-flag-complete"), this.arcgisAddFlagError = e(() => this.widget, "add-flag-error"), this.arcgisAddResultArea = e(() => this.widget, "add-result-area"), this.arcgisPropertyChange = i()("state"), this.arcgisReady = a(), this.arcgisRemoveResultArea = e(() => this.widget, "remove-result-area");
+    super(...arguments), this.widget = c(this), this.viewModel = this.widget.viewModel, this.view = this.widget.view, this.autoDestroyDisabled = !1, this.defaultGraphicColor = this.widget.defaultGraphicColor, this.disabled = this.widget.disabled, this.enableResultArea = this.widget.enableResultArea, this.flags = this.widget.flags, this.icon = this.widget.icon, this.inputSettings = this.widget.inputSettings, this.label = this.widget.label, this.resultAreaProperties = this.widget.resultAreaProperties, this.selectOnCompleteDisabled = this.widget.selectOnComplete, this.selectedTraces = this.widget.selectedTraces, this.showGraphicsOnCompleteDisabled = this.widget.showGraphicsOnComplete, this.showSelectionAttributesDisabled = this.widget.showSelectionAttributes, this.state = this.viewModel.state, this.traceResults = this.widget.traceResults, this.arcgisAddFlag = e(() => this.widget, "add-flag"), this.arcgisAddFlagComplete = e(() => this.widget, "add-flag-complete"), this.arcgisAddFlagError = e(() => this.widget, "add-flag-error"), this.arcgisAddResultArea = e(() => this.widget, "add-result-area"), this.arcgisPropertyChange = i()("state", "traceResults"), this.arcgisReady = a(), this.arcgisRemoveResultArea = e(() => this.widget, "remove-result-area");
   }
   static {
     this.properties = { view: 0, autoDestroyDisabled: 5, defaultGraphicColor: 0, disabled: 7, enableResultArea: 5, flags: 0, icon: 1, inputSettings: 0, label: 1, referenceElement: 1, resultAreaProperties: 0, selectOnCompleteDisabled: 5, selectedTraces: 0, showGraphicsOnCompleteDisabled: 5, showSelectionAttributesDisabled: 5, state: 32, traceResults: 32 };

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

@@ -1,16 +1,74 @@
 /// <reference path="../../index.d.ts" />
 import type Color from "@arcgis/core/Color.js";
-import type Graphic from "@arcgis/core/Graphic";
-import type MapView2 from "@arcgis/core/views/MapView.js";
+import type Graphic from "@arcgis/core/Graphic.js";
+import type MapView from "@arcgis/core/views/MapView.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
-import type { ArcgisReferenceElement } from "../../utils/component-utils.js";
+import type { ArcgisReferenceElement } from "../types.js";
 import type { SelectStartPayload } from "../arcgis-utility-network-trace-location/customElement.js";
 import type { ArcgisUtilityNetworkTraceResults } from "../arcgis-utility-network-trace-results/customElement.js";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
 import type { UtilityNetworkTraceAnalysisState } from "@arcgis/core/networks/UtilityNetworkTraceAnalysis.js";
 
-export type UtilityNetworkTraceAnalysisDisplayMode = "add-spatial-feature-list" | "add-spatial-feature" | "add-spatial-instructions" | "default";
-
+/**
+ * ## Overview
+ *
+ * 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).
+ * - Trace locations (starting points and barriers) are set by selecting features on the view.
+ * - When a subnetwork-based trace is selected, the component displays the domain, tier, and target tier specified by the selected named trace configuration.
+ * - If the user selects a subnetwork trace with a specified subnetwork name, the component provides an option to choose a subnetwork name instead of starting location(s) to run the trace with.
+ *
+ * Supported trace types are: `connected`, `upstream`, `downstream`, `shortest-path`, `subnetwork`, `subnetwork-controller`, `loops`, and `isolation`.
+ *
+ * The component can display the following from a trace result: elements (as [features](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-analysis/#traceResultFeatures)), aggregated geometries, and function results.
+ * If the trace result includes elements that originate from a [feature layer](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/)
+ * that is not included in the map, the Results tab displays an `Unknown` layer with a count of those elements.
+ * The component's [traceResultFeatures](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-analysis/#traceResultFeatures) property also does not include these elements.
+ *
+ * > [!WARNING]
+ * >
+ * > The Utility Network Trace Analysis component does not support proxied feature services or feature services that utilize stored credentials.
+ * >
+ * > This component also does not support `path` and `circuit` trace types or the `paths` and `circuits` result types.
+ *
+ * ## Working with nonspatial objects
+ *
+ * The Utility Network Trace Analysis component supports selecting nonspatial objects as trace locations by traversing associations.
+ *
+ * When selecting a trace location or viewing a trace result feature, information about the feature is displayed according to the
+ * [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/) of the layer that the feature belongs to.
+ * If the feature's layer has no PopupTemplate, a default template is used to display the feature's attributes.
+ *
+ * To select a nonspatial object as a trace location, first select a spatial feature on the map that is associated with the target nonspatial object.
+ * The spatial feature's layer must have a PopupTemplate that includes a [UtilityNetworkAssociationsContent](https://developers.arcgis.com/javascript/latest/references/core/popup/content/UtilityNetworkAssociationsContent/).
+ * Navigate through the spatial feature's associations to the target nonspatial object, then add the object as a trace location.
+ *
+ * ## Examples
+ *
+ * This component can be used slotted into an [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/):
+ *
+ * ```html
+ * <arcgis-map item-id="471eb0bf37074b1fbb972b1da70fb310">
+ *   <arcgis-utility-network-trace-analysis slot="bottom-left"></arcgis-utility-network-trace-analysis>
+ * </arcgis-map>
+ * ```
+ *
+ * Alternatively, this component can be used outside of a map by providing a [referenceElement](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-analysis/#referenceElement):
+ *
+ * ```html
+ * <calcite-shell>
+ *   <calcite-shell-panel slot="panel-start" position="start" width-scale="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>
+ * </calcite-shell>
+ * ```
+ *
+ * Note: Sign in to access the data in this demo, U/P: `viewer01`/`I68VGU^nMurF`
+ *
+ * @since 5.0
+ */
 export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
   /** @internal */
   protected _messages: {
@@ -70,15 +128,15 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
   }>;
   /**
    * The color used to render graphics for aggregated geometries in trace results, specified as a
-   * [Color](https://developers.arcgis.com/javascript/latest/api-reference/esri-Color.html) object.
+   * [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.
    *
-   * @see [Color constructor](https://developers.arcgis.com/javascript/latest/api-reference/esri-Color.html#constructors-summary)
+   * @see [Color constructor](https://developers.arcgis.com/javascript/latest/references/core/Color/#constructors-summary)
    */
   accessor aggregatedGeometryGraphicsColor: Color;
-  /** @default false */
-  accessor allowEditingDisabled: boolean;
   /**
    * 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
@@ -92,7 +150,7 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
   /**
    * A function to run before trace location selection starts.
    *
-   * @experimental
+   * @internal
    * @example
    * ```js
    * const traceElement = document.querySelector("arcgis-utility-network-trace-analysis");
@@ -100,11 +158,10 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
    * ```
    */
   accessor beforeTraceLocationSelectStart: (() => Promise<void>) | undefined;
-  /** @default false */
-  accessor closable: boolean;
   /**
    * Whether to disable highlighting trace result features on the map.
-   * If set to true, the features returned by a trace will not be highlighted on the map.
+   *
+   * If true, the features returned by a trace will not be highlighted on the map.
    *
    * @default false
    * @example
@@ -116,8 +173,18 @@ 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.
+   *
+   * @default false
+   * @internal
+   */
+  accessor hideActionBar: boolean;
   /**
    * Whether to hide feature results in the results tab.
+   *
    * If true, when features are returned by a trace, they will not be visible in the results tab.
    * A message will be displayed in its place indicating that features were returned by the trace, but are not visible in the results pane.
    * This string can be overridden with the `messageOverrides` property.
@@ -138,7 +205,7 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
    * ```
    */
   accessor hideFeatureResults: boolean;
-  accessor icon: string | undefined;
+  /** The component's default label. */
   accessor label: string | undefined;
   /**
    * Replace localized message strings with your own strings.
@@ -173,34 +240,35 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
           resultsTab?: string | undefined;
       } | undefined;
   };
-  accessor mode: string | undefined;
   /**
    * By assigning the `id` attribute of the Map or Scene component to this property, you can position a child component anywhere in the DOM while still maintaining a connection to the Map or Scene.
    *
    * @see [Associate components with a Map or Scene component](https://developers.arcgis.com/javascript/latest/programming-patterns/#associate-components-with-a-map-or-scene-component)
    */
   accessor referenceElement: ArcgisReferenceElement | string | undefined;
+  /** The current state of the component. */
+  get state(): UtilityNetworkTraceAnalysisState;
   /**
-   * The current state of the component.
+   * An array of features returned by the trace result.
    *
-   * @since 5.0
+   * This array is populated if the trace returned [element](https://developers.arcgis.com/javascript/latest/references/core/rest/networks/support/TraceResult/#elements) results.
+   *
+   * When [@arcgisTraceResultFeaturesReady](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-analysis/#event-arcgisTraceResultFeaturesReady) is raised, trace result features are available.
+   * When a new trace has been run, or the trace results are cleared, this array is cleared.
    */
-  get state(): UtilityNetworkTraceAnalysisState;
   get traceResultFeatures(): Graphic[];
   /**
-   * This property defines the target [MapView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html).
-   *
-   * @since 5.0
+   * 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: MapView2 | null | undefined;
+  accessor view: MapView | null | undefined;
   /** Permanently destroy the component. */
   destroy(): Promise<void>;
   /**
    * Fires when the user toggles displaying aggregated geometry results in the result pane.
    * Event payload contains a boolean representing whether the aggregated geometry graphics are hidden.
-   * If true, the user has hidden the graphics on the view's map.
+   * If true, the aggregated geometry graphics are hidden on the view.
    *
-   * @experimental
    * @example
    * ```js
    * const traceElement = document.querySelector("arcgis-utility-network-trace-analysis");
@@ -216,7 +284,7 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
   /**
    * Fires when the user completes the selection of a trace location.
    *
-   * @experimental
+   * @internal
    * @example
    * ```js
    * const traceElement = document.querySelector("arcgis-utility-network-trace-analysis");
@@ -231,7 +299,7 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
    * Event payload contains a callback method `cancelSelect` to cancel a selection in progress.
    * The event can also be prevented with `event.preventDefault()` to stop the selection.
    *
-   * @experimental
+   * @internal
    * @example
    * ```js
    * const traceElement = document.querySelector("arcgis-utility-network-trace-analysis");
@@ -256,7 +324,6 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
   /**
    * Fires when the trace result is cleared from the results tab.
    *
-   * @experimental
    * @example
    * ```js
    * const traceElement = document.querySelector("arcgis-utility-network-trace-analysis");
@@ -268,9 +335,8 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
   readonly arcgisTraceResultClear: import("@arcgis/lumina").TargetedEvent<this, void>;
   /**
    * Fires when the trace result features are ready.
-   * Check property `traceResultFeatures` for the trace result features.
+   * Check property [traceResultFeatures](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-analysis/#traceResultFeatures) for the trace result features.
    *
-   * @experimental
    * @example
    * ```js
    * const traceElement = document.querySelector("arcgis-utility-network-trace-analysis");