@arcgis/map-components 5.2.0-next.9 → 5.2.0-next.91

package/dist/components/arcgis-utility-network-aggregated-geometry-result-item/customElement.d.ts

@@ -0,0 +1,114 @@
+/// <reference path="../../index.d.ts" />
+import type Color from "@arcgis/core/Color.js";
+import type Graphic from "@arcgis/core/Graphic.js";
+import type GraphicsLayer from "@arcgis/core/layers/GraphicsLayer.js";
+import type TraceResult from "@arcgis/core/rest/networks/support/TraceResult.js";
+import type MapView from "@arcgis/core/views/MapView.js";
+import type { PublicLitElement as LitElement } from "@arcgis/lumina";
+import type { T9nMeta } from "@arcgis/lumina/controllers";
+
+/**
+ * * Trace result item for displaying [aggregated geometry](https://developers.arcgis.com/javascript/latest/references/core/rest/networks/support/TraceResult/#aggregatedGeometry) 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 ArcgisUtilityNetworkAggregatedGeometryResultItem extends LitElement {
+  /** @internal */
+  protected _messages: {
+      headings: { setColor: string; };
+      labels: {
+          aggregatedGeometryGraphicsColor: string;
+          showGraphicsToggle: string;
+      };
+      showGraphics: string;
+  } & T9nMeta<{
+      headings: { setColor: string; };
+      labels: {
+          aggregatedGeometryGraphicsColor: string;
+          showGraphicsToggle: string;
+      };
+      showGraphics: string;
+  }>;
+  /**
+   * 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-aggregated-geometry-result-item/#destroy) method when you are done to
+   * prevent memory leaks.
+   *
+   * @default false
+   * @example
+   * ```html
+   * <arcgis-utility-network-aggregated-geometry-result-item auto-destroy-disabled></arcgis-utility-network-aggregated-geometry-result-item>
+   * ```
+   *
+   * ```js
+   * utilityNetworkAggregatedGeometryResultItemElement.autoDestroyDisabled = true;
+   * ```
+   * 
+   */
+  accessor autoDestroyDisabled: boolean;
+  /**
+   * The size of the aggregated geometry graphics to render, in points.
+   *
+   * @default 12
+   */
+  accessor defaultSelectionSize: number;
+  /** The graphics which represent the aggregated geometry results from the trace. */
+  get geometryGraphics(): Graphic[];
+  /**
+   * The color used for the aggregated geometry graphics.
+   * Default value is #FFFF00.
+   */
+  accessor graphicsColor: Color;
+  /**
+   * The layer used to render the graphics which represent the aggregated geometry result.
+   * If this property is not specified, a new layer will be created on the map.
+   */
+  accessor graphicsLayer: GraphicsLayer | undefined;
+  /** The heading of the result item. */
+  accessor heading: string | undefined;
+  /**
+   * Whether or not the aggregated geometry graphics are hidden on the map.
+   *
+   * @default false
+   */
+  accessor hideGraphics: boolean;
+  /**
+   * The trace result containing the aggregated geometry result to render graphics for.
+   *
+   * @required
+   */
+  accessor traceResult: TraceResult | 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-aggregated-geometry-result-item component will be associated with a map or scene component rather than using the `view` property.
+   *
+   * @required
+   */
+  accessor view: MapView | undefined;
+  /**
+   * Removes the [layer](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-aggregated-geometry-result-item/#graphicsLayer)
+   * containing the aggregated geometry graphics from the map.
+   */
+  clearResult(): void;
+  /** Permanently destroy the component. */
+  destroy(): Promise<void>;
+  readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "defaultSelectionSize" | "geometryGraphics" | "hideGraphics" | "graphicsColor"; }>;
+  /**
+   * Fires when the component finishes processing the aggrgegated geometry results.
+   *
+   * If the component has a valid trace result with aggregated geometry results, this fires
+   * when the aggregated geometry graphics have been added to the map.
+   *
+   * If the component does not have a valid map or trace result, this fires when the
+   * component has finished loading.
+   */
+  readonly arcgisResultReady: import("@arcgis/lumina").TargetedEvent<this, void>;
+  readonly "@eventTypes": {
+    arcgisPropertyChange: ArcgisUtilityNetworkAggregatedGeometryResultItem["arcgisPropertyChange"]["detail"];
+    arcgisResultReady: ArcgisUtilityNetworkAggregatedGeometryResultItem["arcgisResultReady"]["detail"];
+  };
+}

package/dist/components/arcgis-utility-network-aggregated-geometry-result-item/customElement.js

@@ -0,0 +1,125 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+import { c as p } from "../../chunks/runtime.js";
+import l from "@arcgis/core/Color.js";
+import m from "@arcgis/core/Graphic.js";
+import d from "@arcgis/core/layers/GraphicsLayer.js";
+import n from "@arcgis/core/symbols/SimpleFillSymbol.js";
+import y from "@arcgis/core/symbols/SimpleLineSymbol.js";
+import u from "@arcgis/core/symbols/SimpleMarkerSymbol.js";
+import { LitElement as f, createEvent as w, nothing as v } from "@arcgis/lumina";
+import { usePropertyChange as G, bypassReadOnly as b } from "@arcgis/lumina/controllers";
+import { log as s, composeMissingPropertyMessage as o } from "@arcgis/toolkit/log";
+import { css as R, html as g } from "lit";
+import { createRef as L, ref as C } from "lit/directives/ref.js";
+import { u as S } from "../../chunks/useT9n.js";
+import { a as h, i as $ } from "../../chunks/layer-utils.js";
+const k = R`.aggregated-geometry-container{display:flex;justify-content:space-between;margin:0 var(--calcite-space-md) var(--calcite-space-md)}.geometry-heading{margin:var(--calcite-space-md);font-weight:var(--calcite-font-weight-medium);font-size:var(--calcite-font-size);color:var(--calcite-color-text-1)}`;
+class z extends f {
+  constructor() {
+    super(...arguments), this._messages = S({ blocking: !0 }), this.#t = "arcgis-utility-network-aggregated-geometry-result-item-graphics", this.#e = L(), this.defaultSelectionSize = 12, this.geometryGraphics = [], this.hideGraphics = !1, this.graphicsColor = new l([255, 255, 0, 0.6]), this.autoDestroyDisabled = !1, this.arcgisPropertyChange = G()("defaultSelectionSize", "geometryGraphics", "hideGraphics", "graphicsColor"), this.arcgisResultReady = w();
+  }
+  static {
+    this.properties = { defaultSelectionSize: 9, heading: 1, traceResult: 0, geometryGraphics: 32, hideGraphics: 5, graphicsColor: 0, graphicsLayer: 0, view: 0, autoDestroyDisabled: 5 };
+  }
+  static {
+    this.styles = k;
+  }
+  #t;
+  #e;
+  clearResult() {
+    this.view?.map && this.graphicsLayer && this.view.map.remove(this.graphicsLayer);
+  }
+  async destroy() {
+    this.clearResult(), await this.manager.destroy();
+  }
+  connectedCallback() {
+    super.connectedCallback(), this.view && this.graphicsLayer && (h(this.view, this.graphicsLayer), this.arcgisResultReady.emit());
+  }
+  load() {
+    if (!this.traceResult?.aggregatedGeometry || !this.view?.map) {
+      this.arcgisResultReady.emit();
+      return;
+    }
+    this.graphicsLayer || this.#a(this.view);
+  }
+  willUpdate(e) {
+    if (e.has("hideGraphics") && this.#s(), e.has("graphicsColor") && this.#h(), e.has("traceResult") && (this.graphicsLayer?.removeAll(), this.traceResult?.aggregatedGeometry && this.view && (this.#i(this.traceResult.aggregatedGeometry), this.arcgisResultReady.emit())), e.has("view")) {
+      const t = e.get("view");
+      t?.map && this.graphicsLayer && (t.map.remove(this.graphicsLayer), this.traceResult?.aggregatedGeometry && this.view && (h(this.view, this.graphicsLayer), this.#i(this.traceResult.aggregatedGeometry), this.arcgisResultReady.emit()));
+    }
+  }
+  loaded() {
+    this.traceResult ? this.traceResult.aggregatedGeometry || s("error", this, o("The property `traceResult` was provided, but `traceResult.aggregatedGeometry` is null. Cannot draw aggregated geometry.")) : s("error", this, o("traceResult")), this.view ? this.view.map || s("error", this, o("The property `view` was provided, but `view.map` is null. Cannot draw aggregated geometry.")) : s("error", this, o("view"));
+  }
+  #i(e) {
+    const { line: t, multipoint: i, polygon: r } = e;
+    b(() => {
+      this.geometryGraphics = [t, i, r].filter((a) => a != null).map((a) => this.#o(a));
+    }), this.graphicsLayer?.addMany(this.geometryGraphics);
+  }
+  #a(e) {
+    const t = this.#t, i = e.map?.findLayerById(t);
+    if (i && $(i)) {
+      this.graphicsLayer = i;
+      return;
+    }
+    this.graphicsLayer = new d({
+      id: t,
+      listMode: "hide",
+      title: t
+    }), h(e, this.graphicsLayer);
+  }
+  #s() {
+    this.hideGraphics ? (this.graphicsLayer?.removeAll(), this.#e.value?.open && (this.#e.value.open = !1)) : this.graphicsLayer?.addMany(this.geometryGraphics);
+  }
+  #o(e) {
+    return new m({
+      geometry: e,
+      symbol: this.#r(e)
+    });
+  }
+  #r(e) {
+    const { defaultSelectionSize: t, graphicsColor: i } = this;
+    switch (e.type) {
+      case "multipoint":
+        return new u({
+          color: i,
+          size: t,
+          outline: {
+            color: i,
+            width: 0
+          }
+        });
+      case "polygon":
+        return new n({
+          color: i,
+          outline: {
+            color: i,
+            width: t
+          }
+        });
+      case "polyline":
+        return new y({
+          color: i,
+          width: t
+        });
+    }
+  }
+  #h() {
+    this.graphicsLayer?.graphics.forEach((e) => {
+      const t = e.geometry;
+      e.symbol = this.#r(t);
+    });
+  }
+  render() {
+    const { graphicsColor: e, heading: t, hideGraphics: i, _messages: r } = this;
+    return g`${t && g`<div class="geometry-heading">${t}</div>` || ""}<div class="aggregated-geometry-container"><calcite-switch .checked=${!i} .label=${r.labels.showGraphicsToggle} label-text-end=${r.showGraphics ?? v} @calciteSwitchChange=${() => this.hideGraphics = !this.hideGraphics}></calcite-switch><calcite-swatch .color=${e.toCss()} .disabled=${i} id=geometry-color-swatch .label=${r.labels.aggregatedGeometryGraphicsColor}></calcite-swatch><calcite-popover closable .heading=${r.headings.setColor} .label=${r.headings.setColor} reference-element=geometry-color-swatch ${C(this.#e)}><calcite-color-picker alpha-channel channels-disabled clearable .disabled=${i} hex-disabled saved-disabled .value=${e.toCss()} @calciteColorPickerChange=${(a) => {
+      const c = a.target.value;
+      c && (this.graphicsColor = new l(c));
+    }}></calcite-color-picker></calcite-popover></div>`;
+  }
+}
+p("arcgis-utility-network-aggregated-geometry-result-item", z);
+export {
+  z as ArcgisUtilityNetworkAggregatedGeometryResultItem
+};

package/dist/components/arcgis-utility-network-aggregated-geometry-result-item/index.d.ts

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

package/dist/components/arcgis-utility-network-aggregated-geometry-result-item/index.js

@@ -0,0 +1,5 @@
+import "@esri/calcite-components/components/calcite-switch";
+import "@esri/calcite-components/components/calcite-swatch";
+import "@esri/calcite-components/components/calcite-popover";
+import "@esri/calcite-components/components/calcite-color-picker";
+export * from "./customElement.js";

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

@@ -22,6 +22,15 @@ export abstract class ArcgisUtilityNetworkAssociations extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-utility-network-associations auto-destroy-disabled></arcgis-utility-network-associations>
+   * ```
+   *
+   * ```js
+   * utilityNetworkAssociationsElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**
@@ -219,8 +228,8 @@ export abstract class ArcgisUtilityNetworkAssociations 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-associations 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-associations component will be associated with a map or scene component rather than using the `view` property.
    *
    * @since 4.26
    */

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

@@ -0,0 +1,56 @@
+/// <reference path="../../index.d.ts" />
+import type UtilityNetwork from "@arcgis/core/networks/UtilityNetwork.js";
+import type MapView from "@arcgis/core/views/MapView.js";
+import type { PublicLitElement as LitElement } from "@arcgis/lumina";
+import type { T9nMeta } from "@arcgis/lumina/controllers";
+
+/**
+ * This is a sub-component used by the **ArcgisUtilityNetworkTraceAnalysis** component.
+ * It allows users to select utility networks from the map.
+ *
+ * @since 5.2
+ * @internal
+ */
+export abstract class ArcgisUtilityNetworkPicker extends LitElement {
+  /** @internal */
+  protected _messages: {
+      componentLabel: string;
+      errors: {
+          mapLoadFailed: string;
+          noUtilityNetwork: string;
+          noView: string;
+          utilityNetworkLoadFailed: string;
+      };
+      labels: { utilityNetwork: string; };
+  } & T9nMeta<{
+      componentLabel: string;
+      errors: {
+          mapLoadFailed: string;
+          noUtilityNetwork: string;
+          noView: string;
+          utilityNetworkLoadFailed: string;
+      };
+      labels: { utilityNetwork: string; };
+  }>;
+  accessor error: string | undefined;
+  accessor heading: string | undefined;
+  /** @default false */
+  accessor hideErrors: boolean;
+  /** @default false */
+  accessor hideLoader: boolean;
+  accessor selectedUtilityNetwork: UtilityNetwork | undefined;
+  /** @default "loading" */
+  accessor state: "error" | "loading" | "ready";
+  /**
+   * 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-picker component will be associated with a map or scene component rather than using the `view` property.
+   */
+  accessor view: MapView | undefined;
+  /** Fires when an error occurs while loading the utility networks from the map. */
+  readonly arcgisError: import("@arcgis/lumina").TargetedEvent<this, void>;
+  readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "selectedUtilityNetwork" | "state"; }>;
+  readonly "@eventTypes": {
+    arcgisError: ArcgisUtilityNetworkPicker["arcgisError"]["detail"];
+    arcgisPropertyChange: ArcgisUtilityNetworkPicker["arcgisPropertyChange"]["detail"];
+  };
+}

package/dist/components/arcgis-utility-network-picker/customElement.js

@@ -0,0 +1,91 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+import { c } from "../../chunks/runtime.js";
+import h from "@arcgis/core/core/Collection.js";
+import { watch as d } from "@arcgis/core/core/reactiveUtils.js";
+import { LitElement as n, createEvent as m } from "@arcgis/lumina";
+import { usePropertyChange as w } from "@arcgis/lumina/controllers";
+import { log as o } from "@arcgis/toolkit/log";
+import { css as y, html as s } from "lit";
+import { l } from "../../chunks/async-utils.js";
+import { u as g } from "../../chunks/useT9n.js";
+const k = y`:host{height:100%;flex-grow:1}calcite-block{--calcite-block-content-space: 0;--calcite-block-border-color: transparent;margin:0}calcite-block calcite-combobox,calcite-label{margin:0 var(--calcite-space-md)}calcite-block calcite-notice{margin:var(--calcite-space-md) var(--calcite-space-md) 0}calcite-notice{margin:var(--calcite-space-md)}`;
+class u extends n {
+  constructor() {
+    super(...arguments), this._messages = g({ blocking: !0 }), this.hideErrors = !1, this.hideLoader = !1, this.state = "loading", this.arcgisPropertyChange = w()("selectedUtilityNetwork", "state"), this.arcgisError = m();
+  }
+  static {
+    this.properties = { _utilityNetworks: 16, view: 0, hideErrors: 5, hideLoader: 5, state: 1, error: 1, selectedUtilityNetwork: 0, heading: 1 };
+  }
+  static {
+    this.styles = k;
+  }
+  load() {
+    this.#e(), this.manager.onLifecycle(() => [
+      d(() => this.view?.map, () => this.#e())
+    ]);
+  }
+  willUpdate(t) {
+    t.has("_utilityNetworks") && this.#r(), t.has("selectedUtilityNetwork") && this.#s();
+  }
+  #t(t) {
+    this.error = t, this.state = "error", this.arcgisError.emit();
+  }
+  #e() {
+    if (this.error = void 0, this.state = "loading", !this.view?.map) {
+      o("error", this, this._messages.errors.noView), this._utilityNetworks = void 0, this.#t(this._messages.errors.noView);
+      return;
+    }
+    const t = this.view.map;
+    this.#i(t);
+  }
+  async #i(t) {
+    try {
+      t.loaded || await t.load();
+    } catch (e) {
+      this.#t(this._messages.errors.mapLoadFailed), l(e, this, this._messages.errors.mapLoadFailed);
+    } finally {
+      this._utilityNetworks = t.utilityNetworks || new h();
+    }
+  }
+  #r() {
+    const { selectedUtilityNetwork: t, _utilityNetworks: e } = this;
+    e?.length ? (!t || !e.includes(t)) && (this.selectedUtilityNetwork = e.at(0)) : (this.#t(this._messages.errors.noUtilityNetwork), o("error", this, this._messages.errors.noUtilityNetwork), this.selectedUtilityNetwork = void 0);
+  }
+  async #s() {
+    const { selectedUtilityNetwork: t } = this;
+    try {
+      t && !t.loaded && await t.load(), this.state = "ready";
+    } catch (e) {
+      l(e, this, this._messages.errors.utilityNetworkLoadFailed), this.#t(this._messages.errors.utilityNetworkLoadFailed);
+    }
+  }
+  #o() {
+    return this.hideLoader ? null : s`<calcite-loader label=loading></calcite-loader>`;
+  }
+  #l(t, e = !1, i) {
+    return this.hideErrors ? null : s`<calcite-notice .closable=${e} kind=danger open scale=s width=auto .icon=${i}><div slot=message>${t}</div></calcite-notice>`;
+  }
+  #a() {
+    const t = this._messages.labels.utilityNetwork, e = this._utilityNetworks?.map((i) => s`<calcite-combobox-item .value=${i.id} .heading=${i.title || i.id} .selected=${i.id === this.selectedUtilityNetwork?.id}></calcite-combobox-item>`);
+    return s`<calcite-combobox .label=${t} selection-mode=single-persist @calciteComboboxChange=${({ currentTarget: i }) => {
+      const r = i.selectedItems[0]?.value;
+      this.selectedUtilityNetwork?.id !== r && (this.selectedUtilityNetwork = this._utilityNetworks?.find((a) => a.id === r));
+    }}>${e}</calcite-combobox>`;
+  }
+  #c() {
+    const { selectedUtilityNetwork: t } = this;
+    return s`<calcite-label>${t?.title}</calcite-label>`;
+  }
+  #h(t) {
+    const e = this._messages.labels.utilityNetwork, i = this.heading || e, r = this._utilityNetworks?.length ? this._utilityNetworks?.length === 1 ? this.#c() : this.#a() : void 0;
+    return s`<calcite-block .heading=${i} .label=${e} expanded>${r}${t}</calcite-block>`;
+  }
+  render() {
+    const { error: t, state: e, selectedUtilityNetwork: i } = this, r = e === "error" && t ? this.#l(t, !1, "exclamation-mark-triangle") : void 0;
+    return !r && !i?.loaded && !i?.loadError ? this.#o() : e === "error" && r && !this._utilityNetworks?.length ? r : this.#h(r);
+  }
+}
+c("arcgis-utility-network-picker", u);
+export {
+  u as ArcgisUtilityNetworkPicker
+};

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

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

package/dist/components/arcgis-utility-network-picker/index.js

@@ -0,0 +1,7 @@
+import "@esri/calcite-components/components/calcite-loader";
+import "@esri/calcite-components/components/calcite-notice";
+import "@esri/calcite-components/components/calcite-combobox-item";
+import "@esri/calcite-components/components/calcite-combobox";
+import "@esri/calcite-components/components/calcite-label";
+import "@esri/calcite-components/components/calcite-block";
+export * from "./customElement.js";

package/dist/components/arcgis-utility-network-subnetwork-info/customElement.d.ts

@@ -25,5 +25,5 @@ export abstract class ArcgisUtilityNetworkSubnetworkInfo extends LitElement {
       tier: string;
   }; }>;
   /** @required */
-  accessor namedTraceConfig: NamedTraceConfiguration | undefined;
+  accessor namedTraceConfiguration: NamedTraceConfiguration | undefined;
 }

package/dist/components/arcgis-utility-network-subnetwork-info/customElement.js

@@ -1,35 +1,35 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import { c as l } from "../../chunks/runtime.js";
-import { css as c, html as o } from "lit";
-import { LitElement as d } from "@arcgis/lumina";
-import { u } from "../../chunks/useT9n.js";
-import { log as s, composeMissingPropertyMessage as n } from "@arcgis/toolkit/log";
-const m = c`.subnetwork-details{border-radius:var(--calcite-border-radius);border:solid 1px var(--calcite-color-border-3)}.key-value-pair{padding:var(--calcite-spacing-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)}`;
-class g extends d {
+import { c } from "../../chunks/runtime.js";
+import { css as l, html as s } from "lit";
+import { LitElement as u } from "@arcgis/lumina";
+import { u as d } from "../../chunks/useT9n.js";
+import { log as o, composeMissingPropertyMessage as n } from "@arcgis/toolkit/log";
+const m = l`.subnetwork-details{border-radius:var(--calcite-border-radius);border:solid 1px var(--calcite-color-border-3)}.key-value-pair{padding:var(--calcite-spacing-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)}`;
+class g extends u {
   constructor() {
-    super(...arguments), this._messages = u({ blocking: !0 });
+    super(...arguments), this._messages = d({ blocking: !0 });
   }
   static {
-    this.properties = { namedTraceConfig: 0 };
+    this.properties = { namedTraceConfiguration: 0 };
   }
   static {
     this.styles = m;
   }
   loaded() {
-    this.namedTraceConfig || s("warn", this, n("namedTraceConfig"));
+    this.namedTraceConfiguration || o("warn", this, n("namedTraceConfiguration"));
+  }
+  #e(e, r) {
+    return s`<div class="key-value-pair"><div class="key-value-pair__key">${e}</div><div class="key-value-pair__value">${r}</div></div>`;
   }
   render() {
-    const { _messages: e, namedTraceConfig: r } = this;
+    const { _messages: e, namedTraceConfiguration: r } = this;
     if (!r?.traceConfiguration)
-      return s("error", this, n("namedTraceConfig.traceConfiguration")), null;
-    const { domainNetworkName: a, tierName: i, targetTierName: t } = r.traceConfiguration;
-    return !a && !i && !t ? (s("warn", this, "`namedTraceConfig.traceConfiguration` has no `domainNetworkName`, `tierName`, or `targetTierName`."), null) : o`<div class="subnetwork-details">${a ? this._renderKeyValuePair(e.headings.domainNetwork, a) : null}${i ? this._renderKeyValuePair(e.headings.tier, i) : null}${t ? this._renderKeyValuePair(e.headings.targetTier, t) : null}</div>`;
-  }
-  _renderKeyValuePair(e, r) {
-    return o`<div class="key-value-pair"><div class="key-value-pair__key">${e}</div><div class="key-value-pair__value">${r}</div></div>`;
+      return o("error", this, n("namedTraceConfig.traceConfiguration")), null;
+    const { domainNetworkName: i, tierName: a, targetTierName: t } = r.traceConfiguration;
+    return !i && !a && !t ? (o("warn", this, "`namedTraceConfig.traceConfiguration` has no `domainNetworkName`, `tierName`, or `targetTierName`."), null) : s`<div class="subnetwork-details">${i ? this.#e(e.headings.domainNetwork, i) : null}${a ? this.#e(e.headings.tier, a) : null}${t ? this.#e(e.headings.targetTier, t) : null}</div>`;
   }
 }
-l("arcgis-utility-network-subnetwork-info", g);
+c("arcgis-utility-network-subnetwork-info", g);
 export {
   g as ArcgisUtilityNetworkSubnetworkInfo
 };

package/dist/components/arcgis-utility-network-subnetwork-info-next/customElement.d.ts

@@ -0,0 +1,29 @@
+/// <reference path="../../index.d.ts" />
+import type NamedTraceConfiguration from "@arcgis/core/networks/support/NamedTraceConfiguration.js";
+import type { PublicLitElement as LitElement } from "@arcgis/lumina";
+import type { T9nMeta } from "@arcgis/lumina/controllers";
+
+/**
+ * This is a sub-component used by the **ArcgisUtilityNetworkTraceAnalysis** component.
+ *
+ * This sub-component takes a utility network and named trace configuration as input.
+ * The sub-component displays information from the trace configuration relevant to subnetworks:
+ * Domain network name, tier name, and target tier name.
+ *
+ * @since 4.34
+ * @internal
+ */
+export abstract class ArcgisUtilityNetworkSubnetworkInfoNext extends LitElement {
+  /** @internal */
+  protected _messages: { headings: {
+      domainNetwork: string;
+      targetTier: string;
+      tier: string;
+  }; } & T9nMeta<{ headings: {
+      domainNetwork: string;
+      targetTier: string;
+      tier: string;
+  }; }>;
+  /** @required */
+  accessor namedTraceConfiguration: NamedTraceConfiguration | undefined;
+}

package/dist/components/arcgis-utility-network-subnetwork-info-next/customElement.js

@@ -0,0 +1,35 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+import { c } from "../../chunks/runtime.js";
+import { css as l, html as s } from "lit";
+import { LitElement as u } from "@arcgis/lumina";
+import { u as d } from "../../chunks/useT9n.js";
+import { log as o, composeMissingPropertyMessage as n } from "@arcgis/toolkit/log";
+const m = l`.subnetwork-details{border-radius:var(--calcite-border-radius);border:solid 1px var(--calcite-color-border-3)}.key-value-pair{padding:var(--calcite-spacing-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)}`;
+class g extends u {
+  constructor() {
+    super(...arguments), this._messages = d({ blocking: !0 });
+  }
+  static {
+    this.properties = { namedTraceConfiguration: 0 };
+  }
+  static {
+    this.styles = m;
+  }
+  loaded() {
+    this.namedTraceConfiguration || o("warn", this, n("namedTraceConfiguration"));
+  }
+  #e(e, r) {
+    return s`<div class="key-value-pair"><div class="key-value-pair__key">${e}</div><div class="key-value-pair__value">${r}</div></div>`;
+  }
+  render() {
+    const { _messages: e, namedTraceConfiguration: r } = this;
+    if (!r?.traceConfiguration)
+      return o("error", this, n("namedTraceConfig.traceConfiguration")), null;
+    const { domainNetworkName: i, tierName: t, targetTierName: a } = r.traceConfiguration;
+    return !i && !t && !a ? (o("warn", this, "`namedTraceConfig.traceConfiguration` has no `domainNetworkName`, `tierName`, or `targetTierName`."), null) : s`<div class="subnetwork-details">${i ? this.#e(e.headings.domainNetwork, i) : null}${t ? this.#e(e.headings.tier, t) : null}${a ? this.#e(e.headings.targetTier, a) : null}</div>`;
+  }
+}
+c("arcgis-utility-network-subnetwork-info-next", g);
+export {
+  g as ArcgisUtilityNetworkSubnetworkInfoNext
+};

package/dist/components/arcgis-utility-network-subnetwork-info-next/index.d.ts

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

package/dist/components/arcgis-utility-network-subnetwork-info-next/index.js

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

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

@@ -29,6 +29,15 @@ export abstract class ArcgisUtilityNetworkTrace extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-utility-network-trace auto-destroy-disabled></arcgis-utility-network-trace>
+   * ```
+   *
+   * ```js
+   * utilityNetworkTraceElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**
@@ -205,8 +214,8 @@ export abstract class ArcgisUtilityNetworkTrace extends LitElement {
    */
   get traceResults(): TraceResultExtend[];
   /**
-   * 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 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-trace component will be associated with a map or scene component rather than using the `view` property.
    */
   accessor view: MapView | null | undefined;
   checkCanTrace(): Promise<void>;

package/dist/components/arcgis-utility-network-trace-analysis/customElement.d.ts

@@ -40,7 +40,7 @@ import type { UtilityNetworkTraceAnalysisState } from "@arcgis/core/networks/Uti
  * > 1. Proxied feature services or feature services that utilize stored credentials.
  * > 2. The `circuit` trace type or the `paths` and `circuits` result types.
  * > 3. Setting grouping properties `firstUnit` and `lastUnit` for trace locations in a [telecom domain network](https://pro.arcgis.com/en/pro-app/latest/help/data/utility-network/telecom-domain-networks.htm).
- * >    If a [grouped object](https://pro.arcgis.com/en/pro-app/latest/help/data/utility-network/grouping.htm) is used as a trace location, its `firstUnit` and `lastUnit` attributes are not used in the trace.
+ * >    If a [grouped object](https://doc.esri.com/en/arcgis-pro/latest/help/data/utility-network/grouping.html) is used as a trace location, its `firstUnit` and `lastUnit` attributes are not used in the trace.
  *
  * ## Working with nonspatial objects
  *
@@ -159,6 +159,15 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-utility-network-trace-analysis auto-destroy-disabled></arcgis-utility-network-trace-analysis>
+   * ```
+   *
+   * ```js
+   * utilityNetworkTraceAnalysisElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**
@@ -228,7 +237,7 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
    *
    * _**Note**: Individual message keys may change between releases._
    */
-  accessor messageOverrides: Pick<ArcgisUtilityNetworkTraceResults["_messages"], "resultFeaturesAreHidden"> & {
+  accessor messageOverrides: NonNullable<ArcgisUtilityNetworkTraceResults["messageOverrides"]> & {
       buttons?: {
           clearResultsCustom?: string | undefined;
           clearResultsGeneric?: string | undefined;
@@ -276,8 +285,8 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
    */
   get traceResultFeatures(): Graphic[];
   /**
-   * 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-analysis 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-trace-analysis component will be associated with a map or scene component rather than using the `view` property.
    */
   accessor view: MapView | null | undefined;
   /** Permanently destroy the component. */