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

package/dist/components/arcgis-utility-network-validate-network-topology/customElement.d.ts

@@ -0,0 +1,296 @@
+/// <reference path="../../index.d.ts" />
+import type UtilityNetwork from "@arcgis/core/networks/UtilityNetwork.js";
+import type ValidateNetworkTopologyResult from "@arcgis/core/rest/networks/support/ValidateNetworkTopologyResult.js";
+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 { T9nMeta } from "@arcgis/lumina/controllers";
+
+/** Component state when validation is unavailable because the component cannot run. */
+export interface Disabled {
+  type: "disabled";
+}
+
+/** Component state while utility network topology validation is currently running. */
+export interface Executing {
+  type: "executing";
+}
+
+/** Component state while component dependencies are loading. */
+export interface Loading {
+  type: "loading";
+}
+
+/** Component state when component dependencies are loaded and validation can execute. */
+export interface Ready {
+  type: "ready";
+}
+
+/** Component state after validation completes successfully. */
+export interface Success {
+  type: "success";
+  message: string;
+}
+
+/** Component state when validation or setup encounters an error. */
+export interface ValidateNetworkTopologyError {
+  /**
+   * The type of error the component has encountered:
+   *
+   * - `error-disable-component`: The component is disabled because the component could not find a utility network in the map.
+   * - `error-disable-execute`: The component cannot run validation because the user lacks permissions or the dirty areas layer is missing from the map.
+   * - `error-info`: Some other error occurred while running validation. The error is displayed in the component.
+   */
+  type: "error-disable-component" | "error-disable-execute" | "error-info";
+  /** Additional information about the error the component has encountered. */
+  message: string;
+}
+
+/** The extent options for network topology validation. */
+export type ExtentOption = "current" | "entire";
+
+/** The current component workflow state. */
+export type State = Disabled | Executing | Loading | Ready | Success | ValidateNetworkTopologyError;
+
+/**
+ * ## Overview
+ *
+ * The Utility Network Validate Network Topology component validates dirty areas in a utility network after edits have been made.
+ * It provides an interface to choose a utility network (if applicable), choose the [extent](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-validate-network-topology/#extentToValidate) to validate, and perform validation.
+ * If successful, the result of the validation is available as [result](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-validate-network-topology/#result).
+ *
+ * ## Validation requirements
+ *
+ * - The component only supports a 2D [MapView](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/).
+ * - The utility network must be [stored in the map](https://developers.arcgis.com/javascript/latest/references/core/WebMap/#utilityNetworks) and the network topology must be enabled.
+ * - The active portal user must have the required user type extension to validate a network topology.
+ * - Validation fails in cases such as: no dirty areas in the target extent, inability to acquire a version lock, or insufficient permissions on the version.
+ *
+ * > [!WARNING]
+ * >
+ * > The Utility Network Validate Network Topology component does not support proxied feature services or feature services that utilize stored credentials.
+ *
+ * ## Examples
+ *
+ * This component can be used slotted into an [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/):
+ *
+ * ```html
+ * <arcgis-map item-id="471eb0bf37074b1fbb972b1da70fb310">
+ *   <arcgis-utility-network-validate-network-topology slot="top-right"></arcgis-utility-network-validate-network-topology>
+ * </arcgis-map>
+ * ```
+ *
+ * Alternatively, this component can be used outside of a map by providing a [referenceElement](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-validate-network-topology/#referenceElement):
+ *
+ * ```html
+ * <calcite-shell>
+ *   <calcite-shell-panel slot="panel-start" position="start" width-scale="l">
+ *     <arcgis-utility-network-validate-network-topology reference-element="#map-element"></arcgis-utility-network-validate-network-topology>
+ *   </calcite-shell-panel>
+ *   <arcgis-map id="map-element" item-id="471eb0bf37074b1fbb972b1da70fb310"></arcgis-map>
+ * </calcite-shell>
+ * ```
+ *
+ * <video src="https://developers.arcgis.com/javascript/latest/assets/references/components/utility-network-validate-network-topology/validate-topology-example.webm" autoplay loop muted playsInline></video>
+ *
+ * @since 5.1
+ * @see [Network topology](https://pro.arcgis.com/en/pro-app/latest/help/data/utility-network/about-network-topology.htm)
+ * @see [Validate a network topology](https://pro.arcgis.com/en/pro-app/latest/help/data/utility-network/validate-a-network-topology.htm)
+ * @see [Dirty areas](https://pro.arcgis.com/en/pro-app/latest/help/data/utility-network/dirty-areas-in-a-utility-network.htm)
+ */
+export abstract class ArcgisUtilityNetworkValidateNetworkTopology extends LitElement {
+  /** @internal */
+  protected _messages: {
+      componentLabel: string;
+      actions: { validateTopology: string; };
+      errors: {
+          cannotAcquireVersionLock: string;
+          noAdvancedEditingUserTypeExtension: string;
+          noDirtyAreasInExtent: string;
+          noDirtyAreasLayer: string;
+          noUtilityNetwork: string;
+          noUtilityNetworks: string;
+          noUtilityNetworkServiceUserTypeExtension: string;
+          noView: string;
+          operationOnlyAllowedByOwner: string;
+          sceneViewNotSupported: string;
+          utilityNetworkLoadFailed: string;
+      };
+      info: { validateCanceled: string; };
+      input: {
+          selectExtent: {
+              label: string;
+              options: {
+                  currentExtent: string;
+                  entireExtent: string;
+              };
+          };
+          selectUtilityNetwork: { label: string; };
+      };
+      status: {
+          executing: string;
+          success: string;
+      };
+  } & T9nMeta<{
+      componentLabel: string;
+      actions: { validateTopology: string; };
+      errors: {
+          cannotAcquireVersionLock: string;
+          noAdvancedEditingUserTypeExtension: string;
+          noDirtyAreasInExtent: string;
+          noDirtyAreasLayer: string;
+          noUtilityNetwork: string;
+          noUtilityNetworks: string;
+          noUtilityNetworkServiceUserTypeExtension: string;
+          noView: string;
+          operationOnlyAllowedByOwner: string;
+          sceneViewNotSupported: string;
+          utilityNetworkLoadFailed: string;
+      };
+      info: { validateCanceled: string; };
+      input: {
+          selectExtent: {
+              label: string;
+              options: {
+                  currentExtent: string;
+                  entireExtent: string;
+              };
+          };
+          selectUtilityNetwork: { label: string; };
+      };
+      status: {
+          executing: string;
+          success: string;
+      };
+  }>;
+  /**
+   * A function to run before utility network topology validation starts.
+   *
+   * The function is awaited before the [@arcgisValidateNetworkTopologyStart](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-validate-network-topology/#event-arcgisValidateNetworkTopologyStart)
+   * event is emitted and before the validation request is sent.
+   * If the function rejects its Promise, validation does not start and the component displays an error. If the Promise was rejected with an [Error](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error), the component displays the error.
+   *
+   * @internal
+   * @example
+   * ```js
+   * const validateNetworkTopologyElement = document.querySelector("arcgis-utility-network-validate-network-topology");
+   * validateNetworkTopologyElement.beforeValidateNetworkTopologyStart = async () => await doAsyncWork();
+   * ```
+   */
+  accessor beforeValidateNetworkTopologyStart: (() => Promise<void>) | undefined;
+  /**
+   * When true, the component is visually withdrawn and cannot receive user interaction.
+   *
+   * @default false
+   */
+  accessor disabled: boolean;
+  /**
+   * Specifies the area to validate.
+   *
+   * Use `"current"` to validate the current view extent. Use `"entire"` to validate the utility network's full extent.
+   *
+   * @default "current"
+   */
+  accessor extentToValidate: ExtentOption;
+  /**
+   * When true, hides the utility network selector.
+   *
+   * The selector is also hidden when the map has one utility network.
+   *
+   * @default false
+   */
+  accessor hideUtilityNetworkSelect: boolean;
+  /** The component's default label. */
+  accessor label: string | undefined;
+  /**
+   * Replace localized message strings with your own strings.
+   *
+   * _**Note**: Individual message keys may change between releases._
+   */
+  accessor messageOverrides: {
+      componentLabel?: string | undefined;
+      actions?: { validateTopology?: string | undefined; } | undefined;
+      errors?: {
+          cannotAcquireVersionLock?: string | undefined;
+          noAdvancedEditingUserTypeExtension?: string | undefined;
+          noDirtyAreasInExtent?: string | undefined;
+          noDirtyAreasLayer?: string | undefined;
+          noUtilityNetwork?: string | undefined;
+          noUtilityNetworks?: string | undefined;
+          noUtilityNetworkServiceUserTypeExtension?: string | undefined;
+          noView?: string | undefined;
+          operationOnlyAllowedByOwner?: string | undefined;
+          sceneViewNotSupported?: string | undefined;
+          utilityNetworkLoadFailed?: string | undefined;
+      } | undefined;
+      info?: { validateCanceled?: string | undefined; } | undefined;
+      input?: {
+          selectExtent?: {
+              label?: string | undefined;
+              options?: {
+                  currentExtent?: string | undefined;
+                  entireExtent?: string | undefined;
+              } | undefined;
+          } | undefined;
+          selectUtilityNetwork?: { label?: string | undefined; } | undefined;
+      } | undefined;
+      status?: {
+          executing?: string | undefined;
+          success?: string | undefined;
+      } | undefined;
+  };
+  /**
+   * 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 result returned from the most recent successful utility network topology validation.
+   * This value is cleared when clicking the "Validate" action.
+   */
+  accessor result: ValidateNetworkTopologyResult | undefined;
+  /** The current component state. */
+  get state(): State;
+  /**
+   * The utility network to validate.
+   *
+   * If not provided, the component uses the first utility network stored in the map. When the map contains multiple
+   * utility networks and the selector is visible, the user can change this value from the component UI.
+   */
+  accessor utilityNetwork: UtilityNetwork | undefined;
+  /**
+   * The target [MapView](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/).
+   *
+   * The component only supports 2D map views.
+   */
+  accessor view: MapView | undefined;
+  /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
+  readonly arcgisReady: import("@arcgis/lumina").TargetedEvent<this, void>;
+  /**
+   * Fires after a validation workflow ends.
+   *
+   * This event fires after validation succeeds, fails, or is canceled by preventing the
+   * [@arcgisValidateNetworkTopologyStart](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-validate-network-topology/#event-arcgisValidateNetworkTopologyStart) event.
+   */
+  readonly arcgisValidateNetworkTopologyEnd: import("@arcgis/lumina").TargetedEvent<this, void>;
+  /**
+   * Fires before the validation request is sent.
+   *
+   * This event can be prevented with `event.preventDefault()` to cancel validation.
+   *
+   * @example
+   * ```js
+   * const validateNetworkTopologyElement = document.querySelector("arcgis-utility-network-validate-network-topology");
+   * validateNetworkTopologyElement.addEventListener("arcgisValidateNetworkTopologyStart", (event) => {
+   *   event.preventDefault();
+   * });
+   * ```
+   */
+  readonly arcgisValidateNetworkTopologyStart: import("@arcgis/lumina").TargetedEvent<this, void>;
+  readonly "@eventTypes": {
+    arcgisReady: ArcgisUtilityNetworkValidateNetworkTopology["arcgisReady"]["detail"];
+    arcgisValidateNetworkTopologyEnd: ArcgisUtilityNetworkValidateNetworkTopology["arcgisValidateNetworkTopologyEnd"]["detail"];
+    arcgisValidateNetworkTopologyStart: ArcgisUtilityNetworkValidateNetworkTopology["arcgisValidateNetworkTopologyStart"]["detail"];
+  };
+}

package/dist/components/arcgis-utility-network-validate-network-topology/customElement.js

@@ -0,0 +1,208 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
+import { c as k } from "../../chunks/runtime.js";
+import { css as _, html as s } from "lit";
+import { getOwningPortalUrl as N, hasUserTypeExtension as V } from "@arcgis/core/applications/Components/featureUtils.js";
+import "@arcgis/core/core/Error.js";
+import { on as b, watch as $ } from "@arcgis/core/core/reactiveUtils.js";
+import T from "@arcgis/core/portal/Portal.js";
+import "@arcgis/core/rest/networks/support/ValidateNetworkTopologyResult.js";
+import { LitElement as A, createEvent as u, nothing as l } from "@arcgis/lumina";
+import { log as d, composeMissingPropertyMessage as y } from "@arcgis/toolkit/log";
+import { generateGuid as E } from "@arcgis/toolkit/string";
+import { u as U } from "../../chunks/useT9n.js";
+import { u as L } from "../../chunks/useView.js";
+import { c as S, i as C, l as I, t as n } from "../../chunks/async-utils.js";
+import { d as O } from "../../chunks/layer-utils.js";
+const D = _`:host{--arcgis-internal-color-black-30: color-mix(in srgb, #000000 30.2%, transparent);--arcgis-internal-box-shadow: var(--calcite-spacing-none) var(--calcite-spacing-px) var(--calcite-spacing-base) var(--arcgis-internal-color-black-30);--arcgis-internal-top-max-width: calc(min(100cqw, 100vw) - var(--calcite-spacing-xxxl));--arcgis-internal-panel-width: 300px;--arcgis-internal-panel-height: 100%;--arcgis-internal-panel-height-sm: 240px;--arcgis-internal-panel-height-md: 420px;--arcgis-internal-panel-height-lg: 540px;--arcgis-internal-panel-height-xl: 680px;--arcgis-internal-panel-gap: var(--calcite-spacing-lg);--arcgis-internal-panel-actions-gap: var(--calcite-spacing-sm);--arcgis-internal-basemap-gallery-width-lg: 450px;--arcgis-internal-collapse-icon-flip: scaleX(1);--arcgis-internal-row-direction: row;--arcgis-internal-legend-width: 300px;--arcgis-internal-layout-overlay-space-top: var(--arcgis-layout-overlay-space-top, 0px);--arcgis-internal-layout-overlay-space-bottom: var(--arcgis-layout-overlay-space-bottom, 0px);--arcgis-internal-layout-overlay-space-left: var(--arcgis-layout-overlay-space-left, 0px);--arcgis-internal-layout-overlay-space-right: var(--arcgis-layout-overlay-space-right, 0px);--arcgis-internal-view-color-focus: var(--arcgis-view-color-focus, var(--calcite-color-brand));--arcgis-internal-attribution-space-bottom: var(--arcgis-internal-layout-overlay-space-bottom);--arcgis-internal-attribution-space-left: var(--arcgis-internal-layout-overlay-space-left);--arcgis-internal-attribution-space-right: var(--arcgis-internal-layout-overlay-space-right);--arcgis-internal-attribution-font-size: var(--calcite-font-size-sm);--arcgis-internal-attribution-font-size-sm: var(--calcite-font-size-xs);--arcgis-internal-sketch-justify-content: flex-start}:host{display:flex;flex-direction:column;height:var(--arcgis-internal-panel-height, 100%)}calcite-block{margin:0;border-bottom:none}calcite-combobox{margin-bottom:var(--calcite-spacing-sm)}calcite-icon{width:32px}`, p = {
+  noDirtyAreasInExtent: -2147208940,
+  operationOnlyAllowedByOwner: -2147217144,
+  cannotAcquireVersionLockV10: -2147217146,
+  cannotAcquireVersionLockV11: -2147220947
+};
+class q extends A {
+  constructor() {
+    super(...arguments), this._messages = U({ blocking: !0 }), this._unVntGuid = `unvnt_${E()}`, this.disabled = !1, this.extentToValidate = "current", this.hideUtilityNetworkSelect = !1, this.state = { type: "disabled" }, this.view = L(this), this.arcgisReady = u(), this.arcgisValidateNetworkTopologyEnd = u(), this.arcgisValidateNetworkTopologyStart = u();
+  }
+  static {
+    this.properties = { beforeValidateNetworkTopologyStart: 0, disabled: 5, extentToValidate: 1, hideUtilityNetworkSelect: 5, label: 1, messageOverrides: 0, referenceElement: 1, result: 0, state: 0, utilityNetwork: 0, view: 0 };
+  }
+  static {
+    this.styles = D;
+  }
+  async loaded() {
+    this.manager.onLifecycle(() => [
+      b(() => this.view?.map?.allLayers, "change", (e) => {
+        const t = e.added.concat(e.removed);
+        this._getDirtyAreasLayer(t) && this._runSetup();
+      }),
+      b(() => this.view?.map?.utilityNetworks, "change", () => {
+        this._runSetup();
+      }),
+      $(() => this.view, () => {
+        this._runSetup();
+      }, { initial: !0 })
+    ]);
+  }
+  _getDirtyAreasLayer(e) {
+    const t = this.utilityNetwork?.networkSystemLayers.dirtyAreasLayerUrl;
+    if (t)
+      return e.find((i) => O(i) && `${i.url}/${i.layerId}` === t);
+  }
+  async _handleValidateNetworkTopologyAction() {
+    try {
+      if (this.result = void 0, !this.view) {
+        this.state = { type: "error-disable-component", message: this._messages.errors.noView };
+        return;
+      }
+      if (!this.utilityNetwork) {
+        this.state = { type: "error-disable-component", message: this._messages.errors.noUtilityNetworks };
+        return;
+      }
+      this.beforeValidateNetworkTopologyStart && await this.beforeValidateNetworkTopologyStart();
+      const { view: e, utilityNetwork: t } = this;
+      if (!e) {
+        this.state = { type: "error-disable-component", message: this._messages.errors.noView };
+        return;
+      }
+      if (!t) {
+        this.state = { type: "error-disable-component", message: this._messages.errors.noUtilityNetwork }, d("warn", this, y("utilityNetwork"));
+        return;
+      }
+      if (this.arcgisValidateNetworkTopologyStart.emit().defaultPrevented) {
+        d("info", this, this._messages.info.validateCanceled);
+        return;
+      }
+      this.state = { type: "executing" };
+      const r = {
+        outSpatialReference: e.spatialReference?.clone() || null,
+        validateArea: this.extentToValidate === "current" || !t.fullExtent ? e.extent.clone() : t.fullExtent.clone()
+      };
+      this.result = await t.validateTopology(r), this.state = { type: "success", message: this._messages.status.success };
+    } catch (e) {
+      const { _messages: { errors: { cannotAcquireVersionLock: t, noDirtyAreasInExtent: i, operationOnlyAllowedByOwner: r } } } = this;
+      this.result = void 0;
+      const o = e, a = o.details?.raw?.extendedCode;
+      let c = o.message || this._messages.info.validateCanceled;
+      switch (a) {
+        case p.noDirtyAreasInExtent:
+          c = i;
+          break;
+        case p.cannotAcquireVersionLockV10:
+        case p.cannotAcquireVersionLockV11:
+          c = t;
+          break;
+        case p.operationOnlyAllowedByOwner:
+          c = r;
+          break;
+      }
+      this.state = { type: "error-info", message: c };
+    } finally {
+      this.arcgisValidateNetworkTopologyEnd.emit();
+    }
+  }
+  async _runSetup() {
+    this._setupTask?.abort();
+    const e = S(async (t) => {
+      this.state = { type: "loading" }, this.result = void 0;
+      const { view: i } = this;
+      if (!i) {
+        this.utilityNetwork = void 0, this.state = { type: "error-disable-component", message: this._messages.errors.noView }, d("warn", this, y("view"));
+        return;
+      }
+      if (i.type !== "2d") {
+        this.utilityNetwork = void 0, this.state = { type: "error-disable-component", message: this._messages.errors.sceneViewNotSupported };
+        return;
+      }
+      const r = i.map;
+      await r.load({ signal: t }), n(t);
+      const o = r.utilityNetworks ?? null;
+      if (!o?.length) {
+        this.utilityNetwork = void 0, this.state = { type: "error-disable-component", message: this._messages.errors.noUtilityNetworks };
+        return;
+      }
+      let a = this.utilityNetwork;
+      if ((!a || !o.find((f) => f.id === a?.id)) && (a = o.getItemAt(0)), !a) {
+        this.state = { type: "error-disable-component", message: this._messages.errors.noUtilityNetworks }, d("warn", this, y("utilityNetwork"));
+        return;
+      }
+      await a.load({ signal: t }), n(t);
+      const g = (Number(a.sourceJSON.currentVersion) || 0) <= 11.1 ? "utilityNetwork" : "advediting", w = await N(a.layerUrl, { signal: t }) ?? void 0;
+      n(t);
+      const h = new T({ url: w });
+      await h.load({ signal: t }), n(t);
+      const x = h.user?.username ?? "", v = await V(h, x, g);
+      if (n(t), this._utilityNetworks = o, this.utilityNetwork = a, !v) {
+        this.state = g === "advediting" ? { type: "error-disable-execute", message: this._messages.errors.noAdvancedEditingUserTypeExtension } : {
+          type: "error-disable-execute",
+          message: this._messages.errors.noUtilityNetworkServiceUserTypeExtension
+        };
+        return;
+      }
+      const m = this._getDirtyAreasLayer(r.allLayers.toArray());
+      if (!m) {
+        this.state = { type: "error-disable-execute", message: this._messages.errors.noDirtyAreasLayer };
+        return;
+      }
+      await m.load({ signal: t }), n(t), this.state = { type: "ready" };
+    });
+    this._setupTask = e;
+    try {
+      await e.promise;
+    } catch (t) {
+      if (C(t))
+        return;
+      this.state = { type: "error-disable-execute", message: this._messages.errors.utilityNetworkLoadFailed }, I(t, this, this.state.message);
+    } finally {
+      this._setupTask === e && (this._setupTask = void 0);
+    }
+  }
+  _renderExtentToValidateCombobox() {
+    if (this.state.type !== "error-disable-component")
+      return s`<calcite-combobox .disabled=${this.disabled || this.state.type === "disabled" || this.state.type === "executing"} .label=${this._messages.input.selectExtent.label} .labelText=${this._messages.input.selectExtent.label} selection-mode=single-persist @calciteComboboxChange=${(e) => {
+        this.extentToValidate = e.target.value;
+      }}><calcite-combobox-item .heading=${this._messages.input.selectExtent.options.currentExtent} .selected=${this.extentToValidate === "current"} value=current></calcite-combobox-item><calcite-combobox-item .heading=${this._messages.input.selectExtent.options.entireExtent} .selected=${this.extentToValidate === "entire"} value=entire></calcite-combobox-item></calcite-combobox>`;
+  }
+  _renderInfoNotice() {
+    if (this.state.type === "error-disable-component" || this.state.type === "error-disable-execute" || this.state.type === "error-info" || this.state.type === "success")
+      return s`<calcite-notice .closable=${this.state.type === "error-info" || this.state.type === "success"} .kind=${this.state.type === "success" ? "success" : "warning"} open scale=s width=full @calciteNoticeClose=${() => this.state = { type: "ready" }}><div slot=message>${this.state.message}</div></calcite-notice>`;
+  }
+  _renderStatusIcon() {
+    const e = `${this._unVntGuid}_status-icon`;
+    switch (this.state.type) {
+      case "error-disable-component":
+      case "error-disable-execute":
+      case "error-info":
+        return s`<calcite-icon icon=exclamation-mark-triangle id=${e ?? l} scale=s slot=actions-end></calcite-icon>`;
+      case "executing":
+        return s`<calcite-action loading disabled slot=actions-end .text=${this._messages.status.executing}></calcite-action>`;
+      case "success":
+        return s`<calcite-icon icon=check-circle id=${e ?? l} scale=s slot=actions-end></calcite-icon>`;
+      default:
+        return s`<calcite-icon icon=blank scale=m slot=actions-end></calcite-icon>`;
+    }
+  }
+  _renderUtilityNetworkCombobox() {
+    if (!(!this._utilityNetworks || this._utilityNetworks?.length === 1 || this.state.type === "error-disable-component" || this.hideUtilityNetworkSelect))
+      return s`<calcite-combobox .disabled=${this.state.type === "executing"} .label=${this._messages.input.selectUtilityNetwork.label} .labelText=${this._messages.input.selectUtilityNetwork.label} selection-mode=single-persist @calciteComboboxChange=${(e) => {
+        const t = e.target.value;
+        this.utilityNetwork = this._utilityNetworks?.find((i) => i.id === t), this._runSetup();
+      }}>${this._utilityNetworks.map((e) => s`<calcite-combobox-item .heading=${e.title} .selected=${e === this.utilityNetwork} .value=${e.id}></calcite-combobox-item>`)}</calcite-combobox>`;
+  }
+  _renderValidateNetworkTopologyAction() {
+    if (this.state.type === "error-disable-component")
+      return;
+    const e = `${this._unVntGuid}_execute-action`;
+    return [
+      s`<calcite-action .disabled=${this.disabled || this.state.type === "disabled" || this.state.type === "error-disable-execute" || this.state.type === "executing"} icon=play-f id=${e ?? l} @click=${this._handleValidateNetworkTopologyAction} slot=actions-end .text=${this._messages.actions.validateTopology}></calcite-action>`,
+      s`<calcite-tooltip reference-element=${e ?? l}><span>${this._messages.actions.validateTopology}</span></calcite-tooltip>`
+    ];
+  }
+  render() {
+    const e = this._renderStatusIcon(), t = this._renderValidateNetworkTopologyAction(), i = this._renderUtilityNetworkCombobox(), r = this._renderExtentToValidateCombobox(), o = this._renderInfoNotice();
+    return s`<calcite-panel .loading=${this.state.type === "loading"}><calcite-block collapsible expanded .heading=${this.label}>${e}${t}${i}${r}${o}</calcite-block></calcite-panel>`;
+  }
+}
+k("arcgis-utility-network-validate-network-topology", q);
+export {
+  q as ArcgisUtilityNetworkValidateNetworkTopology
+};

package/dist/components/arcgis-utility-network-validate-network-topology/index.d.ts

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

package/dist/components/arcgis-utility-network-validate-network-topology/index.js

@@ -0,0 +1,9 @@
+import "@esri/calcite-components/components/calcite-combobox";
+import "@esri/calcite-components/components/calcite-combobox-item";
+import "@esri/calcite-components/components/calcite-notice";
+import "@esri/calcite-components/components/calcite-icon";
+import "@esri/calcite-components/components/calcite-action";
+import "@esri/calcite-components/components/calcite-tooltip";
+import "@esri/calcite-components/components/calcite-panel";
+import "@esri/calcite-components/components/calcite-block";
+export * from "./customElement.js";

package/dist/components/arcgis-utility-network-validate-topology/customElement.d.ts

@@ -8,9 +8,13 @@ import type { Icon } from "@esri/calcite-components/components/calcite-icon";
 import type { UtilityNetworkValidateTopologyViewModelState } from "@arcgis/core/widgets/UtilityNetworkValidateTopology/UtilityNetworkValidateTopologyViewModel.js";
 
 /**
- * The UtilityNetworkValidateTopology component simplifies the process of validating a DirtyArea within a utility network. It offers an intuitive user interface, reducing the complexity of working with utility network associations.
+ * > This component is **deprecated**. [arcgis-utility-network-validate-network-topology](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-validate-network-topology/) is the preferred component for validating utility network topology and should be used for all new development.
+ *
+ * The UtilityNetworkValidateTopology component simplifies the process of validating a DirtyArea within a utility network. It offers an intuitive user interface.
  *
  * > The UtilityNetworkValidateTopology Component does not support proxied feature services or feature services that utilize stored credentials.
+ *
+ * @deprecated since 5.1, use [arcgis-utility-network-validate-network-topology](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-validate-network-topology/) instead.
  */
 export abstract class ArcgisUtilityNetworkValidateTopology extends LitElement {
   /**