@arcgis/map-components 4.34.0-next.2 → 4.34.0-next.21

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

@@ -90,9 +90,9 @@ export declare class ArcgisSearch extends LitElement {
      * geocoded results, you can set up a [search-complete](#event-search-complete) event handler and get the results
      * through the event object.
      *
-     * @default true
+     * @default false
      */
-    autoSelect: boolean;
+    autoSelectDisabled: boolean;
     /**
      * A read-only property that is a [Collection](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-Collection.html)
      * of [LayerSearchSource](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search-LayerSearchSource.html)
@@ -117,9 +117,9 @@ export declare class ArcgisSearch extends LitElement {
      * Indicates whether or not to include [defaultSources](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search-SearchViewModel.html#defaultSources) in the Search UI.
      * This can be a boolean value or a function that returns an array of Search [sources](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search-SearchViewModel.html#sources).
      *
-     * @default true
+     * @default false
      */
-    includeDefaultSources: boolean | Function;
+    includeDefaultSourcesDisabled: boolean | Function;
     /**
      * Enables location services within the component.
      *
@@ -133,9 +133,9 @@ export declare class ArcgisSearch extends LitElement {
      * (currently Chrome and Firefox).
      * :::
      *
-     * @default true
+     * @default false
      */
-    locationEnabled: boolean;
+    locationDisabled: boolean;
     /**
      * The maximum number of results returned by the component if not specified by the source.
      *
@@ -162,9 +162,9 @@ export declare class ArcgisSearch extends LitElement {
      * Indicates whether to display the [Popup](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Popup.html) on feature click. The graphic can
      * be clicked to display a [Popup](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Popup.html).
      *
-     * @default true
+     * @default false
      */
-    popupEnabled: boolean;
+    popupDisabled: boolean;
     /**
      * A customized [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) for the selected feature.
      * Note that any [templates](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html)
@@ -196,9 +196,9 @@ export declare class ArcgisSearch extends LitElement {
      * Indicates if the [resultGraphic](#resultGraphic) will display at the
      * location of the selected feature.
      *
-     * @default true
+     * @default false
      */
-    resultGraphicEnabled: boolean;
+    resultGraphicDisabled: boolean;
     /**
      * An array of objects, each containing a [SearchResult](#SearchResult) from the search.
      *
@@ -215,9 +215,9 @@ export declare class ArcgisSearch extends LitElement {
      *
      * ![search-searchAllEnabled-false](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/search-enablesearchingall-false.png)
      *
-     * @default true
+     * @default false
      */
-    searchAllEnabled: boolean;
+    searchAllDisabled: boolean;
     /** The value of the search box input text string. */
     searchTerm: string;
     /**
@@ -267,9 +267,9 @@ export declare class ArcgisSearch extends LitElement {
      * This is only available if working with a 10.3 or greater geocoding service that has [suggest capability
      * loaded](https://developers.arcgis.com/rest/geocode/api-reference/geocoding-suggest.htm) or a 10.3 or greater feature layer that supports pagination, i.e. `supportsPagination = true`.
      *
-     * @default true
+     * @default false
      */
-    suggestionsEnabled: boolean;
+    suggestionsDisabled: boolean;
     /**
      * 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
@@ -280,7 +280,11 @@ export declare class ArcgisSearch extends LitElement {
      * @default false
      */
     autoDestroyDisabled: boolean;
-    /** Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases. */
+    /**
+     * Replace localized message strings with your own strings.
+     *
+     * _**Note**: Individual message keys may change between releases._
+     */
     messageOverrides?: typeof this.messages._overrides;
     /** The component's default label. */
     label?: string;
@@ -292,8 +296,29 @@ export declare class ArcgisSearch extends LitElement {
      * @default "ready"
      */
     readonly state: "ready" | "loading" | "disabled" | "searching";
+    /**
+     * Clears the current searchTerm, search results, suggest results, graphic, and graphics layer.
+     * It also hides any open menus.
+     */
+    clear(): void;
     /** Permanently destroy the component. */
     destroy(): Promise<void>;
+    /**
+     * Depending on the sources specified, search() queries the feature layer(s) and/or performs
+     * address matching using any specified [locator(s)](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-locator.html) and
+     * returns any applicable results.
+     */
+    search(searchItem?: __esri.Graphic | __esri.Point | __esri.SuggestResult | Nil | number[] | string): Promise<__esri.SearchResponse | Nil>;
+    /**
+     * Performs a suggest() request on the active Locator. It also uses the current value of
+     * the component or one that is passed in.
+     *
+     * Suggestions are available if working with a 10.3 or greater geocoding service that has
+     * [suggest capability
+     * loaded](https://developers.arcgis.com/rest/geocode/api-reference/geocoding-suggest.htm) or a 10.3 or greater feature layer that supports pagination, i.e.
+     * `supportsPagination = true`.
+     */
+    suggest(query?: string): Promise<__esri.SuggestResponse | Nil>;
     /** Brings focus to the component's text input. */
     setFocus(): Promise<void>;
     /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */

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

@@ -1,40 +1,40 @@
 import { c as p } from "../../chunks/runtime.js";
 import { ref as d } from "lit-html/directives/ref.js";
 import _ from "@arcgis/core/widgets/Search/SearchViewModel.js";
-import { LitElement as v, createEvent as w, noShadowRoot as f, safeClassMap as c, nothing as S } from "@arcgis/lumina";
+import { LitElement as v, createEvent as w, noShadowRoot as f, safeClassMap as n, nothing as S } from "@arcgis/lumina";
 import { reEmitEvent as l } from "@arcgis/lumina/controllers/accessor";
 import { a as g } from "../../chunks/maybe.js";
 import { classes as M } from "@arcgis/components-utils";
-import { g as C } from "../../chunks/globalCss.js";
-import { isAbortError as $ } from "@arcgis/core/core/promiseUtils.js";
-import { m as b } from "../../chunks/useViewModel.js";
+import { g as b } from "../../chunks/globalCss.js";
+import { isAbortError as C } from "@arcgis/core/core/promiseUtils.js";
+import { m as $ } from "../../chunks/useViewModel.js";
 import { render as R, html as o } from "lit-html";
 import { css as x } from "@lit/reactive-element/css-tag.js";
 import { substitute as y } from "@arcgis/core/intl.js";
-import { usePropertyChange as E } from "@arcgis/lumina/controllers";
-import { u as T } from "../../chunks/useT9n.js";
-import { watch as A } from "@arcgis/core/core/reactiveUtils.js";
+import { usePropertyChange as T } from "@arcgis/lumina/controllers";
+import { u as A } from "../../chunks/useT9n.js";
+import { watch as D } from "@arcgis/core/core/reactiveUtils.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.2 */
+v4.34.0-next.21 */
 const h = "arcgis-search", u = {
   base: h,
   autocomplete: `${h}__autocomplete`,
   dropdown: `${h}__dropdown`,
   container: `${h}__container`,
   form: `${h}__form`
-}, N = x`@layer{arcgis-search{display:block}.arcgis-search{--arcgis-internal-search-width: 240px;display:flex;flex-flow:row nowrap;align-items:center;justify-content:center;width:var(--arcgis-internal-search-width)}.arcgis-search__dropdown{--calcite-color-border-1: var(--calcite-color-border-input);--calcite-dropdown-width: var(--arcgis-internal-search-width);width:31px}.arcgis-search__autocomplete{flex:1}.arcgis-search__container{display:flex;position:relative;flex:1 0 100%;flex-flow:row nowrap;align-items:stretch}.arcgis-search__form{display:flex;flex:1 0;flex-flow:row nowrap;align-items:stretch;margin:0;padding:0}}`, I = b(_);
-class L extends v {
+}, E = x`@layer{arcgis-search{display:block}.arcgis-search{--arcgis-internal-search-width: 240px;display:flex;flex-flow:row nowrap;align-items:center;justify-content:center;width:var(--arcgis-internal-search-width)}.arcgis-search__dropdown{--calcite-color-border-1: var(--calcite-color-border-input);--calcite-dropdown-width: var(--arcgis-internal-search-width);width:31px}.arcgis-search__autocomplete{flex:1}.arcgis-search__container{display:flex;position:relative;flex:1 0 100%;flex-flow:row nowrap;align-items:stretch}.arcgis-search__form{display:flex;flex:1 0;flex-flow:row nowrap;align-items:stretch;margin:0;padding:0}}`, N = $(_);
+class I extends v {
   constructor() {
-    super(...arguments), this.viewModel = I(this), this._currentLocationValue = "search-use-current-location", this._autocompleteEl = void 0, this._searchResultRendererContainerEl = document.createElement("div"), this._searchResultRendererEl = void 0, this._suggestController = void 0, this._searchController = void 0, this._lastSearchTerm = "", this.messages = T({}), this._setSearchResultRendererRef = (e) => {
+    super(...arguments), this.viewModel = N(this), this._currentLocationValue = "search-use-current-location", this._autocompleteEl = void 0, this._searchResultRendererContainerEl = document.createElement("div"), this._searchResultRendererEl = void 0, this._suggestController = void 0, this._searchController = void 0, this._lastSearchTerm = "", this.messages = A({}), this._setSearchResultRendererRef = (e) => {
       this._searchResultRendererEl = e;
-    }, this._locateFailed = !1, this._showNoResults = !1, this.position = "top-left", this.goToOverride = this.viewModel.goToOverride, this.icon = "search", this.activeMenu = "none", this.activeSourceIndex = this.viewModel.activeSourceIndex, this.allPlaceholder = this.viewModel.allPlaceholder, this.allSources = this.viewModel.allSources, this.autoNavigate = this.viewModel.autoNavigate, this.autoSelect = this.viewModel.autoSelect, this.defaultSources = this.viewModel.defaultSources, this.disabled = !1, this.includeDefaultSources = this.viewModel.includeDefaultSources, this.locationEnabled = this.viewModel.locationEnabled, this.maxResults = this.viewModel.maxResults, this.maxSuggestions = this.viewModel.maxSuggestions, this.minSuggestCharacters = this.viewModel.minSuggestCharacters, this.popupEnabled = this.viewModel.popupEnabled, this.popupTemplate = this.viewModel.popupTemplate, this.portal = this.viewModel.portal, this.resultGraphic = this.viewModel.resultGraphic, this.resultGraphicEnabled = this.viewModel.resultGraphicEnabled, this.results = this.viewModel.results, this.searchAllEnabled = this.viewModel.searchAllEnabled, this.searchTerm = this.viewModel.searchTerm, this.selectedResult = this.viewModel.selectedResult, this.sources = this.viewModel.sources, this.suggestions = this.viewModel.suggestions, this.suggestionsEnabled = this.viewModel.suggestionsEnabled, this.autoDestroyDisabled = !1, this.state = this.viewModel.state, this.arcgisPropertyChange = E()("state"), this.arcgisReady = w(), this.arcgisSearchClear = l(() => this.viewModel, "search-clear"), this.arcgisSearchComplete = l(() => this.viewModel, "search-complete"), this.arcgisSearchStart = l(() => this.viewModel, "search-start"), this.arcgisSelectResult = l(() => this.viewModel, "select-result"), this.arcgisSuggestComplete = l(() => this.viewModel, "suggest-complete"), this.arcgisSuggestStart = l(() => this.viewModel, "suggest-start"), this._renderSearchResultsContent = () => this._searchResultRendererEl;
+    }, this._locateFailed = !1, this._showNoResults = !1, this.position = "top-left", this.goToOverride = this.viewModel.goToOverride, this.icon = "search", this.activeMenu = "none", this.activeSourceIndex = this.viewModel.activeSourceIndex, this.allPlaceholder = this.viewModel.allPlaceholder, this.allSources = this.viewModel.allSources, this.autoNavigate = 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.autoDestroyDisabled = !1, this.state = this.viewModel.state, this.arcgisPropertyChange = T()("state"), this.arcgisReady = w(), this.arcgisSearchClear = l(() => this.viewModel, "search-clear"), this.arcgisSearchComplete = l(() => this.viewModel, "search-complete"), this.arcgisSearchStart = l(() => this.viewModel, "search-start"), this.arcgisSelectResult = l(() => this.viewModel, "select-result"), this.arcgisSuggestComplete = l(() => this.viewModel, "suggest-complete"), this.arcgisSuggestStart = l(() => this.viewModel, "suggest-start");
   }
   static {
-    this.properties = { _locateFailed: 16, _showNoResults: 16, _isDisabled: 16, _showCurrentLocation: 16, _effectiveActiveMenu: 16, referenceElement: 1, position: 3, goToOverride: 0, icon: 1, activeMenu: 1, activeSource: 32, activeSourceIndex: 9, allPlaceholder: 1, allSources: 0, autoNavigate: 5, autoSelect: 5, defaultSources: 0, disabled: 5, includeDefaultSources: 5, locationEnabled: 5, maxResults: 9, maxSuggestions: 9, minSuggestCharacters: 9, popupEnabled: 5, popupTemplate: 0, portal: 0, resultGraphic: 0, resultGraphicEnabled: 5, results: 0, searchAllEnabled: 5, searchTerm: 1, selectedResult: 0, sources: 0, suggestions: 0, suggestionsEnabled: 5, autoDestroyDisabled: 5, messageOverrides: 0, label: 1, state: 3 };
+    this.properties = { _locateFailed: 16, _showNoResults: 16, _isDisabled: 16, _showCurrentLocation: 16, _effectiveActiveMenu: 16, referenceElement: 1, position: 3, goToOverride: 0, icon: 1, activeMenu: 1, activeSource: 32, activeSourceIndex: 9, allPlaceholder: 1, allSources: 0, autoNavigate: 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: 0, suggestionsDisabled: 5, autoDestroyDisabled: 5, messageOverrides: 0, label: 1, state: 3 };
   }
   static {
-    this.styles = N;
+    this.styles = E;
   }
   static {
     this.shadowRootOptions = f;
@@ -44,7 +44,7 @@ class L extends v {
     return e === "disabled" || e === "loading" || this.disabled;
   }
   get _showCurrentLocation() {
-    return this.locationEnabled && !this.searchTerm?.trim();
+    return !this.locationDisabled && !this.searchTerm?.trim();
   }
   get _effectiveActiveMenu() {
     return this._isDisabled ? "none" : this.activeMenu;
@@ -52,20 +52,12 @@ class L extends v {
   get activeSource() {
     return this.viewModel?.activeSource;
   }
-  async destroy() {
-    await this.manager.destroy(), await this._searchResultRendererEl?.destroy(), this._cancelQueries();
-  }
-  async setFocus() {
-    await this._autocompleteEl?.setFocus();
-  }
-  loaded() {
-    this._addSearchResultRenderer(), this.manager.onLifecycle(() => A(() => this.viewModel?.defaultPopupTemplate, (e) => {
-      e && (e.content = this._renderSearchResultsContent);
-    }, { initial: !0 }));
-  }
   clear() {
     this._locateFailed = !1, this.viewModel.clear();
   }
+  async destroy() {
+    await this.manager.destroy(), await this._searchResultRendererEl?.destroy(), this._cancelQueries();
+  }
   async search(e) {
     this._cancelQueries();
     const t = new AbortController(), { signal: s } = t;
@@ -91,6 +83,17 @@ class L extends v {
       return this._suggestController !== t || (this._suggestController = void 0), null;
     }
   }
+  async setFocus() {
+    await this._autocompleteEl?.setFocus();
+  }
+  loaded() {
+    this._addSearchResultRenderer(), this.manager.onLifecycle(() => D(() => this.viewModel?.defaultPopupTemplate, (e) => {
+      if (e) {
+        const t = document.createElement("div");
+        t.appendChild(this._searchResultRendererContainerEl), e.content = t;
+      }
+    }, { initial: !0 }));
+  }
   _addSearchResultRenderer() {
     R(o`<arcgis-search-result-renderer auto-destroy-disabled .messages=${this.messages} .viewModel=${this.viewModel} ${d(this._setSearchResultRendererRef)}></arcgis-search-result-renderer>`, this._searchResultRendererContainerEl);
   }
@@ -126,7 +129,7 @@ class L extends v {
     try {
       await this.viewModel.searchNearby({ signal: t });
     } catch (s) {
-      $(s) || (this._locateFailed = !0, this.activeMenu = "suggestion");
+      C(s) || (this._locateFailed = !0, this.activeMenu = "suggestion");
     } finally {
       this._searchController = void 0;
     }
@@ -158,22 +161,22 @@ class L extends v {
     return (e === -1 ? t.all : i?.name || t.untitledSource) || "";
   }
   render() {
-    return o`<div class=${c(M(u.base, C.widget))}><div class=${c(u.container)}>${this._renderSourcesMenu()}${this._renderForm()}</div></div>`;
+    return this._addSearchResultRenderer(), o`<div class=${n(M(u.base, b.widget))}><div class=${n(u.container)}>${this._renderSourcesMenu()}${this._renderForm()}</div></div>`;
   }
   _renderSourcesMenu() {
     const { messages: e, _isDisabled: t, _effectiveActiveMenu: s } = this, { allSources: i, searchAllEnabled: r } = this.viewModel;
-    return i.length > 1 ? o`<calcite-dropdown class=${c(u.dropdown)} .disabled=${t} .open=${s === "source"} overlay-positioning=fixed @calciteDropdownClose=${this._handleSourceClose} @calciteDropdownOpen=${this._handleSourceOpen} @calciteDropdownSelect=${this._handleSourceSelect}><calcite-button appearance=outline-fill icon-start=caret-down kind=neutral .label=${e.searchIn} slot=trigger></calcite-button><calcite-dropdown-group .groupTitle=${e.searchIn}>${r ? this._renderSource(-1) : null}${i.map((a, n) => this._renderSource(n)).toArray()}</calcite-dropdown-group></calcite-dropdown>` : null;
+    return i.length > 1 ? o`<calcite-dropdown class=${n(u.dropdown)} .disabled=${t} .open=${s === "source"} overlay-positioning=fixed @calciteDropdownClose=${this._handleSourceClose} @calciteDropdownOpen=${this._handleSourceOpen} @calciteDropdownSelect=${this._handleSourceSelect}><calcite-button appearance=outline-fill icon-start=caret-down kind=neutral .label=${e.searchIn} slot=trigger></calcite-button><calcite-dropdown-group .groupTitle=${e.searchIn}>${r ? this._renderSource(-1) : null}${i.map((a, c) => this._renderSource(c)).toArray()}</calcite-dropdown-group></calcite-dropdown>` : null;
   }
   _renderUseCurrentLocation() {
     const { _currentLocationValue: e } = this;
     return o`<calcite-autocomplete-item .heading=${this.messages.useCurrentLocation ?? ""} icon-start=gps-on .value=${e}></calcite-autocomplete-item>`;
   }
   _renderAutocomplete() {
-    const { _effectiveActiveMenu: e, messages: t, _isDisabled: s } = this, { maxInputLength: i, placeholder: r, searchTerm: a, state: n } = this.viewModel, m = this.label ?? t.searchButtonTitle ?? "";
-    return o`<calcite-autocomplete .autocomplete=${"off"} class=${c(u.autocomplete)} .disabled=${s} .icon=${this.icon} .inputValue=${a} .label=${m} .loading=${n === "searching"} .maxLength=${i} .name=${this.el.id} @keydown=${this._handleInputKeydown} .open=${e === "suggestion"} overlay-positioning=fixed .placeholder=${r} title=${(a ? "" : r) ?? S} @calciteAutocompleteChange=${this._handleCalciteAutocompleteChange} @calciteAutocompleteClose=${this._handleAutocompleteClose} @calciteAutocompleteOpen=${this._handleAutocompleteOpen} @calciteAutocompleteTextChange=${this._handleCalciteAutocompleteTextInput} @calciteAutocompleteTextInput=${this._handleCalciteAutocompleteTextInput} ${d(this._handleAutocompleteCreate)}>${this._renderSuggestions()}${this._renderNotices()}</calcite-autocomplete>`;
+    const { _effectiveActiveMenu: e, messages: t, _isDisabled: s } = this, { maxInputLength: i, placeholder: r, searchTerm: a, state: c } = this.viewModel, m = this.label ?? t.searchButtonTitle ?? "";
+    return o`<calcite-autocomplete .autocomplete=${"off"} class=${n(u.autocomplete)} .disabled=${s} .icon=${this.icon} .inputValue=${a} .label=${m} .loading=${c === "searching"} .maxLength=${i} .name=${this.el.id} @keydown=${this._handleInputKeydown} .open=${e === "suggestion"} overlay-positioning=fixed .placeholder=${r} title=${(a ? "" : r) ?? S} @calciteAutocompleteChange=${this._handleCalciteAutocompleteChange} @calciteAutocompleteClose=${this._handleAutocompleteClose} @calciteAutocompleteOpen=${this._handleAutocompleteOpen} @calciteAutocompleteTextChange=${this._handleCalciteAutocompleteTextInput} @calciteAutocompleteTextInput=${this._handleCalciteAutocompleteTextInput} ${d(this._handleAutocompleteCreate)}>${this._renderSuggestions()}${this._renderNotices()}</calcite-autocomplete>`;
   }
   _renderForm() {
-    return o`<form class=${c(u.form)} @submit=${this._formSubmit} role=search>${this._renderAutocomplete()}</form>`;
+    return o`<form class=${n(u.form)} @submit=${this._formSubmit} role=search>${this._renderAutocomplete()}</form>`;
   }
   _renderSuggestGroup(e) {
     return e.results?.map((t) => this._renderSuggestion(t));
@@ -183,8 +186,8 @@ class L extends v {
     return this._showNoResults ? null : this._showCurrentLocation ? this._renderUseCurrentLocation() : e?.map((t) => this._renderSuggestResults(t));
   }
   _renderSuggestResults(e) {
-    const { allSources: t, activeSourceIndex: s } = this.viewModel, { sourceIndex: i } = e, r = e.results?.length, a = t.length > 1 && s === -1, n = this._getSourceName(i);
-    return r && a ? o`<calcite-autocomplete-item-group .heading=${n}>${this._renderSuggestGroup(e)}</calcite-autocomplete-item-group>` : this._renderSuggestGroup(e);
+    const { allSources: t, activeSourceIndex: s } = this.viewModel, { sourceIndex: i } = e, r = e.results?.length, a = t.length > 1 && s === -1, c = this._getSourceName(i);
+    return r && a ? o`<calcite-autocomplete-item-group .heading=${c}>${this._renderSuggestGroup(e)}</calcite-autocomplete-item-group>` : this._renderSuggestGroup(e);
   }
   _renderSuggestion({ key: e, sourceIndex: t, text: s }) {
     const i = {
@@ -210,7 +213,7 @@ class L extends v {
     return this._locateFailed ? this._renderLocateError() : this._showNoResults ? this._renderNoResultsWarning(this._lastSearchTerm ?? this.viewModel.searchTerm) : null;
   }
 }
-p("arcgis-search", L);
+p("arcgis-search", I);
 export {
-  L as ArcgisSearch
+  I as ArcgisSearch
 };

package/dist/components/arcgis-search-result-renderer/customElement.js

@@ -9,7 +9,7 @@ import { watch as u } from "@arcgis/core/core/reactiveUtils.js";
 import { substitute as M } from "@arcgis/core/intl.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.2 */
+v4.34.0-next.21 */
 const n = "arcgis-search-result-renderer", h = {
   base: n,
   moreResults: `${n}__more-results`

package/dist/components/arcgis-shadow-cast/customElement.js

@@ -6,7 +6,7 @@ import { m as l } from "../../chunks/useWidget.js";
 import { css as a } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.2 */
+v4.34.0-next.21 */
 const r = a`@layer{arcgis-shadow-cast{display:block}}`, n = l(s);
 class m extends o {
   constructor() {

package/dist/components/arcgis-sketch/customElement.js

@@ -8,7 +8,7 @@ import { m as r } from "../../chunks/useWidget.js";
 import { css as g } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.2 */
+v4.34.0-next.21 */
 const p = g`@layer{arcgis-sketch{display:block}}`, c = r(n);
 class m extends a {
   constructor() {

package/dist/components/arcgis-slice/customElement.d.ts

@@ -66,15 +66,20 @@ export declare class ArcgisSlice extends LitElement {
     icon?: HTMLCalciteIconElement["icon"];
     /** The component's default label. */
     label?: string;
-    /** Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases. */
+    /**
+     * Replace localized message strings with your own strings.
+     *
+     * _**Note**: Individual message keys may change between releases._
+     */
     messageOverrides?: typeof this._messages._overrides;
     /** @default "bottom-left" */
     position: __esri.UIPosition;
     referenceElement?: ArcgisReferenceElement | string;
     /**
      * The shape used to slice elements in a 3D scene. Currently the only supported shape is a plane.
-     * Example:
-     * ```
+     *
+     * @example
+     * ```js
      * // Clone the shape to modify its properties
      * const shape = slice.shape.clone();
      * // Set new values for heading and tilt

package/dist/components/arcgis-slice/customElement.js

@@ -14,7 +14,7 @@ import { g as m } from "../../chunks/globalCss.js";
 import { watch as H } from "@arcgis/core/core/reactiveUtils.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.2 */
+v4.34.0-next.21 */
 const O = E`@layer{arcgis-slice{display:block}.arcgis-slice__container{display:flex;padding:var(--esri-widget-padding-y) var(--esri-widget-padding-x);overflow-y:auto;--layer-item-background: var(--calcite-color-foreground-2)}.arcgis-slice__error{color:var(--calcite-color-status-danger)}.arcgis-slice__container,.arcgis-slice__hint{display:flex;flex-direction:column;gap:var(--calcite-spacing-md)}.arcgis-slice__error,.arcgis-slice__hint{overflow:hidden;animation:arcgis-slice-fade-in .25s ease-in-out}.arcgis-slice__error p,.arcgis-slice__hint p{margin:0;padding:0}.arcgis-slice__hint:not(:has(*)){display:none}.arcgis-slice__layer-item{--calcite-color-foreground-2: var(--layer-item-background);--calcite-color-foreground-1: var(--layer-item-background)}.arcgis-slice__actions{display:flex;flex-flow:column;gap:var(--calcite-spacing-xxs);justify-content:center}.arcgis-slice__actions:not(:has(*)){display:none}@keyframes arcgis-slice-fade-in{0%{opacity:0}25%{opacity:0}to{opacity:1}}}`;
 var B = Object.defineProperty, P = Object.getOwnPropertyDescriptor, o = (e, i, t, u) => {
   for (var c = u > 1 ? void 0 : u ? P(i, t) : i, y = e.length - 1, h; y >= 0; y--)

package/dist/components/arcgis-slider/customElement.js

@@ -7,7 +7,7 @@ import { m as g } from "../../chunks/useWidget.js";
 import { css as m } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.2 */
+v4.34.0-next.21 */
 const c = m`@layer{arcgis-slider{min-width:200px;min-height:25px}}`, r = g(n);
 class d extends a {
   constructor() {

package/dist/components/arcgis-swipe/customElement.d.ts

@@ -15,7 +15,7 @@ declare const useSwipeViewModel: (component: LitElement & Pick<SwipeViewModel, n
  * properties to determine what will be compared on either side of the component. If one of these properties
  * is not set, then the Swipe component will overlay the existing map.
  *
- * **Known Limitations**
+ * **Known limitations**
  *
  * - This component is not currently supported within a Scene component.
  *
@@ -74,7 +74,11 @@ export declare class ArcgisSwipe extends LitElement {
     label?: string;
     /** A collection of layers that will show on the left or top side of the Swipe component. */
     leadingLayers: __esri.Collection<__esri.Layer>;
-    /** Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases. */
+    /**
+     * Replace localized message strings with your own strings.
+     *
+     * _**Note**: Individual message keys may change between releases._
+     */
     messageOverrides?: typeof this.messages._overrides;
     /** @default "manual" */
     position: __esri.UIPosition;

package/dist/components/arcgis-swipe/customElement.js

@@ -11,7 +11,7 @@ import { l as b } from "../../chunks/legacyIcon.js";
 import { css as A } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.2 */
+v4.34.0-next.21 */
 const H = A`@layer{arcgis-swipe,.arcgis-swipe{position:absolute;margin:0;background:transparent!important;padding:0;width:100%;height:100%;overflow:hidden;user-select:none}.arcgis-swipe,.arcgis-ui .arcgis-swipe{pointer-events:none!important}.arcgis-swipe__container{position:absolute;z-index:1;margin:0;outline:0;border:0;padding:0;overflow:hidden;pointer-events:auto;touch-action:none;outline-color:transparent}.arcgis-swipe--horizontal .arcgis-swipe__container{margin-left:calc(var(--calcite-spacing-xxxl) / 2 * -1);cursor:col-resize;height:100%}.arcgis-swipe--vertical .arcgis-swipe__container{margin-top:calc(var(--calcite-spacing-xxxl) / 2 * -1);cursor:row-resize;width:100%}.arcgis-swipe--disabled .arcgis-swipe__container{cursor:default;pointer-events:none}.arcgis-swipe__divider{position:absolute;background-color:var(--calcite-color-background)}.arcgis-swipe--horizontal .arcgis-swipe__divider{top:0;left:calc(var(--calcite-spacing-xxxl) / 2);margin-left:calc(var(--calcite-border-width-lg) * .5 * -1);border-right:var(--calcite-border-width-sm) solid var(--calcite-color-border-1);border-left:var(--calcite-border-width-sm) solid var(--calcite-color-border-1);width:var(--calcite-border-width-lg);height:100%}.arcgis-swipe--vertical .arcgis-swipe__divider{top:calc(var(--calcite-spacing-xxxl) / 2);left:0;margin-top:calc(var(--calcite-border-width-lg) * .5 * -1);border-top:var(--calcite-border-width-sm) solid var(--calcite-color-border-1);border-bottom:var(--calcite-border-width-sm) solid var(--calcite-color-border-1);width:100%;height:var(--calcite-border-width-lg)}.arcgis-swipe__handle{display:flex;position:relative;align-items:center;justify-content:center;border:var(--calcite-border-width-sm) solid var(--calcite-color-border-1);border-radius:var(--calcite-corner-radius-round);background-color:var(--calcite-color-background);width:var(--calcite-spacing-xxxl);height:var(--calcite-spacing-xxxl);color:var(--calcite-color-border-input)}.arcgis-swipe__handle--hidden{visibility:hidden}.arcgis-swipe--vertical .arcgis-swipe__handle{rotate:90deg}.arcgis-swipe__handle-icon{position:relative;z-index:2}.arcgis-swipe--horizontal .arcgis-swipe__handle{top:calc(50% - calc(var(--calcite-spacing-xxxl) / 2))}.arcgis-swipe--vertical .arcgis-swipe__handle{left:calc(50% - calc(var(--calcite-spacing-xxxl) / 2))}.arcgis-swipe__container:focus .arcgis-swipe__handle,.arcgis-swipe__container:focus .arcgis-swipe__divider{outline:inset 2px var(--calcite-color-focus, var(--calcite-ui-focus-color, var(--calcite-color-brand)))}.arcgis-swipe__container:focus .arcgis-swipe__handle{outline-offset:calc(-2px*(1 - (2*clamp(0,var(--calcite-offset-invert-focus),1))))}}`, l = "arcgis-swipe", n = {
   base: l,
   baseDisabled: `${l}--disabled`,

package/dist/components/arcgis-table-list/customElement.js

@@ -8,7 +8,7 @@ import { css as h } from "@lit/reactive-element/css-tag.js";
 import { c as d } from "../../chunks/createCloseEvent.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.2 */
+v4.34.0-next.21 */
 const n = h`@layer{arcgis-table-list{display:block}}`, m = a(s);
 class c extends o {
   constructor() {

package/dist/components/arcgis-time-slider/customElement.js

@@ -8,7 +8,7 @@ import { css as d } from "@lit/reactive-element/css-tag.js";
 import { when as r } from "@arcgis/core/core/reactiveUtils.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.2 */
+v4.34.0-next.21 */
 const m = d`@layer{arcgis-time-slider{display:block}}`, c = n(o);
 class g extends a {
   constructor() {

package/dist/components/arcgis-time-zone-label/customElement.d.ts

@@ -49,7 +49,9 @@ export declare class ArcgisTimeZoneLabel extends LitElement {
      */
     expanded: boolean;
     /**
-     * Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases.
+     * Replace localized message strings with your own strings.
+     *
+     * _**Note**: Individual message keys may change between releases._
      *
      * @property
      * ({ reflect: true })

package/dist/components/arcgis-time-zone-label/customElement.js

@@ -10,7 +10,7 @@ import { u as $ } from "../../chunks/useView.js";
 import { when as y, watch as z } from "@arcgis/core/core/reactiveUtils.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.2 */
+v4.34.0-next.21 */
 const D = f`@layer{.arcgis-time-zone-label{display:inline-flex;background-color:var(--calcite-color-foreground-1)}.arcgis-time-zone-label__badge{display:flex;padding-block:var(--calcite-spacing-sm);padding-inline:var(--calcite-spacing-sm);color:var(--calcite-color-text-1)}.arcgis-time-zone-label__badge--disabled{opacity:var(--calcite-opacity-disabled)}.arcgis-time-zone-label__badge--hidden{display:none}.arcgis-time-zone-label__badge-icon{align-self:center}.arcgis-time-zone-label__name{--calcite-color-background: transparent;--calcite-color-border-input: transparent;--calcite-font-weight-medium: normal;pointer-events:none}.arcgis-time-zone-label__name--hidden{display:none}.arcgis-time-zone-label__label{--calcite-label-margin-bottom: 0;align-items:center;padding-inline:var(--calcite-spacing-sm)}.arcgis-time-zone-label__label--disabled{opacity:var(--calcite-opacity-disabled)}.arcgis-time-zone-label__label--hidden{display:none}}`, t = "esri-time-zone-label", i = {
   base: t,
   badge: `${t}__badge`,

package/dist/components/arcgis-track/customElement.d.ts

@@ -11,7 +11,7 @@ declare const useTrackViewModel: (component: LitElement & Pick<TrackViewModel, n
  * The view rotates based on device heading.
  * The default heading symbol will display when speed is greater than zero and the browser provides heading information.
  *
- * **Known Limitations**
+ * **Known limitations**
  *
  * - The heading symbol is not currently supported within a Scene component.
  *
@@ -70,7 +70,11 @@ export declare class ArcgisTrack extends LitElement {
     icon?: string;
     /** The component's default label. */
     label?: string;
-    /** Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases. */
+    /**
+     * Replace localized message strings with your own strings.
+     *
+     * _**Note**: Individual message keys may change between releases._
+     */
     messageOverrides?: typeof this.messages._overrides;
     /** @default "top-left" */
     position: __esri.UIPosition;

package/dist/components/arcgis-track/customElement.js

@@ -11,7 +11,7 @@ import { g as c } from "../../chunks/globalCss.js";
 import { css as T } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.2 */
+v4.34.0-next.21 */
 const y = T`@layer{arcgis-track{display:block}}`, $ = {
   base: "esri-track"
 }, D = b(v);

package/dist/components/arcgis-unit-select/customElement.d.ts

@@ -15,7 +15,11 @@ export declare class ArcgisUnitSelect<Unit extends UnitUnion = UnitUnion> extend
     options: Unit[];
     selectLabel: string;
     value: Unit;
-    /** Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases. */
+    /**
+     * Replace localized message strings with your own strings.
+     *
+     * _**Note**: Individual message keys may change between releases._
+     */
     messageOverrides?: typeof this.messages._overrides;
     label?: string;
     /** Permanently destroy the component. */

package/dist/components/arcgis-unit-select/customElement.js

@@ -6,7 +6,7 @@ import { LitElement as g, createEvent as u, safeClassMap as p } from "@arcgis/lu
 import { css as h } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.2 */
+v4.34.0-next.21 */
 const b = h`.arcgis-unit-select{width:100%}.arcgis-unit-select__label{--calcite-label-margin-bottom: 0;width:100%}`, $ = "arcgis-unit-select", d = {
   label: `${$}__label`
 };

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

@@ -4,7 +4,7 @@ import { LitElement as c, createEvent as r, noShadowRoot as h } from "@arcgis/lu
 import { m as A } from "../../chunks/useWidget.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.2 */
+v4.34.0-next.21 */
 const S = A(a);
 class g extends c {
   constructor() {

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

@@ -6,7 +6,7 @@ import { LitElement as r, createEvent as a, noShadowRoot as o } from "@arcgis/lu
 import { m as l } from "../../chunks/useWidget.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.2 */
+v4.34.0-next.21 */
 const d = l(s);
 class h extends r {
   constructor() {

package/dist/components/arcgis-utility-network-validate-topology/customElement.js

@@ -6,7 +6,7 @@ import { LitElement as a, createEvent as r, noShadowRoot as l } from "@arcgis/lu
 import { m as h } from "../../chunks/useWidget.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.2 */
+v4.34.0-next.21 */
 const w = h(
   // Workaround for https://devtopia.esri.com/WebGIS/arcgis-js-api/issues/69562
   s

package/dist/components/arcgis-value-picker/customElement.js

@@ -7,7 +7,7 @@ import { m as h } from "../../chunks/useWidget.js";
 import { css as r } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.2 */
+v4.34.0-next.21 */
 const l = r`@layer{arcgis-value-picker{display:block}}`, c = h(s);
 class u extends a {
   constructor() {

package/dist/components/arcgis-version-management/customElement.d.ts

@@ -44,18 +44,22 @@ export declare class ArcgisVersionManagement extends LitElement {
     /** @default false */
     closable: boolean;
     /**
-     * The `initialVersionInfos` property enables users to initialize the Version Management Component with a predefined set of versions.
+     * The `initialVersionInfos` property enables users to initialize the Version Management component with a predefined set of versions.
      * By providing an array of `InitialVersionInfo`, the component displays a specified version for each feature service upon initialization.
      */
     get initialVersionInfos(): InitialVersionInfo[];
     set initialVersionInfos(value: InitialVersionInfo[]);
     icon?: string;
     label?: string;
-    /** Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases. */
+    /**
+     * Replace localized message strings with your own strings.
+     *
+     * _**Note**: Individual message keys may change between releases._
+     */
     messageOverrides?: typeof this.messages._overrides;
     mode?: string;
     /**
-     * Specifies the number of versions displayed on each page of the Version Management Component.
+     * Specifies the number of versions displayed on each page of the Version Management component.
      *
      * @default 5
      */
@@ -71,8 +75,8 @@ export declare class ArcgisVersionManagement extends LitElement {
     readonly state: "ready" | "loading" | "disabled" | "executing" | "failed" | "success";
     /**
      * This class provides functionality for managing versions in a versioned geodatabase.
-     * In the event that the Version Management component is destroyed, the VersioningStates can be utilized to maintain the current state of the Version Management Component.
-     * The Version Management Component can be reinitialized using a `Collection<VersioningState>`, or a predefined `Collection<VersioningState>` can be provided during the initial instantiation of the Version Management Component.
+     * In the event that the Version Management component is destroyed, the VersioningStates can be utilized to maintain the current state of the Version Management component.
+     * The Version Management component can be reinitialized using a `Collection<VersioningState>`, or a predefined `Collection<VersioningState>` can be provided during the initial instantiation of the Version Management component.
      */
     versioningStates: __esri.Collection<__esri.VersioningState>;
     /** Permanently destroy the component. */

package/dist/components/arcgis-version-management/customElement.js

@@ -9,7 +9,7 @@ import { m as $ } from "../../chunks/useViewModel.js";
 import { css as T } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.2 */
+v4.34.0-next.21 */
 const O = T`@layer{.arcgis-version-management{.component-container-flow{width:300px}.invalid-initial-version-notice{margin-bottom:1rem}.service-items-panel{z-index:unset!important}calcite-block{margin:0}}}`, U = $(C), I = "map-components:version-management";
 class R extends y {
   constructor() {

package/dist/components/arcgis-version-management-service-item/customElement.js

@@ -3,7 +3,7 @@ import { LitElement as U, createEvent as t, noShadowRoot as _, safeClassMap as v
 import { html as s, render as S } from "lit-html";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.2 */
+v4.34.0-next.21 */
 class F extends U {
   constructor() {
     super(...arguments), this._showInvalidVersionNotice = !0, this.arcgisCreateVersionList = t(), this.arcgisFlowItemBack = t(), this.arcgisFlowItemClose = t(), this.arcgisGetVersions = t(), this.arcgisManageVersion = t(), this.arcgisNewVersion = t();