@arcgis/map-components 4.34.0-next.5 → 4.34.0-next.50

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

@@ -27,6 +27,11 @@ declare const useSearchViewModel: (component: LitElement & Pick<SearchViewModel,
  * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-search/)
  */
 export declare class ArcgisSearch extends LitElement {
+    /**
+     * By assigning the `id` attribute of the Map or Scene component to this property, you can position a child component anywhere in the DOM while still maintaining a connection to the Map or Scene.
+     *
+     * @see [Associate components with a Map or Scene component](https://developers.arcgis.com/javascript/latest/programming-patterns/#associate-components-with-a-map-or-scene-component)
+     */
     referenceElement?: ArcgisReferenceElement | string;
     /** @default "top-left" */
     position: __esri.UIPosition;
@@ -83,6 +88,12 @@ export declare class ArcgisSearch extends LitElement {
      * displays first in the Search UI.
      */
     readonly allSources: __esri.Collection<__esri.LayerSearchSource | __esri.LocatorSearchSource>;
+    /**
+     * Indicates whether to automatically navigate to the selected result.
+     *
+     * @default false
+     */
+    autoNavigateDisabled: boolean;
     /**
      * Indicates whether to automatically select and zoom to the first geocoded result. If `false`, the
      * [findAddressCandidates](https://developers.arcgis.com/rest/geocode/api-reference/geocoding-find-address-candidates.htm)
@@ -90,9 +101,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 +128,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 +144,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 +173,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 +207,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 +226,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 +278,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,20 +291,45 @@ 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;
     /**
-     * The current state of the widget.
+     * The current state.
      *
      * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search-SearchViewModel.html#state)
      *
      * @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 { ref as d } from "lit/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 { css as x } from "lit";
 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.5 */
+v4.34.0-next.50 */
 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.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.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, 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: 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.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 || !1} .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

@@ -1,31 +1,30 @@
 import { c as d } from "../../chunks/runtime.js";
-import { html as r } from "lit-html";
-import { keyed as c } from "lit-html/directives/keyed.js";
-import { LitElement as m, createEvent as p, noShadowRoot as g, safeClassMap as a } from "@arcgis/lumina";
-import { classes as _ } from "@arcgis/components-utils";
-import { g as R } from "../../chunks/globalCss.js";
-import { css as w } from "@lit/reactive-element/css-tag.js";
+import { css as m, html as r } from "lit";
+import { keyed as c } from "lit/directives/keyed.js";
+import { LitElement as p, createEvent as g, noShadowRoot as _, safeClassMap as a } from "@arcgis/lumina";
+import { classes as R } from "@arcgis/components-utils";
+import { g as w } from "../../chunks/globalCss.js";
 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.5 */
+v4.34.0-next.50 */
 const n = "arcgis-search-result-renderer", h = {
   base: n,
   moreResults: `${n}__more-results`
-}, f = w`@layer{.arcgis-search-result-renderer calcite-block,.arcgis-search-result-renderer calcite-block[expanded]{margin-block:0;margin-block-start:var(--calcite-spacing-md);border:0}}`;
-class $ extends m {
+}, $ = m`@layer{.arcgis-search-result-renderer calcite-block,.arcgis-search-result-renderer calcite-block[expanded]{margin-block:0;margin-block-start:var(--calcite-spacing-md);border:0}}`;
+class f extends p {
   constructor() {
-    super(...arguments), this._resultCount = 0, this._showMoreResultsOpen = !1, this.autoDestroyDisabled = !1, this.arcgisReady = p();
+    super(...arguments), this._resultCount = 0, this._showMoreResultsOpen = !1, this.autoDestroyDisabled = !1, this.arcgisReady = g();
   }
   static {
     this.properties = { _results: 16, _resultCount: 16, _selectedResult: 16, _showMoreResultsOpen: 16, messages: 0, autoDestroyDisabled: 5, viewModel: 0 };
   }
   static {
-    this.styles = f;
+    this.styles = $;
   }
   static {
-    this.shadowRootOptions = g;
+    this.shadowRootOptions = _;
   }
   async destroy() {
     await this.manager.destroy();
@@ -50,7 +49,7 @@ class $ extends m {
     s && "reposition" in s && s.reposition();
   }
   render() {
-    return r`<div class=${a(_(h.base, R.widget))}>${this._selectedResult?.name ?? ""}${this._renderMoreResults()}</div>`;
+    return r`<div class=${a(R(h.base, w.widget))}>${this._selectedResult?.name ?? ""}${this._renderMoreResults()}</div>`;
   }
   _renderMoreResults() {
     const { _resultCount: e, _results: s } = this;
@@ -67,7 +66,7 @@ class $ extends m {
     return c(`result-${e.sourceIndex}-${e.key}`, r`<calcite-list-item .label=${e.name} @calciteListItemSelect=${() => this._selectResult(e)}></calcite-list-item>`);
   }
 }
-d("arcgis-search-result-renderer", $);
+d("arcgis-search-result-renderer", f);
 export {
-  $ as ArcgisSearchResultRenderer
+  f as ArcgisSearchResultRenderer
 };

package/dist/components/arcgis-shadow-cast/customElement.d.ts

@@ -27,7 +27,53 @@ declare const useShadowCastWidget: (component: LitElement & Pick<ShadowCast, "ic
     destroy: () => Promise<void>;
 }) => ShadowCast;
 /**
- * The Shadow Cast component displays the cumulative shadows of 3D features in a [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html).
+ * The Shadow Cast component displays the cumulative shadows of 3D features in a [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/).
+ * This type of analysis is helpful in urban development, where new projects have to satisfy certain shadow duration constraints.
+ *
+ * The component calculates the cumulative shadows for a time range during a single day. The user can
+ * configure the time range and select a calendar date. This time range and calendar date are only used
+ * for the shadow analysis and are not connected to the lighting in the scene.
+ * To control the lighting in the scene, the [Daylight](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-daylight/) component can be used.
+ * Changing the timezone in the component updates the visualization by interpreting the time range as being
+ * in that timezone. This behavior is different from the [Daylight](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-daylight/) component,
+ * where selecting a timezone updates the [environment lighting's](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#environment) date and time according to the camera position.
+ *
+ * The component provides three [visualization modes](#visualizationType): threshold, duration, and discrete mode.
+ *
+ * In the **threshold** mode, only the areas that receive
+ * shadows for more than a certain amount of time are displayed. In the image below, on May 1, 2021 the red areas receive
+ * shadow for more than 4 hours within the time interval of 10AM to 4PM.
+ *
+ * [![threshold mode](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/shadow-cast/shadow-cast-threshold.png)](https://developers.arcgis.com/javascript/latest/sample-code/shadow-cast/)
+ *
+ * **Total shadow duration** mode displays the duration of the cumulative shadow using opacity: areas that don't
+ * receive any shadow are fully transparent and areas that receive a maximum amount of shadow have a default opacity
+ * of 0.7. The values in between are interpolated. Hovering over the Scene will display a tooltip showing the
+ * amount of time that location is in shadow, rounded to 15-minute intervals. In this mode, the visualization
+ * can display shadow cast in a continuous way or in 1-hour intervals.
+ *
+ * [![duration mode](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/shadow-cast/shadow-cast-duration.png)](https://developers.arcgis.com/javascript/latest/sample-code/shadow-cast/)
+ *
+ * **Discrete shadows** is a third visualization mode which displays individual shadows at a given time interval.
+ * For example, setting the time range to 10AM-11AM and the visualization time interval to 30 minutes will display
+ * shadows for 10AM, 10:30AM and 11:00AM.
+ *
+ * [![discrete mode](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/shadow-cast/shadow-cast-discrete.png)](https://developers.arcgis.com/javascript/latest/sample-code/shadow-cast/)
+ *
+ * The defaults for the time range and visualization settings can be changed using the [startTimeOfDay](#startTimeOfDay), [endTimeOfDay](#endTimeOfDay), and [visualizationType](#visualizationType) properties.
+ *
+ * **Known limitations**
+ *
+ * * Shadow Cast is only supported in a 3D [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/) component.
+ * * Terrain does not cast shadows and it is therefore not taken into account in this analysis.
+ * * The component does not take into account the daylight savings.
+ * Use the timezone dropdown to adjust the offset from the Coordinated Universal Time (UTC) and account for the daylight saving time.
+ * * The timezone is automatically detected by the component based on the camera location. In some situations, this might not be accurate.
+ * In case of an inaccurate timezone, users can set it manually using the timezone dropdown.
+ *
+ * **See also**
+ *
+ * - [Sample - Shadow cast component](https://developers.arcgis.com/javascript/latest/sample-code/shadow-cast/)
  *
  * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-shadow-cast/)
  */
@@ -42,24 +88,34 @@ export declare class ArcgisShadowCast extends LitElement {
      * @default false
      */
     autoDestroyDisabled: boolean;
+    /**
+     * The calendar date used to calculate the shadow cast. This date excludes the time. If a date with a time is set, the time value will be set to midnight (`00:00:00`) of that date in local system time.
+     * If no date is set, then it defaults to the current date in local system time.
+     *
+     * _See also_
+     *
+     * * [Date](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/Date)
+     */
     get date(): Date;
     set date(value: Date | number | string);
     /**
-     * The configuration used when the widget's [visualizationType](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#visualizationType) is set to "discrete".
+     * The configuration used when the component's [visualizationType](#visualizationType)
+     * is set to "discrete".
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#discreteOptions)
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-DiscreteOptions.html)
      */
     discreteOptions: __esri.DiscreteOptions;
     /**
-     * The configuration used when the widget's [visualizationType](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#visualizationType) is set to "duration".
+     * The configuration used when the component's [visualizationType](#visualizationType)
+     * is set to "duration".
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#durationOptions)
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-DurationOptions.html)
      */
     durationOptions: __esri.DurationOptions;
     /**
-     * Time (in milliseconds from midnight of the [date](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#date)) when the shadow cast computation should stop.
+     * Time (in milliseconds from midnight of the [date](#date)) when the shadow cast computation should stop.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#endTimeOfDay)
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#endTimeOfDay)
      *
      * @default 16 * 3600 * 1000
      */
@@ -91,63 +147,69 @@ export declare class ArcgisShadowCast extends LitElement {
     /** @default false */
     hideThresholdContextToggle: boolean;
     /**
-     * Icon which represents the widget.
+     * Icon which represents the component. Typically used when the component is controlled by another component (e.g. by the Expand component).
+     *
+     * See also: [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
      *
-     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
      * @default "measure-building-height-shadow"
      */
     icon: string;
-    /**
-     * The widget's default label.
-     *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast.html#label)
-     */
+    /** The component's default label. */
     label: string;
     /** @default "bottom-left" */
     position: __esri.UIPosition;
+    /**
+     * By assigning the `id` attribute of the Map or Scene component to this property, you can position a child component anywhere in the DOM while still maintaining a connection to the Map or Scene.
+     *
+     * @see [Associate components with a Map or Scene component](https://developers.arcgis.com/javascript/latest/programming-patterns/#associate-components-with-a-map-or-scene-component)
+     */
     referenceElement?: ArcgisReferenceElement | string;
     /**
-     * Time (in milliseconds from midnight of the [date](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#date))
-     * when the shadow cast computation should start.
+     * Time (in milliseconds from midnight of the [date](#date)) when the shadow cast computation should start.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#startTimeOfDay)
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#startTimeOfDay)
      *
      * @default 10 * 3600 * 1000
      */
     startTimeOfDay: number;
     /**
-     * The current state of the view model that can be used for rendering the UI
-     * of the widget.
+     * The component's state. The values mean the following:
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#state)
+     * * `disabled` -  component is being created
+     * * `ready` - component is ready
      *
      * @default "disabled"
      */
     readonly state: "ready" | "disabled";
     /**
-     * The configuration used when the widget's [visualizationType](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#visualizationType) is set to "threshold".
+     * The configuration used when the component's [visualizationType](#visualizationType)
+     * is set to "threshold".
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#thresholdOptions)
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ThresholdOptions.html)
      */
     thresholdOptions: __esri.ThresholdOptions;
-    /**
-     * The difference in hours between UTC time and the times displayed in the widget.
-     *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#utcOffset)
-     */
+    /** The difference in hours between UTC time and the times displayed in the component. */
     utcOffset: number;
     /**
-     * Type of visualization to use when showing the shadows.
-     *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#visualizationType)
+     * Type of visualization to use when showing the shadows. There are 3 types of visualization:
+     * * `threshold` - only displays areas that receive shadows for a period longer than a given threshold value
+     * * `duration` - displays all areas that receive shadows either in a continuous mode or in 1 hour time intervals
+     * * `discrete` - displays individual shadows cast at a given time interval
      *
      * @default "threshold"
      */
     visualizationType: "duration" | "threshold" | "discrete";
     /** Permanently destroy the component. */
     destroy(): Promise<void>;
+    /**
+     * Returns the time (in milliseconds) spent in shadow for a certain point on the screen.
+     *
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#getDuration)
+     */
     getDuration(point: __esri.Point): Promise<number>;
+    /** Starts the component. While running, it will automatically perform shadow accumulation. */
     start(): Promise<void>;
+    /** Stops the component. */
     stop(): Promise<void>;
     /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
     readonly arcgisPropertyChange: TargetedEvent<this, {

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

@@ -3,10 +3,10 @@ import { usePropertyChange as i } from "@arcgis/lumina/controllers";
 import s from "@arcgis/core/widgets/ShadowCast.js";
 import { LitElement as o, createEvent as h, noShadowRoot as d } from "@arcgis/lumina";
 import { m as l } from "../../chunks/useWidget.js";
-import { css as a } from "@lit/reactive-element/css-tag.js";
+import { css as a } from "lit";
 /*! 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.5 */
+v4.34.0-next.50 */
 const r = a`@layer{arcgis-shadow-cast{display:block}}`, n = l(s);
 class m extends o {
   constructor() {

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

@@ -176,6 +176,11 @@ export declare class ArcgisSketch extends LitElement {
     polylineSymbol: __esri.SimpleLineSymbol | __esri.CIMSymbol | __esri.LineSymbol3D;
     /** @default "bottom-left" */
     position: __esri.UIPosition;
+    /**
+     * By assigning the `id` attribute of the Map or Scene component to this property, you can position a child component anywhere in the DOM while still maintaining a connection to the Map or Scene.
+     *
+     * @see [Associate components with a Map or Scene component](https://developers.arcgis.com/javascript/latest/programming-patterns/#associate-components-with-a-map-or-scene-component)
+     */
     referenceElement?: ArcgisReferenceElement | string;
     /**
      * Determines the size of widget elements.