npm - @arcgis/map-components - Versions diffs - 5.2.0-next.111 → 5.2.0-next.112 - Mend

@arcgis/map-components 5.2.0-next.111 → 5.2.0-next.112

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (685) hide show

package/dist/components/arcgis-search/customElement.d.ts CHANGED Viewed

@@ -9,7 +9,7 @@ import type Portal from "@arcgis/core/portal/Portal.js";
 import type { SearchViewModelEvents, SearchViewModelSelectResultEvent, SearchViewModelState } from "@arcgis/core/widgets/Search/SearchViewModel.js";
 import type { ArcgisReferenceElement, IconName } from "../types.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
-import type { SuggestResult, SuggestResults, SearchResponse, SuggestResponse, SupportedSearchSource, SourcesHandler, SearchResults, SearchResult } from "@arcgis/core/widgets/Search/types.js";
+import type { SuggestResult, SuggestResults, SourcesHandler, SearchResponse, SuggestResponse, SupportedSearchSource, SearchResults, SearchResult } from "@arcgis/core/widgets/Search/types.js";
 import type { ActiveMenu } from "./types.js";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
 import type { MapViewOrSceneView } from "@arcgis/core/views/MapViewOrSceneView.js";
@@ -22,7 +22,8 @@ import type { GoToOverride } from "@arcgis/core/widgets/support/types.js";
  *
  * By default, the Search component uses the ArcGIS World Geocoding Service via this URL: `https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer`.
  * If a global apiKey is present, the Search component uses this URL: `https://geocode-api.arcgis.com/arcgis/rest/services/World/GeocodeServer`. If an apiKey
- * is present on the LocatorSearchSource, then the Search component uses the URL defined by the LocatorSearchSource.url property.
+ * is present on the LocatorSearchSource, then the Search component uses the URL defined by the LocatorSearchSource.url property. See the
+ * [Authentication and access tokens](https://developers.arcgis.com/javascript/latest/authentication/access-tokens/) guide to learn more.
  *
  * For popups, we recommend using either [popup-component-enabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#popupComponentEnabled),
  * or adding the [arcgis-popup](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/) to your view components as a best practice.
@@ -39,6 +40,7 @@ import type { GoToOverride } from "@arcgis/core/widgets/support/types.js";
  *
  * @see [Sample - Search component with multiple sources](https://developers.arcgis.com/javascript/latest/sample-code/search-component-multisource/)
  * @see [Sample - Search component with custom source](https://developers.arcgis.com/javascript/latest/sample-code/search-component-customsource/)
+ * @see [Authentication and access tokens](https://developers.arcgis.com/javascript/latest/authentication/access-tokens/)
  * @since 4.28
  */
 export abstract class ArcgisSearch extends LitElement {
@@ -168,10 +170,11 @@ export abstract class ArcgisSearch extends LitElement {
   accessor icon: IconName;
   /**
    * When `true`, will not include [defaultSources](https://developers.arcgis.com/javascript/latest/references/core/widgets/Search/SearchViewModel/#defaultSources) in the Search UI.
+   * This can be a boolean value or a function that returns a collection of Search sources.
    *
    * @default false
    */
-  accessor includeDefaultSourcesDisabled: boolean | SourcesHandler;
+  accessor includeDefaultSourcesDisabled: SourcesHandler | boolean;
   /** The component's default label. */
   accessor label: string | undefined;
   /**
@@ -356,10 +359,14 @@ export abstract class ArcgisSearch extends LitElement {
    *
    * @example
    * // Default sources[] when sources is not specified
-   * [
+   * const search = document.querySelector("arcgis-search");
+   * await search.componentOnReady();
+   * // set the search sources once the component is ready
+   * search.sources = [
    *   {
    *     url: "https://geocode-api.arcgis.com/arcgis/rest/services/World/GeocodeServer",
    *     singleLineFieldName: "SingleLine",
+   *     apiKey: "YOUR_ACCESS_TOKEN",
    *     outFields: ["Addr_type"],
    *     name: "ArcGIS World Geocoding Service",
    *     placeholder: "Adresse",
@@ -370,60 +377,58 @@ export abstract class ArcgisSearch extends LitElement {
    *        width: 24,
    *        height: 24,
    *        xoffset: 0,
-   *        yoffset: 0
+   *        yoffset: 0,
    *    }
    *   }
-   * ]
+   * ];
    * @example
    * // Example of multiple sources[]
-   * let sources = [
-   * {
-   *   url: "https://geocode-api.arcgis.com/arcgis/rest/services/World/GeocodeServer",
-   *   singleLineFieldName: "SingleLine",
-   *   name: "Custom Geocoding Service",
-   *   placeholder: "Search Geocoder",
-   *   maxResults: 3,
-   *   maxSuggestions: 6,
-   *   suggestionsEnabled: false,
-   *   minSuggestCharacters: 0
-   * }, {
-   *   layer: new FeatureLayer({
-   *     url: "https://services.arcgis.com/DO4gTjwJVIJ7O9Ca/arcgis/rest/services/GeoForm_Survey_v11_live/FeatureServer/0",
-   *     outFields: ["*"]
-   *   }),
-   *   searchFields: ["Email", "URL"],
-   *   displayField: "Email",
-   *   exactMatch: false,
-   *   outFields: ["*"],
-   *   name: "Point FS",
-   *   placeholder: "example: esri",
-   *   maxResults: 6,
-   *   maxSuggestions: 6,
-   *   suggestionsEnabled: true,
-   *   minSuggestCharacters: 0
-   * },
-   * {
-   *   layer: new FeatureLayer({
-   *     outFields: ["*"]
-   *   });
-   *   placeholder: "esri",
-   *   name: "A FeatureLayer",
-   *   prefix: "",
-   *   suffix: "",
-   *   maxResults: 1,
-   *   maxSuggestions: 6,
-   *   exactMatch: false,
-   *   searchFields: [], // defaults to FeatureLayer.displayField
-   *   displayField: "", // defaults to FeatureLayer.displayField
-   *   minSuggestCharacters: 0
-   * }
+   * const search = document.querySelector("arcgis-search");
+   * await search.componentOnReady();
+   * // set the search sources once the component is ready
+   * search.sources = [
+   *   {
+   *     url: "https://geocode-api.arcgis.com/arcgis/rest/services/World/GeocodeServer",
+   *     singleLineFieldName: "SingleLine",
+   *     apiKey: "YOUR_ACCESS_TOKEN",
+   *     name: "Custom Geocoding Service",
+   *     placeholder: "Search Geocoder",
+   *     maxResults: 3,
+   *     maxSuggestions: 6,
+   *     suggestionsEnabled: false,
+   *     minSuggestCharacters: 0,
+   *   }, {
+   *     layer: new FeatureLayer({
+   *       url: "https://services.arcgis.com/DO4gTjwJVIJ7O9Ca/arcgis/rest/services/GeoForm_Survey_v11_live/FeatureServer/0",
+   *       outFields: ["*"]
+   *     }),
+   *     searchFields: ["Email", "URL"],
+   *     displayField: "Email",
+   *     exactMatch: false,
+   *     outFields: ["*"],
+   *     name: "Point FS",
+   *     placeholder: "example: Esri",
+   *     maxResults: 6,
+   *     maxSuggestions: 6,
+   *     suggestionsEnabled: true,
+   *     minSuggestCharacters: 0,
+   *   },
+   *   {
+   *     layer: new FeatureLayer({
+   *       outFields: ["*"]
+   *     }),
+   *     placeholder: "esri",
+   *     name: "A FeatureLayer",
+   *     prefix: "",
+   *     suffix: "",
+   *     maxResults: 1,
+   *     maxSuggestions: 6,
+   *     exactMatch: false,
+   *     searchFields: [],
+   *     displayField: "", // defaults to FeatureLayer.displayField
+   *     minSuggestCharacters: 0,
+   *   }
    * ];
-   * @example
-   * let sources = [{ ... }, { ... }, { ... }]; // array of sources
-   * searchViewModel.sources = sources;
-   *
-   * // Add to source(s)
-   * searchViewModel.sources.push({ ... });  // new source
    */
   accessor sources: Collection<SupportedSearchSource>;
   /**

package/dist/components/arcgis-search/customElement.js CHANGED Viewed

@@ -10,9 +10,9 @@ import { classes as y } from "@arcgis/toolkit/dom";
 import { g as C } from "../../chunks/globalCss.js";
 import { isAbortError as $ } from "@arcgis/core/core/promiseUtils.js";
 import { m as R } from "../../chunks/useViewModel.js";
-import { s as k } from "../../chunks/sr.js";
+import { s as D } from "../../chunks/sr.js";
 import { substitute as g } from "@arcgis/core/intl.js";
-import { usePropertyChange as D } from "@arcgis/lumina/controllers";
+import { usePropertyChange as k } from "@arcgis/lumina/controllers";
 import { u as E } from "../../chunks/useT9n.js";
 import { watch as u, on as T } from "@arcgis/core/core/reactiveUtils.js";
 const A = _`.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{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__heading{word-break:break-word}.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}:host{width:240px}.root{--arcgis-internal-search-width: 240px;display:flex;flex-flow:row nowrap;align-items:center;justify-content:center;width:100%}.dropdown{--calcite-color-border-1: var(--calcite-color-border-input);--calcite-dropdown-width: var(--arcgis-internal-search-width);width:31px}.dropdown calcite-button{--calcite-offset-invert-focus: 1}.autocomplete{flex:1}.container{display:flex;position:relative;flex:1 0 100%;flex-flow:row nowrap;align-items:stretch}.form{display:flex;flex:1 0;flex-flow:row nowrap;align-items:stretch;margin:0;padding:0}.submit-button{position:absolute;margin:-1px;border-width:0;padding:0;width:1px;height:1px;overflow:hidden;white-space:nowrap;clip:rect(0,0,0,0)}`, L = R(w);
@@ -24,13 +24,13 @@ class z extends f {
     super(...arguments), this.viewModel = L(this), this._currentLocationValue = "search-use-current-location", this._autocompleteEl = void 0, this._searchResultRendererEl = void 0, this._searchResultRendererContentEl = void 0, this._suggestController = void 0, this._searchController = void 0, this._lastSearchTerm = "", this._handleSelectResult = (e) => {
       const { name: t } = e.detail.result;
       this._selectedMessage = g(this.messages.resultSelected, { resultName: t });
-    }, this.messages = E({ blocking: !0 }), this._locateFailed = !1, this._showNoResults = !1, this.view = this.viewModel.view, this.goToOverride = this.viewModel.goToOverride, this.icon = "search", this.hideSourcesMenu = !1, this.activeMenu = "none", this.activeSourceIndex = this.viewModel.activeSourceIndex, this.allPlaceholder = this.viewModel.allPlaceholder, this.allSources = this.viewModel.allSources, this.autoNavigateDisabled = this.viewModel.autoNavigate, this.autoSelectDisabled = this.viewModel.autoSelect, this.defaultSources = this.viewModel.defaultSources, this.disabled = !1, this.includeDefaultSourcesDisabled = this.viewModel.includeDefaultSources, this.locationDisabled = this.viewModel.locationEnabled, this.maxResults = this.viewModel.maxResults, this.maxSuggestions = this.viewModel.maxSuggestions, this.minSuggestCharacters = this.viewModel.minSuggestCharacters, this.popupDisabled = this.viewModel.popupEnabled, this.popupTemplate = this.viewModel.popupTemplate, this.portal = this.viewModel.portal, this.resultGraphic = this.viewModel.resultGraphic, this.resultGraphicDisabled = this.viewModel.resultGraphicEnabled, this.results = this.viewModel.results, this.searchAllDisabled = this.viewModel.searchAllEnabled, this.searchTerm = this.viewModel.searchTerm, this.selectedResult = this.viewModel.selectedResult, this.sources = this.viewModel.sources, this.suggestions = this.viewModel.suggestions, this.suggestionsDisabled = this.viewModel.suggestionsEnabled, this.topLayerDisabled = !1, this.autoDestroyDisabled = !1, this.state = this.viewModel.state, this.arcgisPropertyChange = D()("state"), this.arcgisReady = b(), this.arcgisSearchClear = a(() => this.viewModel, "search-clear"), this.arcgisSearchComplete = a(() => this.viewModel, "search-complete"), this.arcgisSearchStart = a(() => this.viewModel, "search-start"), this.arcgisSelectResult = a(() => this.viewModel, "select-result"), this.arcgisSuggestComplete = a(() => this.viewModel, "suggest-complete"), this.arcgisSuggestStart = a(() => this.viewModel, "suggest-start");
+    }, this.messages = E({ blocking: !0 }), this._locateFailed = !1, this._showNoResults = !1, this.view = this.viewModel.view, this.goToOverride = this.viewModel.goToOverride, this.icon = "search", this.hideSourcesMenu = !1, this.activeMenu = "none", this.activeSourceIndex = this.viewModel.activeSourceIndex, this.allPlaceholder = this.viewModel.allPlaceholder, this.allSources = this.viewModel.allSources, this.autoNavigateDisabled = this.viewModel.autoNavigate, this.autoSelectDisabled = this.viewModel.autoSelect, this.defaultSources = this.viewModel.defaultSources, this.disabled = !1, this.locationDisabled = this.viewModel.locationEnabled, this.maxResults = this.viewModel.maxResults, this.maxSuggestions = this.viewModel.maxSuggestions, this.minSuggestCharacters = this.viewModel.minSuggestCharacters, this.popupDisabled = this.viewModel.popupEnabled, this.popupTemplate = this.viewModel.popupTemplate, this.portal = this.viewModel.portal, this.resultGraphic = this.viewModel.resultGraphic, this.resultGraphicDisabled = this.viewModel.resultGraphicEnabled, this.results = this.viewModel.results, this.searchAllDisabled = this.viewModel.searchAllEnabled, this.searchTerm = this.viewModel.searchTerm, this.selectedResult = this.viewModel.selectedResult, this.sources = this.viewModel.sources, this.suggestions = this.viewModel.suggestions, this.suggestionsDisabled = this.viewModel.suggestionsEnabled, this.topLayerDisabled = !1, this.autoDestroyDisabled = !1, this.state = this.viewModel.state, this.arcgisPropertyChange = k()("state"), this.arcgisReady = b(), this.arcgisSearchClear = a(() => this.viewModel, "search-clear"), this.arcgisSearchComplete = a(() => this.viewModel, "search-complete"), this.arcgisSearchStart = a(() => this.viewModel, "search-start"), this.arcgisSelectResult = a(() => this.viewModel, "select-result"), this.arcgisSuggestComplete = a(() => this.viewModel, "suggest-complete"), this.arcgisSuggestStart = a(() => this.viewModel, "suggest-start");
   }
   static {
     this.properties = { _selectedMessage: 16, messages: 16, _locateFailed: 16, _showNoResults: 16, _isDisabled: 16, _showCurrentLocation: 16, _effectiveActiveMenu: 16, view: 0, referenceElement: 1, goToOverride: 0, icon: 1, hideSourcesMenu: 5, activeMenu: 1, activeSource: 32, activeSourceIndex: 9, allPlaceholder: 1, allSources: 0, autoNavigateDisabled: 5, autoSelectDisabled: 5, defaultSources: 0, disabled: 5, includeDefaultSourcesDisabled: 5, locationDisabled: 5, maxResults: 9, maxSuggestions: 9, minSuggestCharacters: 9, popupDisabled: 5, popupTemplate: 0, portal: 0, resultGraphic: 0, resultGraphicDisabled: 5, results: 0, searchAllDisabled: 5, searchTerm: 1, selectedResult: 0, sources: 0, suggestions: 32, suggestionsDisabled: 5, topLayerDisabled: 5, autoDestroyDisabled: 5, messageOverrides: 0, label: 1, state: 32 };
   }
   static {
-    this.styles = [A, k];
+    this.styles = [A, D];
   }
   get _isDisabled() {
     const { state: e } = this.viewModel;
@@ -45,6 +45,13 @@ class z extends f {
   get activeSource() {
     return this.viewModel?.activeSource;
   }
+  get includeDefaultSourcesDisabled() {
+    const { includeDefaultSources: e } = this.viewModel;
+    return typeof e == "boolean" ? !e : e;
+  }
+  set includeDefaultSourcesDisabled(e) {
+    this.viewModel.includeDefaultSources = typeof e == "boolean" ? !e : e;
+  }
   clear() {
     this._locateFailed = !1, this._selectedMessage = void 0, this.viewModel.clear();
   }

package/dist/components/{arcgis-utility-network-aggregated-geometry-result-item → arcgis-utility-network-trace-aggregated-geometry-result-item}/customElement.d.ts RENAMED Viewed

@@ -14,7 +14,7 @@ import type { T9nMeta } from "@arcgis/lumina/controllers";
  * @since 5.2
  * @see [Result types](https://doc.esri.com/en/arcgis-pro/latest/help/data/utility-network/configure-a-trace.html#DA5)
  */
-export abstract class ArcgisUtilityNetworkAggregatedGeometryResultItem extends LitElement {
+export abstract class ArcgisUtilityNetworkTraceAggregatedGeometryResultItem extends LitElement {
   /** @internal */
   protected _messages: {
       headings: { setColor: string; };
@@ -35,17 +35,17 @@ export abstract class ArcgisUtilityNetworkAggregatedGeometryResultItem extends L
    * If true, the component will not be destroyed automatically when it is
    * disconnected from the document. This is useful when you want to move the
    * component to a different place on the page, or temporarily hide it. If this
-   * is set, make sure to call the [destroy()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-aggregated-geometry-result-item/#destroy) method when you are done to
+   * is set, make sure to call the [destroy()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-aggregated-geometry-result-item/#destroy) method when you are done to
    * prevent memory leaks.
    *
    * @default false
    * @example
    * ```html
-   * <arcgis-utility-network-aggregated-geometry-result-item auto-destroy-disabled></arcgis-utility-network-aggregated-geometry-result-item>
+   * <arcgis-utility-network-trace-aggregated-geometry-result-item auto-destroy-disabled></arcgis-utility-network-trace-aggregated-geometry-result-item>
    * ```
    *
    * ```js
-   * utilityNetworkAggregatedGeometryResultItemElement.autoDestroyDisabled = true;
+   * utilityNetworkTraceAggregatedGeometryResultItemElement.autoDestroyDisabled = true;
    * ```
    *
    */
@@ -71,7 +71,7 @@ export abstract class ArcgisUtilityNetworkAggregatedGeometryResultItem extends L
   /** The heading of the result item. */
   accessor heading: string | undefined;
   /**
-   * Whether to hide the aggregated geometry [graphics](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-aggregated-geometry-result-item/#geometryGraphics)
+   * Whether to hide the aggregated geometry [graphics](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-aggregated-geometry-result-item/#geometryGraphics)
    * from the map when the trace result contains aggregated geometry results.
    *
    * @default false
@@ -85,13 +85,13 @@ export abstract class ArcgisUtilityNetworkAggregatedGeometryResultItem extends L
   accessor traceResult: TraceResult | undefined;
   /**
    * The view associated with the component.
-   * > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the arcgis-utility-network-aggregated-geometry-result-item component will be associated with a map or scene component rather than using the `view` property.
+   * > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the arcgis-utility-network-trace-aggregated-geometry-result-item component will be associated with a map or scene component rather than using the `view` property.
    *
    * @required
    */
   accessor view: MapView | undefined;
   /**
-   * Removes the [layer](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-aggregated-geometry-result-item/#graphicsLayer)
+   * Removes the [layer](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-aggregated-geometry-result-item/#graphicsLayer)
    * containing the aggregated geometry graphics from the map.
    */
   clearResult(): void;
@@ -109,7 +109,7 @@ export abstract class ArcgisUtilityNetworkAggregatedGeometryResultItem extends L
    */
   readonly arcgisResultReady: import("@arcgis/lumina").TargetedEvent<this, void>;
   readonly "@eventTypes": {
-    arcgisPropertyChange: ArcgisUtilityNetworkAggregatedGeometryResultItem["arcgisPropertyChange"]["detail"];
-    arcgisResultReady: ArcgisUtilityNetworkAggregatedGeometryResultItem["arcgisResultReady"]["detail"];
+    arcgisPropertyChange: ArcgisUtilityNetworkTraceAggregatedGeometryResultItem["arcgisPropertyChange"]["detail"];
+    arcgisResultReady: ArcgisUtilityNetworkTraceAggregatedGeometryResultItem["arcgisResultReady"]["detail"];
   };
 }

package/dist/components/{arcgis-utility-network-aggregated-geometry-result-item → arcgis-utility-network-trace-aggregated-geometry-result-item}/customElement.js RENAMED Viewed

@@ -12,11 +12,11 @@ import { log as s, composeMissingPropertyMessage as o } from "@arcgis/toolkit/lo
 import { css as R, html as g } from "lit";
 import { createRef as L, ref as C } from "lit/directives/ref.js";
 import { u as S } from "../../chunks/useT9n.js";
-import { a as h, i as $ } from "../../chunks/layer-utils.js";
+import { a as c, b as $ } from "../../chunks/layer-utils.js";
 const k = R`.aggregated-geometry-container{display:flex;justify-content:space-between;margin:0 var(--calcite-space-md) var(--calcite-space-md)}.geometry-heading{margin:var(--calcite-space-md);font-weight:var(--calcite-font-weight-medium);font-size:var(--calcite-font-size);color:var(--calcite-color-text-1)}`;
 class z extends f {
   constructor() {
-    super(...arguments), this._messages = S({ blocking: !0 }), this.#t = "arcgis-utility-network-aggregated-geometry-result-item-graphics", this.#e = L(), this.defaultSelectionSize = 12, this.geometryGraphics = [], this.hideGraphics = !1, this.graphicsColor = new l([255, 255, 0, 0.6]), this.autoDestroyDisabled = !1, this.arcgisPropertyChange = G()("defaultSelectionSize", "geometryGraphics", "hideGraphics", "graphicsColor"), this.arcgisResultReady = w();
+    super(...arguments), this._messages = S({ blocking: !0 }), this.#t = "arcgis-utility-network-trace-aggregated-geometry-result-item-graphics", this.#e = L(), this.defaultSelectionSize = 12, this.geometryGraphics = [], this.hideGraphics = !1, this.graphicsColor = new l([255, 255, 0, 0.6]), this.autoDestroyDisabled = !1, this.arcgisPropertyChange = G()("defaultSelectionSize", "geometryGraphics", "hideGraphics", "graphicsColor"), this.arcgisResultReady = w();
   }
   static {
     this.properties = { defaultSelectionSize: 9, heading: 1, traceResult: 0, geometryGraphics: 32, hideGraphics: 5, graphicsColor: 0, graphicsLayer: 0, view: 0, autoDestroyDisabled: 5 };
@@ -33,7 +33,7 @@ class z extends f {
     this.clearResult(), await this.manager.destroy();
   }
   connectedCallback() {
-    super.connectedCallback(), this.view && this.graphicsLayer && (h(this.view, this.graphicsLayer), this.arcgisResultReady.emit());
+    super.connectedCallback(), this.view && this.graphicsLayer && (c(this.view, this.graphicsLayer), this.arcgisResultReady.emit());
   }
   load() {
     if (!this.traceResult?.aggregatedGeometry || !this.view?.map) {
@@ -43,9 +43,9 @@ class z extends f {
     this.graphicsLayer || this.#a(this.view);
   }
   willUpdate(e) {
-    if (e.has("hideGraphics") && this.#s(), e.has("graphicsColor") && this.#h(), e.has("traceResult") && (this.graphicsLayer?.removeAll(), this.traceResult?.aggregatedGeometry && this.view && (this.#i(this.traceResult.aggregatedGeometry), this.arcgisResultReady.emit())), e.has("view")) {
+    if (e.has("hideGraphics") && this.#s(), e.has("graphicsColor") && this.#c(), e.has("traceResult") && (this.graphicsLayer?.removeAll(), this.traceResult?.aggregatedGeometry && this.view && (this.#i(this.traceResult.aggregatedGeometry), this.arcgisResultReady.emit())), e.has("view")) {
       const t = e.get("view");
-      t?.map && this.graphicsLayer && (t.map.remove(this.graphicsLayer), this.traceResult?.aggregatedGeometry && this.view && (h(this.view, this.graphicsLayer), this.#i(this.traceResult.aggregatedGeometry), this.arcgisResultReady.emit()));
+      t?.map && this.graphicsLayer && (t.map.remove(this.graphicsLayer), this.traceResult?.aggregatedGeometry && this.view && (c(this.view, this.graphicsLayer), this.#i(this.traceResult.aggregatedGeometry), this.arcgisResultReady.emit()));
     }
   }
   loaded() {
@@ -67,7 +67,7 @@ class z extends f {
       id: t,
       listMode: "hide",
       title: t
-    }), h(e, this.graphicsLayer);
+    }), c(e, this.graphicsLayer);
   }
   #s() {
     this.hideGraphics ? (this.graphicsLayer?.removeAll(), this.#e.value?.open && (this.#e.value.open = !1)) : this.graphicsLayer?.addMany(this.geometryGraphics);
@@ -105,7 +105,7 @@ class z extends f {
         });
     }
   }
-  #h() {
+  #c() {
     this.graphicsLayer?.graphics.forEach((e) => {
       const t = e.geometry;
       e.symbol = this.#r(t);
@@ -114,12 +114,12 @@ class z extends f {
   render() {
     const { graphicsColor: e, heading: t, hideGraphics: i, _messages: r } = this;
     return g`${t && g`<div class="geometry-heading">${t}</div>` || ""}<div class="aggregated-geometry-container"><calcite-switch .checked=${!i} .label=${r.labels.showGraphicsToggle} label-text-end=${r.showGraphics ?? v} @calciteSwitchChange=${() => this.hideGraphics = !this.hideGraphics}></calcite-switch><calcite-swatch .color=${e.toCss()} .disabled=${i} id=geometry-color-swatch .label=${r.labels.aggregatedGeometryGraphicsColor}></calcite-swatch><calcite-popover closable .heading=${r.headings.setColor} .label=${r.headings.setColor} reference-element=geometry-color-swatch ${C(this.#e)}><calcite-color-picker alpha-channel channels-disabled clearable .disabled=${i} hex-disabled saved-disabled .value=${e.toCss(!0)} @calciteColorPickerChange=${(a) => {
-      const c = a.target.value;
-      c && (this.graphicsColor = new l(c));
+      const h = a.target.value;
+      h && (this.graphicsColor = new l(h));
     }}></calcite-color-picker></calcite-popover></div>`;
   }
 }
-p("arcgis-utility-network-aggregated-geometry-result-item", z);
+p("arcgis-utility-network-trace-aggregated-geometry-result-item", z);
 export {
-  z as ArcgisUtilityNetworkAggregatedGeometryResultItem
+  z as ArcgisUtilityNetworkTraceAggregatedGeometryResultItem
 };

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

@@ -2,9 +2,11 @@
 import type Color from "@arcgis/core/Color.js";
 import type Graphic from "@arcgis/core/Graphic.js";
 import type MapView from "@arcgis/core/views/MapView.js";
+import type { ActionEvent } from "@arcgis/core/widgets/Popup/types.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
+import type { ArcgisFeaturesNext } from "../arcgis-features-next/customElement.js";
 import type { ArcgisReferenceElement } from "../types.js";
-import type { SelectStartPayload } from "../arcgis-utility-network-trace-location/customElement.js";
+import type { SelectStartPayload } from "../arcgis-utility-network-trace-locations/customElement.js";
 import type { ArcgisUtilityNetworkTraceResults } from "../arcgis-utility-network-trace-results/customElement.js";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
 import type { UtilityNetworkTraceAnalysisState } from "@arcgis/core/networks/UtilityNetworkTraceAnalysis.js";
@@ -77,6 +79,7 @@ import type { UtilityNetworkTraceAnalysisState } from "@arcgis/core/networks/Uti
  *
  * Note: Sign in to access the data in this demo, U/P: `viewer01`/`I68VGU^nMurF`
  *
+ * @internal
  * @since 5.0
  */
 export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
@@ -140,6 +143,16 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
           resultsTab: string;
       };
   }>;
+  /**
+   * A [collection](https://developers.arcgis.com/javascript/latest/references/core/core/Collection/) of [action button](https://developers.arcgis.com/javascript/latest/references/core/support/actions/ActionButton/) or [action toggle](https://developers.arcgis.com/javascript/latest/references/core/support/actions/ActionToggle/) objects. Each action may be executed by clicking the icon or image symbolizing them.
+   * There is a default `Zoom To` action styled with a magnifying glass icon to zoom in four LODs and center the map on the selected feature. This default action can be removed by setting [includeDefaultActionsDisabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-analysis/#includeDefaultActionsDisabled) to `true`, or by setting the [`overwriteActions`](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/#overwriteActions) property to `true` in a [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/).
+   *
+   * The order of each action is the order in which they appear in the actions [Collection](https://developers.arcgis.com/javascript/latest/references/core/core/Collection/). The [@arcgisTriggerAction](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-analysis/#event-arcgisTriggerAction) event fires each time an action is clicked.
+   *
+   * @see [@arcgisTriggerAction](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-analysis/#event-arcgisTriggerAction)
+   * @see [Popup actions sample](https://developers.arcgis.com/javascript/latest/sample-code/popup-actions/)
+   */
+  accessor actions: ArcgisFeaturesNext["actions"] | undefined;
   /**
    * The color used to render graphics for aggregated geometries in trace results, specified as a
    * [Color](https://developers.arcgis.com/javascript/latest/references/core/Color/) object.
@@ -148,6 +161,12 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
    *
    * Default color is #FFFF00.
    *
+   * @example
+   * Set the default aggregated geometry graphics color to lime green.
+   * ```js
+   * const traceElement = document.querySelector("arcgis-utility-network-trace-analysis");
+   * traceElement.aggregatedGeometryGraphicsColor = new Color("lime");
+   * ```
    * @see [Color constructor](https://developers.arcgis.com/javascript/latest/references/core/Color/#constructors-summary)
    */
   accessor aggregatedGeometryGraphicsColor: Color;
@@ -230,6 +249,41 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
    * ```
    */
   accessor hideFeatureResults: boolean;
+  /**
+   * Whether to hide the aggregated geometry [graphics](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-aggregated-geometry-result-item/#geometryGraphics)
+   * from the map when the trace result contains aggregated geometry results.
+   *
+   * @default false
+   */
+  accessor hideGraphics: boolean;
+  /**
+   * Whether to hide the placeholder string when feature results are hidden in the results tab.
+   *
+   * When this property and [hideFeatureResults](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-analysis/#hideFeatureResults) are both set to `true`,
+   * nothing is rendered for trace result elements. However, features are still queried and are available through
+   * [traceResultFeatures](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-analysis/#traceResultFeatures).
+   *
+   * @default false
+   * @example
+   * Hide the placeholder when feature results are hidden.
+   * ```html
+   * <arcgis-map item-id="471eb0bf37074b1fbb972b1da70fb310">
+   *   <arcgis-utility-network-trace-analysis
+   *     hide-feature-results
+   *     hide-placeholder
+   *     slot="top-right"
+   *   ></arcgis-utility-network-trace-analysis>
+   * </arcgis-map>
+   * ```
+   */
+  accessor hidePlaceholder: boolean;
+  /**
+   * Indicates whether default actions are disabled (hidden) when viewing trace result features.
+   * This property must be set to `true` to disable default actions.
+   *
+   * @default false
+   */
+  accessor includeDefaultActionsDisabled: boolean;
   /** The component's default label. */
   accessor label: string | undefined;
   /**
@@ -296,6 +350,7 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
    * Event payload contains a boolean representing whether the aggregated geometry graphics are hidden.
    * If true, the aggregated geometry graphics are hidden on the view.
    *
+   * @deprecated since 5.2. Use [@arcgisPropertyChange](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-analysis/#event-arcgisPropertyChange) instead.
    * @example
    * ```js
    * const traceElement = document.querySelector("arcgis-utility-network-trace-analysis");
@@ -306,6 +361,8 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
    * ```
    */
   readonly arcgisHideGraphicsChange: import("@arcgis/lumina").TargetedEvent<this, boolean>;
+  /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
+  readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "aggregatedGeometryGraphicsColor" | "hideGraphics"; }>;
   /** Emitted when the component associated with a map or scene view is ready for user interaction. */
   readonly arcgisReady: import("@arcgis/lumina").TargetedEvent<this, void>;
   /**
@@ -374,12 +431,16 @@ export abstract class ArcgisUtilityNetworkTraceAnalysis extends LitElement {
    * ```
    */
   readonly arcgisTraceResultFeaturesReady: import("@arcgis/lumina").TargetedEvent<this, void>;
+  /** Emitted when an action is triggered on the component. */
+  readonly arcgisTriggerAction: import("@arcgis/lumina").TargetedEvent<this, ActionEvent>;
   readonly "@eventTypes": {
     arcgisHideGraphicsChange: ArcgisUtilityNetworkTraceAnalysis["arcgisHideGraphicsChange"]["detail"];
+    arcgisPropertyChange: ArcgisUtilityNetworkTraceAnalysis["arcgisPropertyChange"]["detail"];
     arcgisReady: ArcgisUtilityNetworkTraceAnalysis["arcgisReady"]["detail"];
     arcgisTraceLocationSelectEnd: ArcgisUtilityNetworkTraceAnalysis["arcgisTraceLocationSelectEnd"]["detail"];
     arcgisTraceLocationSelectStart: ArcgisUtilityNetworkTraceAnalysis["arcgisTraceLocationSelectStart"]["detail"];
     arcgisTraceResultClear: ArcgisUtilityNetworkTraceAnalysis["arcgisTraceResultClear"]["detail"];
     arcgisTraceResultFeaturesReady: ArcgisUtilityNetworkTraceAnalysis["arcgisTraceResultFeaturesReady"]["detail"];
+    arcgisTriggerAction: ArcgisUtilityNetworkTraceAnalysis["arcgisTriggerAction"]["detail"];
   };
 }