@arcgis/map-components 5.2.0-next.70 → 5.2.0-next.72

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

@@ -0,0 +1,191 @@
+/// <reference path="../../index.d.ts" />
+import type Color from "@arcgis/core/Color.js";
+import type EsriError from "@arcgis/core/core/Error.js";
+import type Graphic from "@arcgis/core/Graphic.js";
+import type Layer from "@arcgis/core/layers/Layer.js";
+import type UtilityNetwork from "@arcgis/core/networks/UtilityNetwork.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 { ArcgisFeaturesNext } from "../arcgis-features-next/customElement.js";
+import type { ArcgisReferenceElement } from "../types.js";
+import type { T9nMeta } from "@arcgis/lumina/controllers";
+
+/**
+ * This is a sub-component used by the **ArcgisUtilityNetworkTraceAnalysis** component.
+ * It displays a subset of trace result types.
+ *
+ * @since 4.34
+ * @internal
+ */
+export abstract class ArcgisUtilityNetworkTraceResultsNext extends LitElement {
+  /** @internal */
+  protected _messages: {
+      gettingResults: string;
+      headings: {
+          features: string;
+          functions: string;
+          setColor: string;
+          totalFeatures: string;
+          traceResultsCustom: string;
+          traceResultsGeneric: string;
+      };
+      labels: {
+          aggregatedGeometryGraphicsColor: string;
+          functionResults: string;
+          numElements: string;
+          numFeatures: string;
+          numFunctions: string;
+          traceResultElementsByLayer: string;
+      };
+      noResultsDescription: string;
+      noResultsHeading: string;
+      noSelectableFeatures: string;
+      noTraceConfigDescription: string;
+      noTraceConfigHeading: string;
+      resultFeaturesAreHidden: string;
+      traceErrors: {
+          dirtyAreasDiscovered: string;
+          noValidControllers: string;
+          pathNotFound: string;
+      };
+      traceFailedDescription: string;
+      traceFailedHeading: string;
+      unknown: string;
+  } & T9nMeta<{
+      gettingResults: string;
+      headings: {
+          features: string;
+          functions: string;
+          setColor: string;
+          totalFeatures: string;
+          traceResultsCustom: string;
+          traceResultsGeneric: string;
+      };
+      labels: {
+          aggregatedGeometryGraphicsColor: string;
+          functionResults: string;
+          numElements: string;
+          numFeatures: string;
+          numFunctions: string;
+          traceResultElementsByLayer: string;
+      };
+      noResultsDescription: string;
+      noResultsHeading: string;
+      noSelectableFeatures: string;
+      noTraceConfigDescription: string;
+      noTraceConfigHeading: string;
+      resultFeaturesAreHidden: string;
+      traceErrors: {
+          dirtyAreasDiscovered: string;
+          noValidControllers: string;
+          pathNotFound: string;
+      };
+      traceFailedDescription: string;
+      traceFailedHeading: string;
+      unknown: string;
+  }>;
+  accessor aggregatedGeometryGraphicsColor: Color;
+  /**
+   * 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-trace-results-next/#destroy) method when you are done to
+   * prevent memory leaks.
+   *
+   * @default false
+   */
+  accessor autoDestroyDisabled: boolean;
+  /**
+   * @default false
+   * @internal
+   */
+  accessor hideActionBar: boolean;
+  /** @default false */
+  accessor hideFeatureResults: boolean;
+  /** @default false */
+  accessor isElementsSelected: boolean;
+  accessor layers: Layer[];
+  /**
+   * Replace localized message strings with your own strings.
+   *
+   * _**Note**: Individual message keys may change between releases._
+   */
+  accessor messageOverrides: NonNullable<ArcgisFeaturesNext["messageOverrides"]> & {
+      gettingResults?: string | undefined;
+      headings?: {
+          features?: string | undefined;
+          functions?: string | undefined;
+          setColor?: string | undefined;
+          totalFeatures?: string | undefined;
+          traceResultsCustom?: string | undefined;
+          traceResultsGeneric?: string | undefined;
+      } | undefined;
+      labels?: {
+          aggregatedGeometryGraphicsColor?: string | undefined;
+          functionResults?: string | undefined;
+          numElements?: string | undefined;
+          numFeatures?: string | undefined;
+          numFunctions?: string | undefined;
+          traceResultElementsByLayer?: string | undefined;
+      } | undefined;
+      noResultsDescription?: string | undefined;
+      noResultsHeading?: string | undefined;
+      noSelectableFeatures?: string | undefined;
+      noTraceConfigDescription?: string | undefined;
+      noTraceConfigHeading?: string | undefined;
+      resultFeaturesAreHidden?: string | undefined;
+      traceErrors?: {
+          dirtyAreasDiscovered?: string | undefined;
+          noValidControllers?: string | undefined;
+          pathNotFound?: string | undefined;
+      } | undefined;
+      traceFailedDescription?: string | undefined;
+      traceFailedHeading?: string | undefined;
+      unknown?: string | undefined;
+  };
+  get numResults(): number;
+  /**
+   * By assigning the `id` attribute of the Map or Scene component to this property, you can position a child component anywhere in the DOM while still maintaining a connection to the Map or Scene.
+   *
+   * @see [Associate components with a Map or Scene component](https://developers.arcgis.com/javascript/latest/programming-patterns/#associate-components-with-a-map-or-scene-component)
+   */
+  accessor referenceElement: ArcgisReferenceElement | string | undefined;
+  /** @default "ready" */
+  accessor state: State;
+  accessor traceConfigTitle: string | undefined;
+  accessor traceError: EsriError<TraceErrorDetails> | undefined;
+  accessor traceResult: TraceResult | undefined;
+  accessor traceResultFeatures: Graphic[];
+  accessor utilityNetwork: UtilityNetwork | 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-trace-results-next component will be associated with a map or scene component rather than using the `view` property.
+   */
+  accessor view: MapView | undefined;
+  clearAggregatedGeometryGraphics(): void;
+  /** Permanently destroy the component. */
+  destroy(): Promise<void>;
+  readonly arcgisAggregatedGeometryGraphicsColorChange: import("@arcgis/lumina").TargetedEvent<this, string>;
+  readonly arcgisHideGraphicsChange: import("@arcgis/lumina").TargetedEvent<this, boolean>;
+  readonly arcgisSelectedResultTypeChange: import("@arcgis/lumina").TargetedEvent<this, void>;
+  readonly arcgisTraceResultFeaturesReady: import("@arcgis/lumina").TargetedEvent<this, void>;
+  readonly "@eventTypes": {
+    arcgisAggregatedGeometryGraphicsColorChange: ArcgisUtilityNetworkTraceResultsNext["arcgisAggregatedGeometryGraphicsColorChange"]["detail"];
+    arcgisHideGraphicsChange: ArcgisUtilityNetworkTraceResultsNext["arcgisHideGraphicsChange"]["detail"];
+    arcgisSelectedResultTypeChange: ArcgisUtilityNetworkTraceResultsNext["arcgisSelectedResultTypeChange"]["detail"];
+    arcgisTraceResultFeaturesReady: ArcgisUtilityNetworkTraceResultsNext["arcgisTraceResultFeaturesReady"]["detail"];
+  };
+}
+
+/** @internal */
+export type State = "loading" | "ready";
+
+/** @internal */
+export interface TraceErrorDetails {
+  url?: string;
+  raw?: {
+      extendedCode?: number;
+      message?: string;
+  };
+}

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

@@ -0,0 +1,210 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+import { c as p } from "../../chunks/runtime.js";
+import y from "@arcgis/core/Color.js";
+import "@arcgis/core/core/Error.js";
+import "@arcgis/core/Graphic.js";
+import { LitElement as f, createEvent as d } from "@arcgis/lumina";
+import { log as o, composeMissingPropertyMessage as g, composeEmptyPropertyMessage as v } from "@arcgis/toolkit/log";
+import { css as b, html as l } from "lit";
+import { createRef as $, ref as u } from "lit/directives/ref.js";
+import { u as w } from "../../chunks/useT9n.js";
+import { l as C } from "../../chunks/async-utils.js";
+import { q as R, c as E } from "../../chunks/layer-utils.js";
+const x = b`:host{min-height:var(--arcgis-internal-panel-height-sm, 240px);height:100%}arcgis-features-next{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;margin:0 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{margin: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-title{font-weight:var(--calcite-font-weight-medium);font-size:var(--calcite-font-size);color:var(--calcite-color-text-1)}.results-heading-subtitle{font-size:var(--calcite-font-size--1);color:var(--calcite-color-text-3)}.functions-heading{margin:var(--calcite-spacing-md) var(--calcite-spacing-md) var(--calcite-spacing-xxs);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);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 = {
+  dirtyAreasDiscovered: -2147208511,
+  noValidControllers: -2147208935,
+  pathNotFound: -2147208444
+};
+class F extends f {
+  constructor() {
+    super(...arguments), this._messages = w({ blocking: !0 }), this.#c = !0, this.#t = [], this.#s = $(), this.#a = /* @__PURE__ */ new Map(), this.#o = /* @__PURE__ */ new Map(), this.#i = /* @__PURE__ */ new Map(), this.#r = /* @__PURE__ */ new Map(), this.#l = [], this._aggregatedGeometryDisabled = !1, this.aggregatedGeometryGraphicsColor = new y([255, 255, 0, 0.6]), this.hideActionBar = !1, this.hideFeatureResults = !1, this.isElementsSelected = !1, this.layers = [], this.state = "ready", this.traceResultFeatures = [], this.autoDestroyDisabled = !1, this.arcgisAggregatedGeometryGraphicsColorChange = d(), this.arcgisHideGraphicsChange = d(), this.arcgisSelectedResultTypeChange = d(), this.arcgisTraceResultFeaturesReady = d();
+  }
+  static {
+    this.properties = { _aggregatedGeometryDisabled: 16, _featuresComponentElement: 16, aggregatedGeometryGraphicsColor: 0, hideActionBar: 5, hideFeatureResults: 5, isElementsSelected: 5, layers: 0, messageOverrides: 0, numResults: 32, referenceElement: 1, state: 1, traceConfigTitle: 1, traceError: 0, traceResult: 0, traceResultFeatures: 0, utilityNetwork: 0, view: 0, autoDestroyDisabled: 5 };
+  }
+  static {
+    this.styles = x;
+  }
+  #c;
+  #t;
+  #n;
+  #s;
+  #a;
+  #o;
+  #i;
+  #r;
+  #l;
+  get numResults() {
+    return this.traceResultFeatures.length + this.#t.length;
+  }
+  clearAggregatedGeometryGraphics() {
+    this.#n?.destroy();
+  }
+  async destroy() {
+    this.#a.clear(), this.#i.clear(), this.#r.clear(), this.#n?.destroy(), this._featuresComponentElement?.destroy(), await this.manager.destroy();
+  }
+  load() {
+    this.traceResult && (this.#$(), this.#v().then(() => this.#b()).finally(() => {
+      this.arcgisTraceResultFeaturesReady.emit(), this.state = "ready";
+    }));
+  }
+  willUpdate(e) {
+    e.has("isElementsSelected") && this.arcgisSelectedResultTypeChange.emit(), e.has("traceResult") && (this.isElementsSelected = !1, this.traceResult || (this.traceResultFeatures = [], this.#t = []));
+  }
+  loaded() {
+    this.traceResult && (this.utilityNetwork || o("warn", this, g("utilityNetwork")), this.layers.length || o("warn", this, v("layers")), this.view || o("warn", this, g("view")));
+  }
+  disconnectedCallback() {
+    super.disconnectedCallback(), this.#o.clear();
+  }
+  #h(e) {
+    e && (this.#n = e);
+  }
+  #g(e) {
+    e && (this._featuresComponentElement = e);
+  }
+  async #m([e, t]) {
+    const s = this.utilityNetwork?.getLayerIdBySourceId(e), a = this.#p(s), i = this.#y(t);
+    if (s == null || !a) {
+      this.#t.push(...i);
+      return;
+    }
+    const r = a.createQuery();
+    r.gdbVersion = this.utilityNetwork?.gdbVersion, r.objectIds = i.map((c) => c.objectId), r.outFields = ["*"];
+    const { features: n } = await R(a, r);
+    n.forEach((c) => {
+      const m = c.layer;
+      c.getEffectivePopupTemplate(this.#c) || (c.popupTemplate = m.createPopupTemplate());
+    }), E(a) ? n.forEach((c) => this.#d(this.#i, c.layer.subtypeCode, c)) : this.#a.set(s, n);
+  }
+  #d(e, t, s) {
+    const a = e.get(t);
+    a == null ? e.set(t, [s]) : a.push(s);
+  }
+  #p(e) {
+    if (e == null)
+      return;
+    const t = this.#o, s = this.#l, a = t.get(e);
+    if (a)
+      return a;
+    if (!s)
+      return;
+    const i = s.find((r) => "layerId" in r && r.layerId === e);
+    return i && t.set(e, i), i;
+  }
+  #y(e) {
+    return Array.from(new Map(e.map((t) => [t.globalId, t])).values());
+  }
+  #f(e) {
+    e.stopPropagation();
+    const t = e.detail;
+    this.arcgisHideGraphicsChange.emit(t), this._aggregatedGeometryDisabled = t, t && this.#s.value?.open && (this.#s.value.open = !1);
+  }
+  async #v() {
+    const { layers: e, utilityNetwork: t } = this;
+    if (!t)
+      return;
+    try {
+      t.loaded || (this.state = "loading", await t.load());
+    } catch (i) {
+      C(i, this, "Error while loading the selected utility network");
+    }
+    this.#l = e.filter((i) => t.isUtilityLayer(i));
+    const a = this.#l.filter((i) => !i.loaded).map((i) => i.load());
+    a.length > 0 && (this.state = "loading", (await Promise.allSettled(a)).forEach((r) => {
+      r.status === "rejected" && o("error", this, `Failed to load layer. Reason: ${r.reason}`);
+    }));
+  }
+  async #b() {
+    const e = Array.from(this.#r.entries());
+    if (!e.length)
+      return;
+    this.state = "loading";
+    const t = e.map((r) => this.#m(r));
+    (await Promise.allSettled(t)).forEach((r, n) => {
+      if (r.status === "rejected") {
+        const [c] = e[n];
+        o("error", this, `Failed to query features for source ${c}. Reason: ${r.reason}`);
+      }
+    });
+    const a = Array.from(this.#a.values()), i = Array.from(this.#i.values());
+    this.traceResultFeatures = a.concat(i).flat();
+  }
+  #$() {
+    this.traceResult.elements?.forEach((e) => this.#d(this.#r, e.networkSourceId, e));
+  }
+  render() {
+    const { traceError: e, traceResult: t } = this;
+    if (e)
+      return this.#G(e);
+    if (!t)
+      return this.#L();
+    const { elements: s, globalFunctionResults: a, aggregatedGeometry: i } = t, r = !s.length && !a.length && !i, n = s.length > 0 && !a.length && !i;
+    return r ? this.#T() : this.state === "loading" ? this.#w() : this.hideFeatureResults && n ? this.#E() : this.isElementsSelected || n ? l`<arcgis-features-next .autoDestroyDisabled=${this.autoDestroyDisabled} .defaultPopupTemplateEnabled=${this.#c} .features=${this.traceResultFeatures} .hideActionBar=${this.hideActionBar} .hideCloseButton=${n} hide-select-feature initial-display-mode=list .messageOverrides=${this.messageOverrides} @arcgisClose=${() => this.isElementsSelected = !1} open .referenceElement=${this.referenceElement} .view=${this.view} ${u(this.#g)}></arcgis-features-next>` : this.#C(t);
+  }
+  #w() {
+    return l`<calcite-panel class="white-panel-background"><calcite-loader .label=${this._messages.gettingResults} .text=${this._messages.gettingResults}></calcite-loader></calcite-panel>`;
+  }
+  #C(e) {
+    const { elements: t, globalFunctionResults: s, aggregatedGeometry: a } = e;
+    return l`<calcite-panel class="white-panel-background">${this.#e()}${a != null ? this.#R(a) : null}${a != null && !t.length ? this.#x() : null}${t.length > 0 ? this.hideFeatureResults ? this.#u() : this.#F() : null}${s.length > 0 ? this.#k(s) : null}</calcite-panel>`;
+  }
+  #R(e) {
+    const { _aggregatedGeometryDisabled: t, aggregatedGeometryGraphicsColor: s, _messages: a } = this;
+    return l`<div class="aggregated-geometry-container"><arcgis-utility-network-aggregated-geometry-next .graphicsColor=${s} .geometry=${e} .view=${this.view} @arcgisHideGraphicsChange=${this.#f} auto-destroy-disabled ${u(this.#h)}></arcgis-utility-network-aggregated-geometry-next><calcite-swatch id=geometry-color-swatch .label=${a.labels.aggregatedGeometryGraphicsColor} .color=${s.toCss()} .disabled=${t}></calcite-swatch><calcite-popover .heading=${a.headings.setColor} .label=${a.headings.setColor} reference-element=geometry-color-swatch closable ${u(this.#s)}><calcite-color-picker alpha-channel channels-disabled clearable hex-disabled saved-disabled .value=${s} @calciteColorPickerChange=${(i) => {
+      const r = i.target.value;
+      this.arcgisAggregatedGeometryGraphicsColorChange.emit(r);
+    }} .disabled=${t}></calcite-color-picker></calcite-popover></div>`;
+  }
+  #E() {
+    return l`<calcite-panel class="white-panel-background">${this.#e()}${this.#u()}</calcite-panel>`;
+  }
+  #u() {
+    return l`<div class="no-selectable-results">${this._messages.resultFeaturesAreHidden}</div>`;
+  }
+  #x() {
+    return l`<div class="no-selectable-results">${this._messages.noSelectableFeatures}</div>`;
+  }
+  #F() {
+    const { _messages: e } = this;
+    return l`<calcite-list .label=${e.headings.traceResultsGeneric}><calcite-list-item id=elements-list-item .label=${e.headings.features} @calciteListItemSelect=${() => this.isElementsSelected = !0}><calcite-chip .label=${e.labels.numFeatures} scale=s slot=content-end>${this.numResults}</calcite-chip><calcite-icon icon=chevron-right slot=content-end></calcite-icon></calcite-list-item></calcite-list>`;
+  }
+  #k(e) {
+    const { _messages: t } = this;
+    return l`<div class="functions-heading">${t.headings.functions}</div><calcite-table .caption=${t.labels.functionResults}>${e.filter((s) => s.networkAttributeName != null && s.result != null && s.functionType != null).map((s) => {
+      const { functionName: a, networkAttributeName: i, functionType: r, result: n } = s, c = a || `${i} ${r}`;
+      return l`<calcite-table-row><calcite-table-cell>${c}</calcite-table-cell><calcite-table-cell>${n}</calcite-table-cell></calcite-table-row>`;
+    })}</calcite-table>`;
+  }
+  #e() {
+    return l`<div class="results-heading"><div class="results-heading-title">${this._messages.headings.traceResultsGeneric}</div>${this.traceConfigTitle ? l`<div class="results-heading-subtitle">${this.traceConfigTitle}</div>` : null}</div>`;
+  }
+  #G(e) {
+    const { _messages: t } = this;
+    let s = e.message;
+    switch (e.details?.raw?.extendedCode) {
+      case h.dirtyAreasDiscovered:
+        s = t.traceErrors.dirtyAreasDiscovered;
+        break;
+      case h.noValidControllers:
+        s = t.traceErrors.noValidControllers;
+        break;
+      case h.pathNotFound:
+        s = t.traceErrors.pathNotFound;
+        break;
+    }
+    return l`<calcite-panel class="white-panel-background">${this.#e()}<div class="no-results-landing"><calcite-icon icon=exclamation-mark-triangle scale=l></calcite-icon><div class="no-results-heading">${t.traceFailedHeading}</div><div class="no-results-description">${t.traceFailedDescription}</div><div class="no-results-description">${s}</div></div></calcite-panel>`;
+  }
+  #T() {
+    const { _messages: e } = this;
+    return l`<calcite-panel class="white-panel-background">${this.#e()}<div class="no-results-landing"><calcite-icon icon=exclamation-mark-triangle scale=l></calcite-icon><div class="no-results-heading">${e.noResultsHeading}</div><div class="no-results-description">${e.noResultsDescription}</div></div></calcite-panel>`;
+  }
+  #L() {
+    const { _messages: e } = this;
+    return l`<calcite-panel class="white-panel-background">${this.#e()}<div class="no-results-landing"><calcite-icon icon=utility-network-trace scale=l></calcite-icon><div class="no-results-heading">${e.noTraceConfigHeading}</div><div class="no-results-description">${e.noTraceConfigDescription}</div></div></calcite-panel>`;
+  }
+}
+p("arcgis-utility-network-trace-results-next", F);
+export {
+  F as ArcgisUtilityNetworkTraceResultsNext
+};

package/dist/components/arcgis-utility-network-trace-results-next/index.d.ts

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

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

@@ -0,0 +1,15 @@
+import "../arcgis-features-next/index.js";
+import "@esri/calcite-components/components/calcite-panel";
+import "@esri/calcite-components/components/calcite-loader";
+import "../arcgis-utility-network-aggregated-geometry-next/index.js";
+import "@esri/calcite-components/components/calcite-swatch";
+import "@esri/calcite-components/components/calcite-popover";
+import "@esri/calcite-components/components/calcite-color-picker";
+import "@esri/calcite-components/components/calcite-list";
+import "@esri/calcite-components/components/calcite-list-item";
+import "@esri/calcite-components/components/calcite-chip";
+import "@esri/calcite-components/components/calcite-icon";
+import "@esri/calcite-components/components/calcite-table";
+import "@esri/calcite-components/components/calcite-table-row";
+import "@esri/calcite-components/components/calcite-table-cell";
+export * from "./customElement.js";