@arcgis/map-components 5.2.0-next.13 → 5.2.0-next.131

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

@@ -0,0 +1,130 @@
+/// <reference path="../../index.d.ts" />
+import type Color from "@arcgis/core/Color.js";
+import type Graphic from "@arcgis/core/Graphic.js";
+import type GraphicsLayer from "@arcgis/core/layers/GraphicsLayer.js";
+import type TraceResult from "@arcgis/core/rest/networks/support/TraceResult.js";
+import type MapView from "@arcgis/core/views/MapView.js";
+import type { PublicLitElement as LitElement } from "@arcgis/lumina";
+import type { UtilityNetworkTraceResultItemState } from "../arcgis-utility-network-trace-analysis/types.js";
+import type { T9nMeta } from "@arcgis/lumina/controllers";
+
+/**
+ * Trace result item for displaying [aggregated geometry](https://developers.arcgis.com/javascript/latest/references/core/rest/networks/support/TraceResult/#aggregatedGeometry) 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)
+ */
+export abstract class ArcgisUtilityNetworkTraceAggregatedGeometryResultItem extends LitElement {
+  /** @internal */
+  protected _messages: {
+      headings: { setColor: string; };
+      labels: {
+          aggregatedGeometryGraphicsColor: string;
+          showGraphicsToggle: string;
+      };
+      showGraphics: string;
+  } & T9nMeta<{
+      headings: { setColor: string; };
+      labels: {
+          aggregatedGeometryGraphicsColor: string;
+          showGraphicsToggle: string;
+      };
+      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-trace-aggregated-geometry-result-item/#destroy) method when you are done to
+   * prevent memory leaks.
+   *
+   * @default false
+   * @example
+   * ```html
+   * <arcgis-utility-network-trace-aggregated-geometry-result-item auto-destroy-disabled></arcgis-utility-network-trace-aggregated-geometry-result-item>
+   * ```
+   *
+   * ```js
+   * utilityNetworkTraceAggregatedGeometryResultItemElement.autoDestroyDisabled = true;
+   * ```
+   * 
+   */
+  accessor autoDestroyDisabled: boolean;
+  /**
+   * The size of the aggregated geometry graphics to render, in points.
+   *
+   * @default 12
+   */
+  accessor defaultSelectionSize: number;
+  /**
+   * Whether the component emits event [@arcgisResultReady](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-aggregated-geometry-result-item/#event-arcgisResultReady).
+   * This property is always `true` for [arcgis-utility-network-trace-aggregated-geometry-result-item](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-aggregated-geometry-result-item/).
+   *
+   * @default false
+   */
+  get emitsArcgisResultReady(): true;
+  /** The graphics which represent the aggregated geometry results from the trace. */
+  get geometryGraphics(): Graphic[];
+  /**
+   * The color used for the aggregated geometry graphics.
+   * Default value is #FFFF00.
+   */
+  accessor graphicsColor: Color;
+  /**
+   * The layer used to render the graphics which represent the aggregated geometry result.
+   * If this property is not specified, a new layer will be created on the map.
+   */
+  accessor graphicsLayer: GraphicsLayer | undefined;
+  /** The heading of the result item. */
+  accessor heading: string | undefined;
+  /**
+   * Whether to hide the aggregated geometry [graphics](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-aggregated-geometry-result-item/#geometryGraphics)
+   * from the map when the trace result contains aggregated geometry results.
+   *
+   * @default false
+   */
+  accessor hideGraphics: boolean;
+  /**
+   * Whether the component has finished adding aggregated geometry graphics to the map.
+   *
+   * @default "ready"
+   */
+  get state(): UtilityNetworkTraceResultItemState;
+  /**
+   * The trace result containing the aggregated geometry result to render graphics for.
+   *
+   * @required
+   */
+  accessor traceResult: TraceResult | 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-aggregated-geometry-result-item component will be associated with a map or scene component rather than using the `view` property.
+   *
+   * @required
+   */
+  accessor view: MapView | undefined;
+  /**
+   * Removes the aggregated geometry graphics from the
+   * [graphicsLayer](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-aggregated-geometry-result-item/#graphicsLayer).
+   * If the layer was created by the component, it is also removed from the map.
+   */
+  clearResult(): void;
+  /** Permanently destroy the component. */
+  destroy(): Promise<void>;
+  readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "defaultSelectionSize" | "hideGraphics" | "geometryGraphics" | "graphicsColor" | "state"; }>;
+  /**
+   * Fires when the component finishes processing the aggregated geometry results.
+   *
+   * If the component has a valid trace result with aggregated geometry results, this fires
+   * when the aggregated geometry graphics have been added to the map.
+   *
+   * If the component does not have a valid map or trace result, this fires when the
+   * component has finished loading.
+   */
+  readonly arcgisResultReady: import("@arcgis/lumina").TargetedEvent<this, void>;
+  readonly "@eventTypes": {
+    arcgisPropertyChange: ArcgisUtilityNetworkTraceAggregatedGeometryResultItem["arcgisPropertyChange"]["detail"];
+    arcgisResultReady: ArcgisUtilityNetworkTraceAggregatedGeometryResultItem["arcgisResultReady"]["detail"];
+  };
+}

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

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

package/dist/components/arcgis-utility-network-trace-aggregated-geometry-result-item/index.d.ts

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

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

@@ -0,0 +1,5 @@
+import "@esri/calcite-components/components/calcite-switch";
+import "@esri/calcite-components/components/calcite-swatch";
+import "@esri/calcite-components/components/calcite-popover";
+import "@esri/calcite-components/components/calcite-color-picker";
+export * from "./customElement.js";

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

@@ -2,9 +2,11 @@
 import type Color from "@arcgis/core/Color.js";
 import type Graphic from "@arcgis/core/Graphic.js";
 import type MapView from "@arcgis/core/views/MapView.js";
+import type { ActionEvent } from "@arcgis/core/widgets/Popup/types.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
+import type { ArcgisFeaturesNext } from "../arcgis-features-next/customElement.js";
 import type { ArcgisReferenceElement } from "../types.js";
-import type { SelectStartPayload } from "../arcgis-utility-network-trace-location/customElement.js";
+import type { SelectStartPayload } from "../arcgis-utility-network-trace-locations/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";
@@ -12,6 +14,12 @@ import type { UtilityNetworkTraceAnalysisState } from "@arcgis/core/networks/Uti
 /**
  * ## Overview
  *
+ * > [!WARNING]
+ * > This component is the successor to the `utility-network-trace-analysis` component.
+ * > The `utility-network-trace-analysis` component is being substantially refactored to expose public trace sub-components in release 5.2 and 6.0.
+ * > To avoid destabilizing the public version of `utility-network-trace-analysis`, the refactoring work is being performed in this component.
+ * > At release, this "next" component will replace the original.
+ *
  * The Utility Network Trace Analysis component allows users to run traces and view trace results in a utility network.
  *
  * - The component supports selecting a utility network and a named trace configuration in that utility network. Both the utility network and trace configuration must be [stored in the map](https://developers.arcgis.com/javascript/latest/references/core/WebMap/#utilityNetworks).
@@ -68,7 +76,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>
@@ -77,6 +85,10 @@ import type { UtilityNetworkTraceAnalysisState } from "@arcgis/core/networks/Uti
  *
  * Note: Sign in to access the data in this demo, U/P: `viewer01`/`I68VGU^nMurF`
  *
+ * @slot
+ * [results] - Slot for instances of [arcgis-utility-network-trace-results](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results/),
+ * for displaying the results of one or more traces.
+ * @internal
  * @since 5.0
  */
 export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
@@ -140,6 +152,16 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
           resultsTab: string;
       };
   }>;
+  /**
+   * A [collection](https://developers.arcgis.com/javascript/latest/references/core/core/Collection/) of [action button](https://developers.arcgis.com/javascript/latest/references/core/support/actions/ActionButton/) or [action toggle](https://developers.arcgis.com/javascript/latest/references/core/support/actions/ActionToggle/) objects. Each action may be executed by clicking the icon or image symbolizing them.
+   * There is a default `Zoom To` action styled with a magnifying glass icon to zoom in four LODs and center the map on the selected feature. This default action can be removed by setting [includeDefaultActionsDisabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-analysis/#includeDefaultActionsDisabled) to `true`, or by setting the [`overwriteActions`](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/#overwriteActions) property to `true` in a [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/).
+   *
+   * The order of each action is the order in which they appear in the actions [Collection](https://developers.arcgis.com/javascript/latest/references/core/core/Collection/). The [@arcgisTriggerAction](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-analysis/#event-arcgisTriggerAction) event fires each time an action is clicked.
+   *
+   * @see [@arcgisTriggerAction](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-analysis/#event-arcgisTriggerAction)
+   * @see [Popup actions sample](https://developers.arcgis.com/javascript/latest/sample-code/popup-actions/)
+   */
+  accessor actions: ArcgisFeaturesNext["actions"] | undefined;
   /**
    * The color used to render graphics for aggregated geometries in trace results, specified as a
    * [Color](https://developers.arcgis.com/javascript/latest/references/core/Color/) object.
@@ -148,6 +170,12 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
    *
    * Default color is #FFFF00.
    *
+   * @example
+   * Set the default aggregated geometry graphics color to lime green.
+   * ```js
+   * const traceElement = document.querySelector("arcgis-utility-network-trace-analysis");
+   * traceElement.aggregatedGeometryGraphicsColor = new Color("lime");
+   * ```
    * @see [Color constructor](https://developers.arcgis.com/javascript/latest/references/core/Color/#constructors-summary)
    */
   accessor aggregatedGeometryGraphicsColor: Color;
@@ -159,6 +187,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;
   /**
@@ -190,11 +227,10 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
   accessor disableHighlightFeatureResults: boolean;
   /**
    * Indicates whether to hide the action bar that holds the feature's
-   * [actions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#actions)
-   * when selecting trace locations and viewing trace result features.
+   * [arcgis-features-next.actions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#actions) when selecting trace locations
+   * and viewing trace result features.
    *
    * @default false
-   * @internal
    */
   accessor hideActionBar: boolean;
   /**
@@ -221,6 +257,41 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
    * ```
    */
   accessor hideFeatureResults: boolean;
+  /**
+   * Whether to hide the aggregated geometry [graphics](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-aggregated-geometry-result-item/#geometryGraphics)
+   * from the map when the trace result contains aggregated geometry results.
+   *
+   * @default false
+   */
+  accessor hideGraphics: boolean;
+  /**
+   * Whether to hide the placeholder string when feature results are hidden in the results tab.
+   *
+   * When this property and [hideFeatureResults](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-analysis/#hideFeatureResults) are both set to `true`,
+   * nothing is rendered for trace result elements. However, features are still queried and are available through
+   * [traceResultFeatures](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-analysis/#traceResultFeatures).
+   *
+   * @default false
+   * @example
+   * Hide the placeholder when feature results are hidden.
+   * ```html
+   * <arcgis-map item-id="471eb0bf37074b1fbb972b1da70fb310">
+   *   <arcgis-utility-network-trace-analysis
+   *     hide-feature-results
+   *     hide-placeholder
+   *     slot="top-right"
+   *   ></arcgis-utility-network-trace-analysis>
+   * </arcgis-map>
+   * ```
+   */
+  accessor hidePlaceholder: boolean;
+  /**
+   * Indicates whether default actions are disabled (hidden) when viewing trace result features.
+   * This property must be set to `true` to disable default actions.
+   *
+   * @default false
+   */
+  accessor includeDefaultActionsDisabled: boolean;
   /** The component's default label. */
   accessor label: string | undefined;
   /**
@@ -228,7 +299,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 +347,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. */
@@ -287,6 +358,7 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
    * Event payload contains a boolean representing whether the aggregated geometry graphics are hidden.
    * If true, the aggregated geometry graphics are hidden on the view.
    *
+   * @deprecated since 5.2. Use [@arcgisPropertyChange](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-analysis/#event-arcgisPropertyChange) instead.
    * @example
    * ```js
    * const traceElement = document.querySelector("arcgis-utility-network-trace-analysis");
@@ -297,7 +369,9 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
    * ```
    */
   readonly arcgisHideGraphicsChange: import("@arcgis/lumina").TargetedEvent<this, boolean>;
-  /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
+  /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
+  readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "aggregatedGeometryGraphicsColor" | "hideGraphics"; }>;
+  /** Emitted when the component associated with a map or scene view is ready for user interaction. */
   readonly arcgisReady: import("@arcgis/lumina").TargetedEvent<this, void>;
   /**
    * Fires when the user completes the selection of a trace location.
@@ -365,12 +439,16 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
    * ```
    */
   readonly arcgisTraceResultFeaturesReady: import("@arcgis/lumina").TargetedEvent<this, void>;
+  /** Emitted when an action is triggered on the component. */
+  readonly arcgisTriggerAction: import("@arcgis/lumina").TargetedEvent<this, ActionEvent>;
   readonly "@eventTypes": {
     arcgisHideGraphicsChange: ArcgisUtilityNetworkTraceAnalysis["arcgisHideGraphicsChange"]["detail"];
+    arcgisPropertyChange: ArcgisUtilityNetworkTraceAnalysis["arcgisPropertyChange"]["detail"];
     arcgisReady: ArcgisUtilityNetworkTraceAnalysis["arcgisReady"]["detail"];
     arcgisTraceLocationSelectEnd: ArcgisUtilityNetworkTraceAnalysis["arcgisTraceLocationSelectEnd"]["detail"];
     arcgisTraceLocationSelectStart: ArcgisUtilityNetworkTraceAnalysis["arcgisTraceLocationSelectStart"]["detail"];
     arcgisTraceResultClear: ArcgisUtilityNetworkTraceAnalysis["arcgisTraceResultClear"]["detail"];
     arcgisTraceResultFeaturesReady: ArcgisUtilityNetworkTraceAnalysis["arcgisTraceResultFeaturesReady"]["detail"];
+    arcgisTriggerAction: ArcgisUtilityNetworkTraceAnalysis["arcgisTriggerAction"]["detail"];
   };
 }