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

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

@@ -84,7 +84,7 @@ export type State = Disabled | Executing | Loading | Ready | Success | ValidateN
  *
  * ```html
  * <calcite-shell>
- *   <calcite-shell-panel slot="panel-start" position="start" width-scale="l">
+ *   <calcite-shell-panel slot="panel-start" position="start" width="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>
@@ -112,6 +112,7 @@ export abstract class ArcgisUtilityNetworkValidateNetworkTopology extends LitEle
           noUtilityNetworks: string;
           noUtilityNetworkServiceUserTypeExtension: string;
           noView: string;
+          operationDisabledOnDefaultVersion: string;
           operationOnlyAllowedByOwner: string;
           sceneViewNotSupported: string;
           utilityNetworkLoadFailed: string;
@@ -143,6 +144,7 @@ export abstract class ArcgisUtilityNetworkValidateNetworkTopology extends LitEle
           noUtilityNetworks: string;
           noUtilityNetworkServiceUserTypeExtension: string;
           noView: string;
+          operationDisabledOnDefaultVersion: string;
           operationOnlyAllowedByOwner: string;
           sceneViewNotSupported: string;
           utilityNetworkLoadFailed: string;
@@ -179,11 +181,27 @@ export abstract class ArcgisUtilityNetworkValidateNetworkTopology extends LitEle
    */
   accessor beforeValidateNetworkTopologyStart: (() => Promise<void>) | undefined;
   /**
-   * When true, the component is visually withdrawn and cannot receive user interaction.
+   * When true, the component is visually de-emphasized and does not accept user interaction.
    *
    * @default false
    */
   accessor disabled: boolean;
+  /**
+   * Whether to disable execution on the Default version.
+   *
+   * If true, the execute action button will be disabled.
+   *
+   * @default false
+   * @example
+   * Disable execution on the Default version.
+   * ```html
+   * <arcgis-map item-id="471eb0bf37074b1fbb972b1da70fb310">
+   *   <arcgis-utility-network-validate-network-topology disable-execute-on-default-version slot="top-right">
+   *   </arcgis-utility-network-validate-network-topology>
+   * </arcgis-map>
+   * ```
+   */
+  accessor disableExecuteOnDefaultVersion: boolean;
   /**
    * Specifies the area to validate.
    *
@@ -219,6 +237,7 @@ export abstract class ArcgisUtilityNetworkValidateNetworkTopology extends LitEle
           noUtilityNetworks?: string | undefined;
           noUtilityNetworkServiceUserTypeExtension?: string | undefined;
           noView?: string | undefined;
+          operationDisabledOnDefaultVersion?: string | undefined;
           operationOnlyAllowedByOwner?: string | undefined;
           sceneViewNotSupported?: string | undefined;
           utilityNetworkLoadFailed?: string | undefined;
@@ -265,7 +284,7 @@ export abstract class ArcgisUtilityNetworkValidateNetworkTopology extends LitEle
    * 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. */
+  /** Emitted when the component associated with a map or scene view is ready for user interaction. */
   readonly arcgisReady: import("@arcgis/lumina").TargetedEvent<this, void>;
   /**
    * Fires after a validation workflow ends.

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

@@ -1,54 +1,85 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/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 = {
+import { c as N } from "../../chunks/runtime.js";
+import { css as V, html as r } from "lit";
+import { getOwningPortalUrl as $, hasUserTypeExtension as _ } from "@arcgis/core/applications/Components/featureUtils.js";
+import { on as b, watch as w, whenOnce as T } from "@arcgis/core/core/reactiveUtils.js";
+import A from "@arcgis/core/portal/Portal.js";
+import { getVersioningStates as E } from "@arcgis/core/versionManagement/utils.js";
+import { LitElement as U, createEvent as p, nothing as u } from "@arcgis/lumina";
+import { log as c, composeMissingPropertyMessage as g } from "@arcgis/toolkit/log";
+import { generateGuid as I } from "@arcgis/toolkit/string";
+import { u as L } from "../../chunks/useT9n.js";
+import { u as S } from "../../chunks/useView.js";
+import { c as C, t as n, i as O, l as D } from "../../chunks/async-utils.js";
+import { d as q } from "../../chunks/layer-utils.js";
+const P = V`: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}`, d = {
   noDirtyAreasInExtent: -2147208940,
   operationOnlyAllowedByOwner: -2147217144,
   cannotAcquireVersionLockV10: -2147217146,
   cannotAcquireVersionLockV11: -2147220947
 };
-class q extends A {
+class z extends U {
   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();
+    super(...arguments), this._messages = L({ blocking: !0 }), this.#o = `unvnt_${I()}`, this.disabled = !1, this.disableExecuteOnDefaultVersion = !1, this.extentToValidate = "current", this.hideUtilityNetworkSelect = !1, this.state = { type: "disabled" }, this.view = S(this), this.arcgisReady = p(), this.arcgisValidateNetworkTopologyEnd = p(), this.arcgisValidateNetworkTopologyStart = p();
   }
   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 };
+    this.properties = { beforeValidateNetworkTopologyStart: 0, disabled: 5, disableExecuteOnDefaultVersion: 5, extentToValidate: 1, hideUtilityNetworkSelect: 5, label: 1, messageOverrides: 0, referenceElement: 1, result: 0, state: 0, utilityNetwork: 0, view: 0 };
   }
   static {
-    this.styles = D;
+    this.styles = P;
   }
-  async loaded() {
+  get #n() {
+    return `${this.#o}_execute-action`;
+  }
+  get #a() {
+    return this._messages.actions.validateTopology + (this.extentToValidate === "current" ? ` ${this._messages.input.selectExtent.options.currentExtent.toLowerCase()}` : ` ${this._messages.input.selectExtent.options.entireExtent.toLowerCase()}`);
+  }
+  get #d() {
+    return this.#r.isDefault;
+  }
+  get #h() {
+    return this.#r?.currentVersionInfo?.access === "protected";
+  }
+  get #p() {
+    return this.#i?.privileges?.includes("features:user:manageVersions") ?? !1;
+  }
+  get #u() {
+    const e = this.#r?.currentVersionInfo?.versionIdentifier.name;
+    return e?.substring(0, e.lastIndexOf("."))?.toUpperCase() === this.#i?.username?.toUpperCase();
+  }
+  #i;
+  #s;
+  #o;
+  #e;
+  get #r() {
+    return this.#l?.find((e) => e.featureServiceUrl === this.utilityNetwork?.featureServiceUrl);
+  }
+  #l;
+  async load() {
     this.manager.onLifecycle(() => [
       b(() => this.view?.map?.allLayers, "change", (e) => {
         const t = e.added.concat(e.removed);
-        this._getDirtyAreasLayer(t) && this._runSetup();
+        this.#c(t) && this.#t();
       }),
       b(() => this.view?.map?.utilityNetworks, "change", () => {
-        this._runSetup();
+        this.#t();
+      }),
+      w(() => this.utilityNetwork?.gdbVersion, () => {
+        T(() => this.utilityNetwork?.gdbVersion === this.#r?.currentVersionInfo?.versionIdentifier.name).then(() => {
+          this.#t();
+        });
       }),
-      $(() => this.view, () => {
-        this._runSetup();
+      w(() => this.view, () => {
+        this.#t();
       }, { initial: !0 })
     ]);
   }
-  _getDirtyAreasLayer(e) {
+  #c(e) {
     const t = this.utilityNetwork?.networkSystemLayers.dirtyAreasLayerUrl;
     if (t)
-      return e.find((i) => O(i) && `${i.url}/${i.layerId}` === t);
+      return e.find((i) => q(i) && `${i.url}/${i.layerId}` === t);
   }
-  async _handleValidateNetworkTopologyAction() {
+  async #g() {
     try {
       if (this.result = void 0, !this.view) {
         this.state = { type: "error-disable-component", message: this._messages.errors.noView };
@@ -65,144 +96,154 @@ class q extends A {
         return;
       }
       if (!t) {
-        this.state = { type: "error-disable-component", message: this._messages.errors.noUtilityNetwork }, d("warn", this, y("utilityNetwork"));
+        this.state = { type: "error-disable-component", message: this._messages.errors.noUtilityNetwork }, c("warn", this, g("utilityNetwork"));
         return;
       }
       if (this.arcgisValidateNetworkTopologyStart.emit().defaultPrevented) {
-        d("info", this, this._messages.info.validateCanceled);
+        c("info", this, this._messages.info.validateCanceled);
         return;
       }
       this.state = { type: "executing" };
-      const r = {
+      const a = {
         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 };
+      this.result = await t.validateTopology(a), this.state = { type: "success", message: this._messages.status.success };
     } catch (e) {
-      const { _messages: { errors: { cannotAcquireVersionLock: t, noDirtyAreasInExtent: i, operationOnlyAllowedByOwner: r } } } = this;
+      const { _messages: { errors: { cannotAcquireVersionLock: t, noDirtyAreasInExtent: i, operationOnlyAllowedByOwner: a } } } = 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;
+      const o = e, s = o.details?.raw?.extendedCode;
+      let l = o.message || this._messages.info.validateCanceled;
+      switch (s) {
+        case d.noDirtyAreasInExtent:
+          l = i;
           break;
-        case p.cannotAcquireVersionLockV10:
-        case p.cannotAcquireVersionLockV11:
-          c = t;
+        case d.cannotAcquireVersionLockV10:
+        case d.cannotAcquireVersionLockV11:
+          l = t;
           break;
-        case p.operationOnlyAllowedByOwner:
-          c = r;
+        case d.operationOnlyAllowedByOwner:
+          l = a;
           break;
       }
-      this.state = { type: "error-info", message: c };
+      this.state = { type: "error-info", message: l };
     } finally {
       this.arcgisValidateNetworkTopologyEnd.emit();
     }
   }
-  async _runSetup() {
-    this._setupTask?.abort();
-    const e = S(async (t) => {
+  async #t() {
+    this.#s?.abort();
+    const e = C(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"));
+        this.utilityNetwork = void 0, this.state = { type: "error-disable-component", message: this._messages.errors.noView }, c("warn", this, g("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;
+      const a = i.map;
+      await a.load({ signal: t }), n(t);
+      const o = a.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"));
+      let s = this.utilityNetwork;
+      if ((!s || !o.find((k) => k.id === s?.id)) && (s = o.getItemAt(0)), !s) {
+        this.state = { type: "error-disable-component", message: this._messages.errors.noUtilityNetworks }, c("warn", this, g("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;
+      await s.load({ signal: t }), n(t);
+      const y = (Number(s.sourceJSON.currentVersion) || 0) <= 11.1 ? "utilityNetwork" : "advediting", x = await $(s.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 } : {
+      const h = new A({ url: x });
+      await h.load({ signal: t }), n(t), this.#i = h.user;
+      const f = this.#i?.username ?? "", v = await _(h, f, y);
+      if (n(t), this.#e = o, this.utilityNetwork = s, !v) {
+        this.state = y === "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());
+      const m = this.#c(a.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" };
+      if (await m.load({ signal: t }), n(t), this.#l = await E(this.view, !1), this.#d && this.disableExecuteOnDefaultVersion) {
+        this.state = {
+          type: "error-disable-execute",
+          message: this._messages.errors.operationDisabledOnDefaultVersion
+        };
+        return;
+      }
+      if (this.#h && !this.#u && !this.#p) {
+        this.state = { type: "error-disable-execute", message: this._messages.errors.operationOnlyAllowedByOwner };
+        return;
+      }
+      this.state = { type: "ready" };
     });
-    this._setupTask = e;
+    this.#s = e;
     try {
       await e.promise;
     } catch (t) {
-      if (C(t))
+      if (O(t))
         return;
-      this.state = { type: "error-disable-execute", message: this._messages.errors.utilityNetworkLoadFailed }, I(t, this, this.state.message);
+      this.state = { type: "error-disable-execute", message: this._messages.errors.utilityNetworkLoadFailed }, D(t, this, this.state.message);
     } finally {
-      this._setupTask === e && (this._setupTask = void 0);
+      this.#s === e && (this.#s = 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) => {
+      return r`<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>`;
+      return r`<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`;
+    const e = `${this.#o}_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>`;
+        return r`<calcite-icon icon=exclamation-mark-triangle id=${e ?? u} 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>`;
+        return r`<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>`;
+        return r`<calcite-icon icon=check-circle id=${e ?? u} scale=s slot=actions-end></calcite-icon>`;
       default:
-        return s`<calcite-icon icon=blank scale=m slot=actions-end></calcite-icon>`;
+        return r`<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) => {
+    if (!(!this.#e || this.#e?.length === 1 || this.state.type === "error-disable-component" || this.hideUtilityNetworkSelect))
+      return r`<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>`;
+        this.utilityNetwork = this.#e?.find((i) => i.id === t), this.#t();
+      }}>${this.#e.map((e) => r`<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>`
-    ];
+    if (this.state.type !== "error-disable-component")
+      return r`<calcite-action .disabled=${this.disabled || this.state.type === "disabled" || this.state.type === "error-disable-execute" || this.state.type === "executing"} icon=play-f id=${this.#n ?? u} .label=${this.#a} slot=actions-end .text=${this.#a} @click=${this.#g}></calcite-action>`;
+  }
+  _renderValidateNetworkTopologyActionTooltip() {
+    if (this.state.type !== "error-disable-component")
+      return r`<calcite-tooltip .referenceElement=${this.#n}><span>${this.#a}</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>`;
+    const e = this._renderStatusIcon(), t = this._renderValidateNetworkTopologyAction(), i = this._renderValidateNetworkTopologyActionTooltip(), a = this._renderUtilityNetworkCombobox(), o = this._renderExtentToValidateCombobox(), s = this._renderInfoNotice();
+    return r`<calcite-panel .loading=${this.state.type === "loading"}><calcite-block expandable expanded .heading=${this.label}>${e}${t}${a}${o}${s}</calcite-block>${i}</calcite-panel>`;
   }
 }
-k("arcgis-utility-network-validate-network-topology", q);
+N("arcgis-utility-network-validate-network-topology", z);
 export {
-  q as ArcgisUtilityNetworkValidateNetworkTopology
+  z as ArcgisUtilityNetworkValidateNetworkTopology
 };

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

@@ -25,6 +25,15 @@ export abstract class ArcgisUtilityNetworkValidateTopology extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-utility-network-validate-topology auto-destroy-disabled></arcgis-utility-network-validate-topology>
+   * ```
+   *
+   * ```js
+   * utilityNetworkValidateTopologyElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**
@@ -69,8 +78,8 @@ export abstract class ArcgisUtilityNetworkValidateTopology extends LitElement {
    */
   accessor utilityNetwork: UtilityNetwork | null | 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-validate-topology component will be associated with a map or scene component rather than using the `view` property.
+   * 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-validate-topology component will be associated with a map or scene component rather than using the `view` property.
    *
    * @since 4.27
    */
@@ -82,7 +91,7 @@ export abstract class ArcgisUtilityNetworkValidateTopology extends LitElement {
   };
   /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
   readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "state"; }>;
-  /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
+  /** Emitted when the component associated with a map or scene view is ready for user interaction. */
   readonly arcgisReady: import("@arcgis/lumina").TargetedEvent<this, void>;
   readonly "@eventTypes": {
     arcgisPropertyChange: ArcgisUtilityNetworkValidateTopology["arcgisPropertyChange"]["detail"];

package/dist/components/arcgis-value-picker-legacy/customElement.d.ts

@@ -10,7 +10,7 @@ import type { Icon } from "@esri/calcite-components/components/calcite-icon";
  * >
  * > This is a **legacy component**. It relies on an underlying widget as part of our migration to native web components.
  * >
- * > A fully native replacement for this component is in development. Once it reaches feature parity, the legacy component will be deprecated and no longer maintained. At that point, development should use the native component.
+ * > We recommend using the [Value Picker component](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-value-picker/) instead, which provides a native implementation with improved features and accessibility.
  *
  * Value Picker is a component that allows users to step or play through a list of values. Value Picker component can be configured
  * with an optional [collection](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-value-picker-legacy/#from-collection),
@@ -25,7 +25,7 @@ import type { Icon } from "@esri/calcite-components/components/calcite-icon";
  *
  * ### Configuring Value Picker
  *
- * Value Picker can be configured in variety of ways, depending on your use case.
+ * Value Picker can be configured in a variety of ways, depending on your use case.
  * The following are the five possible configurations of the Value Picker component.
  *
  * <span id="nodata"></span>
@@ -90,7 +90,7 @@ import type { Icon } from "@esri/calcite-components/components/calcite-icon";
  * ```
  *
  * <span id="from-collection"></span>
- * #### 3. Using an arbitrary collection component to present predefined list
+ * #### 3. Using an arbitrary collection component to present a predefined list
  *
  * It may be required to step through a fixed collection of items like [extents](https://developers.arcgis.com/javascript/latest/references/core/geometry/Extent/),
  * [bookmarks](https://developers.arcgis.com/javascript/latest/references/core/webmap/Bookmark/), or
@@ -100,7 +100,7 @@ import type { Icon } from "@esri/calcite-components/components/calcite-icon";
  * tracked.
  *
  * In the following example, a Value Picker component is created with a [collection](https://developers.arcgis.com/javascript/latest/references/core/core/Collection/) of three items. Value Picker is
- * initialized with starting value of "topo-vector". Since "topo-vector" is the first item in the collection, only the _next_
+ * initialized with a starting value of "topo-vector". Since "topo-vector" is the first item in the collection, only the _next_
  * button will be enabled.
  *
  * ![option-collection](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/valuepicker/option-collection.avif)
@@ -232,6 +232,7 @@ import type { Icon } from "@esri/calcite-components/components/calcite-icon";
  * valuePickerBasemap.values = ["topo-vector"];
  * ```
  *
+ * @deprecated since 5.1. Use the [Value Picker component](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-value-picker/) instead.
  * @since 5.0
  * @see [ValuePickerCollection](https://developers.arcgis.com/javascript/latest/references/core/widgets/ValuePicker/ValuePickerCollection/)
  * @see [ValuePickerCombobox](https://developers.arcgis.com/javascript/latest/references/core/widgets/ValuePicker/ValuePickerCombobox/)
@@ -248,6 +249,15 @@ export abstract class ArcgisValuePickerLegacy extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-value-picker-legacy auto-destroy-disabled></arcgis-value-picker-legacy>
+   * ```
+   *
+   * ```js
+   * valuePickerLegacyElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**
@@ -618,7 +628,7 @@ export abstract class ArcgisValuePickerLegacy extends LitElement {
    * ```
    */
   readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "values"; }>;
-  /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
+  /** Emitted when the component associated with a map or scene view is ready for user interaction. */
   readonly arcgisReady: import("@arcgis/lumina").TargetedEvent<this, void>;
   readonly "@eventTypes": {
     arcgisAnimate: ArcgisValuePickerLegacy["arcgisAnimate"]["detail"];

package/dist/components/arcgis-value-picker-legacy/customElement.js

@@ -1,7 +1,7 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
 import { c as i } from "../../chunks/runtime.js";
 import { usePropertyChange as r } from "@arcgis/lumina/controllers";
-import { reEmitEvent as e } from "@arcgis/lumina/controllers/accessor";
+import { reEmitEvent as e } from "@arcgis/lumina-toolkit/reEmitEvent";
 import t from "@arcgis/core/widgets/ValuePicker.js";
 import { LitElement as o, createEvent as l } from "@arcgis/lumina";
 import { m as a } from "../../chunks/useWidget.js";