@esri/solutions-components 1.0.0-next.20250501.2 → 1.0.0-next.20250506

package/dist/components/map-picker/customElement.js

@@ -6,7 +6,7 @@ import { LitElement as c, createEvent as o, 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/1.0/esri/copyright.txt for details.
-v1.0.0-next.20250501.2 */
+v1.0.0-next.20250506 */
 const m = h`/** @license
  * Copyright 2025 Esri
  *
@@ -35,87 +35,41 @@ class f extends c {
   willUpdate(e) {
     e.has("mapInfos") && (this.hasUpdated || this.mapInfos?.length > 0) && this.mapInfosWatchHandler(this.mapInfos, e.get("mapInfos"));
   }
-  //--------------------------------------------------------------------------
-  //
-  //  Watch handlers
-  //
-  //--------------------------------------------------------------------------
-  /** Called each time the _webMapInfo prop is changed. */
   _webMapInfoWatchHandler(e, t) {
     e && JSON.stringify(e) !== JSON.stringify(t) && (this._loadedId = e?.id, this.mapInfoChange.emit(e));
   }
-  /** Called each time the mapInfos prop is changed. */
   async mapInfosWatchHandler(e, t) {
     e && JSON.stringify(e) !== JSON.stringify(t) && this._webMapSelected(e[0]);
   }
-  //--------------------------------------------------------------------------
-  //
-  //  Methods (public)
-  //
-  //--------------------------------------------------------------------------
   async setMapByID(e, t = !1) {
     this._skipEditCheck = t;
     const i = this.mapInfos?.filter((a) => a.id === e);
     e && i?.length > 0 && this._webMapSelected(i[0]), this._skipEditCheck = !1;
   }
-  /** Closes the list */
   async close() {
     this._mapListExpanded && (this._mapListExpanded = !1);
   }
-  /** Expands the list */
   async toggle(e) {
     this._mapListExpanded = e;
   }
-  /** Renders the component. */
   render() {
     return s`${this._getToolbar()}${this._getMapNameList(this._mapListExpanded)}`;
   }
-  /** Called once after the component has loaded */
   loaded() {
     const e = this.mapInfos && this.mapInfos.length > 0 ? this.mapInfos[0] : void 0;
     e && this._webMapSelected(e);
   }
-  //--------------------------------------------------------------------------
-  //
-  //  Functions (protected)
-  //
-  //--------------------------------------------------------------------------
-  /**
-   * Get a calcite action group for the map list
-   * Actions do not support multiple icons so this uses a block
-   *
-   * @returns the dom node for the action group
-   * @protected
-   */
   _getMapPicker() {
     const e = "map-picker-expand-toggle", t = this._mapListExpanded ? "chevron-up" : "chevron-down";
     return s`<div class="width-full"><calcite-button alignment=icon-end-space-between appearance=transparent class="width-full height-full" .iconEnd=${t} icon-start=map id=${e} kind=neutral @click=${() => this._chooseMap()} width=full>${this._webMapInfo?.name}</calcite-button><calcite-tooltip placement=bottom .referenceElement=${e}><span>${this._translations.switchMap}</span></calcite-tooltip></div>`;
   }
-  /**
-   * Create the toolbar (controls used for map and app interactions)
-   *
-   * @returns The dom node with the toolbar
-   * @protected
-   */
   _getToolbar() {
     return s`<div class="display-flex border-right"><calcite-action-bar class="border-bottom-1 action-bar-size" expand-disabled layout=horizontal slot=header>${this._getMapPicker()}</calcite-action-bar></div>`;
   }
-  /**
-   * Get a pick list for all maps in mapInfos
-   *
-   * @param show boolean to indicate if the list should be shown or hidden
-   * @returns the dom node for the list of maps
-   * @protected
-   */
   _getMapNameList(e) {
     const t = this.isMapLayout ? "width-26" : "width-full", i = e ? `map-list border-bottom-1 adjusted-height ${t}` : "display-none";
     return s`<div class=${p(i)}><calcite-list id=mapList label selection-appearance=border selection-mode=single ${d(this._list)}>${this.mapInfos.map((a) => s`<calcite-list-item .label=${a.name} @click=${() => this._webMapSelected(a)} .selected=${a.id === this._loadedId} .value=${a.id}></calcite-list-item>`)}</calcite-list></div>`;
   }
-  /**
-   * Fired when the user clicks on the map list
-   *
-   * @param webMapInfo the web map id and name selected from the list
-   */
   _webMapSelected(e) {
     const t = this._loadedId;
     this._loadedId = e.id;
@@ -126,12 +80,6 @@ class f extends c {
       ref: this.el
     }).defaultPrevented || (i = !0), i && (this._webMapInfoWatchHandler(e, this._webMapInfo), this._webMapInfo = e), this._mapListExpanded = !1;
   }
-  /**
-   * Toggles the open/close state of the map list
-   *
-   * @returns the dom node for the action group
-   * @protected
-   */
   _chooseMap() {
     this._mapListExpanded = !this._mapListExpanded;
   }

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

@@ -7,15 +7,25 @@ import { PublicLitElement as LitElement, TargetedEvent, JsxNode } from '@arcgis/
 export declare class MapSearch extends LitElement {
     /** esri/views/MapView: https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html */
     mapView: __esri.MapView | undefined;
-    /** boolean: When true the selected feature popup will be shown when serach result is found */
+    /**
+     * boolean: When true the selected feature popup will be shown when serach result is found
+     *
+     * @default false
+     */
     popupEnabled: boolean;
-    /** boolean: When true a graphic will be added for the search result */
+    /**
+     * boolean: When true a graphic will be added for the search result
+     *
+     * @default false
+     */
     resultGraphicEnabled: boolean;
     /** ISearchConfiguration: Configuration details for the Search widget */
     searchConfiguration: ISearchConfiguration | undefined;
     /**
      * string: Text entered by the end user.
      * Used to search against the locator.
+     *
+     * @default ''
      */
     searchTerm: string;
     /** esri/widgets/Search: https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search.html */

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

@@ -6,7 +6,7 @@ import { LitElement as f } from "@arcgis/lumina";
 import { css as y } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/1.0/esri/copyright.txt for details.
-v1.0.0-next.20250501.2 */
+v1.0.0-next.20250506 */
 const S = y`/** @license
  * Copyright 2025 Esri
  *
@@ -32,56 +32,26 @@ class g extends f {
   static {
     this.styles = S;
   }
-  /** TODO: [MIGRATION] Consider inlining some of the watch functions called inside of this method to reduce boilerplate code */
   willUpdate(e) {
     e.has("searchConfiguration") && this.watchSearchConfigurationHandler(), e.has("mapView") && this.mapViewWatchHandler();
   }
-  //--------------------------------------------------------------------------
-  //
-  //  Watch handlers
-  //
-  //--------------------------------------------------------------------------
-  /**
-   * Called each time the searchConfiguration prop is changed.
-   *
-   * @returns Promise when complete
-   */
   async watchSearchConfigurationHandler() {
     this._initSearchWidget();
   }
-  /**
-   * Called each time the mapView prop is changed.
-   *
-   * @returns Promise when complete
-   */
   async mapViewWatchHandler() {
     await this.mapView?.when(() => {
       this._initSearchWidget();
     });
   }
-  /** Called once just after the component is first connected to the DOM. */
   async load() {
     await this._initModules();
   }
-  /** Called once just after the component is fully loaded and the first render() occurs. */
   loaded() {
     return this._initSearchWidget();
   }
-  /** Renders the component. */
   render() {
     return p`<div class="search-widget" ${m(this._searchElement)}></div>`;
   }
-  //--------------------------------------------------------------------------
-  //
-  //  Functions (protected)
-  //
-  //--------------------------------------------------------------------------
-  /**
-   * Load esri javascript api modules
-   *
-   * @returns Promise resolving when function is done
-   * @protected
-   */
   async _initModules() {
     const [e, r] = await d([
       "esri/widgets/Search",
@@ -89,11 +59,6 @@ class g extends f {
     ]);
     this.Search = e, this.FeatureLayer = r;
   }
-  /**
-   * Initialize the search widget
-   *
-   * @protected
-   */
   _initSearchWidget() {
     if (this.mapView && this._searchElement.value && !this.searchWidget) {
       let e = {
@@ -107,18 +72,11 @@ class g extends f {
     } else
       this.searchWidget && (this.searchWidget.view = this.mapView);
   }
-  /**
-   * Initialize the search widget based on user defined configuration
-   *
-   * @param searchConfiguration search configuration defined by the user
-   * @param view the current map view
-   * @protected
-   */
   _getSearchConfig(e, r) {
     const o = "includeDefaultSources", a = e.sources;
     return a && a?.length > 0 ? (e[o] = !1, a.forEach((t) => {
       if (t.hasOwnProperty("layer")) {
-        const i = t, s = i.layer?.id, c = s ? r.map.findLayerById(s) : null, h = i?.layer?.url;
+        const i = t, s = i.layer?.id, c = s ? r.map?.findLayerById(s) : null, h = i?.layer?.url;
         c ? i.layer = c : h && this.FeatureLayer && (i.layer = new this.FeatureLayer(h));
       }
     }), a?.forEach((t) => {

package/dist/components/map-select-tools/customElement.d.ts

@@ -11,22 +11,46 @@ export declare class MapSelectTools extends LitElement {
     bufferColor: any;
     /** string | number[] | object with r, g, b, a: https://developers.arcgis.com/javascript/latest/api-reference/esri-Color.html */
     bufferOutlineColor: any;
-    /** boolean: When true the user can define a name for each notification list */
+    /**
+     * boolean: When true the user can define a name for each notification list
+     *
+     * @default false
+     */
     customLabelEnabled: boolean;
     /**
      * string[]: Optional list of enabled layer ids
      *  If empty all layers will be available
      */
     enabledLayerIds: string[];
-    /** boolean: When true users will be allowed to optionally use features from a layer as the selection geometry */
+    /**
+     * boolean: When true users will be allowed to optionally use features from a layer as the selection geometry
+     *
+     * @default true
+     */
     enableLayerFeatures: boolean;
-    /** boolean: When true the use features from a layer options will be enabled when the component loads */
+    /**
+     * boolean: When true the use features from a layer options will be enabled when the component loads
+     *
+     * @default false
+     */
     enableLayerFeaturesOnLoad: boolean;
-    /** boolean: When true users will be allowed to optionally create a buffer around the selection geometry */
+    /**
+     * boolean: When true users will be allowed to optionally create a buffer around the selection geometry
+     *
+     * @default true
+     */
     enableSearchDistance: boolean;
-    /** boolean: When true the serach distance options will be enabled when the component loads */
+    /**
+     * boolean: When true the serach distance options will be enabled when the component loads
+     *
+     * @default false
+     */
     enableSearchDistanceOnLoad: boolean;
-    /** boolean: When true sketch tools will be provided to allow users to draw a selection geometry */
+    /**
+     * boolean: When true sketch tools will be provided to allow users to draw a selection geometry
+     *
+     * @default true
+     */
     enableSketchTools: boolean;
     /** number: The default value to show for the buffer distance */
     defaultBufferDistance: number | undefined;
@@ -34,7 +58,11 @@ export declare class MapSelectTools extends LitElement {
     defaultBufferUnit: DistanceUnit | undefined;
     /** esri/geometry: https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry.html */
     geometries: __esri.Geometry[];
-    /** boolean: When true a new label is not generated for the stored selection set */
+    /**
+     * boolean: When true a new label is not generated for the stored selection set
+     *
+     * @default false
+     */
     isUpdate: boolean;
     /** esri/views/layers/FeatureLayerView: https://developers.arcgis.com/javascript/latest/api-reference/esri-views-layers-FeatureLayerView.html */
     layerViews: __esri.FeatureLayerView[];
@@ -43,6 +71,8 @@ export declare class MapSelectTools extends LitElement {
     /**
      * string: The value to show for no results
      * when left empty the default text "0 selected features from {layerTitle}" will be shown
+     *
+     * @default ''
      */
     noResultText: string;
     /** ISearchConfiguration: Configuration details for the Search widget */
@@ -62,9 +92,17 @@ export declare class MapSelectTools extends LitElement {
     sketchPointSymbol: __esri.SimpleMarkerSymbol | undefined;
     /** esri/symbols/SimpleFillSymbol | JSON representation: https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-SimpleFillSymbol.html */
     sketchPolygonSymbol: __esri.SimpleFillSymbol | undefined;
-    /** boolean: when true buffer tools controls are enabled */
+    /**
+     * boolean: when true buffer tools controls are enabled
+     *
+     * @default false
+     */
     searchDistanceEnabled: boolean;
-    /** boolean: when true drawn graphics will be used to select features */
+    /**
+     * boolean: when true drawn graphics will be used to select features
+     *
+     * @default false
+     */
     useLayerFeaturesEnabled: boolean;
     /**
      * Clear any selection results