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

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

@@ -0,0 +1,201 @@
+/// <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";
+
+/**
+ * Trace result item for displaying [element](https://developers.arcgis.com/javascript/latest/references/core/rest/networks/support/TraceResult/#elements) 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 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 corresponding to the trace result elements. */
+  get features(): Graphic[];
+  /** The heading of the result item. */
+  accessor heading: string | undefined;
+  /**
+   * 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
+   */
+  accessor hideActionBar: boolean;
+  /**
+   * Whether to hide feature results.
+   * If true, the component renders a placeholder string instead of a button to view features.
+   * 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).
+   *
+   * @default false
+   */
+  accessor hideFeatureResults: boolean;
+  /**
+   * Whether to hide the placeholder string when feature results 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;
+  /**
+   * 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;
+  /**
+   * Whether the list of feature results is being viewed.
+   * When true, the component renders the trace result features as a list in the [arcgis-features-next](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/) component.
+   *
+   * This property is always false when [hideFeatureResults](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/#hideFeatureResults) is true.
+   *
+   * If [hideFeatureResults](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/#hideFeatureResults) is not set, then this property is true when
+   * the trace result only includes [elements](https://developers.arcgis.com/javascript/latest/references/core/rest/networks/support/TraceResult/#elements)
+   * or when the user has chosen to view Feature results in the trace component results tab.
+   *
+   * @default false
+   */
+  get isFeaturesListShown(): boolean;
+  /**
+   * The utility network layers used to query trace result features.
+   *
+   * If none are provided, the component uses all layers in the map belonging to
+   * the specified [utilityNetwork](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/#utilityNetwork).
+   */
+  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 unique network element results,
+   * including elements that did not match any layer in the map.
+   */
+  get numResults(): number;
+  /**
+   * 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 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;
+  /**
+   * Whether the component has finished querying trace result features.
+   *
+   * @default "ready"
+   */
+  get state(): UtilityNetworkTraceResultItemState;
+  /**
+   * The trace result containing the element results to render features for.
+   *
+   * @required
+   */
+  accessor traceResult: TraceResult | undefined;
+  /**
+   * The utility network used to query the trace result features.
+   *
+   * @required
+   */
+  accessor utilityNetwork: UtilityNetwork | 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-elements-result-item component will be associated with a map or scene component rather than using the `view` property.
+   */
+  accessor view: MapView | undefined;
+  /**
+   * Cancels any feature queries in progress, removes feature highlights from the map,
+   * and clears [features](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/#features).
+   */
+  clearResult(): void;
+  /** Permanently destroy the component. */
+  destroy(): Promise<void>;
+  readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "isFeaturesListShown" | "selectedResultFeature" | "state"; }>;
+  /** Fires when the component finishes querying all features for the trace result elements. */
+  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"];
+  };
+}

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

@@ -0,0 +1,189 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+import { c as R } from "../../chunks/runtime.js";
+import { ref as b } from "lit/directives/ref.js";
+import { getOrCreateMapValue as E } from "@arcgis/core/applications/Components/featureUtils.js";
+import { LitElement as L, createEvent as m } from "@arcgis/lumina";
+import { usePropertyChange as T, bypassReadOnly as h } from "@arcgis/lumina/controllers";
+import { log as d, composeMissingPropertyMessage as g } from "@arcgis/toolkit/log";
+import { css as v, html as y } from "lit";
+import { u as A } from "../../chunks/useT9n.js";
+import { i as p, l as w, t as u, c as I } from "../../chunks/async-utils.js";
+import { c as $, q as S, d as F, e as P } from "../../chunks/layer-utils.js";
+const D = v`arcgis-features-next{height:100%}.elements-list-item{border:solid 1px var(--calcite-color-border-3);border-radius:var(--calcite-corner-radius-sm)}.features-hidden{color:var(--calcite-color-text-3);font-size:var(--calcite-font-size);overflow-wrap:anywhere}`;
+class k extends L {
+  constructor() {
+    super(...arguments), this._messages = A({ blocking: !0 }), this.#n = !0, this.#s = [], this.#i = [], this.#r = /* @__PURE__ */ new Map(), this.#a = /* @__PURE__ */ new Map(), this.#l = /* @__PURE__ */ new Map(), this.#o = /* @__PURE__ */ new Map(), this.#e = [], this._isFeaturesSelected = !1, this.autoDestroyDisabled = !1, this.disableHighlight = !1, this.emitsArcgisResultReady = !0, this.features = [], this.hideActionBar = !1, this.hideFeatureResults = !1, this.hidePlaceholder = !1, this.includeDefaultActionsDisabled = !1, this.layers = [], this.state = "ready", this.arcgisPropertyChange = T()("isFeaturesListShown", "selectedResultFeature", "state"), this.arcgisTriggerAction = m(), this.arcgisResultReady = m();
+  }
+  static {
+    this.properties = { _featuresComponentElement: 16, _isFeaturesSelected: 16, actions: 0, autoDestroyDisabled: 5, disableHighlight: 5, emitsArcgisResultReady: 32, features: 32, heading: 1, hideActionBar: 5, hideFeatureResults: 5, hidePlaceholder: 5, includeDefaultActionsDisabled: 5, isFeaturesListShown: 32, layers: 0, messageOverrides: 0, numResults: 32, referenceElement: 1, selectedResultFeature: 32, state: 32, traceResult: 0, utilityNetwork: 0, view: 0 };
+  }
+  static {
+    this.styles = D;
+  }
+  #n;
+  #s;
+  get #h() {
+    if (!this.traceResult)
+      return !1;
+    const { elements: e, globalFunctionResults: t, aggregatedGeometry: s } = this.traceResult;
+    return e.length > 0 && !t.length && !s;
+  }
+  #i;
+  #r;
+  #a;
+  #t;
+  #l;
+  #o;
+  #e;
+  get isFeaturesListShown() {
+    return (this._isFeaturesSelected || this.#h) && !this.hideFeatureResults;
+  }
+  get numResults() {
+    return this.features.length + this.#s.length;
+  }
+  get selectedResultFeature() {
+    return this._featuresComponentElement?.selectedDrillInFeature ?? this._featuresComponentElement?.selectedFeature ?? void 0;
+  }
+  clearResult() {
+    this._isFeaturesSelected = !1, this.#t?.abort(), this.#c(), h(() => this.features = []), this.#e = [], this.#s = [], this.#r.clear(), this.#a.clear(), this.#l.clear(), this.#o.clear(), h(() => this.state = "ready");
+  }
+  async destroy() {
+    this.clearResult(), this._featuresComponentElement?.destroy(), await this.manager.destroy();
+  }
+  load() {
+    this.traceResult && this.#u();
+  }
+  willUpdate(e) {
+    e.has("traceResult") && this.#u(), e.has("_isFeaturesSelected") && (this.#h || (e.get("_isFeaturesSelected") ?? !1)) !== this.isFeaturesListShown && this.arcgisPropertyChange.emit({ name: "isFeaturesListShown" });
+  }
+  loaded() {
+    this.traceResult && (this.traceResult.elements || d("error", this, g("traceResult.elements")), this.utilityNetwork || d("error", this, g("utilityNetwork")));
+  }
+  #c() {
+    this.#i.forEach((e) => e.remove()), this.#i = [];
+  }
+  #d(e) {
+    e && (this._featuresComponentElement = e);
+  }
+  #f(e) {
+    return Array.from(new Map(e.map((t) => [t.globalId, t])).values());
+  }
+  #y(e) {
+    if (e == null || !this.#e.length)
+      return;
+    const t = this.#a.get(e);
+    if (t)
+      return t;
+    const s = this.#e.find((r) => "layerId" in r && r.layerId === e);
+    return s && this.#a.set(e, s), s;
+  }
+  #m() {
+    const { traceResult: e, utilityNetwork: t, view: s } = this;
+    if (!t || !e?.elements?.length || !s)
+      return;
+    const r = (i) => (P(i.layer) || F(i.layer)) && t.isUtilityLayer(i.layer), o = t.getObjectIdsFromElements(e.elements), n = s.allLayerViews.filter(r);
+    o.forEach(({ layerUrl: i, objectIds: l }) => {
+      const a = Number(i.split("/").pop()), c = n.find(({ layer: f }) => f.layerId === a);
+      if (c) {
+        const f = c.highlight(l);
+        this.#i.push(f);
+      }
+    });
+  }
+  async #g(e) {
+    const { layers: t, utilityNetwork: s, view: r } = this;
+    if (!r || !s)
+      return;
+    try {
+      s.loaded || await s.load({ signal: e });
+    } catch (i) {
+      if (p(i))
+        throw i;
+      w(i, this, "Error while loading the selected utility network");
+    }
+    u(e), this.#e = t.length ? t.filter((i) => s.isUtilityLayer(i)) : $(r, s);
+    const n = this.#e.filter((i) => !i.loaded).map((i) => i.load({ signal: e }));
+    if (n.length > 0) {
+      const i = await Promise.allSettled(n);
+      u(e), i.forEach((l) => {
+        l.status === "rejected" && d("error", this, `Failed to load layer. Reason: ${l.reason}`);
+      });
+    }
+  }
+  async #u() {
+    this.clearResult();
+    const e = () => {
+      h(() => this.state = "ready"), this.arcgisResultReady.emit();
+    }, t = I(async (s) => {
+      const r = this.traceResult?.elements;
+      if (!r?.length) {
+        e();
+        return;
+      }
+      h(() => this.state = "loading"), this.#F(r), await this.#g(s), await this.#w(s), u(s), this.disableHighlight || this.#m(), e();
+    });
+    this.#t = t;
+    try {
+      await t.promise;
+    } catch (s) {
+      p(s) || (w(s, this, "Error while loading trace result"), this.#t === t && e());
+    } finally {
+      this.#t === t && (this.#t = void 0, h(() => this.state = "ready"));
+    }
+  }
+  async #p([e, t], s) {
+    u(s);
+    const r = this.utilityNetwork?.getLayerIdBySourceId(e), o = this.#y(r), n = this.#f(t);
+    if (r == null || !o) {
+      this.#s.push(...n);
+      return;
+    }
+    const i = o.createQuery();
+    i.gdbVersion = this.utilityNetwork?.gdbVersion, i.objectIds = n.map((a) => a.objectId), i.outFields = ["*"];
+    const { features: l } = await S(o, i, { signal: s });
+    u(s), l.forEach((a) => {
+      const c = a.layer;
+      a.getEffectivePopupTemplate(this.#n) || (a.popupTemplate = c.createPopupTemplate());
+    }), F(o) ? l.forEach((a) => {
+      E(this.#l, a.layer.subtypeCode, () => []).push(a);
+    }) : this.#r.set(r, l);
+  }
+  async #w(e) {
+    const t = Array.from(this.#o.entries());
+    if (!t.length)
+      return;
+    const s = t.map((i) => this.#p(i, e)), r = await Promise.allSettled(s);
+    u(e), r.forEach((i, l) => {
+      if (i.status === "rejected") {
+        const [a] = t[l];
+        d("error", this, `Failed to query features for source ${a}. Reason: ${i.reason}`);
+      }
+    });
+    const o = Array.from(this.#r.values()), n = Array.from(this.#l.values());
+    h(() => this.features = o.concat(n).flat());
+  }
+  #F(e) {
+    this.#o = Map.groupBy(e, ({ networkSourceId: t }) => t);
+  }
+  #R(e) {
+    const { detail: t } = e;
+    (t.name === "selectedDrillInFeature" || t.name === "selectedFeature") && (e.stopPropagation(), this.arcgisPropertyChange.emit({ name: "selectedResultFeature" }));
+  }
+  #b(e) {
+    e.stopPropagation(), this.arcgisTriggerAction.emit(e.detail);
+  }
+  #E() {
+    return y`<div class="features-hidden">${this._messages.resultFeaturesAreHidden}</div>`;
+  }
+  #L() {
+    const { heading: e, _messages: t } = this;
+    return y`<calcite-list .label=${t.headings.features}><calcite-list-item class="elements-list-item" .label=${e || t.headings.features} @calciteListItemSelect=${() => this._isFeaturesSelected = !0}><calcite-chip .label=${t.labels.numFeatures} scale=s slot=content-end>${this.numResults}</calcite-chip><calcite-icon icon=chevron-right slot=content-end></calcite-icon></calcite-list-item></calcite-list>`;
+  }
+  render() {
+    return !this.traceResult?.elements.length || this.manager.destroyed ? null : this.hideFeatureResults ? this.hidePlaceholder ? null : this.#E() : this.isFeaturesListShown ? y`<arcgis-features-next .actions=${this.actions} .autoDestroyDisabled=${this.autoDestroyDisabled} .defaultPopupTemplateEnabled=${this.#n} .features=${this.features} .hideActionBar=${this.hideActionBar} .hideCloseButton=${this.#h} hide-select-feature .includeDefaultActionsDisabled=${this.includeDefaultActionsDisabled} initial-display-mode=list .messageOverrides=${this.messageOverrides} open .referenceElement=${this.referenceElement} .view=${this.view} @arcgisClose=${() => this._isFeaturesSelected = !1} @arcgisPropertyChange=${this.#R} @arcgisTriggerAction=${this.#b} ${b(this.#d)}></arcgis-features-next>` : this.#L();
+  }
+}
+R("arcgis-utility-network-trace-elements-result-item", k);
+export {
+  k as ArcgisUtilityNetworkTraceElementsResultItem
+};

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

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

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

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

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

@@ -0,0 +1,59 @@
+/// <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 { UtilityNetworkTraceResultItemState } from "../arcgis-utility-network-trace-analysis/types.js";
+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; };
+  }>;
+  /**
+   * Whether the component emits event [@arcgisResultReady](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-functions-result-item/#event-arcgisResultReady).
+   * This property is always `true` for [arcgis-utility-network-trace-functions-result-item](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-functions-result-item/).
+   *
+   * @default false
+   */
+  get emitsArcgisResultReady(): true;
+  /** The heading displayed above the result item. */
+  accessor heading: string | undefined;
+  /**
+   * @default "ready"
+   * @internal
+   */
+  get state(): UtilityNetworkTraceResultItemState;
+  /**
+   * The trace result containing the function results to render.
+   *
+   * @required
+   */
+  accessor traceResult: TraceResult | undefined;
+  /**
+   * Clears the result item.
+   * This result item has no side effects to clear.
+   *
+   * @internal
+   */
+  clearResult(): void;
+  /** Permanently destroy the component. */
+  destroy(): Promise<void>;
+  readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "state"; }>;
+  /** Fires when the component is finished rendering its results. */
+  readonly arcgisResultReady: import("@arcgis/lumina").TargetedEvent<this, void>;
+  readonly "@eventTypes": {
+    arcgisPropertyChange: ArcgisUtilityNetworkTraceFunctionsResultItem["arcgisPropertyChange"]["detail"];
+    arcgisResultReady: ArcgisUtilityNetworkTraceFunctionsResultItem["arcgisResultReady"]["detail"];
+  };
+}

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

@@ -0,0 +1,48 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+import { c as u } from "../../chunks/runtime.js";
+import { LitElement as m, createEvent as h } from "@arcgis/lumina";
+import { usePropertyChange as g, bypassReadOnly as d } from "@arcgis/lumina/controllers";
+import { log as b, composeEmptyPropertyMessage as R } from "@arcgis/toolkit/log";
+import { css as f, html as s } from "lit";
+import { u as p } from "../../chunks/useT9n.js";
+const y = f`calcite-table{--calcite-table-border-color: none}calcite-table-row{--calcite-table-row-border-color: var(--calcite-color-border-3)}.functions-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 w extends m {
+  constructor() {
+    super(...arguments), this._messages = p({ blocking: !0 }), this.emitsArcgisResultReady = !0, this.state = "ready", this.arcgisPropertyChange = g()("state"), this.arcgisResultReady = h();
+  }
+  static {
+    this.properties = { emitsArcgisResultReady: 32, heading: 1, state: 32, traceResult: 0 };
+  }
+  static {
+    this.styles = y;
+  }
+  clearResult() {
+  }
+  async destroy() {
+  }
+  load() {
+    this.traceResult && this.#t();
+  }
+  willUpdate(e) {
+    e.has("traceResult") && this.#t();
+  }
+  loaded() {
+    this.traceResult && !this.traceResult.globalFunctionResults.length && b("warn", this, R("traceResult.globalFunctionResults"));
+  }
+  #t() {
+    d(() => this.state = "ready"), this.arcgisResultReady.emit();
+  }
+  render() {
+    if (!this.traceResult?.globalFunctionResults.length)
+      return null;
+    const { heading: e, _messages: l } = this, { globalFunctionResults: a } = this.traceResult;
+    return s`${e && s`<div class="functions-heading">${e}</div>` || ""}<calcite-table .caption=${l.labels.functionResults}>${a.filter((t) => t.networkAttributeName != null && t.result != null && t.functionType != null).map((t) => {
+      const { functionName: i, networkAttributeName: c, functionType: r, result: o } = t, n = i || `${c} ${r}`;
+      return s`<calcite-table-row><calcite-table-cell>${n}</calcite-table-cell><calcite-table-cell>${o}</calcite-table-cell></calcite-table-row>`;
+    })}</calcite-table>`;
+  }
+}
+u("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

@@ -8,13 +8,11 @@ import type MapView from "@arcgis/core/views/MapView.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 import type { ArcgisReferenceElement } from "../types.js";
 import type { UtilityNetworkTraceAnalysisDisplayMode } from "../arcgis-utility-network-trace-analysis/types.js";
-import type { FlagInfo, SelectStartPayload } from "../arcgis-utility-network-trace-location/customElement.js";
+import type { TraceLocationDetails, SelectStartPayload } from "../arcgis-utility-network-trace-locations/customElement.js";
 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;
   /**
@@ -129,61 +136,57 @@ export abstract class ArcgisUtilityNetworkTraceInputs extends LitElement {
    * @default false
    * @internal
    */
-  accessor hideActionBar: boolean;
+  accessor hideFeaturesActionBar: 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.
    *
    * @internal
    */
-  get traceLocationFlagInfos(): Collection<FlagInfo>;
+  get traceLocationDetails(): Collection<TraceLocationDetails>;
   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.
-   *
-   * @internal
-   */
+  readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "mode" | "selectedNamedTraceConfiguration" | "selectedUtilityNetwork" | "traceLocations"; }>;
+  /** Fires when the user completes the selection of a trace location. */
   readonly arcgisTraceLocationSelectEnd: import("@arcgis/lumina").TargetedEvent<this, void>;
   /**
    * Fires when the user begins selection of a trace location.
    * Can be prevented to stop the selection.
-   *
-   * @internal
    */
   readonly arcgisTraceLocationSelectStart: import("@arcgis/lumina").TargetedEvent<this, SelectStartPayload>;
-  /** This will be fired less often than above, only when the utility network changes */
-  readonly arcgisUtilityNetworkChange: import("@arcgis/lumina").TargetedEvent<this, void>;
   readonly "@eventTypes": {
     arcgisPropertyChange: ArcgisUtilityNetworkTraceInputs["arcgisPropertyChange"]["detail"];
-    arcgisSelectedNamedTraceConfigurationChange: ArcgisUtilityNetworkTraceInputs["arcgisSelectedNamedTraceConfigurationChange"]["detail"];
-    arcgisTraceInputsChange: ArcgisUtilityNetworkTraceInputs["arcgisTraceInputsChange"]["detail"];
     arcgisTraceLocationSelectEnd: ArcgisUtilityNetworkTraceInputs["arcgisTraceLocationSelectEnd"]["detail"];
     arcgisTraceLocationSelectStart: ArcgisUtilityNetworkTraceInputs["arcgisTraceLocationSelectStart"]["detail"];
-    arcgisUtilityNetworkChange: ArcgisUtilityNetworkTraceInputs["arcgisUtilityNetworkChange"]["detail"];
   };
 }