@arcgis/map-components 5.2.0-next.16 → 5.2.0-next.161

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

@@ -0,0 +1,137 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+import { c as d } from "../../chunks/runtime.js";
+import c from "@arcgis/core/networks/support/UNTraceConfiguration.js";
+import { LitElement as m, createEvent as h } from "@arcgis/lumina";
+import { u as b } from "../../chunks/useT9n.js";
+import { css as g, html as r } from "lit";
+import { log as l } from "@arcgis/toolkit/log";
+import { usePropertyChange as f } from "@arcgis/lumina/controllers";
+import { q as k } from "../../chunks/layer-utils.js";
+const w = g`:host{height:100%;flex-grow:1}.subnetwork-details{border-radius:var(--calcite-border-radius);border:solid 1px var(--calcite-color-border-3)}.key-value-pair{padding:var(--calcite-space-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)}calcite-block{--calcite-block-content-space: 0;--calcite-block-border-color: transparent;margin:0}calcite-block :is(calcite-combobox,calcite-input,calcite-label,calcite-notice){margin:0 var(--calcite-space-md) var(--calcite-space-md)}calcite-block>:last-child{margin-bottom:0}calcite-block calcite-input-message{padding:var(--calcite-space-sm) var(--calcite-space-md) 0}calcite-notice{margin:var(--calcite-space-md)}#subnetwork-info-block{margin:var(--calcite-space-md) var(--calcite-space-md) 0}.inline-loader{--calcite-loader-spacing: var(--calcite-space-md)}`, C = 20, p = /* @__PURE__ */ new Set(["subnetwork", "subnetwork-controller", "upstream", "downstream", "isolation"]);
+class N extends m {
+  constructor() {
+    super(...arguments), this._messages = b({ blocking: !0 }), this._subnetworkNamesState = "ready", this._compatibleSubnetworkNames = [], this.traceConfigurations = [], this.hideSubnetworkInfo = !1, this.hideErrors = !1, this.state = "ready", this.arcgisPropertyChange = f()("selectedNamedTraceConfiguration", "traceConfiguration"), this.arcgisError = h();
+  }
+  static {
+    this.properties = { _subnetworksTable: 16, _subnetworkNamesState: 16, _compatibleSubnetworkNames: 16, messageOverrides: 0, selectedNamedTraceConfiguration: 0, traceConfigurations: 0, utilityNetwork: 0, heading: 1, traceConfiguration: 0, isSubnetworkNameTraceSelected: 32, hideSubnetworkInfo: 5, hideErrors: 5, error: 1, state: 1 };
+  }
+  static {
+    this.styles = w;
+  }
+  get #e() {
+    return this.traceConfiguration?.subnetworkName ?? void 0;
+  }
+  set #e(e) {
+    this.traceConfiguration && (this.traceConfiguration.subnetworkName = e);
+  }
+  get isSubnetworkNameTraceSelected() {
+    const { selectedNamedTraceConfiguration: e } = this;
+    return !!e?.traceConfiguration?.subnetworkName && e?.traceType === "subnetwork";
+  }
+  willUpdate(e) {
+    e.has("traceConfigurations") && this.#m(), e.has("selectedNamedTraceConfiguration") && this.#o(), e.has("utilityNetwork") && this.#d();
+  }
+  async #o() {
+    const { selectedNamedTraceConfiguration: e, _messages: t } = this;
+    if (!(e?.traceConfiguration instanceof c)) {
+      this.#t(t.errors.noTraceConfiguration), this.traceConfiguration = void 0, this.arcgisPropertyChange.emit({ name: "traceConfiguration" });
+      return;
+    }
+    this.#i(), this.traceConfiguration = e.traceConfiguration.clone(), this.arcgisPropertyChange.emit({ name: "selectedNamedTraceConfiguration" }), this.arcgisPropertyChange.emit({ name: "traceConfiguration" }), this.isSubnetworkNameTraceSelected && (this._subnetworkNamesState = "loading", this.state = "loading", await this.#s(this.traceConfiguration), this._subnetworkNamesState = "ready", this.state = "ready");
+  }
+  async #s(e) {
+    await this.#n(), await this.#c(), e.subnetworkName && !this._compatibleSubnetworkNames.some((t) => t === e.subnetworkName) && (this.#e = this._compatibleSubnetworkNames.at(0));
+  }
+  async #n() {
+    this._subnetworksTable || (this._subnetworksTable = await this.utilityNetwork?.loadSubnetworksTable());
+  }
+  async #c() {
+    const { _subnetworksTable: e } = this;
+    if (!e)
+      return;
+    const t = e.fieldsIndex.get("SUBNETWORKNAME"), i = (s, n, u) => n === 0 || s.getAttribute(t.name) !== u[n - 1].getAttribute(t.name), a = e.createQuery();
+    a.gdbVersion = this.utilityNetwork?.gdbVersion, a.where = this.#l(), a.outFields = [t.name], a.orderByFields = [t.name];
+    const { features: o } = await k(e, a, void 0, !1);
+    this._compatibleSubnetworkNames = o.filter(i).map((s) => s.getAttribute(t.name));
+  }
+  #l() {
+    const e = this.traceConfiguration, t = `DOMAINNETWORKNAME = '${e.domainNetworkName}'`, i = `TIERNAME = '${e.tierName}'`;
+    return [t, i].join(" AND ");
+  }
+  #u(e) {
+    const t = this.traceConfigurations.find((i) => i.globalId === e);
+    if (!t) {
+      this.#t(this._messages.errors.traceConfigurationNotFound), this.traceConfiguration = void 0, this.selectedNamedTraceConfiguration = void 0;
+      return;
+    }
+    this.#i(), this.selectedNamedTraceConfiguration = t;
+  }
+  #d() {
+    this.#e = void 0, this._subnetworksTable = void 0, this._compatibleSubnetworkNames = [];
+  }
+  #m() {
+    this.traceConfiguration = void 0, this.selectedNamedTraceConfiguration = void 0, this.traceConfigurations.length ? (this.#i(), this.selectedNamedTraceConfiguration = this.traceConfigurations.find((e) => e.traceConfiguration instanceof c), this.#o()) : this.#t(this._messages.errors.noTraceConfigurations);
+  }
+  #t(e) {
+    l("error", this, e), this.error = e, this.state = "error", this.arcgisError.emit();
+  }
+  #i() {
+    this.error = void 0, this.state = "ready";
+  }
+  #a(e, t) {
+    return r`<div class="key-value-pair"><div class="key-value-pair__key">${e}</div><div class="key-value-pair__value">${t}</div></div>`;
+  }
+  #r(e, t = !1, i = "exclamation-mark-triangle") {
+    return this.hideErrors ? null : r`<calcite-notice .closable=${t} kind=danger open scale=s width=auto .icon=${i}><div slot=message>${e}</div></calcite-notice>`;
+  }
+  #h() {
+    const { selectedNamedTraceConfiguration: e } = this;
+    return r`<calcite-label>${e?.title}</calcite-label>`;
+  }
+  #b() {
+    const e = this.traceConfigurations.map((i) => r`<calcite-combobox-item .value=${i.globalId} .heading=${i.title} .selected=${i.globalId === this.selectedNamedTraceConfiguration?.globalId}></calcite-combobox-item>`), t = this._messages.labels.traceConfiguration;
+    return r`<calcite-combobox .label=${t} selection-mode=single-persist @calciteComboboxChange=${({ currentTarget: i }) => {
+      const a = i.selectedItems[0]?.value;
+      this.#u(a);
+    }}>${e}</calcite-combobox>`;
+  }
+  #g() {
+    const { _messages: e } = this;
+    if (this.error === e.errors.noTraceConfigurations)
+      return this.#r(e.errors.noTraceConfigurations);
+    const t = this.error ? this.#r(this.error) : null, i = this.traceConfigurations.length > 1 ? this.#b() : this.#h(), a = this._messages.labels.traceConfiguration, o = this.heading ?? a;
+    return r`<calcite-block .heading=${o} .label=${a} expanded>${i}${t}</calcite-block>`;
+  }
+  #f() {
+    if (this.hideSubnetworkInfo)
+      return null;
+    const { _messages: e, selectedNamedTraceConfiguration: t } = this;
+    if (!t?.traceConfiguration)
+      return this.traceConfiguration = void 0, this.#t(this._messages.errors.noTraceConfiguration), null;
+    this.#i();
+    const { domainNetworkName: i, tierName: a, targetTierName: o } = t.traceConfiguration;
+    return !i && !a && !o ? (l("warn", this, "`namedTraceConfig.traceConfiguration` has no `domainNetworkName`, `tierName`, or `targetTierName`."), null) : r`<calcite-block id=subnetwork-info-block expanded .label=${this._messages.labels.subnetworkInfo}><div class="subnetwork-details">${i ? this.#a(e.headings.domainNetwork, i) : null}${a ? this.#a(e.headings.tier, a) : null}${o ? this.#a(e.headings.targetTier, o) : null}</div></calcite-block>`;
+  }
+  #k() {
+    const { _messages: e } = this, t = e.labels.subnetworkName;
+    return this.isSubnetworkNameTraceSelected ? this._subnetworkNamesState === "loading" ? r`<calcite-loader class="inline-loader" label=loading scale=s></calcite-loader>` : this._compatibleSubnetworkNames.length ? r`<calcite-block .heading=${t} .label=${t} expanded>${this._compatibleSubnetworkNames.length > C ? this.#w() : this.#C()}</calcite-block>` : this.#r(e.errors.noCompatibleSubnetworks) : null;
+  }
+  #w() {
+    const { _messages: e } = this;
+    return r`<calcite-input clearable type=text .placeholder=${e.instructions.enterSubnetworkName} max-length=64 .status=${this.#e ? "valid" : "invalid"} .value=${this.#e} @calciteInputInput=${(t) => this.#e = t.target.value}></calcite-input><calcite-input-message icon=exclamation-mark-triangle status=idle>${e.labels.tooManySubnetworks}</calcite-input-message>`;
+  }
+  #C() {
+    return r`<calcite-combobox .label=${this._messages.labels.subnetworkName} selection-mode=single-persist @calciteComboboxChange=${({ currentTarget: e }) => {
+      const t = e.selectedItems[0]?.value;
+      this.#e = t;
+    }}>${this._compatibleSubnetworkNames.map((e) => r`<calcite-combobox-item .value=${e} .heading=${e} .selected=${e === this.#e}></calcite-combobox-item>`)}</calcite-combobox>`;
+  }
+  render() {
+    const { selectedNamedTraceConfiguration: e } = this, i = e?.traceType && p.has(e.traceType) ? r`${this.#f()}${this.#k()}` : null;
+    return r`${this.#g()}${i}`;
+  }
+}
+d("arcgis-utility-network-trace-configuration-picker", N);
+export {
+  N as ArcgisUtilityNetworkTraceConfigurationPicker
+};

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

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

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

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

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

@@ -0,0 +1,281 @@
+/// <reference path="../../index.d.ts" />
+import type Graphic from "@arcgis/core/Graphic.js";
+import type Layer from "@arcgis/core/layers/Layer.js";
+import type UtilityNetwork from "@arcgis/core/networks/UtilityNetwork.js";
+import type TraceResult from "@arcgis/core/rest/networks/support/TraceResult.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 { UtilityNetworkTraceResultItemState } from "../arcgis-utility-network-trace-analysis/types.js";
+import type { T9nMeta } from "@arcgis/lumina/controllers";
+
+/**
+ * The Utility Network Trace Elements Result Item component displays features corresponding to the
+ * [elements](https://developers.arcgis.com/javascript/latest/references/core/rest/networks/support/TraceResult/#elements)
+ * returned by a utility network trace. It queries utility network layers for features, highlights trace elements
+ * in the view, and uses [arcgis-features-next](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/) to display the queried features in a list.
+ *
+ * For traces containing only element results, the features list opens automatically. For traces containing multiple
+ * result types, users open the features list by selecting the elements result item in the trace results component.
+ * See [isFeaturesListShown](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/#isFeaturesListShown) for details.
+ *
+ * Add this component directly to the default slot of [arcgis-utility-network-trace-results](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results/).
+ * The parent supplies the required read-only properties for the
+ * [trace result](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/#traceResult),
+ * [utility network](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/#utilityNetwork), and
+ * [MapView](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/#view).
+ * Configure other settings, such as [layers](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/#layers),
+ * [disableHighlight](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/#disableHighlight), and
+ * [hideFeatureResults](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/#hideFeatureResults), on this component.
+ *
+ * By default, the [arcgis-utility-network-trace-results](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results/) component displays the
+ * [aggregated geometry](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-aggregated-geometry-result-item/),
+ * [elements](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/), and
+ * [functions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-functions-result-item/) result items for the result types
+ * returned by the trace. Adding content to its default slot replaces all default result items. Add each result item
+ * that the custom configuration should display.
+ *
+ * Use [layers](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/#layers) to restrict feature queries to
+ * specific utility network layers.
+ *
+ * @since 5.2
+ * @example
+ * The following example displays element results in a custom set of trace result items.
+ * Providing result items in the default slot replaces the parent's default result items.
+ * This example displays only element results.
+ * ```html
+ * <arcgis-map item-id="471eb0bf37074b1fbb972b1da70fb310">
+ *   <arcgis-utility-network-trace-analysis slot="bottom-left">
+ *     <arcgis-utility-network-trace-results slot="results">
+ *       <arcgis-utility-network-trace-elements-result-item></arcgis-utility-network-trace-elements-result-item>
+ *     </arcgis-utility-network-trace-results>
+ *   </arcgis-utility-network-trace-analysis>
+ * </arcgis-map>
+ * ```
+ * @example
+ * Using the markup above, register these listeners before running a trace to access the queried features
+ * when the elements result item is ready and respond when the selected result feature changes.
+ * ```js
+ * const resultItem = document.querySelector("arcgis-utility-network-trace-elements-result-item");
+ *
+ * resultItem.addEventListener("arcgisResultReady", () => {
+ *   console.log("Trace result features:", resultItem.features);
+ * });
+ *
+ * resultItem.addEventListener("arcgisPropertyChange", (event) => {
+ *   if (event.detail.name === "selectedResultFeature") {
+ *     console.log("Selected feature:", resultItem.selectedResultFeature);
+ *   }
+ * });
+ * ```
+ * @see [Result types](https://doc.esri.com/en/arcgis-pro/latest/help/data/utility-network/configure-a-trace.html#DA5)
+ * @see [arcgis-utility-network-trace-results](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results/)
+ * @see [arcgis-utility-network-trace-analysis](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-analysis/)
+ * @see [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/)
+ * @see [arcgis-utility-network-trace-functions-result-item](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-functions-result-item/)
+ */
+export abstract class ArcgisUtilityNetworkTraceElementsResultItem extends LitElement {
+  /** @internal */
+  protected _messages: {
+      headings: { features: string; };
+      labels: { numFeatures: string; };
+      resultFeaturesAreHidden: string;
+  } & T9nMeta<{
+      headings: { features: string; };
+      labels: { numFeatures: string; };
+      resultFeaturesAreHidden: 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-elements-result-item/#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-elements-result-item/#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-elements-result-item/#event-arcgisTriggerAction)
+   * @see [Popup actions sample](https://developers.arcgis.com/javascript/latest/sample-code/popup-actions/)
+   */
+  accessor actions: ArcgisFeaturesNext["actions"] | undefined;
+  /**
+   * 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-elements-result-item/#destroy) method when you are done to
+   * prevent memory leaks.
+   *
+   * @default false
+   * @example
+   * ```html
+   * <arcgis-utility-network-trace-elements-result-item auto-destroy-disabled></arcgis-utility-network-trace-elements-result-item>
+   * ```
+   *
+   * ```js
+   * utilityNetworkTraceElementsResultItemElement.autoDestroyDisabled = true;
+   * ```
+   * 
+   */
+  accessor autoDestroyDisabled: boolean;
+  /**
+   * Whether to disable highlighting trace result features on the map.
+   * If true, the features returned by a trace will not be highlighted on the map.
+   *
+   * @default false
+   */
+  accessor disableHighlight: boolean;
+  /**
+   * Whether the component emits event [@arcgisResultReady](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/#event-arcgisResultReady).
+   * This property is always `true` for [arcgis-utility-network-trace-elements-result-item](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/).
+   *
+   * @default false
+   */
+  get emitsArcgisResultReady(): true;
+  /**
+   * The features successfully queried for the current trace result elements.
+   * Elements without a matching query layer are not included.
+   */
+  get features(): Graphic[];
+  /**
+   * The label of the elements result item that opens the features list.
+   * If not specified or empty, the component uses its localized default label.
+   */
+  accessor heading: string | undefined;
+  /**
+   * Whether to hide the action bar when viewing trace result features.
+   * The action bar contains the feature's [actions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#actions).
+   *
+   * @default false
+   */
+  accessor hideActionBar: boolean;
+  /**
+   * Whether to hide the elements result item and the features list.
+   * If true, the component renders a placeholder string instead of the elements result item.
+   * When true, features are still queried and are available through [features](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/#features).
+   *
+   * This property does not disable highlighting. Use
+   * [disableHighlight](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/#disableHighlight) to hide trace-element highlights.
+   *
+   * @default false
+   */
+  accessor hideFeatureResults: boolean;
+  /**
+   * Whether to hide the placeholder string when the elements result item and the features list are hidden.
+   *
+   * When this property and [hideFeatureResults](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/#hideFeatureResults) are both set to `true`,
+   * nothing is rendered for trace result elements. However, features are still queried and are available through
+   * [features](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/#features).
+   *
+   * @default false
+   */
+  accessor hidePlaceholder: boolean;
+  /**
+   * Whether to hide the default actions when viewing trace result features.
+   *
+   * @default false
+   */
+  accessor includeDefaultActionsDisabled: boolean;
+  /**
+   * Whether the features list is currently displayed.
+   * Returns `true` when the component is displaying the features list using the [arcgis-features-next](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/) component.
+   *
+   * Always returns `false` when [hideFeatureResults](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/#hideFeatureResults) is set to `true`.
+   *
+   * If [hideFeatureResults](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/#hideFeatureResults) is not set, the features list opens automatically when
+   * a trace result containing only [elements](https://developers.arcgis.com/javascript/latest/references/core/rest/networks/support/TraceResult/#elements) loads,
+   * or when the user selects the [elements result item](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/). Closing the features list causes this property to return `false`.
+   *
+   * @default false
+   */
+  get isFeaturesListShown(): boolean;
+  /**
+   * The utility network layers and tables used to query trace result features.
+   *
+   * When the array is empty, the component uses the map's layers and tables that belong to
+   * the selected [utilityNetwork](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/#utilityNetwork).
+   * Entries that do not belong to that utility network are ignored.
+   *
+   * Set this property before the trace result is processed. Changing it does not requery the current result.
+   *
+   * This property restricts which layers are queried for features. It does not restrict highlighting of trace result features.
+   */
+  accessor layers: Layer[];
+  /**
+   * Replace localized message strings with your own strings.
+   *
+   * _**Note**: Individual message keys may change between releases._
+   */
+  accessor messageOverrides: NonNullable<ArcgisFeaturesNext["messageOverrides"]> & {
+      headings?: { features?: string | undefined; } | undefined;
+      labels?: { numFeatures?: string | undefined; } | undefined;
+      resultFeaturesAreHidden?: string | undefined;
+  };
+  /**
+   * The number of successfully queried features plus unique trace elements without a matching query layer.
+   *
+   * This value can be lower than the number of elements returned by the trace. For example:
+   * - Trace result elements that only differ by a terminal ID are treated as one feature.
+   * - Feature queries may fail or return no matching features.
+   */
+  get numResults(): number;
+  /**
+   * The reference element, or its ID, forwarded to the embedded
+   * [Features component](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#referenceElement).
+   *
+   * Setting this property does not remove the requirement to use this component as a child of
+   * [arcgis-utility-network-trace-results](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results/).
+   */
+  accessor referenceElement: ArcgisReferenceElement | string | undefined;
+  /**
+   * The currently selected trace result feature.
+   *
+   * This property also returns associated features that have been selected via
+   * [association content](https://developers.arcgis.com/javascript/latest/references/core/popup/content/UtilityNetworkAssociationsContent/)
+   * in a [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/).
+   */
+  get selectedResultFeature(): Graphic | undefined;
+  /**
+   * The processing state of the elements result item: `"loading"` while processing a trace result and `"ready"` when no
+   * processing is in progress. A `"ready"` state does not necessarily mean that every feature query succeeded.
+   *
+   * @default "ready"
+   */
+  get state(): UtilityNetworkTraceResultItemState;
+  /** The trace result containing the element results to render features for. */
+  get traceResult(): TraceResult | undefined;
+  /** The utility network used to query the trace result features. */
+  get utilityNetwork(): UtilityNetwork | undefined;
+  /**
+   * The MapView supplied by the parent [arcgis-utility-network-trace-results](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results/) component.
+   * Used to query utility network layers and highlight trace elements.
+   */
+  get view(): MapView | undefined;
+  /**
+   * Cancels feature queries in progress, removes trace-element highlights from the map,
+   * clears [features](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/#features), closes the features list,
+   * and resets [state](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/#state) to `"ready"`.
+   *
+   * Does not clear the parent-provided [traceResult](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/#traceResult)
+   * or emit [@arcgisResultReady](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/#event-arcgisResultReady).
+   */
+  clearResult(): void;
+  /** Permanently destroy the component. */
+  destroy(): Promise<void>;
+  /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
+  readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "features" | "isFeaturesListShown" | "selectedResultFeature" | "state"; }>;
+  /**
+   * Fires when processing the current trace result finishes, including when a query fails.
+   * The [features](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/#features) property contains the features
+   * successfully queried.
+   *
+   * Clearing an in-progress result with
+   * [clearResult()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/#clearResult) does not emit this event.
+   */
+  readonly arcgisResultReady: import("@arcgis/lumina").TargetedEvent<this, void>;
+  /** Emitted when an action is triggered on the component. */
+  readonly arcgisTriggerAction: import("@arcgis/lumina").TargetedEvent<this, ActionEvent>;
+  readonly "@eventTypes": {
+    arcgisPropertyChange: ArcgisUtilityNetworkTraceElementsResultItem["arcgisPropertyChange"]["detail"];
+    arcgisResultReady: ArcgisUtilityNetworkTraceElementsResultItem["arcgisResultReady"]["detail"];
+    arcgisTriggerAction: ArcgisUtilityNetworkTraceElementsResultItem["arcgisTriggerAction"]["detail"];
+  };
+}