@arcgis/map-components 5.1.0-next.102 → 5.1.0-next.104

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

@@ -4,17 +4,18 @@ import y from "@arcgis/core/Color.js";
 import "@arcgis/core/core/Error.js";
 import "@arcgis/core/Graphic.js";
 import { LitElement as f, createEvent as o } from "@arcgis/lumina";
-import { log as d, composeMissingPropertyMessage as g, composeEmptyPropertyMessage as _ } from "@arcgis/toolkit/log";
+import { log as d, composeMissingPropertyMessage as h, composeEmptyPropertyMessage as _ } from "@arcgis/toolkit/log";
 import { css as v, html as l } from "lit";
 import { createRef as b, ref as u } from "lit/directives/ref.js";
 import { u as R } from "../../chunks/useT9n.js";
 import { q as C, c as w } from "../../chunks/layer-utils.js";
 import { l as $ } from "../../chunks/async-utils.js";
-const E = v`:host{min-height:var(--arcgis-internal-panel-height-sm, 240px);height:100%}arcgis-features{height:100%}calcite-table{--calcite-table-border-color: none}calcite-table-row{--calcite-table-row-border-color: var(--calcite-color-border-3)}.white-panel-background{--calcite-panel-background-color: var(--calcite-color-foreground-1)}.aggregated-geometry-container{display:flex;justify-content:space-between;padding:0 var(--calcite-spacing-md) var(--calcite-spacing-md) var(--calcite-spacing-md)}#elements-list-item{border:solid 1px var(--calcite-color-border-3);border-radius:var(--calcite-corner-radius-sm);margin:0 var(--calcite-spacing-sm)}.no-selectable-results{padding:0 var(--calcite-spacing-md);color:var(--calcite-color-text-3);font-size:var(--calcite-font-size)}.results-heading{display:flex;flex-direction:column;margin:var(--calcite-spacing-md);gap:var(--calcite-spacing-xs)}.results-heading .results-heading-title{font-weight:var(--calcite-font-weight-medium);font-size:var(--calcite-font-size);color:var(--calcite-color-text-1)}.results-heading .results-heading-subtitle{font-size:var(--calcite-font-size--1);color:var(--calcite-color-text-3)}.functions-heading{padding:var(--calcite-spacing-md) var(--calcite-spacing-md) var(--calcite-spacing-xxs) var(--calcite-spacing-md);font-weight:var(--calcite-font-weight-medium);font-size:var(--calcite-font-size);color:var(--calcite-color-text-1)}.no-results-landing{display:flex;flex-direction:column;justify-content:center;align-items:center;text-align:center;margin:var(--calcite-spacing-sm) var(--calcite-spacing-xl) var(--calcite-spacing-xl) var(--calcite-spacing-xl);gap:var(--calcite-spacing-md)}.no-results-landing calcite-icon{margin-bottom:var(--calcite-spacing-sm);--calcite-icon-color: var(--calcite-color-text-3)}.no-results-landing .no-results-heading{font-size:var(--calcite-font-size-2)}.no-results-landing .no-results-description{color:var(--calcite-color-text-3)}`, h = {
+const E = v`:host{min-height:var(--arcgis-internal-panel-height-sm, 240px);height:100%}arcgis-features{height:100%}calcite-table{--calcite-table-border-color: none}calcite-table-row{--calcite-table-row-border-color: var(--calcite-color-border-3)}.white-panel-background{--calcite-panel-background-color: var(--calcite-color-foreground-1)}.aggregated-geometry-container{display:flex;justify-content:space-between;padding:0 var(--calcite-spacing-md) var(--calcite-spacing-md) var(--calcite-spacing-md)}#elements-list-item{border:solid 1px var(--calcite-color-border-3);border-radius:var(--calcite-corner-radius-sm);margin:0 var(--calcite-spacing-sm)}.no-selectable-results{padding:0 var(--calcite-spacing-md);color:var(--calcite-color-text-3);font-size:var(--calcite-font-size)}.results-heading{display:flex;flex-direction:column;margin:var(--calcite-spacing-md);gap:var(--calcite-spacing-xs)}.results-heading .results-heading-title{font-weight:var(--calcite-font-weight-medium);font-size:var(--calcite-font-size);color:var(--calcite-color-text-1)}.results-heading .results-heading-subtitle{font-size:var(--calcite-font-size--1);color:var(--calcite-color-text-3)}.functions-heading{padding:var(--calcite-spacing-md) var(--calcite-spacing-md) var(--calcite-spacing-xxs) var(--calcite-spacing-md);font-weight:var(--calcite-font-weight-medium);font-size:var(--calcite-font-size);color:var(--calcite-color-text-1)}.no-results-landing{display:flex;flex-direction:column;justify-content:center;align-items:center;text-align:center;margin:var(--calcite-spacing-sm) var(--calcite-spacing-xl) var(--calcite-spacing-xl) var(--calcite-spacing-xl);gap:var(--calcite-spacing-md)}.no-results-landing calcite-icon{margin-bottom:var(--calcite-spacing-sm);--calcite-icon-color: var(--calcite-color-text-3)}.no-results-landing .no-results-heading{font-size:var(--calcite-font-size-2)}.no-results-landing .no-results-description{color:var(--calcite-color-text-3)}`, g = {
   dirtyAreasDiscovered: -2147208511,
-  noValidControllers: -2147208935
+  noValidControllers: -2147208935,
+  pathNotFound: -2147208444
 };
-class T extends f {
+class F extends f {
   constructor() {
     super(...arguments), this._defaultPopupTemplateEnabled = !0, this._messages = R({ blocking: !0 }), this._elementsWithoutLayer = [], this._popoverRef = b(), this._layerIdToFeatures = /* @__PURE__ */ new Map(), this._layerIdToLayer = /* @__PURE__ */ new Map(), this._subtypeCodeToFeatures = /* @__PURE__ */ new Map(), this._sourceIdToElements = /* @__PURE__ */ new Map(), this._unLayers = [], this._queryFeaturesOnLayer = async ([e, t]) => {
       const a = this.utilityNetwork?.getLayerIdBySourceId(e), s = this._getLayerByLayerId(a), r = this._getElementsUniqueByGlobalId(t);
@@ -59,7 +60,7 @@ class T extends f {
     e.has("isElementsSelected") && this.arcgisSelectedResultTypeChange.emit(), e.has("selectedLayer") && this.arcgisSelectedLayerChange.emit(), e.has("traceResult") && (this.isElementsSelected = !1, this.traceResult || (this.traceResultFeatures = [], this._elementsWithoutLayer = [])), (e.has("layers") || e.has("utilityNetwork")) && this._loadDependencies();
   }
   loaded() {
-    this.utilityNetwork || d("warn", this, g("utilityNetwork")), this.layers.length === 0 && d("warn", this, _("layers")), this.view || d("warn", this, g("view"));
+    this.utilityNetwork || d("warn", this, h("utilityNetwork")), this.layers.length === 0 && d("warn", this, _("layers")), this.view || d("warn", this, h("view"));
   }
   disconnectedCallback() {
     super.disconnectedCallback(), this._layerIdToLayer.clear();
@@ -161,12 +162,15 @@ class T extends f {
   _renderErrorLanding(e) {
     let t = e.message;
     switch (e.details?.raw?.extendedCode) {
-      case h.dirtyAreasDiscovered:
+      case g.dirtyAreasDiscovered:
         t = this._messages.traceErrors.dirtyAreasDiscovered;
         break;
-      case h.noValidControllers:
+      case g.noValidControllers:
         t = this._messages.traceErrors.noValidControllers;
         break;
+      case g.pathNotFound:
+        t = this._messages.traceErrors.pathNotFound;
+        break;
     }
     return l`<calcite-panel class="white-panel-background">${this._renderTraceResultsHeading()}<div class="no-results-landing"><calcite-icon icon=exclamation-mark-triangle scale=l></calcite-icon><div class="no-results-heading">${this._messages.traceFailedHeading}</div><div class="no-results-description">${this._messages.traceFailedDescription}</div><div class="no-results-description">${t}</div></div></calcite-panel>`;
   }
@@ -177,7 +181,7 @@ class T extends f {
     return l`<calcite-panel class="white-panel-background">${this._renderTraceResultsHeading()}<div class="no-results-landing"><calcite-icon icon=utility-network-trace scale=l></calcite-icon><div class="no-results-heading">${this._messages.noTraceConfigHeading}</div><div class="no-results-description">${this._messages.noTraceConfigDescription}</div></div></calcite-panel>`;
   }
 }
-p("arcgis-utility-network-trace-results", T);
+p("arcgis-utility-network-trace-results", F);
 export {
-  T as ArcgisUtilityNetworkTraceResults
+  F as ArcgisUtilityNetworkTraceResults
 };

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

@@ -6,6 +6,101 @@ 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>
+ *   <source src="https://developers.arcgis.com/javascript/latest/assets/references/core/components/utility-network-validate-network-topology/validate-topology-example.webm" autoplay loop muted playsinline type="video/webm">
+ *   Your browser does not support the video tag.
+ * </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: {
@@ -72,16 +167,41 @@ export abstract class ArcgisUtilityNetworkValidateNetworkTopology extends LitEle
       };
   }>;
   /**
-   * A function to run before validate utility network topology starts.
+   * 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;
-  /** @default false */
+  /**
+   * When true, the component is visually withdrawn and cannot receive user interaction.
+   *
+   * @default false
+   */
   accessor disabled: boolean;
-  /** @default "current" */
+  /**
+   * 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;
-  /** @default false */
+  /**
+   * 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;
@@ -128,46 +248,52 @@ export abstract class ArcgisUtilityNetworkValidateNetworkTopology extends LitEle
    * @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;
-  accessor state: State;
+  /** 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"];
   };
-}
-
-export type ExtentOption = "current" | "entire";
-
-export type State = Disabled | Executing | Loading | Ready | Success | ValidateNetworkTopologyError;
-
-export interface Disabled {
-  type: "disabled";
-}
-
-export interface Executing {
-  type: "executing";
-}
-
-export interface Loading {
-  type: "loading";
-}
-
-export interface Ready {
-  type: "ready";
-}
-
-export interface Success {
-  type: "success";
-  message: string;
-}
-
-export interface ValidateNetworkTopologyError {
-  type: "error-disable-component" | "error-disable-execute" | "error-info";
-  message: string;
 }

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 {
   /**

package/dist/components/arcgis-volume-measurement/customElement.d.ts

@@ -10,8 +10,7 @@ import type { Icon as Icon } from "@esri/calcite-components/components/calcite-i
 import type { SystemOrVolumeUnit, SystemOrLengthUnit, LengthUnit, SystemOrAreaUnit } from "@arcgis/core/core/units.js";
 
 /**
- * > The Volume Measurement component is currently in beta.
- * > To learn about features in beta, see the [Frequently Asked Questions](https://developers.arcgis.com/javascript/latest/faq/#what-does-the-beta-tag-mean)
+ * The Volume Measurement component is currently [in preview](https://support.esri.com/en-us/knowledge-base/faq-what-is-preview-000036425).
  *
  * The Volume Measurement component can be added to a
  * [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/) to
@@ -75,7 +74,6 @@ import type { SystemOrVolumeUnit, SystemOrLengthUnit, LengthUnit, SystemOrAreaUn
  * - [Sample - Volume measurement analysis object](https://developers.arcgis.com/javascript/latest/sample-code/analysis-volume-measurement/)
  *
  * @since 5.0
- * @beta
  */
 export abstract class ArcgisVolumeMeasurement extends LitElement {
   /**