@arcgis/map-components 5.2.0-next.12 → 5.2.0-next.121

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/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, 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,193 @@
+/// <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 { 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 disableHighlightFeatureResults: boolean;
+  /** 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 map layers to derive utility network layers from.
+   *
+   * These layers are filtered by those belonging to the specified utility network.
+   * The utility network layers are used for querying the 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 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 "loading"
+   */
+  accessor state: State;
+  /**
+   * 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;
+  /** Destroys the `arcgis-features-next` component used to render the trace result 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"];
+  };
+}
+
+/** @internal */
+export type State = "loading" | "ready";

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

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