@arcgis/map-components 5.2.0-next.86 → 5.2.0-next.88

package/dist/components/arcgis-track/customElement.d.ts

@@ -42,6 +42,16 @@ export abstract class ArcgisTrack extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * 
+   * ```html
+   * <arcgis-track auto-destroy-disabled></arcgis-track>
+   * ```
+   *
+   * ```js
+   * trackElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**

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

@@ -41,6 +41,16 @@ export abstract class ArcgisUtilityNetworkAggregatedGeometry extends LitElement
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * 
+   * ```html
+   * <arcgis-utility-network-aggregated-geometry auto-destroy-disabled></arcgis-utility-network-aggregated-geometry>
+   * ```
+   *
+   * ```js
+   * utilityNetworkAggregatedGeometryElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /** @required */

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

@@ -39,6 +39,16 @@ export abstract class ArcgisUtilityNetworkAggregatedGeometryResultItem extends L
    * 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;
   /**

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

@@ -22,6 +22,16 @@ 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;
   /**

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-trace/customElement.d.ts

@@ -29,6 +29,16 @@ 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;
   /**

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

@@ -159,6 +159,16 @@ 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;
   /**

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

@@ -4,7 +4,6 @@ import { css as y, html as a } from "lit";
 import { ref as g } from "lit/directives/ref.js";
 import { keyed as u } from "lit/directives/keyed.js";
 import d from "@arcgis/core/Color.js";
-import "@arcgis/core/core/Error.js";
 import { when as f } from "@arcgis/core/core/reactiveUtils.js";
 import b from "@arcgis/core/networks/UtilityNetworkTraceAnalysis.js";
 import { LitElement as w, createEvent as o } from "@arcgis/lumina";

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

@@ -172,6 +172,16 @@ export abstract class ArcgisUtilityNetworkTraceAnalysisNext extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * 
+   * ```html
+   * <arcgis-utility-network-trace-analysis-next auto-destroy-disabled></arcgis-utility-network-trace-analysis-next>
+   * ```
+   *
+   * ```js
+   * utilityNetworkTraceAnalysisNextElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**

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

@@ -4,7 +4,6 @@ import { css as m, html as a } from "lit";
 import { ref as g } from "lit/directives/ref.js";
 import { keyed as u } from "lit/directives/keyed.js";
 import y from "@arcgis/core/Color.js";
-import "@arcgis/core/core/Error.js";
 import { when as f } from "@arcgis/core/core/reactiveUtils.js";
 import b from "@arcgis/core/networks/UtilityNetworkTraceAnalysis.js";
 import { LitElement as w, createEvent as o } from "@arcgis/lumina";

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

@@ -115,6 +115,16 @@ export abstract class ArcgisUtilityNetworkTraceInputs extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * 
+   * ```html
+   * <arcgis-utility-network-trace-inputs auto-destroy-disabled></arcgis-utility-network-trace-inputs>
+   * ```
+   *
+   * ```js
+   * utilityNetworkTraceInputsElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**

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

@@ -115,6 +115,16 @@ export abstract class ArcgisUtilityNetworkTraceInputsNext extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * 
+   * ```html
+   * <arcgis-utility-network-trace-inputs-next auto-destroy-disabled></arcgis-utility-network-trace-inputs-next>
+   * ```
+   *
+   * ```js
+   * utilityNetworkTraceInputsNextElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**