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

package/dist/components/map-draw-tools/customElement.js

@@ -9,7 +9,7 @@ import { LitElement as f, createEvent as h, noShadowRoot as y, safeClassMap as o
 import { css as k } 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.1 */
 const w = k`@layer{/** @license
  * Copyright 2025 Esri
  *
@@ -38,80 +38,34 @@ class _ extends f {
   static {
     this.shadowRootOptions = y;
   }
-  /** TODO: [MIGRATION] Consider inlining some of the watch functions called inside of this method to reduce boilerplate code */
   willUpdate(e) {
     e.has("graphics") && this.graphicsWatchHandler(this.graphics, e.get("graphics")), e.has("mapView") && this.mapView && this.mapViewWatchHandler(this.mapView, e.get("mapView"));
   }
-  //--------------------------------------------------------------------------
-  //
-  //  Watch handlers
-  //
-  //--------------------------------------------------------------------------
-  /** Called each time the graphics prop is changed. */
   graphicsWatchHandler(e, t) {
     e && e.length > 0 && JSON.stringify(e) !== JSON.stringify(t) && this._sketchGraphicsLayer && (this._updateGraphicsSymbols(e), this._sketchGraphicsLayer.removeAll(), this._sketchGraphicsLayer.addMany(e));
   }
-  /** Called each time the mapView prop is changed. */
   mapViewWatchHandler(e, t) {
     e && e !== t && this._init();
   }
-  //--------------------------------------------------------------------------
-  //
-  //  Methods (public)
-  //
-  //--------------------------------------------------------------------------
-  /**
-   * Clears the user drawn graphics
-   *
-   * @returns Promise that resolves when the operation is complete
-   */
   async clear() {
     this._clearSketch();
   }
-  /**
-   * Set the sketch widget to update mode with the current graphic
-   *
-   * @returns Promise that resolves when the operation is complete
-   */
   async updateGraphics() {
     this._updateGraphics();
   }
-  /**
-   * Called once just after the component is first connected to the DOM.
-   *
-   * @returns Promise when complete
-   */
   async load() {
     await this._initModules();
   }
-  /**
-   * Called once just after the component is fully loaded and the first render() occurs.
-   *
-   * @returns Promise when complete
-   */
   loaded() {
     this._init();
   }
-  /** Called every time the component is disconnected from the DOM */
   disconnectedCallback() {
     super.disconnectedCallback(), this._sketchWidget?.cancel(), this._clearSketch();
   }
-  /** Renders the component. */
   render() {
     const e = this.drawMode === s.SKETCH ? "border" : "border esri-widget esri-sketch__panel", t = this.drawMode === s.SKETCH ? "display-none" : "esri-widget esri-sketch__panel border-left esri-sketch__section";
     return p`<div class=${o(e)}><div ${m(this._sketchElement)}></div><div class=${o(t)}><calcite-action .disabled=${!this.undoEnabled} icon=undo @click=${() => this._undo()} scale=s .text=${this._translations.undo}></calcite-action><calcite-action .disabled=${!this.redoEnabled} icon=redo @click=${() => this._redo()} scale=s .text=${this._translations.redo}></calcite-action></div></div>`;
   }
-  //--------------------------------------------------------------------------
-  //
-  //  Functions (protected)
-  //
-  //--------------------------------------------------------------------------
-  /**
-   * Load esri javascript api modules
-   *
-   * @returns Promise resolving when function is done
-   * @protected
-   */
   async _initModules() {
     const [e, t, i] = await c([
       "esri/layers/GraphicsLayer",
@@ -120,20 +74,9 @@ class _ extends f {
     ]);
     this.GraphicsLayer = e, this.Sketch = t, this.SketchViewModel = i;
   }
-  /**
-   * Initialize the graphics layer and the tools that support creating new graphics
-   *
-   * @protected
-   */
   _init() {
     this.mapView && this._sketchElement.value && (this._initGraphicsLayer(), this._initSketch());
   }
-  /**
-   * Initialize the graphics layer
-   *
-   * @returns Promise when the operation has completed
-   * @protected
-   */
   _initGraphicsLayer() {
     const e = this._translations.sketchLayer;
     if (this.mapView) {
@@ -141,11 +84,6 @@ class _ extends f {
       t > -1 ? this._sketchGraphicsLayer = this.mapView.map.layers.getItemAt(t) : (this._sketchGraphicsLayer = this.GraphicsLayer && new this.GraphicsLayer({ title: e, listMode: "hide" }), this._sketchGraphicsLayer && (d.managedLayers[e] = "sketch", this.mapView.map.layers.add(this._sketchGraphicsLayer))), this.graphics && this.graphics.length > 0 && this._sketchGraphicsLayer && this._sketchGraphicsLayer.addMany(this.graphics);
     }
   }
-  /**
-   * Initialize the skecth widget
-   *
-   * @protected
-   */
   _initSketch() {
     const e = {
       layer: this._sketchGraphicsLayer,
@@ -216,37 +154,15 @@ class _ extends f {
       }));
     }
   }
-  /**
-   * Clear any stored graphics and remove all graphics from the graphics layer
-   *
-   * @protected
-   */
   _clearSketch() {
     this._sketchWidget?.viewModel.cancel(), this.graphics = [], this._sketchGraphicsLayer?.removeAll();
   }
-  /**
-   * Emit the undo event
-   *
-   * @protected
-   */
   _undo() {
     this.drawUndo.emit();
   }
-  /**
-   * Emit the undo event
-   *
-   * @protected
-   */
   _redo() {
     this.drawRedo.emit();
   }
-  /**
-   * Set the sketch widget to update mode with the current graphic
-   *
-   * reshape tool only supports a single graphic
-   *
-   * @protected
-   */
   _updateGraphics() {
     setTimeout(() => {
       this.graphics.length === 1 && this._sketchWidget && this._sketchWidget.update(this.graphics, {
@@ -258,15 +174,6 @@ class _ extends f {
       });
     }, 100);
   }
-  /**
-   * Any time graphics are added update the symbology so they will always be consistent
-   * regardless of where they are from.
-   * https://github.com/Esri/solutions-components/issues/246
-   *
-   * reshape tool only supports a single graphic
-   *
-   * @protected
-   */
   _updateGraphicsSymbols(e) {
     const i = e[0]?.geometry?.type, a = i === "point" ? this.pointSymbol : i === "polyline" ? this.polylineSymbol : i === "polygon" ? this.polygonSymbol : void 0;
     a && e.forEach((r) => r.symbol = a);

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

@@ -6,7 +6,7 @@ import { LitElement as r, createEvent as c } from "@arcgis/lumina";
 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.1 */
 const o = h`/** @license
  * Copyright 2025 Esri
  *
@@ -32,66 +32,30 @@ class d extends r {
   static {
     this.styles = o;
   }
-  /** TODO: [MIGRATION] Consider inlining some of the watch functions called inside of this method to reduce boilerplate code */
   willUpdate(e) {
     e.has("mapView") && this.mapViewWatchHandler();
   }
-  //--------------------------------------------------------------------------
-  //
-  //  Watch handlers
-  //
-  //--------------------------------------------------------------------------
-  /**
-   * Called each time the mapView prop is changed.
-   *
-   * @returns Promise when complete
-   */
   async mapViewWatchHandler() {
     await this.mapView?.when(async () => {
       await this._initFullscreenWidget();
     });
   }
-  /** Called once just after the component is first connected to the DOM. */
   async load() {
     await this._initModules();
   }
-  /** Renders the component. */
   render() {
     return l`<div class="fullscreen-widget" ${a(this._fullscreenElement)}></div>`;
   }
-  /**
-   * Called just after the component updates.
-   * It's never called during the first render().
-   */
-  /** This lifecycle method is not expected to return a promise. The returned promise will be ignored by Lit rather than awaited. */
   async updated() {
     this.hasUpdated || await this._initFullscreenWidget();
   }
-  /** Called once just after the component is fully loaded and the first render() occurs. */
-  /** This lifecycle method is not expected to return a promise. The returned promise will be ignored by Lit rather than awaited. */
   async loaded() {
     await this._initFullscreenWidget();
   }
-  //--------------------------------------------------------------------------
-  //
-  //  Functions (protected)
-  //
-  //--------------------------------------------------------------------------
-  /**
-   * Load esri javascript api modules
-   *
-   * @returns Promise resolving when function is done
-   * @protected
-   */
   async _initModules() {
     const [e, i] = await s(["esri/widgets/Fullscreen", "esri/core/reactiveUtils"]);
     this.Fullscreen = e, this.reactiveUtils = i;
   }
-  /**
-   * Initialize the search widget
-   *
-   * @protected
-   */
   async _initFullscreenWidget() {
     this.mapView && this._fullscreenElement.value && !this.fullscreenWidget ? (this.fullscreenWidget = this.Fullscreen && new this.Fullscreen({
       view: this.mapView

package/dist/components/map-layer-picker/customElement.d.ts

@@ -5,11 +5,23 @@ import { PropertyValues } from 'lit';
 import { PublicLitElement as LitElement, TargetedEvent, JsxNode } from '@arcgis/lumina';
 
 export declare class MapLayerPicker extends LitElement {
-    /** "transparent" | "solid": controls the button appearance when using the "dropdown" type */
+    /**
+     * "transparent" | "solid": controls the button appearance when using the "dropdown" type
+     *
+     * @default 'transparent'
+     */
     appearance: 'solid' | 'transparent';
-    /** string: when provided this layer ID will be used when the app loads */
+    /**
+     * string: when provided this layer ID will be used when the app loads
+     *
+     * @default ''
+     */
     defaultLayerId: string;
-    /** "inline-flex" | "inline-block": controls the display style of the dropdown */
+    /**
+     * "inline-flex" | "inline-block": controls the display style of the dropdown
+     *
+     * @default 'inline-block'
+     */
     display: 'inline-block' | 'inline-flex';
     /**
      * string[]: Optional list of enabled layer ids
@@ -26,28 +38,58 @@ export declare class MapLayerPicker extends LitElement {
      * Specified as pixel height.
      */
     height: number | undefined;
-    /** When true the component will render an optimized view for mobile devices */
+    /**
+     * When true the component will render an optimized view for mobile devices
+     *
+     * @default false
+     */
     isMobile: boolean;
     /** esri/views/View: https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html */
     mapView: __esri.MapView | undefined;
-    /** boolean: When true only editable layers that support the update capability will be available */
+    /**
+     * boolean: When true only editable layers that support the update capability will be available
+     *
+     * @default false
+     */
     onlyShowUpdatableLayers: boolean;
-    /** string: optional placeholder icon used with "combobox" type */
+    /**
+     * string: optional placeholder icon used with "combobox" type
+     *
+     * @default ''
+     */
     placeholderIcon: string;
     /** string[]: list of layer ids that have been selected by the end user */
     selectedIds: string[];
-    /** "s" | "m" | "l": scale to render the component */
+    /**
+     * "s" | "m" | "l": scale to render the component
+     *
+     * @default 'm'
+     */
     scale: 'l' | 'm' | 's';
-    /** boolean: when true standalone tables will also be available */
+    /**
+     * boolean: when true standalone tables will also be available
+     *
+     * @default false
+     */
     showTables: boolean;
-    /** boolean: when true table will shown as disabled */
+    /**
+     * boolean: when true table will shown as disabled
+     *
+     * @default false
+     */
     showTablesDisabled: boolean;
     /**
      * boolean: when true a map with a single layer will show a label rather than a dropdown
      * Used in conjunction with _hasMultipleLayers
+     *
+     * @default false
      */
     showSingleLayerAsLabel: boolean;
-    /** "select" | "combobox" | "dropdown": type of component to leverage */
+    /**
+     * "select" | "combobox" | "dropdown": type of component to leverage
+     *
+     * @default 'select'
+     */
     type: 'combobox' | 'dropdown' | 'select';
     /** Set the layer by id */
     setLayerById(id: string, skipEditCheck?: boolean): Promise<void>;

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

@@ -8,7 +8,7 @@ import { LitElement as f, createEvent as r, noShadowRoot as L, safeStyleMap as y
 import { css as w } 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.1 */
 const I = w`@layer{/** @license
  * Copyright 2025 Esri
  *
@@ -37,128 +37,60 @@ class v extends f {
   static {
     this.shadowRootOptions = L;
   }
-  /** TODO: [MIGRATION] Consider inlining some of the watch functions called inside of this method to reduce boilerplate code */
   willUpdate(e) {
     e.has("mapView") && this.mapViewWatchHandler(), e.has("type") && (this._layerElement = this.type === "select" ? this._layerSelectElement : this._layerComboboxElement);
   }
-  //--------------------------------------------------------------------------
-  //
-  //  Watch handlers
-  //
-  //--------------------------------------------------------------------------
-  /** Called each time the mapView prop is changed. */
   async mapViewWatchHandler() {
     await this._setLayers(), this.ids?.length > 0 ? (this._hasValidLayers = !0, this._hasMultipleLayers = this.ids.length > 1, this._setSelectedLayer(this.ids[0])) : (this._hasValidLayers = !1, this.noLayersFound.emit());
   }
-  //--------------------------------------------------------------------------
-  //
-  //  Methods (public)
-  //
-  //--------------------------------------------------------------------------
-  /** Set the layer by id */
   async setLayerById(e, t = !1) {
     this._skipEditCheck = t, !t || t && e !== this.selectedIds[0] ? this._setSelectedLayer(e) : t && e === this.selectedIds[0] && (this.force = !0, setTimeout(() => {
       this.force = !1;
     }, 10)), this._skipEditCheck = !1;
   }
-  /** Set the layers by ids */
   async setLayerByIds(e, t = !1) {
     this._skipEditCheck = t, this._layerSelectionChange(e), this._skipEditCheck = !1;
   }
-  /** updates the layers */
   async updateLayer() {
     await this._setSelectedLayer(this.ids[0]);
   }
-  /** Called once just after the component is first connected to the DOM. */
   async load() {
     await this._setLayers();
   }
-  /** Renders the component. */
   render() {
     const e = "map-layer-picker";
     let t = this.height && this.height > 0 ? { height: `${this.height.toString()}px` } : {};
     return t = { ...t, display: this.display }, a`<div class="map-layer-picker-container" style=${y(t)}><div class="map-layer-picker" style=${y(t)}>${this._hasValidLayers ? !this._hasMultipleLayers && this.showSingleLayerAsLabel ? this._getSingleLayerPlaceholder() : this.type === "combobox" ? this._getCombobox(e) : this.type === "select" ? this._getSelect(e) : this._getDropdown(e) : this._getInvalidPlaceholder()}</div></div>`;
   }
-  /** Called once just after the component is fully loaded and the first render() occurs. */
   loaded() {
     if (this.ids?.length > 0 || this.selectedIds?.length === 1) {
       const e = this.selectedIds.length === 1 ? this.selectedIds[0] : this.ids[0];
       this.type === "select" ? this._layerElement.value && (this._layerElement.value.value = e) : this.type === "dropdown" && (this.selectedName = this._layerNameHash && Object.keys(this._layerNameHash).indexOf(e) > -1 ? this._layerNameHash[e].name : this._tableNameHash && Object.keys(this._tableNameHash).indexOf(e) > -1 ? this._tableNameHash[e].name : "");
     }
   }
-  //--------------------------------------------------------------------------
-  //
-  //  Functions (protected)
-  //
-  //--------------------------------------------------------------------------
-  /**
-   * Create a notice to inform the user that no layers were found
-   *
-   * @returns Calcite Notice component with the message
-   */
   _getInvalidPlaceholder() {
     return a`<div><calcite-notice class="height-100" icon=exclamation-mark-triangle id=no-valid-layers kind=danger open><div slot=message>${this._translations.noLayersFound}</div></calcite-notice><calcite-tooltip .label=${this._translations.enableEditUpdate} placement=bottom reference-element=no-valid-layers><span>${this._translations.enableEditUpdate}</span></calcite-tooltip></div>`;
   }
-  /**
-   * Show layer name as a label with icon
-   *
-   * @returns Calcite label with the layer name and icon
-   */
   _getSingleLayerPlaceholder() {
     const e = this._getItemTypeIcon();
     return a`<div class="layer-picker-label-container cursor-default"><calcite-icon .icon=${e} scale=s></calcite-icon><calcite-label class="no-bottom-margin padding-start-1">${this.selectedName}</calcite-label></div>`;
   }
-  /**
-   * Create a list of layers from the map
-   * Used for selecting a single layer.
-   *
-   * @param id the id for the select component used to support the tooltip
-   * @returns Calcite Select component with the ids of the layers from the map
-   */
   _getSelect(e) {
     return a`<calcite-select id=${e ?? n} label @calciteSelectChange=${() => this._layerSelectionChange()} .scale=${this.scale} ${c(this._layerElement)}>${this._getMapLayerOptions()}</calcite-select>`;
   }
-  /**
-   * Create a list of layer ids from the map
-   * Used for selecting multiple layers
-   *
-   * @param id the id for the combobox component used to support the tooltip
-   * @returns Calcite ComboBox component with the ids of the layers from the map
-   */
   _getCombobox(e) {
     return a`<calcite-combobox clear-disabled id=${e ?? n} label @calciteComboboxChange=${() => this._layerSelectionChange()} .placeholderIcon=${this.placeholderIcon} .scale=${this.scale} selection-mode=single ${c(this._layerElement)}>${this._getMapLayerOptions()}</calcite-combobox>`;
   }
-  /**
-   * Hydrate a dropdown component with items to display the layer names
-   *
-   * @param id the id for the dropdown component used to support the tooltip
-   * @returns Array of Dropdown items with layer names
-   */
   _getDropdown(e) {
     return a`<calcite-dropdown class="layer-picker-dropdown" @calciteDropdownBeforeClose=${() => this._isDropdownOpen = !1} @calciteDropdownBeforeOpen=${() => this._isDropdownOpen = !0}>${this.isMobile ? this._getDropdownButton() : this._getActionDropdownButton(e)}<calcite-dropdown-group selection-mode=single>${this._getMapLayerOptions()}</calcite-dropdown-group></calcite-dropdown>`;
   }
-  /**
-   * Get the button that will open the dropdown list wrapped in an action
-   *
-   * @returns the node for the action and button
-   */
   _getActionDropdownButton(e) {
     return a`<calcite-action id=${e ?? n} slot=trigger text>${this._getDropdownButton()}</calcite-action>`;
   }
-  /**
-   * Get the button that will open the dropdown list
-   *
-   * @returns the node for the button
-   */
   _getDropdownButton() {
     const e = this._getItemTypeIcon(), t = this.isMobile ? "" : "max-width-350", s = this.isMobile ? "trigger" : "", i = this._isDropdownOpen ? "chevron-up" : "chevron-down";
     return a`<calcite-button alignment=icon-end-space-between .appearance=${this.appearance} class=${p(t)} .iconEnd=${i} .iconStart=${e} kind=neutral slot=${s ?? n} width=full><div>${this.selectedName}</div></calcite-button>`;
   }
-  /**
-   * Get the appropriate icon based on the selected layer or table
-   *
-   * @returns a string for the appropriate icon
-   */
   _getItemTypeIcon() {
     let e = "layers";
     if (this.selectedIds.length > 0 && this._layerNameHash) {
@@ -167,24 +99,13 @@ class v extends f {
     }
     return e;
   }
-  /**
-   * Get the appropriate type of dom nodes for each valid layer or table
-   *
-   * @returns Array of dom nodes with the names of the layers and optionally of the tables
-   */
   _getMapLayerOptions() {
     return this.ids.reduce((e, t) => (this._validLayer(t) ? e.push(this._getItem(t, "layer")) : this._validTable(t) && e.push(this._getItem(t, "table")), e), []);
   }
-  /**
-   * Get the appropriate type of dom node for the current layer or table id
-   *
-   * @returns A dom node with the name of the layer or table
-   */
   _getItem(e, t) {
     const s = t === "layer" && this._layerNameHash ? this._layerNameHash[e] : this._tableNameHash ? this._tableNameHash[e] : void 0, i = this.onlyShowUpdatableLayers ? s && !s.supportsUpdate : !1, h = s?.name, l = this.selectedIds.indexOf(e) > -1;
     return this.type === "combobox" ? a`<calcite-combobox-item .disabled=${i} .selected=${l} .textLabel=${h} .value=${e}></calcite-combobox-item>` : this.type === "select" ? a`<calcite-option .disabled=${i} .label=${h} .selected=${l} .value=${e}></calcite-option>` : this.force && l || !this.force ? a`<calcite-dropdown-group class=${p(i ? "disabled" : "")} .selectionMode=${i ? "none" : "single"}><calcite-dropdown-item .disabled=${!!(t === "table" && this.showTablesDisabled)} .iconStart=${t} @click=${i ? void 0 : () => void this._setSelectedLayer(e)} .selected=${l}>${h}</calcite-dropdown-item></calcite-dropdown-group>` : null;
   }
-  /** Store the layer name based on the user selection */
   async _setSelectedLayer(e) {
     if (e !== this.selectedIds[0]) {
       let t;
@@ -200,19 +121,9 @@ class v extends f {
       this.selectedName = t?.title || "";
     }
   }
-  /**
-   * Fetch layer hash info for the given id
-   *
-   * @returns ILayerHashInfo for the id
-   */
   _getLayerFromHash(e) {
     return this._layerNameHash && Object.keys(this._layerNameHash).indexOf(e) > -1 ? this._layerNameHash[e] : this._tableNameHash && Object.keys(this._tableNameHash).indexOf(e) > -1 ? this._tableNameHash[e] : void 0;
   }
-  /**
-   * Fetch the ids of the layers from the map
-   *
-   * @returns Promise when the operation has completed
-   */
   async _setLayers() {
     if (this.mapView) {
       await this._initLayerTableHash();
@@ -228,45 +139,20 @@ class v extends f {
       });
     }
   }
-  /**
-   * Fetch the ids of all layers that support edits with the update capability
-   *
-   * @returns array of layer ids
-   */
   _getEditableIds(e) {
     return Object.keys(e).reduce((t, s) => (e[s].supportsUpdate && t.push(s), t), []);
   }
-  /**
-   * Create a layer id:title hash for layer name display
-   *
-   * @returns Promise when the operation has completed
-   */
   async _initLayerTableHash() {
     this._layerNameHash = this.mapView && await _(this.mapView, this.onlyShowUpdatableLayers), this._tableNameHash = this.showTables && this.mapView ? await u(this.mapView, this.onlyShowUpdatableLayers) : {};
   }
-  /**
-   * Evaluate if the id exists in the current hash and verify if it should be excluded
-   *
-   * @returns boolean when true the layer will be used in the current layer picker type
-   */
   _validLayer(e) {
     const t = this._layerNameHash && this._layerNameHash[e]?.name;
     return t !== void 0 && Object.keys(o.managedLayers).indexOf(t) < 0 && (this.enabledLayerIds?.length > 0 ? this.enabledLayerIds.indexOf(e) > -1 : !0);
   }
-  /**
-   * Evaluate if the id exists in the current hash and verify if it should be excluded
-   *
-   * @returns boolean when true the table will be used in the current layer picker type
-   */
   _validTable(e) {
     const t = this._tableNameHash && this._tableNameHash[e]?.name, s = t && this.showTables;
     return s ? o.managedTables.indexOf(t) < 0 && (this.enabledTableIds?.length > 0 ? this.enabledTableIds.indexOf(e) > -1 : !0) : s !== void 0;
   }
-  /**
-   * Fetch the ids of the layers from the map
-   *
-   * @returns Promise when the operation has completed
-   */
   _layerSelectionChange(e) {
     if (this._layerElement.value) {
       const t = e || (Array.isArray(this._layerElement.value.value) ? this._layerElement.value.value : [this._layerElement.value.value]);

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

@@ -6,7 +6,7 @@ import { LitElement as r } from "@arcgis/lumina";
 import { css as d } 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.1 */
 const o = d`/**
  * @license
  * Copyright 2025 Esri
@@ -33,51 +33,27 @@ class l extends r {
   static {
     this.styles = o;
   }
-  /** TODO: [MIGRATION] Consider inlining some of the watch functions called inside of this method to reduce boilerplate code */
   willUpdate(e) {
     e.has("mapView") && this.mapViewWatchHandler();
   }
-  //--------------------------------------------------------------------------
-  //
-  //  Watch handlers
-  //
-  //--------------------------------------------------------------------------
-  // TODO add doc
   async mapViewWatchHandler() {
     await this.mapView?.when(() => {
       this.mapView && this._initLegend(this.mapView);
     });
   }
-  // TODO check all load...for async
-  /** Called once just after the component is first connected to the DOM. */
   async load() {
     return this._initModules();
   }
-  /** Renders the component. */
   render() {
     return s`<div ${a(this._legendElement)}></div>`;
   }
-  /** Called once just after the component is fully loaded and the first render() occurs. */
-  /** This lifecycle method is not expected to return a promise. The returned promise will be ignored by Lit rather than awaited. */
   async loaded() {
     this.mapView && await this.mapViewWatchHandler();
   }
-  //--------------------------------------------------------------------------
-  //
-  //  Functions (protected)
-  //
-  //--------------------------------------------------------------------------
-  /**
-   * Load esri javascript api modules
-   *
-   * @returns Promise resolving when function is done
-   * @protected
-   */
   async _initModules() {
     const [e] = await t(["esri/widgets/Legend"]);
     this.Legend = e;
   }
-  /** Initialize the basemap gallery or reset the current view if it already exists */
   _initLegend(e) {
     e && this.Legend && (this.legendWidget ? this.legendWidget.view = e : this.legendWidget = new this.Legend({
       container: this._legendElement.value,

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

@@ -6,7 +6,11 @@ import { PublicLitElement as LitElement, TargetedEvent, JsxNode } from '@arcgis/
 export declare class MapPicker extends LitElement {
     /** IMapInfo[]: array of map infos (name and id) */
     mapInfos: IMapInfo[];
-    /** boolean: when true map list will shown in half width. */
+    /**
+     * boolean: when true map list will shown in half width.
+     *
+     * @default false
+     */
     isMapLayout?: boolean | undefined;
     setMapByID(id: string, skipEditCheck?: boolean): Promise<void>;
     /** Closes the list */