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

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

@@ -0,0 +1,27 @@
+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";
+
+export type UtilityNetworkTraceAnalysisDisplayMode = "add-spatial-feature" | "add-spatial-instructions" | "default";
+
+/**
+ * Defines the common properties shared by all children of [arcgis-utility-network-trace-results-next](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results-next/).
+ *
+ * @internal
+ * @since 5.2
+ */
+export interface UtilityNetworkTraceResultItem {
+  /** The layers used by the result item. */
+  layers?: Layer[];
+  /** The heading of the result item. */
+  heading?: string;
+  /** The trace result used by the result item. */
+  traceResult?: TraceResult;
+  /** The utility network used by the result item. */
+  utilityNetwork?: UtilityNetwork;
+  /** The MapView used by the result item. */
+  view?: MapView;
+  /** A method to clean up side effects from the result item. */
+  clearResult?: () => void;
+}

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

@@ -0,0 +1,89 @@
+/// <reference path="../../index.d.ts" />
+import type NamedTraceConfiguration from "@arcgis/core/networks/support/NamedTraceConfiguration.js";
+import type UNTraceConfiguration from "@arcgis/core/networks/support/UNTraceConfiguration.js";
+import type UtilityNetwork from "@arcgis/core/networks/UtilityNetwork.js";
+import type { PublicLitElement as LitElement } from "@arcgis/lumina";
+import type { T9nMeta } from "@arcgis/lumina/controllers";
+
+/**
+ * Selects a named trace configuration from a list and displays subnetwork fields from the named trace configuration:
+ * Domain network name, tier name, and target tier name.
+ *
+ * @since 5.2
+ * @internal
+ */
+export abstract class ArcgisUtilityNetworkTraceConfigurationPicker extends LitElement {
+  /** @internal */
+  protected _messages: {
+      errors: {
+          noCompatibleSubnetworks: string;
+          noTraceConfiguration: string;
+          traceConfigurationNotFound: string;
+          noTraceConfigurations: string;
+      };
+      headings: {
+          domainNetwork: string;
+          targetTier: string;
+          tier: string;
+      };
+      instructions: { enterSubnetworkName: string; };
+      labels: {
+          subnetworkInfo: string;
+          subnetworkName: string;
+          tooManySubnetworks: string;
+          traceConfiguration: string;
+      };
+  } & T9nMeta<{
+      errors: {
+          noCompatibleSubnetworks: string;
+          noTraceConfiguration: string;
+          traceConfigurationNotFound: string;
+          noTraceConfigurations: string;
+      };
+      headings: {
+          domainNetwork: string;
+          targetTier: string;
+          tier: string;
+      };
+      instructions: { enterSubnetworkName: string; };
+      labels: {
+          subnetworkInfo: string;
+          subnetworkName: string;
+          tooManySubnetworks: string;
+          traceConfiguration: string;
+      };
+  }>;
+  accessor error: string | undefined;
+  accessor heading: string | undefined;
+  /** @default false */
+  accessor hideErrors: boolean;
+  /** @default false */
+  accessor hideSubnetworkInfo: boolean;
+  /**
+   * Whether a the user has selected a named trace configuration that executes a
+   * subnetwork trace with a specified subnetwork name.
+   *
+   * @default false
+   * @internal
+   */
+  get isSubnetworkNameTraceSelected(): boolean;
+  accessor selectedNamedTraceConfiguration: NamedTraceConfiguration | undefined;
+  /** @default "ready" */
+  accessor state: "error" | "loading" | "ready";
+  /**
+   * A clone of the utility network trace configuration associated with
+   * the selected named trace configuration. Updates on this object are
+   * used to reflect the user's changes to the named trace configuration.
+   */
+  accessor traceConfiguration: UNTraceConfiguration | undefined;
+  /** @required */
+  accessor traceConfigurations: NamedTraceConfiguration[];
+  /** @required */
+  accessor utilityNetwork: UtilityNetwork | undefined;
+  readonly arcgisError: import("@arcgis/lumina").TargetedEvent<this, void>;
+  readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "selectedNamedTraceConfiguration" | "traceConfiguration"; }>;
+  readonly "@eventTypes": {
+    arcgisError: ArcgisUtilityNetworkTraceConfigurationPicker["arcgisError"]["detail"];
+    arcgisPropertyChange: ArcgisUtilityNetworkTraceConfigurationPicker["arcgisPropertyChange"]["detail"];
+  };
+}

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

@@ -0,0 +1,137 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/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, 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-functions-result-item/customElement.d.ts

@@ -0,0 +1,30 @@
+/// <reference path="../../index.d.ts" />
+import type TraceResult from "@arcgis/core/rest/networks/support/TraceResult.js";
+import type { PublicLitElement as LitElement } from "@arcgis/lumina";
+import type { T9nMeta } from "@arcgis/lumina/controllers";
+
+/**
+ * Trace result item for displaying [function](https://developers.arcgis.com/javascript/latest/references/core/rest/networks/support/TraceResult/#globalFunctionResults) results from a trace.
+ *
+ * @internal
+ * @since 5.2
+ * @see [Set up functions](https://doc.esri.com/en/arcgis-pro/latest/help/data/utility-network/configure-a-trace.html#CBB)
+ */
+export abstract class ArcgisUtilityNetworkTraceFunctionsResultItem extends LitElement {
+  /** @internal */
+  protected _messages: {
+      componentLabel: string;
+      labels: { functionResults: string; };
+  } & T9nMeta<{
+      componentLabel: string;
+      labels: { functionResults: string; };
+  }>;
+  /** The heading displayed above the result item. */
+  accessor heading: string | undefined;
+  /**
+   * The trace result containing the function results to render.
+   *
+   * @required
+   */
+  accessor traceResult: TraceResult | undefined;
+}

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

@@ -0,0 +1,34 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
+import { c as m } from "../../chunks/runtime.js";
+import { css as g, html as e } from "lit";
+import { LitElement as b } from "@arcgis/lumina";
+import { log as l, composeMissingPropertyMessage as p, composeEmptyPropertyMessage as h } from "@arcgis/toolkit/log";
+import { u as f } from "../../chunks/useT9n.js";
+const d = g`calcite-table{--calcite-table-border-color: none}calcite-table-row{--calcite-table-row-border-color: var(--calcite-color-border-3)}.functions-heading{margin:var(--calcite-spacing-md) var(--calcite-spacing-md) var(--calcite-spacing-xxs);font-weight:var(--calcite-font-weight-medium);font-size:var(--calcite-font-size);color:var(--calcite-color-text-1)}`;
+class w extends b {
+  constructor() {
+    super(...arguments), this._messages = f({ blocking: !0 });
+  }
+  static {
+    this.properties = { heading: 1, traceResult: 0 };
+  }
+  static {
+    this.styles = d;
+  }
+  loaded() {
+    this.traceResult ? this.traceResult.globalFunctionResults.length || l("warn", this, h("traceResult")) : l("warn", this, p("traceResult"));
+  }
+  render() {
+    if (!this.traceResult?.globalFunctionResults.length)
+      return;
+    const { heading: c, _messages: s } = this, { globalFunctionResults: i } = this.traceResult;
+    return e`${c && e`<div class="functions-heading">${c}</div>` || ""}<calcite-table .caption=${s.labels.functionResults}>${i.filter((t) => t.networkAttributeName != null && t.result != null && t.functionType != null).map((t) => {
+      const { functionName: a, networkAttributeName: r, functionType: o, result: n } = t, u = a || `${r} ${o}`;
+      return e`<calcite-table-row><calcite-table-cell>${u}</calcite-table-cell><calcite-table-cell>${n}</calcite-table-cell></calcite-table-row>`;
+    })}</calcite-table>`;
+  }
+}
+m("arcgis-utility-network-trace-functions-result-item", w);
+export {
+  w as ArcgisUtilityNetworkTraceFunctionsResultItem
+};

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

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

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

@@ -0,0 +1,4 @@
+import "@esri/calcite-components/components/calcite-table";
+import "@esri/calcite-components/components/calcite-table-row";
+import "@esri/calcite-components/components/calcite-table-cell";
+export * from "./customElement.js";

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

@@ -13,8 +13,6 @@ import type { T9nMeta } from "@arcgis/lumina/controllers";
 
 /**
  * This is a sub-component used by the **ArcgisUtilityNetworkTraceAnalysis** component.
- *
- * This sub-component takes a map view as an input.
  * It allows users to select utility networks, trace configurations, and input features for tracing.
  *
  * @since 4.34
@@ -117,6 +115,15 @@ export abstract class ArcgisUtilityNetworkTraceInputs extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-utility-network-trace-inputs auto-destroy-disabled></arcgis-utility-network-trace-inputs>
+   * ```
+   *
+   * ```js
+   * utilityNetworkTraceInputsElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**
@@ -131,15 +138,29 @@ export abstract class ArcgisUtilityNetworkTraceInputs extends LitElement {
    */
   accessor hideActionBar: boolean;
   /**
+   * Whether a the user has selected a named trace configuration that executes a
+   * subnetwork trace with a specified subnetwork name.
+   *
    * @default false
    * @internal
    */
   get isSubnetworkNameTraceSelected(): boolean;
   /** @default "default" */
   accessor mode: UtilityNetworkTraceAnalysisDisplayMode;
+  /**
+   * 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;
   accessor selectedNamedTraceConfiguration: NamedTraceConfiguration | undefined;
   accessor selectedUtilityNetwork: UtilityNetwork | undefined;
+  /**
+   * A clone of the utility network trace configuration associated with
+   * the selected named trace configuration. Updates on this object are
+   * used to reflect the user's changes to the named trace configuration.
+   */
+  get traceConfiguration(): UNTraceConfiguration | undefined;
   /**
    * Supplementary information about the points selected on the map to run the trace.
    * I.e., feature title, terminal configuration, selected terminals, and spatial properties.
@@ -149,19 +170,15 @@ export abstract class ArcgisUtilityNetworkTraceInputs extends LitElement {
   get traceLocationFlagInfos(): Collection<FlagInfo>;
   get traceLocations(): TraceLocation[];
   /**
-   * A clone of the utility network trace configuration associated with
-   * the selected named trace configuration. Updates on this object are
-   * used to reflect the user's changes to the named trace configuration.
+   * 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-inputs component will be associated with a map or scene component rather than using the `view` property.
    */
-  get unTraceConfiguration(): UNTraceConfiguration | undefined;
-  /** @required */
   accessor view: MapView | undefined;
   /** Permanently destroy the component. */
   destroy(): Promise<void>;
   readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "mode"; }>;
   /** Fires when the user changes the selected named trace configuration. */
   readonly arcgisSelectedNamedTraceConfigurationChange: import("@arcgis/lumina").TargetedEvent<this, void>;
-  /** There will be more added to this event as we increase the functionality of this component */
   readonly arcgisTraceInputsChange: import("@arcgis/lumina").TargetedEvent<this, void>;
   /**
    * Fires when the user completes the selection of a trace location.
@@ -176,7 +193,7 @@ export abstract class ArcgisUtilityNetworkTraceInputs extends LitElement {
    * @internal
    */
   readonly arcgisTraceLocationSelectStart: import("@arcgis/lumina").TargetedEvent<this, SelectStartPayload>;
-  /** This will be fired less often than above, only when the utility network changes */
+  /** Fires when the user changes the selected utility network. */
   readonly arcgisUtilityNetworkChange: import("@arcgis/lumina").TargetedEvent<this, void>;
   readonly "@eventTypes": {
     arcgisPropertyChange: ArcgisUtilityNetworkTraceInputs["arcgisPropertyChange"]["detail"];