@arcgis/map-components 4.33.0-next.110 → 4.33.0-next.112

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

@@ -10,7 +10,8 @@ type ActiveMenu = "none" | "source" | "suggestion";
 declare const useSearchViewModel: (component: LitElement & Pick<SearchViewModel, never> & import('../../controllers/useViewModel').ViewModelControllerUses<SearchViewModel>, options?: {
     editConstructorProperties(props: unknown): unknown;
 } | undefined) => SearchViewModel;
-/** The Search component provides a way to perform search operations on locator service(s), map/feature service feature layer(s), SceneLayers with an associated feature layer,
+/**
+ * The Search component provides a way to perform search operations on locator service(s), map/feature service feature layer(s), SceneLayers with an associated feature layer,
  * BuildingComponentSublayer with an associated feature layer, GeoJSONLayer, CSVLayer, OGCFeatureLayer, and/or table(s). If using a locator with a geocoding service, the
  * findAddressCandidates operation is used, whereas queries are used on feature layers.
  *
@@ -24,25 +25,38 @@ declare const useSearchViewModel: (component: LitElement & Pick<SearchViewModel,
  * However, when the scale of the MapView or SceneView is less than or equal to 300,000, the operations support prioritization of candidates based on their distance from a
  * specified point (the center of the view) by passing in the `location parameter`. Features closest to the input location show up higher in the list of results.
  * This behavior can be changed by using the localSearchDisabled property.
+ *
+ * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-search/)
  */
 export declare class ArcgisSearch extends LitElement {
     referenceElement: ArcgisReferenceElement | Nil | string;
+    /** @default "top-left" */
     position: __esri.UIPosition;
+    /**
+     * This function provides the ability to override either the
+     * [MapView goTo()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#goTo) or
+     * [SceneView goTo()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#goTo) methods.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search-SearchViewModel.html#goToOverride)
+     */
     goToOverride: nullish | __esri.GoToOverride;
     /**
      * Icon which represents the component.
      * Typically used when the component is controlled by another component (e.g. by the Expand component).
-     * Search [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/) for possible values.
+     *
+     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
+     * @default "search"
      */
     icon: string;
     /**
      * The current active menu of the Search component.
      *
+     * @default "none"
      */
     activeMenu: ActiveMenu;
     /**
      * The [source](#sources) object currently selected. Can be either a
-     * {@link module:esri/widgets/Search/LayerSearchSource} or a {@link module:esri/widgets/Search/LocatorSearchSource}.
+     * [LayerSearchSource](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search-LayerSearchSource.html) or a [LocatorSearchSource](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search-LocatorSearchSource.html).
      *
      * @default null
      */
@@ -63,12 +77,10 @@ export declare class ArcgisSearch extends LitElement {
      */
     allPlaceholder: string | nullish;
     /**
-     * The combined collection of {@link module:esri/widgets/Search/SearchViewModel#defaultSources defaultSources}
-     * and {@link module:esri/widgets/Search/SearchViewModel#sources sources}.
-     * The {@link module:esri/widgets/Search/SearchViewModel#defaultSources defaultSources}
+     * The combined collection of [defaultSources](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search-SearchViewModel.html#defaultSources)
+     * and [sources](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search-SearchViewModel.html#sources).
+     * The [defaultSources](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search-SearchViewModel.html#defaultSources)
      * displays first in the Search UI.
-     *
-     * @readonly
      */
     readonly allSources: __esri.Collection<__esri.LayerSearchSource | __esri.LocatorSearchSource>;
     /**
@@ -82,29 +94,28 @@ export declare class ArcgisSearch extends LitElement {
      */
     autoSelect: boolean;
     /**
-     * A read-only property that is a {@link module:esri/core/Collection Collection}
-     * of {@link module:esri/widgets/Search/LayerSearchSource}
-     * and/or {@link module:esri/widgets/Search/LocatorSearchSource}. This property
+     * 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)
+     * and/or [LocatorSearchSource](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search-LocatorSearchSource.html). This property
      * may contain [ArcGIS Portal](https://enterprise.arcgis.com/en/portal/)
      * [locators](http://enterprise.arcgis.com/en/server/latest/publish-services/windows/geocode-services.htm)
      * and any web map or web scene [configurable search sources](http://doc.arcgis.com/en/arcgis-online/create-maps/configure-feature-search.htm).
      * Web maps or web scenes may contain
-     * {@link module:esri/layers/MapImageLayer map}/{@link module:esri/layers/FeatureLayer feature} service feature
-     * layer(s), and/or {@link module:esri/webdoc/applicationProperties/SearchTable table(s)} as sources.
+     * [map](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-MapImageLayer.html)/[feature](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html) service feature
+     * layer(s), and/or [table(s)](https://developers.arcgis.com/javascript/latest/api-reference/esri-webdoc-applicationProperties-SearchTable.html) as sources.
      *
-     * This property is used to populate the Search UI if the {@link module:esri/widgets/Search/SearchViewModel#sources sources} property is not set.
-     *
-     * @readonly
+     * This property is used to populate the Search UI if the [sources](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search-SearchViewModel.html#sources) property is not set.
      */
     readonly defaultSources: __esri.Collection<__esri.LayerSearchSource | __esri.LocatorSearchSource>;
     /**
      * When true, the component is visually withdrawn and cannot be interacted with.
      *
+     * @default false
      */
     disabled: boolean;
     /**
-     * Indicates whether or not to include {@link module:esri/widgets/Search/SearchViewModel#defaultSources defaultSources} in the Search UI.
-     * This can be a boolean value or a function that returns an array of Search {@link module:esri/widgets/Search/SearchViewModel#sources sources}.
+     * 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
      */
@@ -148,24 +159,24 @@ export declare class ArcgisSearch extends LitElement {
      */
     minSuggestCharacters: number;
     /**
-     * Indicates whether to display the {@link module:esri/widgets/Popup} on feature click. The graphic can
-     * be clicked to display a {@link module:esri/widgets/Popup}.
+     * 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
      */
     popupEnabled: boolean;
     /**
-     * A customized {@link module:esri/PopupTemplate} for the selected feature.
-     * Note that any {@link module:esri/PopupTemplate templates}
+     * 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)
      * defined on [allSources](#allSources) take precedence over those defined directly on the template.
      *
      * @autocast
+     * @default null
      */
     popupTemplate: nullish | __esri.PopupTemplate;
     /**
      * It is possible to search a specified portal instance's [locator services](http://enterprise.arcgis.com/en/portal/latest/administer/windows/configure-portal-to-geocode-addresses.htm)
      * Use this property to set this [ArcGIS Portal](https://enterprise.arcgis.com/en/portal/) instance to search.
-     *
      */
     portal: nullish | __esri.Portal;
     /**
@@ -173,12 +184,12 @@ export declare class ArcgisSearch extends LitElement {
      *
      * :::esri-md class="panel trailer-1"
      * A graphic will be placed in the View's
-     * {@link module:esri/views/View#graphics graphics}
-     * for {@link module:esri/views/layers/LayerView layer views}
+     * [graphics](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View.html#graphics)
+     * for [layer](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-layers-LayerView.html)
      * that do not support the `highlight` method.
      * :::
      *
-     * @readonly
+     * @default null
      */
     readonly resultGraphic: nullish | __esri.Graphic;
     /**
@@ -191,7 +202,7 @@ export declare class ArcgisSearch extends LitElement {
     /**
      * An array of objects, each containing a [SearchResult](#SearchResult) from the search.
      *
-     * @readonly
+     * @default null
      */
     readonly results: nullish | __esri.SearchResults[];
     /**
@@ -214,21 +225,21 @@ export declare class ArcgisSearch extends LitElement {
      *
      * @see [Event: select-result](#event-select-result)
      * @see [select()](#select)
-     * @readonly
+     * @default null
      */
     readonly selectedResult: nullish | __esri.SearchResult;
     /**
      * The Search component may be used to search features in a
-     * {@link module:esri/layers/MapImageLayer map}/{@link module:esri/layers/FeatureLayer feature} service feature
-     * layer(s), {@link module:esri/layers/SceneLayer SceneLayers} with an associated feature layer,
-     * {@link module:esri/layers/buildingSublayers/BuildingComponentSublayer} with an associated feature layer,
-     * {@link module:esri/layers/GeoJSONLayer}, {@link module:esri/layers/CSVLayer} or
-     * {@link module:esri/layers/OGCFeatureLayer}, or {@link module:esri/webdoc/applicationProperties/SearchTable table},
-     * or geocode locations with a {@link module:esri/rest/locator}. The `sources` property defines the sources from which
+     * [map](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-MapImageLayer.html)/[feature](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html) service feature
+     * layer(s), [SceneLayers](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-SceneLayer.html) with an associated feature layer,
+     * [BuildingComponentSublayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-buildingSublayers-BuildingComponentSublayer.html) with an associated feature layer,
+     * [GeoJSONLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-GeoJSONLayer.html), [CSVLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-CSVLayer.html) or
+     * [OGCFeatureLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-OGCFeatureLayer.html), or [table](https://developers.arcgis.com/javascript/latest/api-reference/esri-webdoc-applicationProperties-SearchTable.html),
+     * or geocode locations with a [locator](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-locator.html). The `sources` property defines the sources from which
      * to search for the [view](#view) specified by the Search component instance. There are two types of sources:
      *
-     * * {@link module:esri/widgets/Search/LayerSearchSource}
-     * * {@link module:esri/widgets/Search/LocatorSearchSource}
+     * * [LayerSearchSource](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search-LayerSearchSource.html)
+     * * [LocatorSearchSource](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search-LocatorSearchSource.html)
      *
      * Any combination of these sources may be used
      * together in the same instance of the Search component.
@@ -247,6 +258,7 @@ export declare class ArcgisSearch extends LitElement {
      * 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 null
      */
     readonly suggestions: nullish | __esri.SuggestResults[];
     /**
@@ -259,53 +271,85 @@ export declare class ArcgisSearch extends LitElement {
      */
     suggestionsEnabled: 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 component to a different place on the page, or
-     * temporary hide it. If this is set, make sure to call the
-     * \`destroy\` method when you are done to prevent memory leaks.
+     * 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/arcgis-search/#destroy) method when you are done to
+     * prevent memory leaks.
+     *
+     * @default false
      */
     autoDestroyDisabled: boolean;
     /** Overwrite localized strings for this component */
     messageOverrides?: typeof this.messages._overrides;
     /** The component's default label. */
     label: Nil | string;
-    readonly state: "ready" | "disabled" | "loading" | "searching";
-    /** Permanently destroy the component */
-    destroy(): Promise<void>;
     /**
-     * Brings focus to the component's text input.
+     * The current state of the widget.
      *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search-SearchViewModel.html#state)
+     *
+     * @default "ready"
      */
+    readonly state: "ready" | "disabled" | "loading" | "searching";
+    /** Permanently destroy the component. */
+    destroy(): Promise<void>;
+    /** 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. */
     readonly arcgisPropertyChange: TargetedEvent<this, {
         name: "state";
     }>;
+    /** Emitted when the component associated with a map or scene view is is ready to be interacted with. */
     readonly arcgisReady: TargetedEvent<this, undefined>;
-    /**
-     * Fires when a result is cleared from the input box or a new result is selected.
-     */
+    /** Fires when a result is cleared from the input box or a new result is selected. */
     readonly arcgisSearchClear: TargetedEvent<this, __esri.SearchViewModelSearchClearEvent>;
-    /**
-     * Fires when the [search()](#search) method is called and returns its results.
-     */
+    /** Fires when the [search()](#search) method is called and returns its results. */
     readonly arcgisSearchComplete: TargetedEvent<this, __esri.SearchViewModelSearchCompleteEvent>;
-    /**
-     * Fires when the [search()](#search) method starts.
-     */
+    /** Fires when the [search()](#search) method starts. */
     readonly arcgisSearchStart: TargetedEvent<this, __esri.SearchViewModelSearchStartEvent>;
-    /**
-     * Fires when a search result is selected.
-     */
+    /** Fires when a search result is selected. */
     readonly arcgisSelectResult: TargetedEvent<this, __esri.SearchViewModelSelectResultEvent>;
-    /**
-     * Fires when the [suggest](#suggest) method is called and returns its results.
-     */
+    /** Fires when the [suggest](#suggest) method is called and returns its results. */
     readonly arcgisSuggestComplete: TargetedEvent<this, __esri.SearchViewModelSuggestCompleteEvent>;
-    /**
-     * Fires when the [suggest()](#suggest) method starts.
-     */
+    /** Fires when the [suggest()](#suggest) method starts. */
     readonly arcgisSuggestStart: TargetedEvent<this, __esri.SearchViewModelSuggestStartEvent>;
-    private messages;
+    private messages: Partial<{
+        componentLabel: string;
+        searchButtonTitle: string;
+        placeholder: string;
+        searchIn: string;
+        all: string;
+        allPlaceholder: string;
+        locateError: string;
+        untitledResult: string;
+        untitledSource: string;
+        noResults: string;
+        noResultsFound: string;
+        noResultsFoundForValue: string;
+        showMoreResults: string;
+        hideMoreResults: string;
+        searchResult: string;
+        moreResultsHeader: string;
+        useCurrentLocation: string;
+    }> & import('@arcgis/lumina/controllers').T9nMeta<{
+        componentLabel: string;
+        searchButtonTitle: string;
+        placeholder: string;
+        searchIn: string;
+        all: string;
+        allPlaceholder: string;
+        locateError: string;
+        untitledResult: string;
+        untitledSource: string;
+        noResults: string;
+        noResultsFound: string;
+        noResultsFoundForValue: string;
+        showMoreResults: string;
+        hideMoreResults: string;
+        searchResult: string;
+        moreResultsHeader: string;
+        useCurrentLocation: string;
+    }>;
 }
 export {};

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

@@ -12,11 +12,11 @@ import { render as R, html as i } 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 { u as T } from "../../chunks/useView.js";
 import { watch as A } from "@arcgis/core/core/reactiveUtils.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.110 */
+v4.33.0-next.112 */
 const u = "arcgis-search", h = {
   base: u,
   autocomplete: `${u}__autocomplete`,
@@ -31,7 +31,7 @@ class L extends v {
     }, 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;
   }
   static {
-    this.properties = { _locateFailed: 16, _showNoResults: 16, _isDisabled: 16, _showCurrentLocation: 16, _effectiveActiveMenu: 16, referenceElement: 1, position: 3, goToOverride: 0, icon: 3, 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, 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 };
   }
   static {
     this.styles = N;
@@ -49,49 +49,23 @@ class L extends v {
   get _effectiveActiveMenu() {
     return this._isDisabled ? "none" : this.activeMenu;
   }
-  /**
-   * The [source](#sources) object currently selected. Can be either a
-   * {@link module:esri/widgets/Search/LayerSearchSource} or a {@link module:esri/widgets/Search/LocatorSearchSource}.
-   *
-   * @default null
-   */
   get activeSource() {
     return this.viewModel?.activeSource;
   }
-  //#endregion
-  //#region Public Methods
-  /** Permanently destroy the component */
   async destroy() {
     await this.manager.destroy(), await this._searchResultRendererEl?.destroy(), this._cancelQueries();
   }
-  /**
-   * Brings focus to the component's text input.
-   *
-   */
   async setFocus() {
     await this._autocompleteEl?.setFocus();
   }
-  //#endregion
-  //#region Lifecycle
   loaded() {
     this._addSearchResultRenderer(), this.manager.onLifecycle(() => A(() => this.viewModel?.defaultPopupTemplate, (e) => {
       e && (e.content = this._renderSearchResultsContent);
     }, { initial: !0 }));
   }
-  //#endregion
-  //#region Private Methods
-  /**
-   * Clears the current searchTerm, search results, suggest results, graphic, and graphics layer.
-   * It also hides any open menus.
-   */
   clear() {
     this._locateFailed = !1, this.viewModel.clear();
   }
-  /**
-   * Depending on the sources specified, search() queries the feature layer(s) and/or performs
-   * address matching using any specified {@link module:esri/rest/locator locator(s)} and
-   * returns any applicable results.
-   */
   async search(e) {
     this._cancelQueries();
     const t = new AbortController(), { signal: s } = t;
@@ -106,15 +80,6 @@ class L extends v {
       return;
     }
   }
-  /**
-   * 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`.
-   */
   async suggest(e) {
     this._cancelSuggest();
     const t = new AbortController(), { signal: s } = t;
@@ -192,8 +157,6 @@ class L extends v {
     const { messages: t } = this, { allSources: s } = this.viewModel, r = s.at(e);
     return (e === -1 ? t.all : r?.name || t.untitledSource) || "";
   }
-  //#endregion
-  //#region Rendering
   render() {
     return i`<div class=${c(M(h.base, C.widget))}><div class=${c(h.container)}>${this._renderSourcesMenu()}${this._renderForm()}</div></div>`;
   }

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

@@ -4,21 +4,27 @@ import { ArcgisSearch } from '../arcgis-search/customElement.js';
 import { JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { Nil } from '@arcgis/components-utils';
 
-/** The `SearchResultRenderer` renders the Search component results and allows expanding a DOM element to show alternative matches.
+/**
+ * The `SearchResultRenderer` renders the Search component results and allows expanding a DOM element to show alternative matches.
  * These alternative matches appear in the Show more results link.
+ *
+ * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-search-result-renderer/)
  */
 export declare class ArcgisSearchResultRenderer extends LitElement {
     messages: ArcgisSearch["messages"] | Nil;
     /**
-     * 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
-     * temporary hide it. If this is set, make sure to call the
-     * \`destroy\` method when you are done to prevent memory leaks.
+     * 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/arcgis-search-result-renderer/#destroy) method when you are done to
+     * prevent memory leaks.
+     *
+     * @default false
      */
     autoDestroyDisabled: boolean;
     viewModel: Nil | SearchViewModel;
-    /** Permanently destroy the component */
+    /** Permanently destroy the component. */
     destroy(): Promise<void>;
+    /** Emitted when the component associated with a map or scene view is is ready to be interacted with. */
     readonly arcgisReady: TargetedEvent<this, undefined>;
 }

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

@@ -7,7 +7,7 @@ import { css as $ } from "@lit/reactive-element/css-tag.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.33/esri/copyright.txt for details.
-v4.33.0-next.110 */
+v4.33.0-next.112 */
 const i = "arcgis-search-result-renderer", o = {
   base: i,
   showMoreResults: `${i}__more-results--show-more-results`,
@@ -29,14 +29,9 @@ class b extends M {
   static {
     this.shadowRootOptions = g;
   }
-  //#endregion
-  //#region Public Methods
-  /** Permanently destroy the component */
   async destroy() {
     await this.manager.destroy();
   }
-  //#endregion
-  //#region Lifecycle
   loaded() {
     this.manager.onLifecycle(() => [
       d(() => [this.viewModel?.results, this.viewModel?.resultCount], () => {
@@ -45,8 +40,6 @@ class b extends M {
       d(() => this.viewModel?.selectedResult, (e) => this._selectedResult = e, { initial: !0 })
     ]);
   }
-  //#endregion
-  //#region Private Methods
   _showMoreResultsClick(e) {
     e.preventDefault(), this._showMoreResultsOpen = !this._showMoreResultsOpen;
     const s = this.viewModel?.view?.popup;
@@ -58,8 +51,6 @@ class b extends M {
   _getSourceName(e, s) {
     return s === -1 ? this.messages?.all ?? "" : e.name;
   }
-  //#endregion
-  //#region Rendering
   render() {
     const e = {
       [o.showMoreResults]: this._showMoreResultsOpen

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

@@ -28,50 +28,128 @@ declare const useShadowCastWidget: (component: LitElement & Pick<ShadowCast, nev
 }, options?: {
     editConstructorProperties(props: __esri.ShadowCastProperties | undefined): __esri.ShadowCastProperties | Promise<__esri.ShadowCastProperties | undefined> | undefined;
 } | undefined) => ShadowCast;
-/** ShadowCast component displays the cumulative shadows of 3D features in a [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html).
+/**
+ * ShadowCast component displays the cumulative shadows of 3D features in a [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html).
+ *
+ * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-shadow-cast/)
  */
 export declare class ArcgisShadowCast extends LitElement {
     /**
      * 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\` method when you are done to prevent
-     * memory leaks.
+     * is set, make sure to call the [destroy](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-shadow-cast/#destroy) method when you are done to
+     * prevent memory leaks.
+     *
+     * @default false
      */
     autoDestroyDisabled: boolean;
+    /**
+     * 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".
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#discreteOptions)
+     */
     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".
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#durationOptions)
+     */
     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.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#endTimeOfDay)
+     *
+     * @default 16 * 3600 * 1000
+     */
     endTimeOfDay: number;
+    /**
+     * Indicates the heading level to use for the titles "Time range" and "Visualization".
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast.html#headingLevel)
+     *
+     * @default 4
+     */
     headingLevel: number;
+    /** @default false */
     hideColorPicker: boolean;
+    /** @default false */
     hideDatePicker: boolean;
+    /** @default false */
     hideTimeRangeSlider: boolean;
+    /** @default false */
     hideTimezone: boolean;
+    /** @default false */
     hideTooltip: boolean;
+    /** @default false */
     hideVisualizationOptions: boolean;
     /**
-     * Icon which represents the component.
-     * Typically used when the component is controlled by another component (e.g. by the Expand component).
-     * Search [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/) for possible values.
+     * Icon which represents the widget.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast.html#icon)
+     *
+     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
+     * @default "measure-building-height-shadow"
      */
     icon: string;
-    /** The component's default label. */
+    /**
+     * The widget's default label.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast.html#label)
+     */
     label: string;
+    /** @default "bottom-left" */
     position: __esri.UIPosition;
     referenceElement: ArcgisReferenceElement | Nil | 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.
+     *
+     * [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.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#state)
+     *
+     * @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".
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#thresholdOptions)
+     */
     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)
+     */
     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)
+     *
+     * @default "threshold"
+     */
     visualizationType: "duration" | "threshold" | "discrete";
-    /** Permanently destroy the component */
+    /** Permanently destroy the component. */
     destroy(): Promise<void>;
     getDuration(point: __esri.Point): Promise<number>;
     start(): Promise<void>;
     stop(): Promise<void>;
+    /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
     readonly arcgisPropertyChange: TargetedEvent<this, {
         name: "state";
     }>;
+    /** Emitted when the component associated with a map or scene view is is ready to be interacted with. */
     readonly arcgisReady: TargetedEvent<this, undefined>;
 }
 export {};