@arcgis/map-components 5.0.0-next.91 → 5.0.0-next.93

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

@@ -7,7 +7,7 @@ import { m as s } from "../../chunks/useWidget.js";
 import { css as n } from "lit";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/5.0/esri/copyright.txt for details.
-v5.0.0-next.91 */
+v5.0.0-next.93 */
 const l = n`@keyframes esri-basemap-slide{0%{opacity:0;margin-top:0;margin-left:0}75%{opacity:0;margin-top:0;margin-left:0}to{opacity:1;margin-top:5px;margin-left:5px}}@keyframes esri-docking-animation{0%{opacity:0}25%{opacity:0}to{opacity:1}}@keyframes popup-intro-animation-down{0%{opacity:0;transform:translateY(-5px)}to{opacity:1;transform:translate(0)}}@keyframes popup-intro-animation-up{0%{opacity:0;transform:translateY(5px)}to{opacity:1;transform:translate(0)}}@supports (-ms-ime-align: auto){.esri-slider__anchor:focus{outline:1px dotted #000}}@keyframes esri-spinner--start-animation{0%{opacity:0;transform:scale(0)}to{opacity:1;transform:scale(1)}}@keyframes esri-spinner--finish-animation{0%{opacity:1;transform:scale(1)}to{opacity:0;transform:scale(0)}}@keyframes esri-spinner--rotate-animation{0%{transform:rotate(0)}to{transform:rotate(360deg)}}@media(prefers-reduced-motion){.esri-utility-network-trace__reset-prompt{animation:none!important}}@media(prefers-reduced-motion){.esri-popup--aligned-top-center,.esri-popup--aligned-top-left,.esri-popup--aligned-top-right,.esri-popup--aligned-bottom-center,.esri-popup--aligned-bottom-left,.esri-popup--aligned-bottom-right,.esri-popup--is-docked{animation:none!important}}@media(prefers-reduced-motion:reduce){.esri-fov-overlay{animation:none!important}}@keyframes esri-fade-in-down{0%{opacity:0;transform:translateY(-5px)}25%{opacity:0;transform:translateY(-5px)}to{opacity:1;transform:translate(0)}}@keyframes esri-fade-in-up{0%{opacity:0;transform:translateY(5px)}25%{opacity:0;transform:translateY(5px)}to{opacity:1;transform:translate(0)}}@keyframes esri-fade-in{0%{opacity:0}25%{opacity:0}to{opacity:1}}@keyframes esri-fade-in-scale{0%{opacity:0;transform:scale(.95)}to{opacity:1;transform:scale(1)}}@keyframes looping-progresss-bar-ani{0%{width:0;left:0}20%{width:20%;left:0}80%{width:20%;left:80%}to{width:0;left:100%}}@keyframes esri-rotate{0%{transform:rotate(0)}to{transform:rotate(360deg)}}@keyframes panel-advance{0%{opacity:0;transform:translate(50px) scale(.99)}to{opacity:1;transform:translate(0) scale(1)}}@keyframes panel-retreat{0%{opacity:0;transform:translate(-50px) scale(.99)}to{opacity:1;transform:translate(0) scale(1)}}@keyframes panel-advance--rtl{0%{opacity:0;transform:translate(-50px) scale(.99)}to{opacity:1;transform:translate(0) scale(1)}}@keyframes panel-retreat--rtl{0%{opacity:0;transform:translate(50px) scale(.99)}to{opacity:1;transform:translate(0) scale(1)}}.esri-widget__heading{color:var(--calcite-color-text-2);margin:0 0 .5rem;font-weight:var(--calcite-font-weight-semibold)}h1.esri-widget__heading{font-size:var(--calcite-font-size-xl)}h2.esri-widget__heading{font-size:var(--calcite-font-size-md)}h3.esri-widget__heading,h4.esri-widget__heading,h5.esri-widget__heading,h6.esri-widget__heading{font-size:var(--calcite-font-size)}.esri-widget{--esri-widget-padding-x: 15px;--esri-widget-padding-y: var(--calcite-spacing-md);--esri-widget-padding: var(--esri-widget-padding-y) var(--esri-widget-padding-x);box-sizing:border-box;color:var(--calcite-color-text-2);background-color:var(--calcite-color-foreground-1);font-size:var(--calcite-font-size);line-height:var(--calcite-font-line-height-relative-tight)}.esri-widget *,.esri-widget :before,.esri-widget :after{box-sizing:inherit}.esri-widget.esri-widget--disabled>*{opacity:.4;pointer-events:none}.esri-widget.esri-widget--compact{--esri-widget-padding-y: 0;--esri-widget-padding-x: 0}.esri-widget__anchor{color:var(--calcite-color-text-2)}.esri-widget__anchor:hover{color:var(--calcite-color-text-3)}.esri-widget__anchor:hover,.esri-widget__anchor:focus{text-decoration:underline}.esri-widget__anchor--disabled{opacity:.4;pointer-events:none}.esri-widget__header{background-color:var(--calcite-color-foreground-1);flex:1 0 100%;justify-content:space-between;align-items:center;width:100%;min-height:48px;padding:12px 0 12px 15px;display:flex}.esri-widget__header .esri-widget__heading{width:calc(100% - 48px);text-align:initial;color:var(--calcite-color-text-1);align-items:center;margin:0;padding:0;display:flex}.esri-widget__header-button{appearance:none;cursor:pointer;color:var(--calcite-color-text-2);background-color:var(--calcite-color-foreground-1);border:none;flex:0 0 48px;justify-content:center;align-self:stretch;align-items:center;width:48px;padding:0;display:flex}.esri-widget__footer{background-color:var(--calcite-color-foreground-1);justify-content:center;align-items:center;width:100%;min-height:48px;display:flex}.esri-widget__footer-pagination{color:var(--calcite-color-text-2);justify-content:space-between;align-items:center;display:flex}.esri-widget__footer-pagination-previous-button,.esri-widget__footer-pagination-next-button{cursor:pointer;background-color:var(--calcite-color-foreground-1);border:0;margin:0 7px;padding:12px 15px;transition:background-color .125s ease-in-out}.esri-widget__footer-pagination-previous-button:hover,.esri-widget__footer-pagination-previous-button:focus,.esri-widget__footer-pagination-next-button:hover,.esri-widget__footer-pagination-next-button:focus{color:var(--calcite-color-text-1);background-color:var(--calcite-color-foreground-1)}.esri-menu{visibility:hidden;z-index:1;background-clip:padding;background-color:var(--calcite-color-foreground-1);background-clip:padding-box;width:100%;max-height:0;margin:2px 0 0;padding:0;font-size:var(--calcite-font-size);line-height:var(--calcite-spacing-xl);position:absolute;top:100%;left:0;overflow:hidden;box-shadow:0 1px 2px #0000004d}.esri-menu .esri-menu__header{color:var(--calcite-color-text-inverse);background-color:var(--calcite-color-inverse);padding:6px 12px}.esri-menu__list{margin:0;padding:0;list-style:none}.esri-menu__list-item{cursor:pointer;border-top:1px solid #adadad4d;border-left:3px solid #0000;padding:.8em 1em}.esri-menu__list-item [class^=esri-icon-],.esri-menu__list-item [class*=" esri-icon-"]{padding-right:2.8px}.esri-menu__list-item:first-child{border-top:none}.esri-menu__list-item--focus,.esri-menu__list-item:hover,.esri-menu__list-item:focus{background-color:var(--calcite-color-foreground-1)}.esri-menu__list-item:active{background-color:var(--calcite-color-foreground-current)}.esri-menu__list-item--active,.esri-menu__list-item--active:hover,.esri-menu__list-item--active:focus{background-color:var(--calcite-color-foreground-1);border-left-color:var(--calcite-color-brand)}.esri-widget__table{border-collapse:collapse;color:var(--calcite-color-text-1);border:none;width:100%;line-height:var(--calcite-font-line-height-relative-tight)}.esri-widget__table tr:nth-child(odd){background-color:var(--calcite-color-transparent)}.esri-widget__table tr:nth-child(2n){background-color:var(--calcite-color-transparent-press)}.esri-widget__table tr a{color:var(--calcite-color-text-2)}.esri-widget__table tr a:hover,.esri-widget__table tr a:focus{color:var(--calcite-color-text-1)}.esri-widget__table tr td,.esri-widget__table tr th{vertical-align:top;word-break:break-word;padding:.5em .7em;font-size:var(--calcite-font-size-sm);font-weight:var(--calcite-font-weight-regular)}.esri-widget__table tr th{text-align:left;border-right:3px solid #0000000d;width:50%}.esri-widget__table tr td{width:50%}.esri-input{color:var(--calcite-color-text-1);background-color:var(--calcite-color-foreground-1);border:1px solid #959595;font-size:var(--calcite-font-size)}.esri-input::-ms-clear{display:none}.esri-input::placeholder{opacity:1;color:var(--calcite-color-text-2)}.esri-input:placeholder-shown{text-overflow:ellipsis}.esri-input[type=text],.esri-input[type=password],.esri-input[type=number]{height:32px;padding:0 .5em}calcite-combobox.esri-input{border:none}.esri-widget__content--empty{text-align:center;color:var(--calcite-color-border-input);flex-flow:column wrap;align-items:center;padding:18px 22px;display:flex}.esri-widget__content--empty h1.esri-widget__heading,.esri-widget__content--empty h2.esri-widget__heading,.esri-widget__content--empty h3.esri-widget__heading,.esri-widget__content--empty h4.esri-widget__heading,.esri-widget__content--empty h5.esri-widget__heading{font-weight:var(--calcite-font-weight-regular)}.esri-widget__content-illustration--empty{width:128px;padding:1rem 0}.esri-widget__content-icon--empty{width:32px;padding:.5rem 0}.esri-select{appearance:none;cursor:pointer;color:var(--calcite-color-text-2);background:var(--calcite-color-foreground-1) url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='-8 -8 32 32' width='32' height='32'%3E%3Cpath d='M8 11.207l-4-4V5.793l4 4 4-4v1.414z' fill='%23adadad' fillrule='nonzero'/%3E%3C/svg%3E") 100% no-repeat;border:1px solid #959595;border-radius:0;width:100%;height:32px;margin:0;padding:0 .5em;font-family:inherit;font-size:.85em;display:block}.esri-select[disabled]{cursor:auto}.esri-select::-ms-expand{display:none}.esri-disabled a,.esri-disabled [role=menu],.esri-disabled [role=checkbox],.esri-disabled [class^=esri-icon-],.esri-disabled [class*=" esri-icon-"]{color:var(--calcite-color-text-3)}.keynav-mode .esri-widget:focus,.keynav-mode .esri-widget :focus{z-index:1;outline-offset:2px;outline:2px solid #adadad}.esri-widget__loader-animation{border:.15em solid #adadad4d;border-top-color:var(--calcite-color-border-input);border-radius:100%;width:1em;height:1em;font-size:var(--calcite-font-size-md);animation:1.25s linear infinite esri-rotate;display:block;transform:translateZ(0)}:dir(rtl) .esri-widget__table th{text-align:right;border-left:3px solid #0000000d;border-right:none}:dir(rtl) .esri-select{background-position:0}:dir(rtl) .esri-menu__list-item{border-left:none;border-right:3px solid #0000}:dir(rtl) .esri-menu__list-item [class^=esri-icon-],:dir(rtl) .esri-menu__list-item [class*=" esri-icon-"]{padding-left:2px;padding-right:0}:dir(rtl) .esri-menu__list-item--active{border-right-color:var(--calcite-color-brand)}.esri-icon-font-fallback-text{clip:rect(0 0 0 0);width:1px;height:1px;position:absolute;overflow:hidden}.esri-rotating{animation:1.25s linear infinite esri-rotate;transform:translateZ(0)}.esri-clearfix:before,.esri-clearfix:after{content:" ";display:table}.esri-clearfix:after{clear:both}.esri-interactive{cursor:pointer}.esri-hidden{display:none!important}.esri-invisible{visibility:hidden!important}.esri-offscreen{position:absolute;top:-999em;left:-999em}.esri-match-height{flex-direction:column;flex:auto;display:flex;overflow:hidden}:host{min-width:300px}.esri-utility-network-trace{flex:auto;width:300px}.esri-utility-network-trace calcite-icon{box-sizing:initial}.esri-utility-network-trace calcite-tab{background-color:var(--calcite-color-foreground-2);padding-top:0;padding-bottom:0}.esri-utility-network-trace calcite-tab:not([selected]){flex:0}.esri-utility-network-trace.esri-component.esri-widget--panel{min-height:120px;width:300px}.esri-utility-network-trace__add-button-container{justify-content:center;margin:18px 0 var(--calcite-spacing-md);display:grid}.esri-utility-network-trace__block-container{margin-top:0;height:95%}.esri-utility-network-trace__block-content{border-bottom:none;margin:0}.esri-utility-network-trace__clear-results-block{position:absolute;bottom:0;left:0;margin:0;border-top:3px solid #6e6e6e26;background-color:#f3f3f3}.esri-utility-network-trace__divider{color:inherit;border-color:var(--calcite-color-border-input);border-bottom-style:solid;border-bottom-width:1px;flex:none;margin:0 0 var(--calcite-spacing-md)}.esri-utility-network-trace__double-pad-top{padding-top:10px}.esri-utility-network-trace__feature-content{height:300px}.esri-utility-network-trace__flow{height:100%}.esri-utility-network-trace__list-container{background-color:var(--calcite-color-foreground-1);padding:3px}.esri-utility-network-trace__notice-container{padding:var(--calcite-spacing-xs)}.esri-utility-network-trace__number-input{width:150px}.esri-utility-network-trace__pad-bottom{padding-bottom:5px}.esri-utility-network-trace__pad-top{padding-top:5px}.esri-utility-network-trace__reset-prompt{background-color:var(--calcite-color-background);color:var(--calcite-color-text-2);border-top:3px solid var(--calcite-color-border-input);flex-flow:column;max-height:85%;padding:var(--calcite-spacing-md) 15px;animation:.1s ease-in-out esri-fade-in-up;display:flex;position:absolute;bottom:0;left:0;right:0;box-shadow:0 1px 2px #0000004d}.esri-utility-network-trace__results-container{height:100%}.esri-utility-network-trace__tabs{min-height:250px;position:relative}`, c = s(r);
 class d extends o {
   constructor() {

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

@@ -6,6 +6,7 @@ import { default as MapView } from '@arcgis/core/views/MapView';
 import { EventEmitter, JsxNode, ToElement, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { Use } from '@arcgis/lumina/controllers';
 import { ArcgisReferenceElement } from '../../utils/component-utils';
+import { SelectStartPayload } from '../arcgis-utility-network-trace-location/customElement.js';
 
 declare const useUtilityNetworkTraceAnalysisViewModel: (component: LitElement & Pick<UtilityNetworkTraceAnalysis, never> & import('../../controllers/useViewModel').ViewModelControllerUses<UtilityNetworkTraceAnalysis>) => UtilityNetworkTraceAnalysis;
 /** [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-utility-network-trace-analysis/) */
@@ -22,6 +23,17 @@ export declare class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
      * @default false
      */
     autoDestroyDisabled: boolean;
+    /**
+     * A function to run before trace location selection starts.
+     *
+     * @experimental
+     * @example
+     * ```js
+     * const traceElement = document.querySelector("arcgis-utility-network-trace-analysis");
+     * traceElement.beforeTraceLocationSelectStart = async () => await doAsyncWork();
+     * ```
+     */
+    beforeTraceLocationSelectStart?: () => Promise<void>;
     /** @default false */
     closable: boolean;
     icon?: string;
@@ -48,8 +60,10 @@ export declare class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
     destroy(): Promise<void>;
     /**
      * Fires when the user begins selection of a trace location.
-     * Can be prevented to stop the selection.
+     * 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.
      *
+     * @experimental
      * @example
      * ```js
      * const traceElement = document.querySelector("arcgis-utility-network-trace-analysis");
@@ -57,12 +71,38 @@ export declare class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
      *   event.preventDefault();
      * });
      * ```
+     * @example
+     * ```js
+     * let cancelSelect;
+     * const traceElement = document.querySelector("arcgis-utility-network-trace-analysis");
+     * traceElement.addEventListener("arcgisTraceLocationSelectStart", (event) => {
+     *   cancelSelect = event.detail.cancelSelect;
+     * });
+     *
+     * setTimeout(() => {
+     *   cancelSelect();
+     * }, 3000);*
+     * ```
+     */
+    readonly arcgisTraceLocationSelectStart: TargetedEvent<this, SelectStartPayload>;
+    /**
+     * Fires when the user completes the selection of a trace location.
+     *
+     * @experimental
+     * @example
+     * ```js
+     * const traceElement = document.querySelector("arcgis-utility-network-trace-analysis");
+     * traceElement.addEventListener("arcgisTraceLocationSelectEnd", () => {
+     *   console.log("Selection finished!");
+     * });
+     * ```
      */
-    readonly arcgisTraceLocationSelectStart: TargetedEvent<this, void>;
+    readonly arcgisTraceLocationSelectEnd: TargetedEvent<this, void>;
     /**
      * Fires when the trace result features are ready.
      * Check property `traceResultFeatures` for the trace result features.
      *
+     * @experimental
      * @example
      * ```js
      * const traceElement = document.querySelector("arcgis-utility-network-trace-analysis");

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

@@ -1,22 +1,22 @@
 import { c as p } from "../../chunks/runtime.js";
 import { css as m, html as t } from "lit";
-import { keyed as a } from "lit/directives/keyed.js";
+import { keyed as l } from "lit/directives/keyed.js";
 import w from "@arcgis/core/networks/UtilityNetworkTraceAnalysis.js";
 import { LitElement as _, createEvent as n } from "@arcgis/lumina";
-import { createRef as h, ref as d } from "lit/directives/ref.js";
+import { log as h } from "@arcgis/toolkit/log";
+import { createRef as d, ref as f } from "lit/directives/ref.js";
 import { u as v } from "../../chunks/useT9n.js";
 import { m as y } from "../../chunks/useViewModel.js";
-import { log as f } from "@arcgis/toolkit/log";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/5.0/esri/copyright.txt for details.
-v5.0.0-next.91 */
+v5.0.0-next.93 */
 const x = m`.esri-widget__heading{color:var(--calcite-color-text-2);margin:0 0 .5rem;font-weight:var(--calcite-font-weight-semibold)}h1.esri-widget__heading{font-size:var(--calcite-font-size-xl)}h2.esri-widget__heading{font-size:var(--calcite-font-size-md)}h3.esri-widget__heading,h4.esri-widget__heading,h5.esri-widget__heading,h6.esri-widget__heading{font-size:var(--calcite-font-size)}.esri-widget{--esri-widget-padding-x: 15px;--esri-widget-padding-y: var(--calcite-spacing-md);--esri-widget-padding: var(--esri-widget-padding-y) var(--esri-widget-padding-x);box-sizing:border-box;color:var(--calcite-color-text-2);background-color:var(--calcite-color-foreground-1);font-size:var(--calcite-font-size);line-height:var(--calcite-font-line-height-relative-tight)}.esri-widget *,.esri-widget :before,.esri-widget :after{box-sizing:inherit}.esri-widget.esri-widget--disabled>*{opacity:.4;pointer-events:none}.esri-widget.esri-widget--compact{--esri-widget-padding-y: 0;--esri-widget-padding-x: 0}.esri-widget__anchor{color:var(--calcite-color-text-2)}.esri-widget__anchor:hover{color:var(--calcite-color-text-3)}.esri-widget__anchor:hover,.esri-widget__anchor:focus{text-decoration:underline}.esri-widget__anchor--disabled{opacity:.4;pointer-events:none}.esri-widget__header{background-color:var(--calcite-color-foreground-1);flex:1 0 100%;justify-content:space-between;align-items:center;width:100%;min-height:48px;padding:12px 0 12px 15px;display:flex}.esri-widget__header .esri-widget__heading{width:calc(100% - 48px);text-align:initial;color:var(--calcite-color-text-1);align-items:center;margin:0;padding:0;display:flex}.esri-widget__header-button{appearance:none;cursor:pointer;color:var(--calcite-color-text-2);background-color:var(--calcite-color-foreground-1);border:none;flex:0 0 48px;justify-content:center;align-self:stretch;align-items:center;width:48px;padding:0;display:flex}.esri-widget__footer{background-color:var(--calcite-color-foreground-1);justify-content:center;align-items:center;width:100%;min-height:48px;display:flex}.esri-widget__footer-pagination{color:var(--calcite-color-text-2);justify-content:space-between;align-items:center;display:flex}.esri-widget__footer-pagination-previous-button,.esri-widget__footer-pagination-next-button{cursor:pointer;background-color:var(--calcite-color-foreground-1);border:0;margin:0 7px;padding:12px 15px;transition:background-color .125s ease-in-out}.esri-widget__footer-pagination-previous-button:hover,.esri-widget__footer-pagination-previous-button:focus,.esri-widget__footer-pagination-next-button:hover,.esri-widget__footer-pagination-next-button:focus{color:var(--calcite-color-text-1);background-color:var(--calcite-color-foreground-1)}.esri-menu{visibility:hidden;z-index:1;background-clip:padding;background-color:var(--calcite-color-foreground-1);background-clip:padding-box;width:100%;max-height:0;margin:2px 0 0;padding:0;font-size:var(--calcite-font-size);line-height:var(--calcite-spacing-xl);position:absolute;top:100%;left:0;overflow:hidden;box-shadow:0 1px 2px #0000004d}.esri-menu .esri-menu__header{color:var(--calcite-color-text-inverse);background-color:var(--calcite-color-inverse);padding:6px 12px}.esri-menu__list{margin:0;padding:0;list-style:none}.esri-menu__list-item{cursor:pointer;border-top:1px solid #adadad4d;border-left:3px solid #0000;padding:.8em 1em}.esri-menu__list-item [class^=esri-icon-],.esri-menu__list-item [class*=" esri-icon-"]{padding-right:2.8px}.esri-menu__list-item:first-child{border-top:none}.esri-menu__list-item--focus,.esri-menu__list-item:hover,.esri-menu__list-item:focus{background-color:var(--calcite-color-foreground-1)}.esri-menu__list-item:active{background-color:var(--calcite-color-foreground-current)}.esri-menu__list-item--active,.esri-menu__list-item--active:hover,.esri-menu__list-item--active:focus{background-color:var(--calcite-color-foreground-1);border-left-color:var(--calcite-color-brand)}.esri-widget__table{border-collapse:collapse;color:var(--calcite-color-text-1);border:none;width:100%;line-height:var(--calcite-font-line-height-relative-tight)}.esri-widget__table tr:nth-child(odd){background-color:var(--calcite-color-transparent)}.esri-widget__table tr:nth-child(2n){background-color:var(--calcite-color-transparent-press)}.esri-widget__table tr a{color:var(--calcite-color-text-2)}.esri-widget__table tr a:hover,.esri-widget__table tr a:focus{color:var(--calcite-color-text-1)}.esri-widget__table tr td,.esri-widget__table tr th{vertical-align:top;word-break:break-word;padding:.5em .7em;font-size:var(--calcite-font-size-sm);font-weight:var(--calcite-font-weight-regular)}.esri-widget__table tr th{text-align:left;border-right:3px solid #0000000d;width:50%}.esri-widget__table tr td{width:50%}.esri-input{color:var(--calcite-color-text-1);background-color:var(--calcite-color-foreground-1);border:1px solid #959595;font-size:var(--calcite-font-size)}.esri-input::-ms-clear{display:none}.esri-input::placeholder{opacity:1;color:var(--calcite-color-text-2)}.esri-input:placeholder-shown{text-overflow:ellipsis}.esri-input[type=text],.esri-input[type=password],.esri-input[type=number]{height:32px;padding:0 .5em}calcite-combobox.esri-input{border:none}.esri-widget__content--empty{text-align:center;color:var(--calcite-color-border-input);flex-flow:column wrap;align-items:center;padding:18px 22px;display:flex}.esri-widget__content--empty h1.esri-widget__heading,.esri-widget__content--empty h2.esri-widget__heading,.esri-widget__content--empty h3.esri-widget__heading,.esri-widget__content--empty h4.esri-widget__heading,.esri-widget__content--empty h5.esri-widget__heading{font-weight:var(--calcite-font-weight-regular)}.esri-widget__content-illustration--empty{width:128px;padding:1rem 0}.esri-widget__content-icon--empty{width:32px;padding:.5rem 0}.esri-select{appearance:none;cursor:pointer;color:var(--calcite-color-text-2);background:var(--calcite-color-foreground-1) url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='-8 -8 32 32' width='32' height='32'%3E%3Cpath d='M8 11.207l-4-4V5.793l4 4 4-4v1.414z' fill='%23adadad' fillrule='nonzero'/%3E%3C/svg%3E") 100% no-repeat;border:1px solid #959595;border-radius:0;width:100%;height:32px;margin:0;padding:0 .5em;font-family:inherit;font-size:.85em;display:block}.esri-select[disabled]{cursor:auto}.esri-select::-ms-expand{display:none}.esri-disabled a,.esri-disabled [role=menu],.esri-disabled [role=checkbox],.esri-disabled [class^=esri-icon-],.esri-disabled [class*=" esri-icon-"]{color:var(--calcite-color-text-3)}.keynav-mode .esri-widget:focus,.keynav-mode .esri-widget :focus{z-index:1;outline-offset:2px;outline:2px solid #adadad}.esri-widget__loader-animation{border:.15em solid #adadad4d;border-top-color:var(--calcite-color-border-input);border-radius:100%;width:1em;height:1em;font-size:var(--calcite-font-size-md);animation:1.25s linear infinite esri-rotate;display:block;transform:translateZ(0)}:dir(rtl) .esri-widget__table th{text-align:right;border-left:3px solid #0000000d;border-right:none}:dir(rtl) .esri-select{background-position:0}:dir(rtl) .esri-menu__list-item{border-left:none;border-right:3px solid #0000}:dir(rtl) .esri-menu__list-item [class^=esri-icon-],:dir(rtl) .esri-menu__list-item [class*=" esri-icon-"]{padding-left:2px;padding-right:0}:dir(rtl) .esri-menu__list-item--active{border-right-color:var(--calcite-color-brand)}.esri-icon-font-fallback-text{clip:rect(0 0 0 0);width:1px;height:1px;position:absolute;overflow:hidden}.esri-rotating{animation:1.25s linear infinite esri-rotate;transform:translateZ(0)}.esri-clearfix:before,.esri-clearfix:after{content:" ";display:table}.esri-clearfix:after{clear:both}.esri-interactive{cursor:pointer}.esri-invisible{visibility:hidden!important}.esri-offscreen{position:absolute;top:-999em;left:-999em}.esri-match-height{flex-direction:column;flex:auto;display:flex;overflow:hidden}.esri-hidden{display:none!important}[class^=esri-icon-],[class*=" esri-icon-"]{speak:none;font-variant:normal;text-transform:none;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;font-style:normal;font-weight:var(--calcite-font-weight-normal);line-height:1;font-family:CalciteWebCoreIcons!important}.esri-icon-close:before{content:"";color:inherit}.esri-icon-drag-horizontal:before{content:"";color:inherit}.esri-icon-drag-vertical:before{content:"";color:inherit}.esri-icon-handle-horizontal:before{content:"";color:inherit}.esri-icon-handle-vertical:before{content:"";color:inherit}.esri-icon-check-mark:before{content:"";color:inherit}.esri-icon-left-triangle-arrow:before{content:"";color:inherit}.esri-icon-right-triangle-arrow:before{content:"";color:inherit}.esri-icon-down-arrow:before{content:"";color:inherit}.esri-icon-up-arrow:before{content:"";color:inherit}.esri-icon-overview-arrow-bottom-left:before{content:"";color:inherit}.esri-icon-overview-arrow-bottom-right:before{content:"";color:inherit}.esri-icon-overview-arrow-top-left:before{content:"";color:inherit}.esri-icon-overview-arrow-top-right:before{content:"";color:inherit}.esri-icon-maximize:before{content:"";color:inherit}.esri-icon-minimize:before{content:"";color:inherit}.esri-icon-checkbox-unchecked:before{content:"";color:inherit}.esri-icon-checkbox-checked:before{content:"";color:inherit}.esri-icon-radio-unchecked:before{content:"";color:inherit}.esri-icon-radio-checked:before{content:"";color:inherit}.esri-icon-up-arrow-circled:before{content:"";color:inherit}.esri-icon-down-arrow-circled:before{content:"";color:inherit}.esri-icon-left-arrow-circled:before{content:"";color:inherit}.esri-icon-right-arrow-circled:before{content:"";color:inherit}.esri-icon-zoom-out-fixed:before{content:"";color:inherit}.esri-icon-zoom-in-fixed:before{content:"";color:inherit}.esri-icon-refresh:before{content:"";color:inherit}.esri-icon-edit:before{content:"";color:inherit}.esri-icon-authorize:before{content:"";color:inherit}.esri-icon-map-pin:before{content:"";color:inherit}.esri-icon-blank-map-pin:before{content:"";color:inherit}.esri-icon-table:before{content:"";color:inherit}.esri-icon-plus:before{content:"+";color:inherit}.esri-icon-minus:before{content:"";color:inherit}.esri-icon-beginning:before{content:"";color:inherit}.esri-icon-reverse:before{content:"";color:inherit}.esri-icon-pause:before{content:"";color:inherit}.esri-icon-play:before{content:"";color:inherit}.esri-icon-forward:before{content:"";color:inherit}.esri-icon-end:before{content:"";color:inherit}.esri-icon-erase:before{content:"";color:inherit}.esri-icon-up-down-arrows:before{content:"";color:inherit}.esri-icon-left:before{content:"";color:inherit}.esri-icon-right:before{content:"";color:inherit}.esri-icon-announcement:before{content:"";color:inherit}.esri-icon-notice-round:before{content:"";color:inherit}.esri-icon-notice-triangle:before{content:"";color:inherit}.esri-icon-home:before{content:"";color:inherit}.esri-icon-locate:before{content:"";color:inherit}.esri-icon-expand:before{content:"";color:inherit}.esri-icon-collapse:before{content:"";color:inherit}.esri-icon-layer-list:before{content:"";color:inherit}.esri-icon-basemap:before{content:"";color:inherit}.esri-icon-globe:before{content:"";color:inherit}.esri-icon-applications:before{content:"";color:inherit}.esri-icon-arrow-up-circled:before{content:"";color:inherit}.esri-icon-arrow-down-circled:before{content:"";color:inherit}.esri-icon-arrow-left-circled:before{content:"";color:inherit}.esri-icon-arrow-right-circled:before{content:"";color:inherit}.esri-icon-minus-circled:before{content:"";color:inherit}.esri-icon-plus-circled:before{content:"";color:inherit}.esri-icon-add-attachment:before{content:"";color:inherit}.esri-icon-attachment:before{content:"";color:inherit}.esri-icon-calendar:before{content:"";color:inherit}.esri-icon-close-circled:before{content:"";color:inherit}.esri-icon-browser:before{content:"";color:inherit}.esri-icon-collection:before{content:"";color:inherit}.esri-icon-comment:before{content:"";color:inherit}.esri-icon-configure-popup:before{content:"";color:inherit}.esri-icon-contact:before{content:"";color:inherit}.esri-icon-dashboard:before{content:"";color:inherit}.esri-icon-deny:before{content:"";color:inherit}.esri-icon-description:before{content:"";color:inherit}.esri-icon-directions:before{content:"";color:inherit}.esri-icon-directions2:before{content:"";color:inherit}.esri-icon-documentation:before{content:"";color:inherit}.esri-icon-duplicate:before{content:"";color:inherit}.esri-icon-review:before{content:"";color:inherit}.esri-icon-environment-settings:before{content:"";color:inherit}.esri-icon-error:before{content:"";color:inherit}.esri-icon-error2:before{content:"";color:inherit}.esri-icon-experimental:before{content:"";color:inherit}.esri-icon-feature-layer:before{content:"";color:inherit}.esri-icon-filter:before{content:"";color:inherit}.esri-icon-grant:before{content:"";color:inherit}.esri-icon-group:before{content:"";color:inherit}.esri-icon-key:before{content:"";color:inherit}.esri-icon-labels:before{content:"";color:inherit}.esri-icon-tag:before{content:"";color:inherit}.esri-icon-layers:before{content:"";color:inherit}.esri-icon-left-arrow:before{content:"";color:inherit}.esri-icon-right-arrow:before{content:"";color:inherit}.esri-icon-link-external:before{content:"";color:inherit}.esri-icon-link:before{content:"";color:inherit}.esri-icon-loading-indicator:before{content:"";color:inherit}.esri-icon-maps:before{content:"";color:inherit}.esri-icon-marketplace:before{content:"";color:inherit}.esri-icon-media:before{content:"";color:inherit}.esri-icon-media2:before{content:"";color:inherit}.esri-icon-menu:before{content:"";color:inherit}.esri-icon-mobile:before{content:"";color:inherit}.esri-icon-phone:before{content:"";color:inherit}.esri-icon-navigation:before{content:"";color:inherit}.esri-icon-pan:before{content:"";color:inherit}.esri-icon-printer:before{content:"";color:inherit}.esri-icon-pie-chart:before{content:"";color:inherit}.esri-icon-chart:before{content:"";color:inherit}.esri-icon-line-chart:before{content:"";color:inherit}.esri-icon-question:before{content:"";color:inherit}.esri-icon-resend-invitation:before{content:"";color:inherit}.esri-icon-rotate:before{content:"";color:inherit}.esri-icon-save:before{content:"";color:inherit}.esri-icon-settings:before{content:"";color:inherit}.esri-icon-settings2:before{content:"";color:inherit}.esri-icon-share:before{content:"";color:inherit}.esri-icon-sign-out:before{content:"";color:inherit}.esri-icon-support:before{content:"";color:inherit}.esri-icon-user:before{content:"";color:inherit}.esri-icon-time-clock:before{content:"";color:inherit}.esri-icon-trash:before{content:"";color:inherit}.esri-icon-upload:before{content:"";color:inherit}.esri-icon-download:before{content:"";color:inherit}.esri-icon-zoom-in-magnifying-glass:before{content:"";color:inherit}.esri-icon-search:before{content:"";color:inherit}.esri-icon-zoom-out-magnifying-glass:before{content:"";color:inherit}.esri-icon-locked:before{content:"";color:inherit}.esri-icon-unlocked:before{content:"";color:inherit}.esri-icon-favorites:before{content:"";color:inherit}.esri-icon-compass:before{content:"";color:inherit}.esri-icon-down:before{content:"";color:inherit}.esri-icon-up:before{content:"";color:inherit}.esri-icon-chat:before{content:"";color:inherit}.esri-icon-dock-bottom:before{content:"";color:inherit}.esri-icon-dock-left:before{content:"";color:inherit}.esri-icon-dock-right:before{content:"";color:inherit}.esri-icon-organization:before{content:"";color:inherit}.esri-icon-north-navigation:before{content:"";color:inherit}.esri-icon-locate-circled:before{content:"";color:inherit}.esri-icon-dial:before{content:"";color:inherit}.esri-icon-polygon:before{content:"";color:inherit}.esri-icon-polyline:before{content:"";color:inherit}.esri-icon-visible:before{content:"";color:inherit}.esri-icon-non-visible:before{content:"";color:inherit}.esri-icon-link-vertical:before{content:"";color:inherit}.esri-icon-unlocked-link-vertical:before{content:"";color:inherit}.esri-icon-link-horizontal:before{content:"";color:inherit}.esri-icon-unlocked-link-horizontal:before{content:"";color:inherit}.esri-icon-swap:before{content:"";color:inherit}.esri-icon-cta-link-external:before{content:"";color:inherit}.esri-icon-reply:before{content:"";color:inherit}.esri-icon-public:before{content:"";color:inherit}.esri-icon-share2:before{content:"";color:inherit}.esri-icon-launch-link-external:before{content:"";color:inherit}.esri-icon-rotate-back:before{content:"";color:inherit}.esri-icon-pan2:before{content:"";color:inherit}.esri-icon-tracking:before{content:"";color:inherit}.esri-icon-expand2:before{content:"";color:inherit}.esri-icon-arrow-down:before{content:"";color:inherit}.esri-icon-arrow-up:before{content:"";color:inherit}.esri-icon-hollow-eye:before{content:"";color:inherit}.esri-icon-play-circled:before{content:"";color:inherit}.esri-icon-volume-off:before{content:"";color:inherit}.esri-icon-volume-on:before{content:"";color:inherit}.esri-icon-bookmark:before{content:"";color:inherit}.esri-icon-lightbulb:before{content:"";color:inherit}.esri-icon-sketch-rectangle:before{content:"";color:inherit}.esri-icon-north-navigation-filled:before{content:"";color:inherit}.esri-icon-default-action:before{content:"";color:inherit}.esri-icon-undo:before{content:"";color:inherit}.esri-icon-redo:before{content:"";color:inherit}.esri-icon-cursor:before{content:"";color:inherit}.esri-icon-cursor-filled:before{content:"";color:inherit}.esri-icon-measure:before{content:"";color:inherit}.esri-icon-measure-line:before{content:"";color:inherit}.esri-icon-measure-area:before{content:"";color:inherit}.esri-icon-legend:before{content:"";color:inherit}.esri-icon-sliders:before{content:"";color:inherit}.esri-icon-sliders-horizontal:before{content:"";color:inherit}.esri-icon-cursor-marquee:before{content:"";color:inherit}.esri-icon-lasso:before{content:"";color:inherit}.esri-icon-elevation-profile:before{content:"";color:inherit}.esri-icon-slice:before{content:"";color:inherit}.esri-icon-line-of-sight:before{content:"";color:inherit}.esri-icon-zoom-to-object:before{content:"";color:inherit}.esri-icon-urban-model:before{content:"";color:inherit}.esri-icon-measure-building-height-shadow:before{content:"";color:inherit}.esri-icon-partly-cloudy:before{content:"";color:inherit}:host{max-width:fit-content;max-height:100%;overflow:auto;arcgis-utility-network-trace-inputs::slotted{overflow-y:auto;max-height:450px}}.arcgis-utility-network-trace-analysis{flex:auto;width:300px}.arcgis-utility-network-trace-analysis calcite-tab{background-color:var(--calcite-color-foreground-1);padding-top:0;padding-bottom:0;min-height:300px;--calcite-tab-content-space-y: 0}.arcgis-utility-network-trace-analysis calcite-tab:not([selected]){flex:0}.arcgis-utility-network-trace-analysis calcite-block{--calcite-block-border-color: transparent;margin:0;background-color:transparent}.arcgis-utility-network-trace-analysis calcite-block calcite-label:last-child{--calcite-label-margin-bottom: 0}.arcgis-utility-network-trace-analysis calcite-notice{padding:var(--calcite-spacing-xs)}`, k = y(w);
-class R extends _ {
+class T extends _ {
   constructor() {
-    super(...arguments), this._messages = v({ blocking: !0 }), this._viewModel = k(this), this._traceInputsRef = h(), this._traceResultsRef = h(), this._highlightHandles = [], this.activeTab = "input", this._mode = "default", this.allowEditingDisabled = !1, this.autoDestroyDisabled = !1, this.closable = !1, this.state = this._viewModel.state, this.view = this._viewModel.view, this.arcgisTraceLocationSelectStart = n(), this.arcgisTraceResultFeaturesReady = n(), this.arcgisReady = n();
+    super(...arguments), this._messages = v({ blocking: !0 }), this._viewModel = k(this), this._traceInputsRef = d(), this._traceResultsRef = d(), this._highlightHandles = [], this.activeTab = "input", this._mode = "default", this.allowEditingDisabled = !1, this.autoDestroyDisabled = !1, this.closable = !1, this.state = this._viewModel.state, this.view = this._viewModel.view, this.arcgisTraceLocationSelectStart = n(), this.arcgisTraceLocationSelectEnd = n(), this.arcgisTraceResultFeaturesReady = n(), this.arcgisReady = n();
   }
   static {
-    this.properties = { activeTab: 16, traceResult: 16, _mode: 16, allowEditingDisabled: 5, autoDestroyDisabled: 5, closable: 7, icon: 1, label: 3, messageOverrides: 0, mode: 1, traceResultFeatures: 32, referenceElement: 1, state: 3, view: 0 };
+    this.properties = { activeTab: 16, traceResult: 16, _mode: 16, allowEditingDisabled: 5, autoDestroyDisabled: 5, beforeTraceLocationSelectStart: 0, closable: 7, icon: 1, label: 3, messageOverrides: 0, mode: 1, traceResultFeatures: 32, referenceElement: 1, state: 3, view: 0 };
   }
   static {
     this.styles = x;
@@ -69,10 +69,10 @@ class R extends _ {
       return;
     o.getObjectIdsFromElements(e.elements).forEach((c) => {
       const s = i.allLayerViews.find((g) => {
-        const l = g.layer;
-        if (o.isUtilityLayer(l)) {
+        const a = g.layer;
+        if (o.isUtilityLayer(a)) {
           const u = Number(c.layerUrl.split("/").pop());
-          return l.layerId === u;
+          return a.layerId === u;
         }
         return !1;
       });
@@ -85,7 +85,7 @@ class R extends _ {
   async _runTrace() {
     const e = this._traceInputsRef.value?.selectedNamedTraceConfiguration, i = this._traceInputsRef.value?.unTraceConfiguration;
     if (!(e?.traceType && i)) {
-      f("error", this, "Trace configuration not found");
+      h("error", this, "Trace configuration not found");
       return;
     }
     const o = this._traceInputsRef.value?.traceLocations;
@@ -96,11 +96,14 @@ class R extends _ {
         traceLocations: o ?? []
       }), this._highlightResults();
     } catch (r) {
-      f("error", this, `Error while running trace. ${r}`), this.traceResult = void 0;
+      h("error", this, `Error while running trace. ${r}`), this.traceResult = void 0;
     }
   }
   _handleTraceLocationSelectStart(e) {
-    e.stopPropagation(), this.arcgisTraceLocationSelectStart.emit().defaultPrevented && e.preventDefault();
+    e.stopPropagation(), this.arcgisTraceLocationSelectStart.emit(e.detail).defaultPrevented && e.preventDefault();
+  }
+  _handleTraceLocationSelectEnd(e) {
+    e.stopPropagation(), this.arcgisTraceLocationSelectEnd.emit();
   }
   _handleTraceResultFeaturesReady(e) {
     e.stopPropagation(), this.arcgisTraceResultFeaturesReady.emit();
@@ -111,7 +114,7 @@ class R extends _ {
     this._viewModel.utilityNetwork = this._traceInputsRef.value?.selectedUtilityNetwork;
   }
   renderResultsTab() {
-    return a(`${this.el.id}__results-tab-item`, t`<calcite-tab .selected=${this.activeTab === "results"}>${this._viewModel.state === "executing" ? t`<calcite-loader .label=${this._messages.runningTrace} .text=${this._messages.runningTrace}></calcite-loader>` : t`<arcgis-utility-network-trace-results .referenceElement=${this.referenceElement} .layers=${this._allLayers} .traceConfigTitle=${this._selectedTraceConfig?.title} .traceResult=${this.traceResult} .utilityNetwork=${this._viewModel.utilityNetwork ?? void 0} .view=${this.view ?? void 0} @arcgisTraceResultFeaturesReady=${this._handleTraceResultFeaturesReady} ${d(this._traceResultsRef)}></arcgis-utility-network-trace-results>`}</calcite-tab>`);
+    return l(`${this.el.id}__results-tab-item`, t`<calcite-tab .selected=${this.activeTab === "results"}>${this._viewModel.state === "executing" ? t`<calcite-loader .label=${this._messages.runningTrace} .text=${this._messages.runningTrace}></calcite-loader>` : t`<arcgis-utility-network-trace-results .referenceElement=${this.referenceElement} .layers=${this._allLayers} .traceConfigTitle=${this._selectedTraceConfig?.title} .traceResult=${this.traceResult} .utilityNetwork=${this._viewModel.utilityNetwork ?? void 0} .view=${this.view ?? void 0} @arcgisTraceResultFeaturesReady=${this._handleTraceResultFeaturesReady} ${f(this._traceResultsRef)}></arcgis-utility-network-trace-results>`}</calcite-tab>`);
   }
   renderResultsFooter() {
     const { _mode: e } = this;
@@ -120,9 +123,9 @@ class R extends _ {
     }} .disabled=${!this._traceResultsReady} slot=footer>${this._traceResultsReady ? this._messages.buttons.clearResultsCustom.replace("{number}", this.traceResultFeatures.length.toString()) : this._messages.buttons.clearResultsGeneric}</calcite-button>`;
   }
   renderInputTab() {
-    return a(`${this.el.id}__inputs-tab-item`, t`<calcite-tab .selected=${this.activeTab === "input"}><arcgis-utility-network-trace-inputs .view=${this.view || void 0} @arcgisTraceInputsChange=${this._handleTraceInputsChange} @arcgisUtilityNetworkChange=${this._handleUtilityNetworkChange} @arcgisTraceLocationSelectStart=${this._handleTraceLocationSelectStart} @arcgisPropertyChange=${(e) => {
+    return l(`${this.el.id}__inputs-tab-item`, t`<calcite-tab .selected=${this.activeTab === "input"}><arcgis-utility-network-trace-inputs .view=${this.view || void 0} .beforeTraceLocationSelectStart=${this.beforeTraceLocationSelectStart} @arcgisTraceInputsChange=${this._handleTraceInputsChange} @arcgisUtilityNetworkChange=${this._handleUtilityNetworkChange} @arcgisTraceLocationSelectStart=${this._handleTraceLocationSelectStart} @arcgisTraceLocationSelectEnd=${this._handleTraceLocationSelectEnd} @arcgisPropertyChange=${(e) => {
       e.stopPropagation(), e.detail.name === "mode" && (this._mode = e.target.mode);
-    }} ${d(this._traceInputsRef)}></arcgis-utility-network-trace-inputs></calcite-tab>`);
+    }} ${f(this._traceInputsRef)}></arcgis-utility-network-trace-inputs></calcite-tab>`);
   }
   renderInputFooter() {
     const { _mode: e } = this;
@@ -139,7 +142,7 @@ class R extends _ {
     }} .selected=${this.activeTab === "results"}>${e.tabs.resultsTab}</calcite-tab-title></calcite-tab-nav>${this.view ? this.renderInputTab() : null}${this.view && this._viewModel.utilityNetwork ? this.renderResultsTab() : null}</calcite-tabs>${r}${this.activeTab === "input" ? this.renderInputFooter() : null}${this.activeTab === "results" ? this.renderResultsFooter() : null}</calcite-panel></div>`;
   }
 }
-p("arcgis-utility-network-trace-analysis", R);
+p("arcgis-utility-network-trace-analysis", T);
 export {
-  R as ArcgisUtilityNetworkTraceAnalysis
+  T as ArcgisUtilityNetworkTraceAnalysis
 };

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

@@ -9,6 +9,7 @@ import { default as TraceLocation } from '@arcgis/core/rest/networks/support/Tra
 import { JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { PropertyValues } from 'lit';
 import { ArcgisReferenceElement } from '../../utils/component-utils';
+import { SelectStartPayload } from '../arcgis-utility-network-trace-location/customElement.js';
 
 type State = "disabled" | "error" | "loading" | "ready";
 /**
@@ -23,6 +24,12 @@ type State = "disabled" | "error" | "loading" | "ready";
  * @internal
  */
 export declare class ArcgisUtilityNetworkTraceInputs extends LitElement {
+    /**
+     * A function to run before trace location selection starts.
+     *
+     * @experimental
+     */
+    beforeTraceLocationSelectStart?: () => Promise<void>;
     /** @required */
     view?: __esri.MapView;
     selectedUtilityNetwork?: UtilityNetwork;
@@ -42,11 +49,18 @@ export declare class ArcgisUtilityNetworkTraceInputs extends LitElement {
     /** This will be fired less often than above, only when the utility network changes */
     readonly arcgisUtilityNetworkChange: TargetedEvent<this, void>;
     /**
-     * Notify consumers when the user begins selection of a trace location.
-     * This has its own event because consumers may want to prevent interaction
-     * with the map, e.g., Web Editor.
+     * Fires when the user begins selection of a trace location.
+     * Can be prevented to stop the selection.
+     *
+     * @experimental
+     */
+    readonly arcgisTraceLocationSelectStart: TargetedEvent<this, SelectStartPayload>;
+    /**
+     * Fires when the user completes the selection of a trace location.
+     *
+     * @experimental
      */
-    readonly arcgisTraceLocationSelectStart: TargetedEvent<this, void>;
+    readonly arcgisTraceLocationSelectEnd: TargetedEvent<this, void>;
     readonly arcgisPropertyChange: TargetedEvent<this, {
         name: "mode";
     }>;

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

@@ -1,39 +1,39 @@
 import { c as y } from "../../chunks/runtime.js";
 import { repeat as d } from "lit/directives/repeat.js";
 import { queryAllJSON as b } from "@arcgis/core/applications/Components/featureUtils.js";
-import o from "@arcgis/core/core/Collection.js";
+import s from "@arcgis/core/core/Collection.js";
 import f from "@arcgis/core/layers/GraphicsLayer.js";
-import _ from "@arcgis/core/networks/support/UNTraceConfiguration.js";
-import S from "@arcgis/core/rest/networks/support/TraceLocation.js";
-import N from "@arcgis/core/rest/support/FeatureSet.js";
-import l from "@arcgis/core/views/interactive/snapping/FeatureSnappingLayerSource.js";
-import T from "@arcgis/core/widgets/Sketch/SketchViewModel.js";
-import { LitElement as L, createEvent as u, safeClassMap as h } from "@arcgis/lumina";
-import { css as C, html as r } from "lit";
-import { u as $ } from "../../chunks/useT9n.js";
+import S from "@arcgis/core/networks/support/UNTraceConfiguration.js";
+import _ from "@arcgis/core/rest/networks/support/TraceLocation.js";
+import T from "@arcgis/core/rest/support/FeatureSet.js";
+import u from "@arcgis/core/views/interactive/snapping/FeatureSnappingLayerSource.js";
+import N from "@arcgis/core/widgets/Sketch/SketchViewModel.js";
+import { LitElement as L, createEvent as c, safeClassMap as h } from "@arcgis/lumina";
+import { css as $, html as r } from "lit";
+import { u as C } from "../../chunks/useT9n.js";
 import { usePropertyChange as v } from "@arcgis/lumina/controllers";
-import { log as c, composeMissingPropertyMessage as U, composeEmptyPropertyMessage as E } from "@arcgis/toolkit/log";
+import { log as l, composeMissingPropertyMessage as U, composeEmptyPropertyMessage as E } from "@arcgis/toolkit/log";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/5.0/esri/copyright.txt for details.
-v5.0.0-next.91 */
-const M = C`:host{width:100%}.arcgis-utility-network-trace-inputs calcite-block{--calcite-block-content-space: 0;--calcite-block-border-color: transparent;margin:0}.arcgis-utility-network-trace-inputs calcite-block-group{padding-bottom:var(--calcite-spacing-md);background-color:var(--calcite-color-foreground-1)}.arcgis-utility-network-trace-inputs calcite-block calcite-select,.arcgis-utility-network-trace-inputs calcite-block calcite-input{padding:0 var(--calcite-spacing-md)}.arcgis-utility-network-trace-inputs calcite-block calcite-label:last-child{--calcite-label-margin-bottom: 0}.arcgis-utility-network-trace-inputs calcite-notice{padding:var(--calcite-spacing-md)}.arcgis-utility-network-trace-inputs .inline-loader{--calcite-loader-spacing: var(--calcite-spacing-md)}.arcgis-utility-network-trace-inputs__add-spatial-mode{display:flex;height:300px;padding:var(--calcite-spacing-xxl) var(--calcite-spacing-sm);flex-direction:column;justify-content:center;align-items:center;gap:var(--calcite-spacing-md);align-self:stretch}.arcgis-utility-network-trace-inputs .subnetwork-info-block{padding-top:var(--calcite-spacing-md);padding-left:var(--calcite-spacing-md);padding-right:var(--calcite-spacing-md)}`, g = "arcgis-utility-network-trace-inputs", p = {
+v5.0.0-next.93 */
+const M = $`:host{width:100%}.arcgis-utility-network-trace-inputs calcite-block{--calcite-block-content-space: 0;--calcite-block-border-color: transparent;margin:0}.arcgis-utility-network-trace-inputs calcite-block-group{padding-bottom:var(--calcite-spacing-md);background-color:var(--calcite-color-foreground-1)}.arcgis-utility-network-trace-inputs calcite-block calcite-select,.arcgis-utility-network-trace-inputs calcite-block calcite-input{padding:0 var(--calcite-spacing-md)}.arcgis-utility-network-trace-inputs calcite-block calcite-label:last-child{--calcite-label-margin-bottom: 0}.arcgis-utility-network-trace-inputs calcite-notice{padding:var(--calcite-spacing-md)}.arcgis-utility-network-trace-inputs .inline-loader{--calcite-loader-spacing: var(--calcite-spacing-md)}.arcgis-utility-network-trace-inputs__add-spatial-mode{display:flex;height:300px;padding:var(--calcite-spacing-xxl) var(--calcite-spacing-sm);flex-direction:column;justify-content:center;align-items:center;gap:var(--calcite-spacing-md);align-self:stretch}.arcgis-utility-network-trace-inputs .subnetwork-info-block{padding-top:var(--calcite-spacing-md);padding-left:var(--calcite-spacing-md);padding-right:var(--calcite-spacing-md)}`, g = "arcgis-utility-network-trace-inputs", p = {
   // popup renderer
   base: g,
   // containers and content
   addSpatialMode: `${g}__add-spatial-mode`
 }, w = `utility-network-trace-inputs-sketch-${Date.now()}`, n = `utility-network-trace-inputs-flags-${Date.now()}`, I = 20;
-class A extends L {
+class P extends L {
   constructor() {
-    super(...arguments), this._messages = $({ blocking: !0 }), this._startingPoints = new o(), this._barriers = new o(), this._stoppingPoints = new o(), this._subnetworkTraceTypes = /* @__PURE__ */ new Set([
+    super(...arguments), this._messages = C({ blocking: !0 }), this._startingPoints = new s(), this._barriers = new s(), this._stoppingPoints = new s(), this._subnetworkTraceTypes = /* @__PURE__ */ new Set([
       "subnetwork",
       "subnetwork-controller",
       "upstream",
       "downstream",
       "isolation"
-    ]), this._removeDuplicateSubnetworkNames = (e, t, i) => t === 0 || e.getAttribute("SUBNETWORKNAME") !== i[t - 1].getAttribute("SUBNETWORKNAME"), this.compatibleSubnetworkNames = [], this.traceConfigurations = [], this._state = "ready", this.mode = "default", this.arcgisTraceInputsChange = u(), this.arcgisUtilityNetworkChange = u(), this.arcgisTraceLocationSelectStart = u(), this.arcgisPropertyChange = v()("mode");
+    ]), this._removeDuplicateSubnetworkNames = (e, t, i) => t === 0 || e.getAttribute("SUBNETWORKNAME") !== i[t - 1].getAttribute("SUBNETWORKNAME"), this.compatibleSubnetworkNames = [], this.traceConfigurations = [], this._state = "ready", this.mode = "default", this.arcgisTraceInputsChange = c(), this.arcgisUtilityNetworkChange = c(), this.arcgisTraceLocationSelectStart = c(), this.arcgisTraceLocationSelectEnd = c(), this.arcgisPropertyChange = v()("mode");
   }
   static {
-    this.properties = { compatibleSubnetworkNames: 16, subnetworksTable: 16, traceConfigurations: 16, utilityNetworks: 16, _unTraceConfiguration: 16, _state: 16, _activeTraceLocationType: 16, view: 0, selectedUtilityNetwork: 0, selectedNamedTraceConfiguration: 0, unTraceConfiguration: 32, referenceElement: 1, mode: 1, traceLocations: 32 };
+    this.properties = { compatibleSubnetworkNames: 16, subnetworksTable: 16, traceConfigurations: 16, utilityNetworks: 16, _unTraceConfiguration: 16, _state: 16, _activeTraceLocationType: 16, beforeTraceLocationSelectStart: 0, view: 0, selectedUtilityNetwork: 0, selectedNamedTraceConfiguration: 0, unTraceConfiguration: 32, referenceElement: 1, mode: 1, traceLocations: 32 };
   }
   static {
     this.styles = M;
@@ -53,13 +53,13 @@ class A extends L {
   }
   get traceLocations() {
     const e = [], t = (i) => {
-      i.flagProperties.terminalConfiguration && i.flagProperties.selectedTerminals ? i.flagProperties.selectedTerminals.forEach((s) => {
-        e.push(new S({
+      i.flagProperties.terminalConfiguration && i.flagProperties.selectedTerminals ? i.flagProperties.selectedTerminals.forEach((o) => {
+        e.push(new _({
           type: i.traceLocation.type,
           isFilterBarrier: i.traceLocation.isFilterBarrier,
           globalId: i.traceLocation.globalId,
           percentAlong: i.traceLocation.percentAlong,
-          terminalId: s
+          terminalId: o
         }));
       }) : e.push(i.traceLocation);
     };
@@ -79,7 +79,7 @@ class A extends L {
     if (!t || !e?.map)
       return;
     const { map: i } = e;
-    i.layers.find((s) => s === t) || i.add(t), i.reorder(t, i.layers.length - 1);
+    i.layers.find((o) => o === t) || i.add(t), i.reorder(t, i.layers.length - 1);
   }
   _createGraphicLayer(e) {
     const { map: t } = this.view;
@@ -104,14 +104,14 @@ class A extends L {
   _setSnappingOption() {
     const { _sketchViewModel: e, _unLayers: t } = this;
     if (e && t && t.length > 0) {
-      const i = new o();
+      const i = new s();
       t.forEach((a) => {
-        a.type === "subtype-group" ? a.sublayers.forEach((s) => {
-          i.add(new l({
-            layer: s,
+        a.type === "subtype-group" ? a.sublayers.forEach((o) => {
+          i.add(new u({
+            layer: o,
             enabled: !0
           }));
-        }) : i.add(new l({
+        }) : i.add(new u({
           layer: a,
           enabled: !0
         }));
@@ -123,11 +123,11 @@ class A extends L {
     }
   }
   _initializeSketchViewModel() {
-    const { view: e, _unLayers: t } = this, i = this._getGraphicLayer(w), a = new o();
-    return t?.forEach((s) => a.add(new l({
-      layer: s,
+    const { view: e, _unLayers: t } = this, i = this._getGraphicLayer(w), a = new s();
+    return t?.forEach((o) => a.add(new u({
+      layer: o,
       enabled: !0
-    }))), new T({
+    }))), new N({
       layer: i,
       view: e
     });
@@ -147,7 +147,7 @@ class A extends L {
       return;
     const t = e.createQuery();
     t.gdbVersion = this.selectedUtilityNetwork?.gdbVersion, t.where = this._getSubnetworkQueryWhereClause(), t.outFields = ["SUBNETWORKNAME"], t.orderByFields = ["SUBNETWORKNAME"];
-    const i = N.fromJSON(await b(e, t));
+    const i = T.fromJSON(await b(e, t));
     this.compatibleSubnetworkNames = i.features.filter(this._removeDuplicateSubnetworkNames).map((a) => a.getAttribute("SUBNETWORKNAME"));
   }
   _getSubnetworkQueryWhereClause() {
@@ -162,15 +162,15 @@ class A extends L {
   _selectTraceConfigurationByGuid(e) {
     const t = this.selectedUtilityNetwork?.sharedNamedTraceConfigurations.find((i) => i.globalId === e);
     if (!t) {
-      c("error", this, "`traceConfig` not found in `selectedUtilityNetwork.sharedNamedTraceConfigurations`");
+      l("error", this, "`traceConfig` not found in `selectedUtilityNetwork.sharedNamedTraceConfigurations`");
       return;
     }
     this.selectedNamedTraceConfiguration = t;
   }
   _handleTraceConfigChange() {
     const { selectedNamedTraceConfiguration: e } = this;
-    if (!(e?.traceConfiguration instanceof _)) {
-      c("error", this, U("selectedNamedTraceConfiguration.traceConfiguration")), this._unTraceConfiguration = void 0;
+    if (!(e?.traceConfiguration instanceof S)) {
+      l("error", this, U("selectedNamedTraceConfiguration.traceConfiguration")), this._unTraceConfiguration = void 0;
       return;
     }
     switch (this._unTraceConfiguration = e.traceConfiguration.clone(), e.traceType) {
@@ -187,12 +187,12 @@ class A extends L {
   }
   _filterUnLayers() {
     const { selectedUtilityNetwork: e } = this;
-    this._unLayers = new o(this._allLayers.filter((t) => e?.isUtilityLayer(t))), this._setSnappingOption();
+    this._unLayers = new s(this._allLayers.filter((t) => e?.isUtilityLayer(t))), this._setSnappingOption();
   }
   _handleUtilityNetworksChange() {
     const { utilityNetworks: e } = this;
     if (!e || e.length === 0) {
-      this._state = "error", c("error", this, E("utilityNetworks"));
+      this._state = "error", l("error", this, E("utilityNetworks"));
       return;
     }
     (!this.selectedUtilityNetwork || !e.includes(this.selectedUtilityNetwork)) && (this.selectedUtilityNetwork = e.at(0));
@@ -202,20 +202,20 @@ class A extends L {
       const e = this.view.map;
       await e.load(), this.utilityNetworks = e.utilityNetworks || void 0;
     } else
-      this._state = "disabled", c("error", this, "The property `view.map` is required to load utility networks but is missing.");
+      this._state = "disabled", l("error", this, "The property `view.map` is required to load utility networks but is missing.");
   }
   _handleTraceLocationSelectStart(e) {
-    if (e.stopPropagation(), this.arcgisTraceLocationSelectStart.emit().defaultPrevented) {
+    if (e.stopPropagation(), this.arcgisTraceLocationSelectStart.emit(e.detail).defaultPrevented) {
       e.preventDefault();
       return;
     }
     this._activeTraceLocationType = e?.target?.traceLocationType, this.mode = "add-spatial";
   }
-  _handleTraceLocationSelectEnd() {
-    this._activeTraceLocationType = void 0, this.mode = "default";
+  _handleTraceLocationSelectEnd(e) {
+    e.stopPropagation(), this.arcgisTraceLocationSelectEnd.emit(), this._activeTraceLocationType = void 0, this.mode = "default";
   }
   _handleFlowItemBack() {
-    this.mode = "default", this._activeTraceLocationType = void 0, this._sketchViewModel?.cancel();
+    this._activeTraceLocationType = void 0, this.mode = "default", this._sketchViewModel?.cancel();
   }
   renderError(e, t = !1, i) {
     return r`<calcite-notice .closable=${t} kind=danger open scale=s width=auto .icon=${i}><div slot=message>${e}</div></calcite-notice>`;
@@ -227,15 +227,15 @@ class A extends L {
     const { _messages: e, traceConfigurations: t } = this, i = e.labels.traceConfiguration;
     if (t.length === 0)
       return this.renderError(e.errors.noTraceConfigurationError, !0);
-    const a = d(t, (s) => s.globalId, (s) => r`<calcite-option .value=${s.globalId}>${s.title}</calcite-option>`);
-    return r`<calcite-block .heading=${i} .label=${i} expanded><calcite-select .label=${i} .value=${this.selectedNamedTraceConfiguration?.globalId || void 0} @calciteSelectChange=${(s) => {
-      this._selectTraceConfigurationByGuid(s.target.value);
+    const a = d(t, (o) => o.globalId, (o) => r`<calcite-option .value=${o.globalId}>${o.title}</calcite-option>`);
+    return r`<calcite-block .heading=${i} .label=${i} expanded><calcite-select .label=${i} .value=${this.selectedNamedTraceConfiguration?.globalId || void 0} @calciteSelectChange=${(o) => {
+      this._selectTraceConfigurationByGuid(o.target.value);
     }}>${a}</calcite-select></calcite-block>`;
   }
   renderUtilityNetworkSelection() {
     const { _messages: e } = this, t = e.labels.utilityNetwork, i = d(this.utilityNetworks, (a) => a.id, (a) => r`<calcite-option .value=${a.id}>${a.title}</calcite-option>`).toArray();
     return r`<calcite-block .heading=${t} .label=${t} expanded><calcite-select .label=${t} .value=${this.selectedUtilityNetwork?.id} @calciteSelectChange=${(a) => {
-      this.selectedUtilityNetwork?.id !== a.target.value && (this.selectedUtilityNetwork = this.utilityNetworks?.find((s) => s.id === a.target.value));
+      this.selectedUtilityNetwork?.id !== a.target.value && (this.selectedUtilityNetwork = this.utilityNetworks?.find((o) => o.id === a.target.value));
     }}>${i}</calcite-select></calcite-block>`;
   }
   renderDefaultMode() {
@@ -247,13 +247,13 @@ class A extends L {
     return r`<calcite-flow-item selected .heading=${i} @calciteFlowItemBack=${() => this._handleFlowItemBack()}><div class=${h(p.addSpatialMode)}><calcite-icon icon=pin-plus scale=l></calcite-icon>${e.instructions.addSpatial}</div></calcite-flow-item>`;
   }
   renderStartingPointSelection() {
-    return r`<arcgis-utility-network-trace-location .view=${this.view} trace-location-type=starting-point @arcgisTraceLocationSelectStart=${(e) => this._handleTraceLocationSelectStart(e)} @arcgisTraceLocationSelectEnd=${() => this._handleTraceLocationSelectEnd()} @arcgisTraceLocationChange=${() => this.arcgisTraceInputsChange.emit()} .sketchViewModel=${this._sketchViewModel} .utilityNetwork=${this.selectedUtilityNetwork} .filterLayers=${this._unLayers} .flagLayer=${this._getGraphicLayer(n)} .traceLocations=${this._startingPoints}></arcgis-utility-network-trace-location>`;
+    return r`<arcgis-utility-network-trace-location .view=${this.view} trace-location-type=starting-point .beforeTraceLocationSelectStart=${this.beforeTraceLocationSelectStart} @arcgisTraceLocationSelectStart=${this._handleTraceLocationSelectStart} @arcgisTraceLocationSelectEnd=${this._handleTraceLocationSelectEnd} @arcgisTraceLocationChange=${() => this.arcgisTraceInputsChange.emit()} .sketchViewModel=${this._sketchViewModel} .utilityNetwork=${this.selectedUtilityNetwork} .filterLayers=${this._unLayers} .flagLayer=${this._getGraphicLayer(n)} .traceLocations=${this._startingPoints}></arcgis-utility-network-trace-location>`;
   }
   renderStoppingPointSelection() {
-    return r`<arcgis-utility-network-trace-location .view=${this.view} trace-location-type=stopping-point @arcgisTraceLocationSelectStart=${(e) => this._handleTraceLocationSelectStart(e)} @arcgisTraceLocationSelectEnd=${() => this._handleTraceLocationSelectEnd()} @arcgisTraceLocationChange=${() => this.arcgisTraceInputsChange.emit()} .sketchViewModel=${this._sketchViewModel} .utilityNetwork=${this.selectedUtilityNetwork} .filterLayers=${this._unLayers} .flagLayer=${this._getGraphicLayer(n)} .traceLocations=${this._stoppingPoints}></arcgis-utility-network-trace-location>`;
+    return r`<arcgis-utility-network-trace-location .view=${this.view} trace-location-type=stopping-point .beforeTraceLocationSelectStart=${this.beforeTraceLocationSelectStart} @arcgisTraceLocationSelectStart=${this._handleTraceLocationSelectStart} @arcgisTraceLocationSelectEnd=${this._handleTraceLocationSelectEnd} @arcgisTraceLocationChange=${() => this.arcgisTraceInputsChange.emit()} .sketchViewModel=${this._sketchViewModel} .utilityNetwork=${this.selectedUtilityNetwork} .filterLayers=${this._unLayers} .flagLayer=${this._getGraphicLayer(n)} .traceLocations=${this._stoppingPoints}></arcgis-utility-network-trace-location>`;
   }
   renderBarrierSelection() {
-    return r`<arcgis-utility-network-trace-location .view=${this.view} trace-location-type=barrier @arcgisTraceLocationSelectStart=${(e) => this._handleTraceLocationSelectStart(e)} @arcgisTraceLocationSelectEnd=${() => this._handleTraceLocationSelectEnd()} @arcgisTraceLocationChange=${() => this.arcgisTraceInputsChange.emit()} .sketchViewModel=${this._sketchViewModel} .utilityNetwork=${this.selectedUtilityNetwork} .filterLayers=${this._unLayers} .flagLayer=${this._getGraphicLayer(n)} .traceLocations=${this._barriers}></arcgis-utility-network-trace-location>`;
+    return r`<arcgis-utility-network-trace-location .view=${this.view} trace-location-type=barrier .beforeTraceLocationSelectStart=${this.beforeTraceLocationSelectStart} @arcgisTraceLocationSelectStart=${this._handleTraceLocationSelectStart} @arcgisTraceLocationSelectEnd=${this._handleTraceLocationSelectEnd} @arcgisTraceLocationChange=${() => this.arcgisTraceInputsChange.emit()} .sketchViewModel=${this._sketchViewModel} .utilityNetwork=${this.selectedUtilityNetwork} .filterLayers=${this._unLayers} .flagLayer=${this._getGraphicLayer(n)} .traceLocations=${this._barriers}></arcgis-utility-network-trace-location>`;
   }
   renderSubnetworkNameInput() {
     return r`<calcite-input clearable type=text .placeholder=${this._messages.instructions.enterSubnetworkName} max-length=64 .value=${this.selectedSubnetworkName} @calciteInputInput=${(e) => this.selectedSubnetworkName = e.target.value}></calcite-input>`;
@@ -273,7 +273,7 @@ class A extends L {
     const { utilityNetworks: e } = this, t = this.selectedNamedTraceConfiguration?.traceConfiguration;
     if (!e || e.length === 0)
       return this.renderError(this._messages.errors.noUtilityNetworkError);
-    const i = r`${this.renderTraceSelection()}${this.renderSubnetworkInfo()}${this.renderSubnetworkSelection()}`, a = this.selectedNamedTraceConfiguration?.traceType, s = !(t?.subnetworkName && a === "subnetwork"), m = a === "path" || a === "circuit", k = r`${s ? this.renderStartingPointSelection() : null}${m ? this.renderStoppingPointSelection() : null}${this.renderBarrierSelection()}`;
+    const i = r`${this.renderTraceSelection()}${this.renderSubnetworkInfo()}${this.renderSubnetworkSelection()}`, a = this.selectedNamedTraceConfiguration?.traceType, o = !(t?.subnetworkName && a === "subnetwork"), m = a === "path" || a === "circuit", k = r`${o ? this.renderStartingPointSelection() : null}${m ? this.renderStoppingPointSelection() : null}${this.renderBarrierSelection()}`;
     return r`<calcite-block-group .label=${this._messages.labels.traceInputs}>${e.length > 1 ? this.renderUtilityNetworkSelection() : null}${this.selectedUtilityNetwork?.loaded ? i : this.renderLoader()}${t ? k : null}</calcite-block-group>`;
   }
   render() {
@@ -281,7 +281,7 @@ class A extends L {
     return r`<div class=${h(p.base)}><calcite-flow>${this.renderDefaultMode()}${e === "add-spatial" ? this.renderAddSpatialMode() : null}</calcite-flow></div>`;
   }
 }
-y("arcgis-utility-network-trace-inputs", A);
+y("arcgis-utility-network-trace-inputs", P);
 export {
-  A as ArcgisUtilityNetworkTraceInputs
+  P as ArcgisUtilityNetworkTraceInputs
 };

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

@@ -25,6 +25,9 @@ export interface FlagInfo {
     };
 }
 export type TraceLocationType = "barrier" | "starting-point" | "stopping-point";
+export interface SelectStartPayload {
+    cancelSelect: () => void;
+}
 
 /**
  * This is a sub-component used by the **ArcgisUtilityNetworkTraceAnalysis** component.
@@ -38,6 +41,12 @@ export type TraceLocationType = "barrier" | "starting-point" | "stopping-point";
  * @internal
  */
 export declare class ArcgisUtilityNetworkTraceLocation extends LitElement {
+    /**
+     * A function to run before trace location selection starts.
+     *
+     * @experimental
+     */
+    beforeTraceLocationSelectStart?: () => Promise<void>;
     /** @required */
     view?: MapView;
     /** @default "starting-point" */
@@ -51,6 +60,17 @@ export declare class ArcgisUtilityNetworkTraceLocation extends LitElement {
     /** @required The utility network to perform the trace on. */
     utilityNetwork?: UtilityNetwork;
     readonly arcgisTraceLocationChange: TargetedEvent<this, void>;
+    /**
+     * Fires when the user completes the selection of a trace location.
+     *
+     * @experimental
+     */
     readonly arcgisTraceLocationSelectEnd: TargetedEvent<this, void>;
-    readonly arcgisTraceLocationSelectStart: TargetedEvent<this, void>;
+    /**
+     * Fires when the user begins selection of a trace location.
+     * Can be prevented to stop the selection.
+     *
+     * @experimental
+     */
+    readonly arcgisTraceLocationSelectStart: TargetedEvent<this, SelectStartPayload>;
 }