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

package/dist/docs/docs.json

@@ -1,8 +1,8 @@
 {
-  "timestamp": "2025-12-16T18:49:09",
+  "timestamp": "2025-12-17T04:36:17",
   "compiler": {
     "name": "@arcgis/lumina-compiler",
-    "version": "5.0.0-next.92",
+    "version": "5.0.0-next.93",
     "typescriptVersion": "5.9.3"
   },
   "components": [
@@ -56599,6 +56599,36 @@
           "optional": true,
           "required": false
         },
+        {
+          "name": "beforeTraceLocationSelectStart",
+          "type": "((() => Promise<void>))",
+          "complexType": {
+            "original": "((() => Promise<void>))",
+            "resolved": "((() => Promise<void>))",
+            "references": {
+              "Promise": {
+                "location": "import",
+                "path": "typescript/lib/lib.es5.d.ts",
+                "id": "notImplemented"
+              }
+            }
+          },
+          "mutable": true,
+          "reflectToAttr": false,
+          "docs": "A function to run before trace location selection starts.",
+          "docsTags": [
+            {
+              "name": "experimental"
+            },
+            {
+              "name": "example",
+              "text": "```js\nconst traceElement = document.querySelector(\"arcgis-utility-network-trace-analysis\");\ntraceElement.beforeTraceLocationSelectStart = async () => await doAsyncWork();\n```"
+            }
+          ],
+          "values": [],
+          "optional": true,
+          "required": false
+        },
         {
           "name": "closable",
           "type": "boolean",
@@ -56932,7 +56962,7 @@
           "docsTags": []
         },
         {
-          "event": "arcgisTraceLocationSelectStart",
+          "event": "arcgisTraceLocationSelectEnd",
           "detail": "void",
           "bubbles": true,
           "complexType": {
@@ -56942,11 +56972,46 @@
           },
           "cancelable": true,
           "composed": true,
-          "docs": "Fires when the user begins selection of a trace location.\nCan be prevented to stop the selection.",
+          "docs": "Fires when the user completes the selection of a trace location.",
+          "docsTags": [
+            {
+              "name": "experimental"
+            },
+            {
+              "name": "example",
+              "text": "```js\nconst traceElement = document.querySelector(\"arcgis-utility-network-trace-analysis\");\ntraceElement.addEventListener(\"arcgisTraceLocationSelectEnd\", () => {\n  console.log(\"Selection finished!\");\n});\n```"
+            }
+          ]
+        },
+        {
+          "event": "arcgisTraceLocationSelectStart",
+          "detail": "SelectStartPayload",
+          "bubbles": true,
+          "complexType": {
+            "original": "SelectStartPayload",
+            "resolved": "SelectStartPayload",
+            "references": {
+              "SelectStartPayload": {
+                "location": "local",
+                "path": "dist/components/arcgis-utility-network-trace-location/customElement.d.ts",
+                "id": "notImplemented"
+              }
+            }
+          },
+          "cancelable": true,
+          "composed": true,
+          "docs": "Fires when the user begins selection of a trace location.\nEvent payload contains a callback method `cancelSelect` to cancel a selection in progress.\nThe event can also be prevented with `event.preventDefault()` to stop the selection.",
           "docsTags": [
+            {
+              "name": "experimental"
+            },
             {
               "name": "example",
               "text": "```js\nconst traceElement = document.querySelector(\"arcgis-utility-network-trace-analysis\");\ntraceElement.addEventListener(\"arcgisTraceLocationSelectStart\", (event) => {\n  event.preventDefault();\n});\n```"
+            },
+            {
+              "name": "example",
+              "text": "```js\nlet cancelSelect;\nconst traceElement = document.querySelector(\"arcgis-utility-network-trace-analysis\");\ntraceElement.addEventListener(\"arcgisTraceLocationSelectStart\", (event) => {\n  cancelSelect = event.detail.cancelSelect;\n});\n\nsetTimeout(() => {\n  cancelSelect();\n}, 3000);*\n```"
             }
           ]
         },
@@ -56963,6 +57028,9 @@
           "composed": true,
           "docs": "Fires when the trace result features are ready.\nCheck property `traceResultFeatures` for the trace result features.",
           "docsTags": [
+            {
+              "name": "experimental"
+            },
             {
               "name": "example",
               "text": "```js\nconst traceElement = document.querySelector(\"arcgis-utility-network-trace-analysis\");\ntraceElement.addEventListener(\"arcgisTraceResultFeaturesReady\", (event) => {\n  const resultFeatures = traceElement.traceResultFeatures;\n  console.log(resultFeatures);\n});\n```"
@@ -57099,6 +57167,32 @@
       "dependencies": [],
       "dependencyGraph": {},
       "props": [
+        {
+          "name": "beforeTraceLocationSelectStart",
+          "type": "((() => Promise<void>))",
+          "complexType": {
+            "original": "((() => Promise<void>))",
+            "resolved": "((() => Promise<void>))",
+            "references": {
+              "Promise": {
+                "location": "import",
+                "path": "typescript/lib/lib.es5.d.ts",
+                "id": "notImplemented"
+              }
+            }
+          },
+          "mutable": true,
+          "reflectToAttr": false,
+          "docs": "A function to run before trace location selection starts.",
+          "docsTags": [
+            {
+              "name": "experimental"
+            }
+          ],
+          "values": [],
+          "optional": true,
+          "required": false
+        },
         {
           "name": "mode",
           "type": "\"add-spatial\" | \"default\"",
@@ -57373,7 +57467,7 @@
           "docsTags": []
         },
         {
-          "event": "arcgisTraceLocationSelectStart",
+          "event": "arcgisTraceLocationSelectEnd",
           "detail": "void",
           "bubbles": true,
           "complexType": {
@@ -57383,8 +57477,36 @@
           },
           "cancelable": true,
           "composed": true,
-          "docs": "Notify consumers when the user begins selection of a trace location.\nThis has its own event because consumers may want to prevent interaction\nwith the map, e.g., Web Editor.",
-          "docsTags": []
+          "docs": "Fires when the user completes the selection of a trace location.",
+          "docsTags": [
+            {
+              "name": "experimental"
+            }
+          ]
+        },
+        {
+          "event": "arcgisTraceLocationSelectStart",
+          "detail": "SelectStartPayload",
+          "bubbles": true,
+          "complexType": {
+            "original": "SelectStartPayload",
+            "resolved": "SelectStartPayload",
+            "references": {
+              "SelectStartPayload": {
+                "location": "local",
+                "path": "dist/components/arcgis-utility-network-trace-location/customElement.d.ts",
+                "id": "notImplemented"
+              }
+            }
+          },
+          "cancelable": true,
+          "composed": true,
+          "docs": "Fires when the user begins selection of a trace location.\nCan be prevented to stop the selection.",
+          "docsTags": [
+            {
+              "name": "experimental"
+            }
+          ]
         },
         {
           "event": "arcgisUtilityNetworkChange",
@@ -57431,6 +57553,32 @@
       "dependencies": [],
       "dependencyGraph": {},
       "props": [
+        {
+          "name": "beforeTraceLocationSelectStart",
+          "type": "((() => Promise<void>))",
+          "complexType": {
+            "original": "((() => Promise<void>))",
+            "resolved": "((() => Promise<void>))",
+            "references": {
+              "Promise": {
+                "location": "import",
+                "path": "typescript/lib/lib.es5.d.ts",
+                "id": "notImplemented"
+              }
+            }
+          },
+          "mutable": true,
+          "reflectToAttr": false,
+          "docs": "A function to run before trace location selection starts.",
+          "docsTags": [
+            {
+              "name": "experimental"
+            }
+          ],
+          "values": [],
+          "optional": true,
+          "required": false
+        },
         {
           "name": "filterLayers",
           "type": "Collection<Layer>",
@@ -57710,22 +57858,36 @@
           },
           "cancelable": true,
           "composed": true,
-          "docs": "",
-          "docsTags": []
+          "docs": "Fires when the user completes the selection of a trace location.",
+          "docsTags": [
+            {
+              "name": "experimental"
+            }
+          ]
         },
         {
           "event": "arcgisTraceLocationSelectStart",
-          "detail": "void",
+          "detail": "SelectStartPayload",
           "bubbles": true,
           "complexType": {
-            "original": "void",
-            "resolved": "void",
-            "references": {}
+            "original": "SelectStartPayload",
+            "resolved": "SelectStartPayload",
+            "references": {
+              "SelectStartPayload": {
+                "location": "local",
+                "path": "dist/components/arcgis-utility-network-trace-location/customElement.d.ts",
+                "id": "notImplemented"
+              }
+            }
           },
           "cancelable": true,
           "composed": true,
-          "docs": "",
-          "docsTags": []
+          "docs": "Fires when the user begins selection of a trace location.\nCan be prevented to stop the selection.",
+          "docsTags": [
+            {
+              "name": "experimental"
+            }
+          ]
         }
       ],
       "styles": [],

package/dist/docs/vscode.html-custom-data.json

@@ -8784,7 +8784,7 @@
     },
     {
       "name": "arcgis-utility-network-trace-analysis",
-      "description": "### Events\n- **arcgisPropertyChange**\n- **arcgisReady** - Emitted when the component associated with a map or scene view is ready to be interacted with.\n- **arcgisTraceLocationSelectStart** - Fires when the user begins selection of a trace location.\nCan be prevented to stop the selection.\n- **arcgisTraceResultFeaturesReady** - Fires when the trace result features are ready.\nCheck property `traceResultFeatures` for the trace result features.\n\n### Methods\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.\n- `destroy(): Promise<void>` - Permanently destroy the component.",
+      "description": "### Events\n- **arcgisPropertyChange**\n- **arcgisReady** - Emitted when the component associated with a map or scene view is ready to be interacted with.\n- **arcgisTraceLocationSelectEnd** - Fires when the user completes the selection of a trace location.\n- **arcgisTraceLocationSelectStart** - Fires when the user begins selection of a trace location.\nEvent payload contains a callback method `cancelSelect` to cancel a selection in progress.\nThe event can also be prevented with `event.preventDefault()` to stop the selection.\n- **arcgisTraceResultFeaturesReady** - Fires when the trace result features are ready.\nCheck property `traceResultFeatures` for the trace result features.\n\n### Methods\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.\n- `destroy(): Promise<void>` - Permanently destroy the component.",
       "attributes": [
         {
           "name": "allow-editing-disabled",
@@ -8859,7 +8859,7 @@
     },
     {
       "name": "arcgis-utility-network-trace-inputs",
-      "description": "This is a sub-component used by the **ArcgisUtilityNetworkTraceAnalysis** component.\n\nThis sub-component takes a map view as an input.\nIt allows users to select utility networks, trace configurations, and input features for tracing.\n--\n\n### Events\n- **arcgisPropertyChange**\n- **arcgisTraceInputsChange** - There will be more added to this event as we increase the functionality of this component\n- **arcgisTraceLocationSelectStart** - Notify consumers when the user begins selection of a trace location.\nThis has its own event because consumers may want to prevent interaction\nwith the map, e.g., Web Editor.\n- **arcgisUtilityNetworkChange** - This will be fired less often than above, only when the utility network changes\n\n### Methods\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.",
+      "description": "This is a sub-component used by the **ArcgisUtilityNetworkTraceAnalysis** component.\n\nThis sub-component takes a map view as an input.\nIt allows users to select utility networks, trace configurations, and input features for tracing.\n--\n\n### Events\n- **arcgisPropertyChange**\n- **arcgisTraceInputsChange** - There will be more added to this event as we increase the functionality of this component\n- **arcgisTraceLocationSelectEnd** - Fires when the user completes the selection of a trace location.\n- **arcgisTraceLocationSelectStart** - Fires when the user begins selection of a trace location.\nCan be prevented to stop the selection.\n- **arcgisUtilityNetworkChange** - This will be fired less often than above, only when the utility network changes\n\n### Methods\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.",
       "attributes": [
         {
           "name": "mode",
@@ -8886,7 +8886,7 @@
     },
     {
       "name": "arcgis-utility-network-trace-location",
-      "description": "This is a sub-component used by the **ArcgisUtilityNetworkTraceAnalysis** component.\n\nThis sub-component takes a map view as an input.\nIt allows users to select locations on the map to use as trace inputs.\n--\n\n### Events\n- **arcgisTraceLocationChange**\n- **arcgisTraceLocationSelectEnd**\n- **arcgisTraceLocationSelectStart**\n\n### Methods\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.",
+      "description": "This is a sub-component used by the **ArcgisUtilityNetworkTraceAnalysis** component.\n\nThis sub-component takes a map view as an input.\nIt allows users to select locations on the map to use as trace inputs.\n--\n\n### Events\n- **arcgisTraceLocationChange**\n- **arcgisTraceLocationSelectEnd** - Fires when the user completes the selection of a trace location.\n- **arcgisTraceLocationSelectStart** - Fires when the user begins selection of a trace location.\nCan be prevented to stop the selection.\n\n### Methods\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.",
       "attributes": [
         {
           "name": "spatial-tolerance",

package/dist/docs/web-types.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://raw.githubusercontent.com/JetBrains/web-types/master/schema/web-types.json",
   "name": "@arcgis/map-components",
-  "version": "5.0.0-next.92",
+  "version": "5.0.0-next.93",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -17854,7 +17854,7 @@
         },
         {
           "name": "arcgis-utility-network-trace-analysis",
-          "description": "### Events\n- **arcgisPropertyChange**\n- **arcgisReady** - Emitted when the component associated with a map or scene view is ready to be interacted with.\n- **arcgisTraceLocationSelectStart** - Fires when the user begins selection of a trace location.\nCan be prevented to stop the selection.\n- **arcgisTraceResultFeaturesReady** - Fires when the trace result features are ready.\nCheck property `traceResultFeatures` for the trace result features.\n\n### Methods\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.\n- `destroy(): Promise<void>` - Permanently destroy the component.",
+          "description": "### Events\n- **arcgisPropertyChange**\n- **arcgisReady** - Emitted when the component associated with a map or scene view is ready to be interacted with.\n- **arcgisTraceLocationSelectEnd** - Fires when the user completes the selection of a trace location.\n- **arcgisTraceLocationSelectStart** - Fires when the user begins selection of a trace location.\nEvent payload contains a callback method `cancelSelect` to cancel a selection in progress.\nThe event can also be prevented with `event.preventDefault()` to stop the selection.\n- **arcgisTraceResultFeaturesReady** - Fires when the trace result features are ready.\nCheck property `traceResultFeatures` for the trace result features.\n\n### Methods\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.\n- `destroy(): Promise<void>` - Permanently destroy the component.",
           "doc-url": "https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-utility-network-trace-analysis/",
           "attributes": [
             {
@@ -17928,9 +17928,14 @@
               "description": "Emitted when the component associated with a map or scene view is ready to be interacted with."
             },
             {
-              "name": "arcgisTraceLocationSelectStart",
+              "name": "arcgisTraceLocationSelectEnd",
               "type": "void",
-              "description": "Fires when the user begins selection of a trace location.\nCan be prevented to stop the selection."
+              "description": "Fires when the user completes the selection of a trace location."
+            },
+            {
+              "name": "arcgisTraceLocationSelectStart",
+              "type": "SelectStartPayload",
+              "description": "Fires when the user begins selection of a trace location.\nEvent payload contains a callback method `cancelSelect` to cancel a selection in progress.\nThe event can also be prevented with `event.preventDefault()` to stop the selection."
             },
             {
               "name": "arcgisTraceResultFeaturesReady",
@@ -17949,6 +17954,11 @@
                 "description": "If true, the component will not be destroyed automatically when it is\ndisconnected from the document. This is useful when you want to move the\ncomponent to a different place on the page, or temporarily hide it. If this\nis set, make sure to call the [destroy](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-utility-network-trace-analysis/#destroy) method when you are done to\nprevent memory leaks.",
                 "type": "boolean"
               },
+              {
+                "name": "beforeTraceLocationSelectStart",
+                "description": "A function to run before trace location selection starts.",
+                "type": "((() => Promise<void>))"
+              },
               {
                 "name": "closable",
                 "type": "boolean"
@@ -18001,9 +18011,14 @@
                 "description": "Emitted when the component associated with a map or scene view is ready to be interacted with."
               },
               {
-                "name": "arcgisTraceLocationSelectStart",
+                "name": "arcgisTraceLocationSelectEnd",
                 "type": "void",
-                "description": "Fires when the user begins selection of a trace location.\nCan be prevented to stop the selection."
+                "description": "Fires when the user completes the selection of a trace location."
+              },
+              {
+                "name": "arcgisTraceLocationSelectStart",
+                "type": "SelectStartPayload",
+                "description": "Fires when the user begins selection of a trace location.\nEvent payload contains a callback method `cancelSelect` to cancel a selection in progress.\nThe event can also be prevented with `event.preventDefault()` to stop the selection."
               },
               {
                 "name": "arcgisTraceResultFeaturesReady",
@@ -18031,7 +18046,7 @@
         },
         {
           "name": "arcgis-utility-network-trace-inputs",
-          "description": "This is a sub-component used by the **ArcgisUtilityNetworkTraceAnalysis** component.\n\nThis sub-component takes a map view as an input.\nIt allows users to select utility networks, trace configurations, and input features for tracing.\n--\n\n### Events\n- **arcgisPropertyChange**\n- **arcgisTraceInputsChange** - There will be more added to this event as we increase the functionality of this component\n- **arcgisTraceLocationSelectStart** - Notify consumers when the user begins selection of a trace location.\nThis has its own event because consumers may want to prevent interaction\nwith the map, e.g., Web Editor.\n- **arcgisUtilityNetworkChange** - This will be fired less often than above, only when the utility network changes\n\n### Methods\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.",
+          "description": "This is a sub-component used by the **ArcgisUtilityNetworkTraceAnalysis** component.\n\nThis sub-component takes a map view as an input.\nIt allows users to select utility networks, trace configurations, and input features for tracing.\n--\n\n### Events\n- **arcgisPropertyChange**\n- **arcgisTraceInputsChange** - There will be more added to this event as we increase the functionality of this component\n- **arcgisTraceLocationSelectEnd** - Fires when the user completes the selection of a trace location.\n- **arcgisTraceLocationSelectStart** - Fires when the user begins selection of a trace location.\nCan be prevented to stop the selection.\n- **arcgisUtilityNetworkChange** - This will be fired less often than above, only when the utility network changes\n\n### Methods\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.",
           "doc-url": "https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-utility-network-trace-inputs/",
           "attributes": [
             {
@@ -18062,9 +18077,14 @@
               "description": "There will be more added to this event as we increase the functionality of this component"
             },
             {
-              "name": "arcgisTraceLocationSelectStart",
+              "name": "arcgisTraceLocationSelectEnd",
               "type": "void",
-              "description": "Notify consumers when the user begins selection of a trace location.\nThis has its own event because consumers may want to prevent interaction\nwith the map, e.g., Web Editor."
+              "description": "Fires when the user completes the selection of a trace location."
+            },
+            {
+              "name": "arcgisTraceLocationSelectStart",
+              "type": "SelectStartPayload",
+              "description": "Fires when the user begins selection of a trace location.\nCan be prevented to stop the selection."
             },
             {
               "name": "arcgisUtilityNetworkChange",
@@ -18074,6 +18094,11 @@
           ],
           "js": {
             "properties": [
+              {
+                "name": "beforeTraceLocationSelectStart",
+                "description": "A function to run before trace location selection starts.",
+                "type": "((() => Promise<void>))"
+              },
               {
                 "name": "mode",
                 "type": "\"add-spatial\" | \"default\""
@@ -18115,9 +18140,14 @@
                 "description": "There will be more added to this event as we increase the functionality of this component"
               },
               {
-                "name": "arcgisTraceLocationSelectStart",
+                "name": "arcgisTraceLocationSelectEnd",
                 "type": "void",
-                "description": "Notify consumers when the user begins selection of a trace location.\nThis has its own event because consumers may want to prevent interaction\nwith the map, e.g., Web Editor."
+                "description": "Fires when the user completes the selection of a trace location."
+              },
+              {
+                "name": "arcgisTraceLocationSelectStart",
+                "type": "SelectStartPayload",
+                "description": "Fires when the user begins selection of a trace location.\nCan be prevented to stop the selection."
               },
               {
                 "name": "arcgisUtilityNetworkChange",
@@ -18129,7 +18159,7 @@
         },
         {
           "name": "arcgis-utility-network-trace-location",
-          "description": "This is a sub-component used by the **ArcgisUtilityNetworkTraceAnalysis** component.\n\nThis sub-component takes a map view as an input.\nIt allows users to select locations on the map to use as trace inputs.\n--\n\n### Events\n- **arcgisTraceLocationChange**\n- **arcgisTraceLocationSelectEnd**\n- **arcgisTraceLocationSelectStart**\n\n### Methods\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.",
+          "description": "This is a sub-component used by the **ArcgisUtilityNetworkTraceAnalysis** component.\n\nThis sub-component takes a map view as an input.\nIt allows users to select locations on the map to use as trace inputs.\n--\n\n### Events\n- **arcgisTraceLocationChange**\n- **arcgisTraceLocationSelectEnd** - Fires when the user completes the selection of a trace location.\n- **arcgisTraceLocationSelectStart** - Fires when the user begins selection of a trace location.\nCan be prevented to stop the selection.\n\n### Methods\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.",
           "doc-url": "https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-utility-network-trace-location/",
           "attributes": [
             {
@@ -18158,15 +18188,22 @@
             },
             {
               "name": "arcgisTraceLocationSelectEnd",
-              "type": "void"
+              "type": "void",
+              "description": "Fires when the user completes the selection of a trace location."
             },
             {
               "name": "arcgisTraceLocationSelectStart",
-              "type": "void"
+              "type": "SelectStartPayload",
+              "description": "Fires when the user begins selection of a trace location.\nCan be prevented to stop the selection."
             }
           ],
           "js": {
             "properties": [
+              {
+                "name": "beforeTraceLocationSelectStart",
+                "description": "A function to run before trace location selection starts.",
+                "type": "((() => Promise<void>))"
+              },
               {
                 "name": "filterLayers",
                 "type": "Collection<Layer>"
@@ -18207,11 +18244,13 @@
               },
               {
                 "name": "arcgisTraceLocationSelectEnd",
-                "type": "void"
+                "type": "void",
+                "description": "Fires when the user completes the selection of a trace location."
               },
               {
                 "name": "arcgisTraceLocationSelectStart",
-                "type": "void"
+                "type": "SelectStartPayload",
+                "description": "Fires when the user begins selection of a trace location.\nCan be prevented to stop the selection."
               }
             ]
           }

package/dist/index.d.ts

@@ -1403,6 +1403,7 @@ declare global {
   interface HTMLArcgisUtilityNetworkTraceAnalysisElementEventMap {
     "arcgisPropertyChange": ArcgisUtilityNetworkTraceAnalysis["arcgisPropertyChange"]["detail"];
     "arcgisReady": ArcgisUtilityNetworkTraceAnalysis["arcgisReady"]["detail"];
+    "arcgisTraceLocationSelectEnd": ArcgisUtilityNetworkTraceAnalysis["arcgisTraceLocationSelectEnd"]["detail"];
     "arcgisTraceLocationSelectStart": ArcgisUtilityNetworkTraceAnalysis["arcgisTraceLocationSelectStart"]["detail"];
     "arcgisTraceResultFeaturesReady": ArcgisUtilityNetworkTraceAnalysis["arcgisTraceResultFeaturesReady"]["detail"];
   }
@@ -1421,6 +1422,7 @@ declare global {
   interface HTMLArcgisUtilityNetworkTraceInputsElementEventMap {
     "arcgisPropertyChange": ArcgisUtilityNetworkTraceInputs["arcgisPropertyChange"]["detail"];
     "arcgisTraceInputsChange": ArcgisUtilityNetworkTraceInputs["arcgisTraceInputsChange"]["detail"];
+    "arcgisTraceLocationSelectEnd": ArcgisUtilityNetworkTraceInputs["arcgisTraceLocationSelectEnd"]["detail"];
     "arcgisTraceLocationSelectStart": ArcgisUtilityNetworkTraceInputs["arcgisTraceLocationSelectStart"]["detail"];
     "arcgisUtilityNetworkChange": ArcgisUtilityNetworkTraceInputs["arcgisUtilityNetworkChange"]["detail"];
   }

package/dist/index.js

@@ -1,7 +1,7 @@
 import { s, g as t } from "./chunks/runtime.js";
 /*! 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.92 */
+v5.0.0-next.93 */
 const a = s, A = t;
 export {
   A as getArcgisAssetPath,

package/dist/loader.js

@@ -2,7 +2,7 @@ import { r as e } from "./chunks/runtime.js";
 import { makeDefineCustomElements as t } from "@arcgis/lumina";
 /*! 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.92 */
+v5.0.0-next.93 */
 const o = t(e, {
   "arcgis-area-measurement-2d": [() => import("./components/arcgis-area-measurement-2d/customElement.js"), "analysis:,autoDestroyDisabled,icon:,label,position,referenceElement,state,unit,unitOptions:,view:;clear,destroy,start"],
   "arcgis-area-measurement-3d": [() => import("./components/arcgis-area-measurement-3d/customElement.js"), "analysis:,autoDestroyDisabled,icon:,label,position,referenceElement,state,unit,unitOptions:,view:;clear,destroy,start"],
@@ -115,10 +115,10 @@ const o = t(e, {
   "arcgis-unit-select": [() => import("./components/arcgis-unit-select/customElement.js"), "label,messageOverrides:,options,selectLabel,value:;destroy"],
   "arcgis-utility-network-associations": [() => import("./components/arcgis-utility-network-associations/customElement.js"), "autoDestroyDisabled,autoRefreshAssociationsDisabled,connectivityAssociationsLineSymbol:,hideConnectivityAssociationsSettingsColorPicker,hideConnectivityAssociationsSettingsStylePicker,hideConnectivityAssociationsSettingsWidthInput,hideStructuralAttachmentAssociationsSettingsColorPicker,hideStructuralAttachmentAssociationsSettingsStylePicker,hideStructuralAttachmentAssociationsSettingsWidthInput,icon:,includeConnectivityAssociationsDisabled,includeStructuralAttachmentAssociationsDisabled,label,maxAllowableAssociations,maxAllowableAssociationsSliderMax,maxAllowableAssociationsSliderMin,maxAllowableAssociationsSliderStep,position,referenceElement,showArrowsConnectivity,showArrowsStructuralAttachment,showAssociationsEnabled,showConnectivityAssociationsSettingsArrowsToggle,showConnectivityAssociationsSettingsCapSelect,showMaxAllowableAssociationsSlider,showStructuralAttachmentAssociationsSettingsArrowsToggle,showStructuralAttachmentAssociationsSettingsCapSelect,structuralAttachmentAssociationsLineSymbol:,utilityNetwork:,view:,visibleElementsConnectivityAssociationsSettingsArrowsToggle,visibleElementsConnectivityAssociationsSettingsCapSelect,visibleElementsConnectivityAssociationsSettingsColorPicker,visibleElementsConnectivityAssociationsSettingsStylePicker,visibleElementsConnectivityAssociationsSettingsWidthInput,visibleElementsMaxAllowableAssociationsSlider,visibleElementsStructuralAttachmentAssociationsSettingsArrowsToggle,visibleElementsStructuralAttachmentAssociationsSettingsCapSelect,visibleElementsStructuralAttachmentAssociationsSettingsColorPicker,visibleElementsStructuralAttachmentAssociationsSettingsStylePicker,visibleElementsStructuralAttachmentAssociationsSettingsWidthInput;destroy"],
   "arcgis-utility-network-trace": [() => import("./components/arcgis-utility-network-trace/customElement.js"), "autoDestroyDisabled,defaultGraphicColor:,disabled,enableResultArea,flags:,icon:,inputSettings:,label,position,referenceElement,resultAreaProperties:,selectedTraces:,selectOnCompleteDisabled,showGraphicsOnCompleteDisabled,showSelectionAttributesDisabled,state,traceResults:,view:;checkCanTrace,confirmReset,destroy"],
-  "arcgis-utility-network-trace-analysis": [() => import("./components/arcgis-utility-network-trace-analysis/customElement.js"), "allowEditingDisabled,autoDestroyDisabled,closable,icon,label,messageOverrides:,mode,referenceElement,state,traceResultFeatures:,view:;destroy"],
+  "arcgis-utility-network-trace-analysis": [() => import("./components/arcgis-utility-network-trace-analysis/customElement.js"), "allowEditingDisabled,autoDestroyDisabled,beforeTraceLocationSelectStart:,closable,icon,label,messageOverrides:,mode,referenceElement,state,traceResultFeatures:,view:;destroy"],
   "arcgis-utility-network-subnetwork-info": [() => import("./components/arcgis-utility-network-subnetwork-info/customElement.js"), "namedTraceConfig:"],
-  "arcgis-utility-network-trace-inputs": [() => import("./components/arcgis-utility-network-trace-inputs/customElement.js"), "mode,referenceElement,selectedNamedTraceConfiguration:,selectedUtilityNetwork:,traceLocations:,unTraceConfiguration:,view:"],
-  "arcgis-utility-network-trace-location": [() => import("./components/arcgis-utility-network-trace-location/customElement.js"), "filterLayers:,flagLayer:,sketchViewModel:,spatialTolerance,traceLocations:,traceLocationType,utilityNetwork:,view:"],
+  "arcgis-utility-network-trace-inputs": [() => import("./components/arcgis-utility-network-trace-inputs/customElement.js"), "beforeTraceLocationSelectStart:,mode,referenceElement,selectedNamedTraceConfiguration:,selectedUtilityNetwork:,traceLocations:,unTraceConfiguration:,view:"],
+  "arcgis-utility-network-trace-location": [() => import("./components/arcgis-utility-network-trace-location/customElement.js"), "beforeTraceLocationSelectStart:,filterLayers:,flagLayer:,sketchViewModel:,spatialTolerance,traceLocations:,traceLocationType,utilityNetwork:,view:"],
   "arcgis-utility-network-trace-location-list": [() => import("./components/arcgis-utility-network-trace-location-list/customElement.js"), "traceLocations:,traceLocationType"],
   "arcgis-utility-network-trace-results": [() => import("./components/arcgis-utility-network-trace-results/customElement.js"), "featuresFromSelectedLayer:,isElementsSelected,layers:,messageOverrides:,referenceElement,selectedFeature:,selectedLayer:,state,traceConfigTitle,traceResult:,traceResultFeatures:,utilityNetwork:,view:"],
   "arcgis-utility-network-validate-topology": [() => import("./components/arcgis-utility-network-validate-topology/customElement.js"), "autoDestroyDisabled,extentToValidate,icon:,label,position,referenceElement,state,utilityNetwork:,view:;destroy"],

package/dist/types/lumina.d.ts

@@ -514,9 +514,10 @@ interface LuminaArcgisUtilityNetworkTrace extends Partial<Pick<ArcgisUtilityNetw
 }
 type ArcgisUtilityNetworkTraceSetterTypes = ArcgisUtilityNetworkTrace["_setterTypes"]
 
-interface LuminaArcgisUtilityNetworkTraceAnalysis extends Partial<Pick<ArcgisUtilityNetworkTraceAnalysis, 'allowEditingDisabled' | 'autoDestroyDisabled' | 'closable' | 'icon' | 'label' | 'messageOverrides' | 'mode' | 'referenceElement' | 'view'>>, h.JSX.HTMLAttributes<HTMLArcgisUtilityNetworkTraceAnalysisElement> {
+interface LuminaArcgisUtilityNetworkTraceAnalysis extends Partial<Pick<ArcgisUtilityNetworkTraceAnalysis, 'allowEditingDisabled' | 'autoDestroyDisabled' | 'beforeTraceLocationSelectStart' | 'closable' | 'icon' | 'label' | 'messageOverrides' | 'mode' | 'referenceElement' | 'view'>>, h.JSX.HTMLAttributes<HTMLArcgisUtilityNetworkTraceAnalysisElement> {
   onarcgisPropertyChange?: EventHandler<HTMLArcgisUtilityNetworkTraceAnalysisElement["arcgisPropertyChange"]>;
   onarcgisReady?: EventHandler<HTMLArcgisUtilityNetworkTraceAnalysisElement["arcgisReady"]>;
+  onarcgisTraceLocationSelectEnd?: EventHandler<HTMLArcgisUtilityNetworkTraceAnalysisElement["arcgisTraceLocationSelectEnd"]>;
   onarcgisTraceLocationSelectStart?: EventHandler<HTMLArcgisUtilityNetworkTraceAnalysisElement["arcgisTraceLocationSelectStart"]>;
   onarcgisTraceResultFeaturesReady?: EventHandler<HTMLArcgisUtilityNetworkTraceAnalysisElement["arcgisTraceResultFeaturesReady"]>;
 }
@@ -524,14 +525,15 @@ interface LuminaArcgisUtilityNetworkTraceAnalysis extends Partial<Pick<ArcgisUti
 interface LuminaArcgisUtilityNetworkSubnetworkInfo extends Required<Pick<ArcgisUtilityNetworkSubnetworkInfo, 'namedTraceConfig'>>, h.JSX.HTMLAttributes<HTMLArcgisUtilityNetworkSubnetworkInfoElement> {
 }
 
-interface LuminaArcgisUtilityNetworkTraceInputs extends Required<Pick<ArcgisUtilityNetworkTraceInputs, 'view'>>, Partial<Pick<ArcgisUtilityNetworkTraceInputs, 'mode' | 'referenceElement' | 'selectedNamedTraceConfiguration' | 'selectedUtilityNetwork'>>, h.JSX.HTMLAttributes<HTMLArcgisUtilityNetworkTraceInputsElement> {
+interface LuminaArcgisUtilityNetworkTraceInputs extends Required<Pick<ArcgisUtilityNetworkTraceInputs, 'view'>>, Partial<Pick<ArcgisUtilityNetworkTraceInputs, 'beforeTraceLocationSelectStart' | 'mode' | 'referenceElement' | 'selectedNamedTraceConfiguration' | 'selectedUtilityNetwork'>>, h.JSX.HTMLAttributes<HTMLArcgisUtilityNetworkTraceInputsElement> {
   onarcgisPropertyChange?: EventHandler<HTMLArcgisUtilityNetworkTraceInputsElement["arcgisPropertyChange"]>;
   onarcgisTraceInputsChange?: EventHandler<HTMLArcgisUtilityNetworkTraceInputsElement["arcgisTraceInputsChange"]>;
+  onarcgisTraceLocationSelectEnd?: EventHandler<HTMLArcgisUtilityNetworkTraceInputsElement["arcgisTraceLocationSelectEnd"]>;
   onarcgisTraceLocationSelectStart?: EventHandler<HTMLArcgisUtilityNetworkTraceInputsElement["arcgisTraceLocationSelectStart"]>;
   onarcgisUtilityNetworkChange?: EventHandler<HTMLArcgisUtilityNetworkTraceInputsElement["arcgisUtilityNetworkChange"]>;
 }
 
-interface LuminaArcgisUtilityNetworkTraceLocation extends Required<Pick<ArcgisUtilityNetworkTraceLocation, 'utilityNetwork' | 'view'>>, Partial<Pick<ArcgisUtilityNetworkTraceLocation, 'filterLayers' | 'flagLayer' | 'sketchViewModel' | 'spatialTolerance' | 'traceLocations' | 'traceLocationType'>>, h.JSX.HTMLAttributes<HTMLArcgisUtilityNetworkTraceLocationElement> {
+interface LuminaArcgisUtilityNetworkTraceLocation extends Required<Pick<ArcgisUtilityNetworkTraceLocation, 'utilityNetwork' | 'view'>>, Partial<Pick<ArcgisUtilityNetworkTraceLocation, 'beforeTraceLocationSelectStart' | 'filterLayers' | 'flagLayer' | 'sketchViewModel' | 'spatialTolerance' | 'traceLocations' | 'traceLocationType'>>, h.JSX.HTMLAttributes<HTMLArcgisUtilityNetworkTraceLocationElement> {
   onarcgisTraceLocationChange?: EventHandler<HTMLArcgisUtilityNetworkTraceLocationElement["arcgisTraceLocationChange"]>;
   onarcgisTraceLocationSelectEnd?: EventHandler<HTMLArcgisUtilityNetworkTraceLocationElement["arcgisTraceLocationSelectEnd"]>;
   onarcgisTraceLocationSelectStart?: EventHandler<HTMLArcgisUtilityNetworkTraceLocationElement["arcgisTraceLocationSelectStart"]>;

package/dist/types/preact.d.ts

@@ -515,9 +515,10 @@ interface PreactArcgisUtilityNetworkTrace extends Partial<Pick<ArcgisUtilityNetw
 }
 type ArcgisUtilityNetworkTraceSetterTypes = ArcgisUtilityNetworkTrace["_setterTypes"]
 
-interface PreactArcgisUtilityNetworkTraceAnalysis extends Partial<Pick<ArcgisUtilityNetworkTraceAnalysis, 'allowEditingDisabled' | 'autoDestroyDisabled' | 'closable' | 'icon' | 'label' | 'messageOverrides' | 'mode' | 'referenceElement' | 'view'>>, HTMLAttributes<HTMLArcgisUtilityNetworkTraceAnalysisElement> {
+interface PreactArcgisUtilityNetworkTraceAnalysis extends Partial<Pick<ArcgisUtilityNetworkTraceAnalysis, 'allowEditingDisabled' | 'autoDestroyDisabled' | 'beforeTraceLocationSelectStart' | 'closable' | 'icon' | 'label' | 'messageOverrides' | 'mode' | 'referenceElement' | 'view'>>, HTMLAttributes<HTMLArcgisUtilityNetworkTraceAnalysisElement> {
   onarcgisPropertyChange?: EventHandler<HTMLArcgisUtilityNetworkTraceAnalysisElement["arcgisPropertyChange"]>;
   onarcgisReady?: EventHandler<HTMLArcgisUtilityNetworkTraceAnalysisElement["arcgisReady"]>;
+  onarcgisTraceLocationSelectEnd?: EventHandler<HTMLArcgisUtilityNetworkTraceAnalysisElement["arcgisTraceLocationSelectEnd"]>;
   onarcgisTraceLocationSelectStart?: EventHandler<HTMLArcgisUtilityNetworkTraceAnalysisElement["arcgisTraceLocationSelectStart"]>;
   onarcgisTraceResultFeaturesReady?: EventHandler<HTMLArcgisUtilityNetworkTraceAnalysisElement["arcgisTraceResultFeaturesReady"]>;
 }
@@ -525,14 +526,15 @@ interface PreactArcgisUtilityNetworkTraceAnalysis extends Partial<Pick<ArcgisUti
 interface PreactArcgisUtilityNetworkSubnetworkInfo extends Required<Pick<ArcgisUtilityNetworkSubnetworkInfo, 'namedTraceConfig'>>, HTMLAttributes<HTMLArcgisUtilityNetworkSubnetworkInfoElement> {
 }
 
-interface PreactArcgisUtilityNetworkTraceInputs extends Required<Pick<ArcgisUtilityNetworkTraceInputs, 'view'>>, Partial<Pick<ArcgisUtilityNetworkTraceInputs, 'mode' | 'referenceElement' | 'selectedNamedTraceConfiguration' | 'selectedUtilityNetwork'>>, HTMLAttributes<HTMLArcgisUtilityNetworkTraceInputsElement> {
+interface PreactArcgisUtilityNetworkTraceInputs extends Required<Pick<ArcgisUtilityNetworkTraceInputs, 'view'>>, Partial<Pick<ArcgisUtilityNetworkTraceInputs, 'beforeTraceLocationSelectStart' | 'mode' | 'referenceElement' | 'selectedNamedTraceConfiguration' | 'selectedUtilityNetwork'>>, HTMLAttributes<HTMLArcgisUtilityNetworkTraceInputsElement> {
   onarcgisPropertyChange?: EventHandler<HTMLArcgisUtilityNetworkTraceInputsElement["arcgisPropertyChange"]>;
   onarcgisTraceInputsChange?: EventHandler<HTMLArcgisUtilityNetworkTraceInputsElement["arcgisTraceInputsChange"]>;
+  onarcgisTraceLocationSelectEnd?: EventHandler<HTMLArcgisUtilityNetworkTraceInputsElement["arcgisTraceLocationSelectEnd"]>;
   onarcgisTraceLocationSelectStart?: EventHandler<HTMLArcgisUtilityNetworkTraceInputsElement["arcgisTraceLocationSelectStart"]>;
   onarcgisUtilityNetworkChange?: EventHandler<HTMLArcgisUtilityNetworkTraceInputsElement["arcgisUtilityNetworkChange"]>;
 }
 
-interface PreactArcgisUtilityNetworkTraceLocation extends Required<Pick<ArcgisUtilityNetworkTraceLocation, 'utilityNetwork' | 'view'>>, Partial<Pick<ArcgisUtilityNetworkTraceLocation, 'filterLayers' | 'flagLayer' | 'sketchViewModel' | 'spatialTolerance' | 'traceLocations' | 'traceLocationType'>>, HTMLAttributes<HTMLArcgisUtilityNetworkTraceLocationElement> {
+interface PreactArcgisUtilityNetworkTraceLocation extends Required<Pick<ArcgisUtilityNetworkTraceLocation, 'utilityNetwork' | 'view'>>, Partial<Pick<ArcgisUtilityNetworkTraceLocation, 'beforeTraceLocationSelectStart' | 'filterLayers' | 'flagLayer' | 'sketchViewModel' | 'spatialTolerance' | 'traceLocations' | 'traceLocationType'>>, HTMLAttributes<HTMLArcgisUtilityNetworkTraceLocationElement> {
   onarcgisTraceLocationChange?: EventHandler<HTMLArcgisUtilityNetworkTraceLocationElement["arcgisTraceLocationChange"]>;
   onarcgisTraceLocationSelectEnd?: EventHandler<HTMLArcgisUtilityNetworkTraceLocationElement["arcgisTraceLocationSelectEnd"]>;
   onarcgisTraceLocationSelectStart?: EventHandler<HTMLArcgisUtilityNetworkTraceLocationElement["arcgisTraceLocationSelectStart"]>;