@geoscene/map-components 4.33.20 → 5.0.19

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

@@ -0,0 +1,358 @@
+/// <reference path="../../index.d.ts" />
+import type Color from "@geoscene/core/Color.js";
+import type Graphic from "@geoscene/core/Graphic.js";
+import type MapView from "@geoscene/core/views/MapView.js";
+import type { PublicLitElement as LitElement } from "@geoscene/lumina";
+import type { GeosceneReferenceElement } from "../types.js";
+import type { SelectStartPayload } from "../geoscene-utility-network-trace-location/customElement.js";
+import type { GeosceneUtilityNetworkTraceResults } from "../geoscene-utility-network-trace-results/customElement.js";
+import type { T9nMeta } from "@geoscene/lumina/controllers";
+import type { UtilityNetworkTraceAnalysisState } from "@geoscene/core/networks/UtilityNetworkTraceAnalysis.js";
+
+/**
+ * ## Overview
+ *
+ * The Utility Network Trace Analysis component allows users to run traces and view trace results in a utility network.
+ *
+ * - The component supports selecting a utility network and a named trace configuration in that utility network. Both the utility network and trace configuration must be [stored in the map](https://doc.geoscene.cn/javascript/5.0/references/core/WebMap/#utilityNetworks).
+ * - Trace locations (starting points and barriers) are set by selecting features on the view.
+ * - When a subnetwork-based trace is selected, the component displays the domain, tier, and target tier specified by the selected named trace configuration.
+ * - If the user selects a subnetwork trace with a specified subnetwork name, the component provides an option to choose a subnetwork name instead of starting location(s) to run the trace with.
+ *
+ * Supported trace types are: `connected`, `upstream`, `downstream`, `shortest-path`, `subnetwork`, `subnetwork-controller`, `loops`, and `isolation`.
+ *
+ * The component can display the following from a trace result: elements (as [features](https://doc.geoscene.cn/javascript/5.0/references/map-components/components/geoscene-utility-network-trace-analysis/#traceResultFeatures)), aggregated geometries, and function results.
+ * If the trace result includes elements that originate from a [feature layer](https://doc.geoscene.cn/javascript/5.0/references/core/layers/FeatureLayer/)
+ * that is not included in the map, the Results tab displays an `Unknown` layer with a count of those elements.
+ * The component's [traceResultFeatures](https://doc.geoscene.cn/javascript/5.0/references/map-components/components/geoscene-utility-network-trace-analysis/#traceResultFeatures) property also does not include these elements.
+ *
+ * > [!WARNING]
+ * >
+ * > The Utility Network Trace Analysis component does not support proxied feature services or feature services that utilize stored credentials.
+ * >
+ * > This component also does not support `path` and `circuit` trace types or the `paths` and `circuits` result types.
+ *
+ * ## Working with nonspatial objects
+ *
+ * The Utility Network Trace Analysis component supports selecting nonspatial objects as trace locations by traversing associations.
+ *
+ * When selecting a trace location or viewing a trace result feature, information about the feature is displayed according to the
+ * [PopupTemplate](https://doc.geoscene.cn/javascript/5.0/references/core/PopupTemplate/) of the layer that the feature belongs to.
+ * If the feature's layer has no PopupTemplate, a default template is used to display the feature's attributes.
+ *
+ * To select a nonspatial object as a trace location, first select a spatial feature on the map that is associated with the target nonspatial object.
+ * The spatial feature's layer must have a PopupTemplate that includes a [UtilityNetworkAssociationsContent](https://doc.geoscene.cn/javascript/5.0/references/core/popup/content/UtilityNetworkAssociationsContent/).
+ * Navigate through the spatial feature's associations to the target nonspatial object, then add the object as a trace location.
+ *
+ * ## Examples
+ *
+ * This component can be used slotted into an [geoscene-map](https://doc.geoscene.cn/javascript/5.0/references/map-components/components/geoscene-map/):
+ *
+ * ```html
+ * <geoscene-map item-id="471eb0bf37074b1fbb972b1da70fb310">
+ *   <geoscene-utility-network-trace-analysis slot="bottom-left"></geoscene-utility-network-trace-analysis>
+ * </geoscene-map>
+ * ```
+ *
+ * Alternatively, this component can be used outside of a map by providing a [referenceElement](https://doc.geoscene.cn/javascript/5.0/references/map-components/components/geoscene-utility-network-trace-analysis/#referenceElement):
+ *
+ * ```html
+ * <calcite-shell>
+ *   <calcite-shell-panel slot="panel-start" position="start" width-scale="l">
+ *     <geoscene-utility-network-trace-analysis reference-element="#map-element"></geoscene-utility-network-trace-analysis>
+ *   </calcite-shell-panel>
+ *   <geoscene-map id="map-element" item-id="471eb0bf37074b1fbb972b1da70fb310"></geoscene-map>
+ * </calcite-shell>
+ * ```
+ *
+ * Note: Sign in to access the data in this demo, U/P: `viewer01`/`I68VGU^nMurF`
+ *
+ * @since 5.0
+ */
+export abstract class GeosceneUtilityNetworkTraceAnalysis extends LitElement {
+  /** @internal */
+  protected _messages: {
+      buttons: {
+          clearResultsCustom: string;
+          clearResultsGeneric: string;
+          getResults: string;
+      };
+      componentLabel: string;
+      errors: {
+          loadErrors: {
+              noUserTypeExtension: string;
+              noUtilityNetwork: string;
+              noView: string;
+              sceneViewNotSupported: string;
+          };
+          noStartingPointsBody: string;
+          noStartingPointsTitle: string;
+      };
+      labels: {
+          traceConfiguration: string;
+          traceInputs: string;
+          utilityNetwork: string;
+      };
+      runningTrace: string;
+      tabs: {
+          inputTab: string;
+          resultsTab: string;
+      };
+  } & T9nMeta<{
+      buttons: {
+          clearResultsCustom: string;
+          clearResultsGeneric: string;
+          getResults: string;
+      };
+      componentLabel: string;
+      errors: {
+          loadErrors: {
+              noUserTypeExtension: string;
+              noUtilityNetwork: string;
+              noView: string;
+              sceneViewNotSupported: string;
+          };
+          noStartingPointsBody: string;
+          noStartingPointsTitle: string;
+      };
+      labels: {
+          traceConfiguration: string;
+          traceInputs: string;
+          utilityNetwork: string;
+      };
+      runningTrace: string;
+      tabs: {
+          inputTab: string;
+          resultsTab: string;
+      };
+  }>;
+  /**
+   * The color used to render graphics for aggregated geometries in trace results, specified as a
+   * [Color](https://doc.geoscene.cn/javascript/5.0/references/core/Color/) object.
+   *
+   * Aggregated geometry is only rendered if the trace configuration specifies aggregated geometry as a result type.
+   *
+   * Default color is #FFFF00.
+   *
+   * @see [Color constructor](https://doc.geoscene.cn/javascript/5.0/references/core/Color/#constructors-summary)
+   */
+  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://doc.geoscene.cn/javascript/5.0/references/map-components/components/geoscene-utility-network-trace-analysis/#destroy) method when you are done to
+   * prevent memory leaks.
+   *
+   * @default false
+   */
+  accessor autoDestroyDisabled: boolean;
+  /**
+   * A function to run before trace location selection starts.
+   *
+   * @internal
+   * @example
+   * ```js
+   * const traceElement = document.querySelector("geoscene-utility-network-trace-analysis");
+   * traceElement.beforeTraceLocationSelectStart = async () => await doAsyncWork();
+   * ```
+   */
+  accessor beforeTraceLocationSelectStart: (() => Promise<void>) | undefined;
+  /**
+   * Whether to disable highlighting trace result features on the map.
+   *
+   * If true, the features returned by a trace will not be highlighted on the map.
+   *
+   * @default false
+   * @example
+   * Disable highlighting trace result features.
+   * ```html
+   * <geoscene-map item-id="471eb0bf37074b1fbb972b1da70fb310">
+   *   <geoscene-utility-network-trace-analysis disable-highlight-feature-results slot="top-right"/>
+   * </geoscene-map>
+   * ```
+   */
+  accessor disableHighlightFeatureResults: boolean;
+  /**
+   * Indicates whether to hide the action bar that holds the feature's
+   * [actions](https://doc.geoscene.cn/javascript/5.0/references/map-components/components/geoscene-features/#actions)
+   * when selecting trace locations and viewing trace result features.
+   *
+   * @default false
+   * @internal
+   */
+  accessor hideActionBar: boolean;
+  /**
+   * Whether to hide feature results in the results tab.
+   *
+   * If true, when features are returned by a trace, they will not be visible in the results tab.
+   * A message will be displayed in its place indicating that features were returned by the trace, but are not visible in the results pane.
+   * This string can be overridden with the `messageOverrides` property.
+   *
+   * @default false
+   * @example
+   * Do not show features in the results tab.
+   * ```html
+   * <geoscene-map item-id="471eb0bf37074b1fbb972b1da70fb310">
+   *   <geoscene-utility-network-trace-analysis hide-feature-results slot="top-right"/>
+   * </geoscene-map>
+   * ```
+   * @example
+   * Override the message displayed in the results tab when features are hidden.
+   * ```js
+   * const traceElement = document.querySelector("geoscene-utility-network-trace-analysis");
+   * traceElement.messageOverrides = { resultFeaturesAreHidden: "Feature results were sent to the results window." };
+   * ```
+   */
+  accessor hideFeatureResults: boolean;
+  /** The component's default label. */
+  accessor label: string | undefined;
+  /**
+   * Replace localized message strings with your own strings.
+   *
+   * _**Note**: Individual message keys may change between releases._
+   */
+  accessor messageOverrides: Pick<GeosceneUtilityNetworkTraceResults["_messages"], "resultFeaturesAreHidden"> & {
+      buttons?: {
+          clearResultsCustom?: string | undefined;
+          clearResultsGeneric?: string | undefined;
+          getResults?: string | undefined;
+      } | undefined;
+      componentLabel?: string | undefined;
+      errors?: {
+          loadErrors?: {
+              noUserTypeExtension?: string | undefined;
+              noUtilityNetwork?: string | undefined;
+              noView?: string | undefined;
+              sceneViewNotSupported?: string | undefined;
+          } | undefined;
+          noStartingPointsBody?: string | undefined;
+          noStartingPointsTitle?: string | undefined;
+      } | undefined;
+      labels?: {
+          traceConfiguration?: string | undefined;
+          traceInputs?: string | undefined;
+          utilityNetwork?: string | undefined;
+      } | undefined;
+      runningTrace?: string | undefined;
+      tabs?: {
+          inputTab?: string | undefined;
+          resultsTab?: string | undefined;
+      } | undefined;
+  };
+  /**
+   * 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://doc.geoscene.cn/javascript/5.0/programming-patterns/#associate-components-with-a-map-or-scene-component)
+   */
+  accessor referenceElement: GeosceneReferenceElement | string | undefined;
+  /** The current state of the component. */
+  get state(): UtilityNetworkTraceAnalysisState;
+  /**
+   * An array of features returned by the trace result.
+   *
+   * This array is populated if the trace returned [element](https://doc.geoscene.cn/javascript/5.0/references/core/rest/networks/support/TraceResult/#elements) results.
+   *
+   * When [@geosceneTraceResultFeaturesReady](https://doc.geoscene.cn/javascript/5.0/references/map-components/components/geoscene-utility-network-trace-analysis/#event-geosceneTraceResultFeaturesReady) is raised, trace result features are available.
+   * When a new trace has been run, or the trace results are cleared, this array is cleared.
+   */
+  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 geoscene-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. */
+  destroy(): Promise<void>;
+  /**
+   * Fires when the user toggles displaying aggregated geometry results in the result pane.
+   * Event payload contains a boolean representing whether the aggregated geometry graphics are hidden.
+   * If true, the aggregated geometry graphics are hidden on the view.
+   *
+   * @example
+   * ```js
+   * const traceElement = document.querySelector("geoscene-utility-network-trace-analysis");
+   * traceElement.addEventListener("geosceneHideGraphicsChange", (event) => {
+   *   const hideGraphics = event.detail;
+   *   console.log(hideGraphics);
+   * });
+   * ```
+   */
+  readonly geosceneHideGraphicsChange: import("@geoscene/lumina").TargetedEvent<this, boolean>;
+  /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
+  readonly geosceneReady: import("@geoscene/lumina").TargetedEvent<this, void>;
+  /**
+   * Fires when the user completes the selection of a trace location.
+   *
+   * @internal
+   * @example
+   * ```js
+   * const traceElement = document.querySelector("geoscene-utility-network-trace-analysis");
+   * traceElement.addEventListener("geosceneTraceLocationSelectEnd", () => {
+   *   console.log("Selection finished!");
+   * });
+   * ```
+   */
+  readonly geosceneTraceLocationSelectEnd: import("@geoscene/lumina").TargetedEvent<this, void>;
+  /**
+   * Fires when the user begins selection of a trace location.
+   * Event payload contains a callback method `cancelSelect` to cancel a selection in progress.
+   * The event can also be prevented with `event.preventDefault()` to stop the selection.
+   *
+   * @internal
+   * @example
+   * ```js
+   * const traceElement = document.querySelector("geoscene-utility-network-trace-analysis");
+   * traceElement.addEventListener("geosceneTraceLocationSelectStart", (event) => {
+   *   event.preventDefault();
+   * });
+   * ```
+   * @example
+   * ```js
+   * let cancelSelect;
+   * const traceElement = document.querySelector("geoscene-utility-network-trace-analysis");
+   * traceElement.addEventListener("geosceneTraceLocationSelectStart", (event) => {
+   *   cancelSelect = event.detail.cancelSelect;
+   * });
+   *
+   * setTimeout(() => {
+   *   cancelSelect();
+   * }, 3000);
+   * ```
+   */
+  readonly geosceneTraceLocationSelectStart: import("@geoscene/lumina").TargetedEvent<this, SelectStartPayload>;
+  /**
+   * Fires when the trace result is cleared from the results tab.
+   *
+   * @example
+   * ```js
+   * const traceElement = document.querySelector("geoscene-utility-network-trace-analysis");
+   * traceElement.addEventListener("geosceneTraceResultClear", (event) => {
+   *   console.log("Trace result was cleared.");
+   * });
+   * ```
+   */
+  readonly geosceneTraceResultClear: import("@geoscene/lumina").TargetedEvent<this, void>;
+  /**
+   * Fires when the trace result features are ready.
+   * Check property [traceResultFeatures](https://doc.geoscene.cn/javascript/5.0/references/map-components/components/geoscene-utility-network-trace-analysis/#traceResultFeatures) for the trace result features.
+   *
+   * @example
+   * ```js
+   * const traceElement = document.querySelector("geoscene-utility-network-trace-analysis");
+   * traceElement.addEventListener("geosceneTraceResultFeaturesReady", (event) => {
+   *   const resultFeatures = traceElement.traceResultFeatures;
+   *   console.log(resultFeatures);
+   * });
+   * ```
+   */
+  readonly geosceneTraceResultFeaturesReady: import("@geoscene/lumina").TargetedEvent<this, void>;
+  readonly "@eventTypes": {
+    geosceneHideGraphicsChange: GeosceneUtilityNetworkTraceAnalysis["geosceneHideGraphicsChange"]["detail"];
+    geosceneReady: GeosceneUtilityNetworkTraceAnalysis["geosceneReady"]["detail"];
+    geosceneTraceLocationSelectEnd: GeosceneUtilityNetworkTraceAnalysis["geosceneTraceLocationSelectEnd"]["detail"];
+    geosceneTraceLocationSelectStart: GeosceneUtilityNetworkTraceAnalysis["geosceneTraceLocationSelectStart"]["detail"];
+    geosceneTraceResultClear: GeosceneUtilityNetworkTraceAnalysis["geosceneTraceResultClear"]["detail"];
+    geosceneTraceResultFeaturesReady: GeosceneUtilityNetworkTraceAnalysis["geosceneTraceResultFeaturesReady"]["detail"];
+  };
+}

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

@@ -0,0 +1,171 @@
+/* COPYRIGHT GeoScene - https://js.geoscene.cn/5.0/LICENSE.txt */
+import { c as y } from "../../chunks/runtime.js";
+import { css as f, html as r } from "lit";
+import { ref as o } from "lit/directives/ref.js";
+import { keyed as h } from "lit/directives/keyed.js";
+import g from "@geoscene/core/Color.js";
+import "@geoscene/core/core/Error.js";
+import b from "@geoscene/core/networks/UtilityNetworkTraceAnalysis.js";
+import { LitElement as v, createEvent as l } from "@geoscene/lumina";
+import { log as u } from "@geoscene/toolkit/log";
+import { u as w } from "../../chunks/useT9n.js";
+import { m as _ } from "../../chunks/useViewModel.js";
+const T = f`:host{--geoscene-internal-color-black-30: color-mix(in srgb, #000000 30.2%, transparent);--geoscene-internal-box-shadow: var(--calcite-spacing-none) var(--calcite-spacing-px) var(--calcite-spacing-base) var(--geoscene-internal-color-black-30);--geoscene-internal-top-max-width: calc(min(100cqw, 100vw) - var(--calcite-spacing-xxxl));--geoscene-internal-panel-width: 300px;--geoscene-internal-panel-height: 100%;--geoscene-internal-panel-height-sm: 240px;--geoscene-internal-panel-height-md: 420px;--geoscene-internal-panel-height-lg: 540px;--geoscene-internal-panel-height-xl: 680px;--geoscene-internal-panel-gap: var(--calcite-spacing-lg);--geoscene-internal-panel-actions-gap: var(--calcite-spacing-sm);--geoscene-internal-basemap-gallery-width-lg: 450px;--geoscene-internal-collapse-icon-flip: scaleX(1);--geoscene-internal-row-direction: row;--geoscene-internal-legend-width: 300px;--geoscene-internal-layout-overlay-space-top: var(--geoscene-layout-overlay-space-top, 0px);--geoscene-internal-layout-overlay-space-bottom: var(--geoscene-layout-overlay-space-bottom, 0px);--geoscene-internal-layout-overlay-space-left: var(--geoscene-layout-overlay-space-left, 0px);--geoscene-internal-layout-overlay-space-right: var(--geoscene-layout-overlay-space-right, 0px);--geoscene-internal-view-color-focus: var(--geoscene-view-color-focus, var(--calcite-color-brand));--geoscene-internal-attribution-space-bottom: var(--geoscene-internal-layout-overlay-space-bottom);--geoscene-internal-attribution-space-left: var(--geoscene-internal-layout-overlay-space-left);--geoscene-internal-attribution-space-right: var(--geoscene-internal-layout-overlay-space-right);--geoscene-internal-attribution-font-size: var(--calcite-font-size-sm);--geoscene-internal-attribution-font-size-sm: var(--calcite-font-size-xs);--geoscene-internal-sketch-justify-content: flex-start}:host{display:flex;flex-direction:column;height:var(--geoscene-internal-panel-height, 100%)}.inputs-tab-container{display:flex;flex-direction:column;height:100%}#no-starting-points-panel{flex:none;height:fit-content;--calcite-panel-background-color: var(--calcite-color-foreground-1)}#no-starting-points-notice{margin:var(--calcite-spacing-md) var(--calcite-spacing-md) 0 var(--calcite-spacing-md)}calcite-tabs{display:flex;flex-direction:column;height:100%}calcite-tab{--calcite-tab-content-space-y: 0}calcite-tab:not([selected]){flex:0}calcite-panel{--calcite-panel-background-color: var(--calcite-color-foreground-1)}calcite-notice{margin:var(--calcite-spacing-md)}`, R = _(b);
+class $ extends v {
+  constructor() {
+    super(...arguments), this._messages = w({ blocking: !0 }), this._viewModel = R(this), this._highlightHandles = [], this._handleRunTraceButtonClick = () => {
+      const t = this._traceInputsElement?.traceLocations?.some((a) => a.type === "starting-point");
+      if (this.traceError = void 0, !this._isSubnetworkNameTraceSelected && !t) {
+        this.showNoStartingPointsWarning = !0;
+        return;
+      }
+      this.showNoStartingPointsWarning = !1, this._clearTraceResult(), this._switchTab("results"), this._runTrace();
+    }, this._handleTraceInputsRefChange = (e) => {
+      e && (this._traceInputsElement = e);
+    }, this._handleTraceResultsRefChange = (e) => {
+      e && (this._traceResultsElement = e);
+    }, this.activeTab = "input", this.showNoStartingPointsWarning = !1, this.mode = "default", this.autoDestroyDisabled = !1, this.aggregatedGeometryGraphicsColor = new g([255, 255, 0, 0.6]), this.disableHighlightFeatureResults = !1, this.hideActionBar = !1, this.hideFeatureResults = !1, this.state = this._viewModel.state, this.view = this._viewModel.view, this.geosceneHideGraphicsChange = l(), this.geosceneTraceLocationSelectStart = l(), this.geosceneTraceLocationSelectEnd = l(), this.geosceneTraceResultFeaturesReady = l(), this.geosceneTraceResultClear = l(), this.geosceneReady = l();
+  }
+  static {
+    this.properties = { activeTab: 16, traceError: 16, traceResult: 16, showNoStartingPointsWarning: 16, mode: 16, autoDestroyDisabled: 5, beforeTraceLocationSelectStart: 0, aggregatedGeometryGraphicsColor: 0, disableHighlightFeatureResults: 5, hideActionBar: 5, hideFeatureResults: 5, label: 3, messageOverrides: 0, traceResultFeatures: 32, referenceElement: 1, state: 32, view: 0 };
+  }
+  static {
+    this.styles = T;
+  }
+  get _allLayers() {
+    const { view: e } = this;
+    return e?.map ? e.map.allLayers.toArray().concat(e.map.allTables.toArray()) : [];
+  }
+  get _isSubnetworkNameTraceSelected() {
+    const e = this._traceInputsElement?.selectedNamedTraceConfiguration?.traceType;
+    return !!this._traceInputsElement?.selectedNamedTraceConfiguration?.traceConfiguration?.subnetworkName && e === "subnetwork";
+  }
+  get traceResultFeatures() {
+    return this._traceResultsElement?.traceResultFeatures ?? [];
+  }
+  async destroy() {
+    this._clearHighlights(), this._traceResultsElement?.destroy(), this._traceInputsElement?.destroy(), await this.manager.destroy();
+  }
+  _clearTraceResult() {
+    this.traceResult = void 0, this._clearHighlights(), this._clearAggregatedGeometryGraphics();
+  }
+  _switchTab(e) {
+    this.activeTab = e;
+  }
+  _getLoadError(e) {
+    const { _messages: t } = this;
+    switch (e) {
+      case "no-user-type-extension":
+        return t.errors.loadErrors.noUserTypeExtension;
+      case "no-utility-network":
+        return t.errors.loadErrors.noUtilityNetwork;
+      case "no-view":
+        return t.errors.loadErrors.noView;
+      case "sceneView-not-supported":
+        return t.errors.loadErrors.sceneViewNotSupported;
+      default:
+        return e;
+    }
+  }
+  _clearHighlights() {
+    this._highlightHandles.forEach((e) => e.remove()), this._highlightHandles = [];
+  }
+  _clearAggregatedGeometryGraphics() {
+    this._traceResultsElement?.clearAggregatedGeometryGraphics();
+  }
+  _highlightResults() {
+    const { traceResult: e, view: t } = this, a = this._viewModel.utilityNetwork;
+    if (!a || !e?.elements || !t)
+      return;
+    a.getObjectIdsFromElements(e.elements).forEach((i) => {
+      const s = t.allLayerViews.find((p) => {
+        const c = p.layer;
+        if (a.isUtilityLayer(c)) {
+          const m = Number(i.layerUrl.split("/").pop());
+          return c.layerId === m;
+        }
+        return !1;
+      });
+      if (!s)
+        return;
+      const d = s.highlight(i.objectIds);
+      this._highlightHandles.push(d);
+    });
+  }
+  async _runTrace() {
+    const e = this._traceInputsElement?.selectedNamedTraceConfiguration, t = this._traceInputsElement?.unTraceConfiguration;
+    if (!(e?.traceType && t)) {
+      u("error", this, "Trace configuration not found");
+      return;
+    }
+    const a = this._traceInputsElement?.traceLocations;
+    try {
+      this.traceResult = await this._viewModel.executeTraceConfiguration({
+        traceType: e.traceType,
+        traceConfiguration: t,
+        traceLocations: a ?? [],
+        resultTypes: e.resultTypes,
+        outSpatialReference: this.view?.spatialReference
+      }), this.disableHighlightFeatureResults || this._highlightResults();
+    } catch (n) {
+      const i = n, s = i.details ? { detail: i.details } : void 0;
+      u("error", this, `Error while running trace: ${String(i)}`, s), this.traceError = i, this.traceResult = void 0;
+    }
+  }
+  _handleHideGraphicsChange(e) {
+    e.stopPropagation(), this.geosceneHideGraphicsChange.emit(e.detail);
+  }
+  _handleTraceLocationSelectStart(e) {
+    e.stopPropagation(), this.geosceneTraceLocationSelectStart.emit(e.detail).defaultPrevented && e.preventDefault();
+  }
+  _handleTraceLocationSelectEnd(e) {
+    e.stopPropagation(), this.geosceneTraceLocationSelectEnd.emit();
+  }
+  _handleTraceResultFeaturesReady(e) {
+    e.stopPropagation(), this.geosceneTraceResultFeaturesReady.emit();
+  }
+  _handleAggregatedGeometryGraphicsColorChange(e) {
+    const t = e.detail;
+    this.aggregatedGeometryGraphicsColor = new g(t);
+  }
+  _handleTraceInputsChange() {
+  }
+  _handleSelectedNamedTraceConfigurationChange() {
+    this.showNoStartingPointsWarning = !1;
+  }
+  _handleUtilityNetworkChange() {
+    this._viewModel.utilityNetwork = this._traceInputsElement?.selectedUtilityNetwork;
+  }
+  renderNoStartingPointsWarning() {
+    return r`<calcite-panel id=no-starting-points-panel><calcite-notice id=no-starting-points-notice open icon=exclamation-mark-triangle closable kind=danger scale=s @calciteNoticeClose=${() => this.showNoStartingPointsWarning = !1}><div slot=title>${this._messages.errors.noStartingPointsTitle}</div><div slot=message>${this._messages.errors.noStartingPointsBody}</div></calcite-notice></calcite-panel>`;
+  }
+  renderResultsTab() {
+    return h(`${this.el.id}__results-tab-item`, r`<calcite-tab .selected=${this.activeTab === "results"}>${this._viewModel.state === "executing" ? r`<calcite-panel><calcite-loader .label=${this._messages.runningTrace} .text=${this._messages.runningTrace}></calcite-loader></calcite-panel>` : r`<geoscene-utility-network-trace-results .aggregatedGeometryGraphicsColor=${this.aggregatedGeometryGraphicsColor} .hideFeatureResults=${this.hideFeatureResults} .referenceElement=${this.referenceElement} .hideActionBar=${this.hideActionBar} .layers=${this._allLayers} .traceConfigTitle=${this._selectedTraceConfig?.title} .traceError=${this.traceError} .traceResult=${this.traceResult} .utilityNetwork=${this._viewModel.utilityNetwork ?? void 0} .view=${this.view ?? void 0} .messageOverrides=${{ resultFeaturesAreHidden: this.messageOverrides?.resultFeaturesAreHidden }} @geosceneHideGraphicsChange=${this._handleHideGraphicsChange} @geosceneTraceResultFeaturesReady=${this._handleTraceResultFeaturesReady} @geosceneAggregatedGeometryGraphicsColorChange=${this._handleAggregatedGeometryGraphicsColorChange} .autoDestroyDisabled=${this.autoDestroyDisabled} ${o(this._handleTraceResultsRefChange)}></geoscene-utility-network-trace-results>`}</calcite-tab>`);
+  }
+  renderResultsFooter() {
+    const { mode: e, state: t } = this;
+    if (e !== "default")
+      return null;
+    const { traceResult: a } = this, i = !!(a?.elements.length || a?.globalFunctionResults.length || a?.aggregatedGeometry) && this._traceResultsElement?.state === "ready", s = this._traceResultsElement?.numResults ?? 0;
+    return r`<calcite-button appearance=outline width=full @click=${() => {
+      this._switchTab("input"), this._clearTraceResult(), this.geosceneTraceResultClear.emit();
+    }} .disabled=${!i} slot=footer>${s > 0 && !this.hideFeatureResults && t !== "executing" ? this._messages.buttons.clearResultsCustom.replace("{number}", s.toString()) : this._messages.buttons.clearResultsGeneric}</calcite-button>`;
+  }
+  renderInputTab() {
+    return h(`${this.el.id}__inputs-tab-item`, r`<calcite-tab .selected=${this.activeTab === "input"}><div class="inputs-tab-container">${this.showNoStartingPointsWarning && this.mode === "default" ? this.renderNoStartingPointsWarning() : null}<geoscene-utility-network-trace-inputs .view=${this.view || void 0} .referenceElement=${this.referenceElement} .beforeTraceLocationSelectStart=${this.beforeTraceLocationSelectStart} .hideActionBar=${this.hideActionBar} @geosceneTraceInputsChange=${this._handleTraceInputsChange} @geosceneSelectedNamedTraceConfigurationChange=${this._handleSelectedNamedTraceConfigurationChange} @geosceneUtilityNetworkChange=${this._handleUtilityNetworkChange} @geosceneTraceLocationSelectStart=${this._handleTraceLocationSelectStart} @geosceneTraceLocationSelectEnd=${this._handleTraceLocationSelectEnd} @geoscenePropertyChange=${(e) => {
+      e.stopPropagation(), e.detail.name === "mode" && (this.mode = e.target.mode);
+    }} .autoDestroyDisabled=${this.autoDestroyDisabled} ${o(this._handleTraceInputsRefChange)}></geoscene-utility-network-trace-inputs></div></calcite-tab>`);
+  }
+  renderInputFooter() {
+    const { mode: e, _viewModel: { state: t } } = this;
+    return e !== "default" ? null : r`<calcite-button appearance=solid width=full @click=${this._handleRunTraceButtonClick} slot=footer .disabled=${t === "disabled"}>${this._messages.buttons.getResults}</calcite-button>`;
+  }
+  render() {
+    const { _messages: e, _viewModel: { loadError: t, state: a } } = this, n = a === "disabled" && t != null, i = n && t !== "no-utility-network" ? r`<calcite-notice kind=warning open scale=s slot=content-top width=full><div slot=message>${this._getLoadError(t)}</div></calcite-notice>` : void 0;
+    return r`<calcite-panel .loading=${this.view === void 0}><calcite-tabs layout=center position=top><calcite-tab-nav slot=title-group><calcite-tab-title @click=${() => this._switchTab("input")} .selected=${this.activeTab === "input"}>${e.tabs.inputTab}</calcite-tab-title><calcite-tab-title @click=${() => this._switchTab("results")} .selected=${this.activeTab === "results"} .disabled=${n}>${e.tabs.resultsTab}</calcite-tab-title></calcite-tab-nav>${this.view ? this.renderInputTab() : null}${this.view && this._viewModel.utilityNetwork ? this.renderResultsTab() : null}</calcite-tabs>${i}${this.activeTab === "input" ? this.renderInputFooter() : null}${this.activeTab === "results" ? this.renderResultsFooter() : null}</calcite-panel>`;
+  }
+}
+y("geoscene-utility-network-trace-analysis", $);
+export {
+  $ as GeosceneUtilityNetworkTraceAnalysis
+};

package/dist/components/geoscene-utility-network-trace-analysis/index.d.ts

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

package/dist/components/geoscene-utility-network-trace-analysis/index.js

@@ -0,0 +1,11 @@
+import "@geoscene/calcite-components/components/calcite-panel";
+import "@geoscene/calcite-components/components/calcite-notice";
+import "@geoscene/calcite-components/components/calcite-tab";
+import "@geoscene/calcite-components/components/calcite-loader";
+import "../geoscene-utility-network-trace-results/index.js";
+import "@geoscene/calcite-components/components/calcite-button";
+import "../geoscene-utility-network-trace-inputs/index.js";
+import "@geoscene/calcite-components/components/calcite-tabs";
+import "@geoscene/calcite-components/components/calcite-tab-nav";
+import "@geoscene/calcite-components/components/calcite-tab-title";
+export * from "./customElement.js";

package/dist/components/geoscene-utility-network-trace-analysis/types.d.ts

@@ -0,0 +1 @@
+export type UtilityNetworkTraceAnalysisDisplayMode = "add-spatial-feature-list" | "add-spatial-feature" | "add-spatial-instructions" | "default";