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

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

@@ -4,7 +4,7 @@ import { usePropertyChange as k } from "@arcgis/lumina/controllers";
 import { classes as H } from "@arcgis/components-utils";
 import { watch as v } from "@arcgis/core/core/reactiveUtils.js";
 import { LitElement as V, createEvent as b, noShadowRoot as Q, safeClassMap as P, nothing as K } from "@arcgis/lumina";
-import { u as J } from "../../chunks/useT9n.js";
+import { u as J } from "../../chunks/useView.js";
 import { m as q } from "../../chunks/useViewModel.js";
 import { g as C } from "../../chunks/globalCss.js";
 import { l as W } from "../../chunks/legacyIcon.js";
@@ -27,7 +27,7 @@ import { project as ae } from "@arcgis/core/rest/geometryService.js";
 import se from "@arcgis/core/rest/support/ProjectParameters.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 ne = X`@layer{arcgis-locate{display:block}}`;
 var le = Object.defineProperty, ce = Object.getOwnPropertyDescriptor, m = (e, t, o, r) => {
   for (var i = r > 1 ? void 0 : r ? ce(t, o) : t, a = e.length - 1, s; a >= 0; a--)
@@ -670,7 +670,7 @@ class ze extends V {
     super(...arguments), this.messages = J(), this.viewModel = je(this), this.autoDestroyDisabled = !1, this.geolocationOptions = this.viewModel.geolocationOptions, this.goToLocationDisabled = this.viewModel.goToLocationEnabled, this.goToOverride = this.viewModel.goToOverride, this.graphic = this.viewModel.graphic, this.icon = _, this.popupDisabled = this.viewModel.popupEnabled, this.position = "top-left", this.scale = this.viewModel.scale, this.state = this.viewModel.state, this.arcgisError = b(), this.arcgisPropertyChange = k()("state"), this.arcgisReady = b(), this.arcgisSuccess = b();
   }
   static {
-    this.properties = { autoDestroyDisabled: 5, geolocationOptions: 0, goToLocationDisabled: 7, goToOverride: 0, graphic: 0, icon: 3, label: 1, messageOverrides: 0, popupDisabled: 5, position: 3, referenceElement: 1, scale: 9, state: 3 };
+    this.properties = { autoDestroyDisabled: 5, geolocationOptions: 0, goToLocationDisabled: 7, goToOverride: 0, graphic: 0, icon: 1, label: 1, messageOverrides: 0, popupDisabled: 5, position: 3, referenceElement: 1, scale: 9, state: 3 };
   }
   static {
     this.shadowRootOptions = Q;
@@ -678,24 +678,15 @@ class ze extends V {
   static {
     this.styles = ne;
   }
-  //#endregion
-  //#region Public Methods
-  /**
-   * This function provides the ability to interrupt and cancel the process of
-   * programmatically obtaining the location of the user's device.
-   */
   async cancelLocate() {
     this.viewModel.cancelLocate();
   }
-  /** Permanently destroy the component */
   async destroy() {
     await this.manager.destroy();
   }
   async locate() {
     return await this.viewModel.locate();
   }
-  //#endregion
-  //#region Lifecycle
   loaded() {
     this.viewModel.messages = { ...this.messages, ...this.messageOverrides }, this.manager.onLifecycle(() => [
       v(() => this.viewModel.error, (t) => {
@@ -706,8 +697,6 @@ class ze extends V {
       })
     ]);
   }
-  //#endregion
-  //#region Private Methods
   _localizeError(t) {
     if (t instanceof GeolocationPositionError)
       return t.code === GeolocationPositionError.PERMISSION_DENIED ? this.messages?.permissionError : t.code === GeolocationPositionError.TIMEOUT ? this.messages?.timeoutError : this.messages?.positionUnavailable;
@@ -719,8 +708,6 @@ class ze extends V {
     t.state === "locating" ? t.cancelLocate() : t.locate().catch(() => {
     });
   }
-  //#endregion
-  //#region Rendering
   render() {
     const { viewModel: t, icon: o } = this, { state: r } = t, i = r === "locating", a = i ? this.messages.cancel : this.messages.title, s = r === "feature-unsupported", y = W === void 0 ? _ : void 0, g = this._localizeError(this.viewModel?.error);
     return f`<div class=${P(H(Fe.base, C.widget))}>${!s && f`<calcite-button class=${P(C.widgetButton)} .disabled=${r === "disabled"} .iconStart=${i ? void 0 : o ?? y} kind=neutral .label=${a} @click=${this._locate} title=${a ?? K}>${i ? f`<calcite-loader inline label></calcite-loader>` : null}</calcite-button>` || ""}${g ? f`<calcite-tooltip open overlay-positioning=fixed .referenceElement=${this.el}>${g}</calcite-tooltip>` : null}</div>`;

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

@@ -18,7 +18,8 @@ declare const useMapView: (component: LitElement & Pick<MapView, never> & {
 }, options?: {
     editConstructorProperties(props: __esri.MapViewProperties | undefined): __esri.MapViewProperties | Promise<__esri.MapViewProperties | undefined> | undefined;
 } | undefined) => MapView;
-/** The ArcGIS Map Component is used to add 2D maps to web applications. For 3D maps, use the
+/**
+ * The ArcGIS Map Component is used to add 2D maps to web applications. For 3D maps, use the
  * [ArcGIS Scene component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/).
  *
  * The Map component creates a [MapView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html) and loads a WebMap from either [ArcGIS Online](https://www.arcgis.com/home/index.html) or [ArcGIS Enterprise portal](https://enterprise.arcgis.com/en/portal/latest/administer/windows/what-is-portal-for-arcgis-.htm).
@@ -34,11 +35,11 @@ declare const useMapView: (component: LitElement & Pick<MapView, never> & {
  * ```
  *
  * Other components can be added and connected to the Map component.
- 
+ *
  * ```html
  * <arcgis-map item-id="05e015c5f0314db9a487a9b46cb37eca">
- *   <arcgis-zoom position="top-left"></arcgis-zoom>
- *   <arcgis-legend position="bottom-left"></arcgis-legend>
+ *  <arcgis-zoom position="top-left"></arcgis-zoom>
+ *  <arcgis-legend position="bottom-left"></arcgis-legend>
  * </arcgis-map>
  * ```
  *
@@ -47,8 +48,8 @@ declare const useMapView: (component: LitElement & Pick<MapView, never> & {
  * ```js
  * const arcgisMap = document.querySelector("arcgis-map");
  * arcgisMap.addEventListener("arcgisViewReadyChange", () => {
- *   const layer = new GraphicsLayer({ title: "My Layer" });
- *   arcgisMap.map.add(layer);
+ *  const layer = new GraphicsLayer({ title: "My Layer" });
+ *  arcgisMap.map.add(layer);
  * });
  * ```
  *
@@ -56,9 +57,11 @@ declare const useMapView: (component: LitElement & Pick<MapView, never> & {
  * - [SDK sample apps using the Map component](https://developers.arcgis.com/javascript/latest/sample-code/?tagged=arcgis-map)
  * - [Getting started](https://developers.arcgis.com/javascript/latest/get-started-overview/)
  * - [Programming patterns](https://developers.arcgis.com/javascript/latest/programming-patterns/)
+ *
+ * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/)
  */
 export declare class ArcgisMap extends LitElement {
-    /** Internal view of the component. */
+    /** The [MapView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html) instance created and manged by the component. Accessible once the component is fully loaded. */
     readonly view: MapView;
     /**
      * Collection containing a flat list of all the created LayerViews
@@ -69,25 +72,29 @@ export declare class ArcgisMap 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-map/#destroy) method when you are done to
+     * prevent memory leaks.
+     *
+     * @default false
      */
     autoDestroyDisabled: boolean;
     /**
      * The background color of the MapView. If the view's map changes, the view's `background` is reset to the map's background,
      * even if the user set it previously.
+     *
+     * @default null
      */
     background: nullish | __esri.ColorBackground;
     /**
-       * Specifies a basemap for the map. The basemap is a set of layers that give
-       * geographic context to the view and the other operational layers
-       * in the map.
-       * It can either be set using a basemap ID string ([see values](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html#basemap)),
-       * [Basemap](https://developers.arcgis.com/javascript/latest/api-reference/esri-Basemap.html)
-       * or [BasemapStyle](https://developers.arcgis.com/javascript/latest/api-reference/esri-support-BasemapStyle.html).
-       *
-       * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html#basemap)
-       */
+     * Specifies a basemap for the map. The basemap is a set of layers that give
+     * geographic context to the view and the other operational layers
+     * in the map.
+     * It can either be set using a basemap ID string ([see values](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html#basemap)),
+     * [Basemap](https://developers.arcgis.com/javascript/latest/api-reference/esri-Basemap.html)
+     * or [BasemapStyle](https://developers.arcgis.com/javascript/latest/api-reference/esri-support-BasemapStyle.html).
+     *
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html#basemap)
+     */
     get basemap(): typeof this._map.basemap;
     set basemap(value: __esri.Basemap | nullish | string);
     /** Represents the view for a single basemap after it has been added to the map. */
@@ -150,20 +157,26 @@ export declare class ArcgisMap extends LitElement {
      */
     highlights: __esri.Collection<__esri.HighlightOptions>;
     /**
-     * @deprecated
+     * Options for configuring the highlight.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View2D.html#highlightOptions)
      *
+     * @deprecated
      * Options for configuring the highlight. Use the highlight method on the
      * appropriate esri/views/layers/LayerView to highlight a feature.
      * The layerView's `highlightOptions` will take precedence over the MapView's `highlightOptions` if both properties are set.
      */
     highlightOptions: __esri.HighlightOptions;
-    /** Indication whether the view is being interacted with (for example when panning or by an interactive tool). */
-    get interacting(): boolean;
     /**
-     * Contains indoor positioning system information for the map.
+     * Indication whether the view is being interacted with (for example when panning or by an interactive tool).
+     *
+     * @default false
      */
+    get interacting(): boolean;
+    /** Contains indoor positioning system information for the map. */
     ipsInfo: nullish | __esri.IPSInfo;
-    /** The ID of a WebMap from ArcGIS Online or ArcGIS Enterprise portal.
+    /**
+     * The ID of a WebMap from ArcGIS Online or ArcGIS Enterprise portal.
      *
      * To configure the portal url you must set the [`portalUrl` property on `config`](https://developers.arcgis.com/javascript/latest/api-reference/esri-config.html#portalUrl) before the `arcgis-map` component loads.
      */
@@ -179,11 +192,29 @@ export declare class ArcgisMap extends LitElement {
     readonly magnifier: __esri.Magnifier;
     /** An instance of a esri/Map object to display in the view. */
     map: __esri.Map;
-    /** Indication whether the view is being navigated (for example when panning). */
+    /**
+     * Indication whether the view is being navigated (for example when panning).
+     *
+     * @default false
+     */
     get navigating(): boolean;
     /** Options to configure the navigation behavior of the View. */
     navigation: __esri.Navigation;
+    /**
+     * Use the padding property to make the [center](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#center),
+     * and [extent](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#extent), etc.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View.html#padding)
+     *
+     * @default {left: 0, top: 0, right: 0, bottom: 0}
+     */
     padding: __esri.ViewPadding;
+    /**
+     * A [Popup](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Popup.html) object that displays general content or attributes from
+     * [layers](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html#layers) in the [map](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View2D.html#map).
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View2D.html#popup)
+     */
     popup: nullish | __esri.Popup;
     /**
      * Controls whether the popup opens when users click on the view.
@@ -194,12 +225,16 @@ export declare class ArcgisMap extends LitElement {
     /**
      * When `true`, this property indicates whether the view successfully satisfied all dependencies,
      * signaling that the following conditions are met.
+     *
+     * @default false
      */
     readonly ready: boolean;
     /**
      * Defines which anchor stays still while resizing the browser window. The default, `center`,
      * ensures the view's center point remains constantly visible as the window size changes. The other
      * options allow  the respective portion of the view to remain visible when the window's size is changed.
+     *
+     * @default "center"
      */
     resizeAlign: "center" | "bottom-left" | "bottom-right" | "top-left" | "top-right" | "left" | "right" | "top" | "bottom";
     /**
@@ -215,6 +250,8 @@ export declare class ArcgisMap extends LitElement {
      * Map rotation may be disabled by setting the `rotationEnabled` property
      * in [constraints](#constraints) to `false`. See the code snippet below for
      * an example of this.
+     *
+     * @default 0
      */
     rotation: number;
     /**
@@ -227,15 +264,27 @@ export declare class ArcgisMap extends LitElement {
      * The spatial reference of the view.
      * This indicates the projected or geographic coordinate system used
      * to locate geographic features in the map.
+     *
+     * @default null
      */
     spatialReference: __esri.SpatialReference;
-    /** Indication whether the view is animating, being navigated with or resizing. */
+    /**
+     * Indication whether the view is animating, being navigated with or resizing.
+     *
+     * @default false
+     */
     get stationary(): boolean;
-    /** Indicates if the view is visible on the page. */
+    /**
+     * Indicates if the view is visible on the page.
+     *
+     * @default true
+     */
     readonly suspended: boolean;
     /**
      * This property specifies the base colors used by some widgets
      * and components to render graphics and labels.
+     *
+     * @default null
      */
     theme: nullish | __esri.Theme;
     /**
@@ -243,17 +292,23 @@ export declare class ArcgisMap extends LitElement {
      * the view's time extent. Setting the view's time extent is similar to setting the spatial
      * extent because once the time extent is set, the
      * view updates automatically to conform to the change.
+     *
+     * @default null
      */
     timeExtent: nullish | __esri.TimeExtent;
     /**
      * Defines the time zone of the view.
      * The time zone property determines how dates and times are represented to the user,
      * but the underlying data is unchanged.
+     *
+     * @default "system"
      */
     timeZone: string;
     /**
      * Indicates whether the view is being updated by additional data requests to the network,
      * or by processing received data.
+     *
+     * @default false
      */
     readonly updating: boolean;
     /**
@@ -263,6 +318,12 @@ export declare class ArcgisMap extends LitElement {
      */
     get viewpoint(): __esri.Viewpoint;
     set viewpoint(newValue: __esri.Viewpoint);
+    /**
+     * The visibleArea represents the visible portion of a [map](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html) within the view as
+     * an instance of a [Polygon](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Polygon.html).
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View2D.html#visibleArea)
+     */
     readonly visibleArea: nullish | __esri.Polygon;
     /**
      * Represents the level of detail (LOD) at the center of the view.
@@ -278,28 +339,32 @@ export declare class ArcgisMap extends LitElement {
     get zoom(): number;
     set zoom(newValue: number);
     /**
-     * @deprecated **Deprecated** since 4.33. Use `element.map.add(layer)` instead.
+     * @deprecated
+     * **Deprecated** since 4.33. Use `element.map.add(layer)` instead.
      *
      * Adds a layer to the map layers collection.
-     * */
+     */
     addLayer(layer: __esri.Layer | Promise<any>, index?: number): Promise<void>;
     /**
-     * @deprecated **Deprecated** since 4.33. Use `element.map.addMany([layer])` instead.
+     * @deprecated
+     * **Deprecated** since 4.33. Use `element.map.addMany([layer])` instead.
      *
      * Adds a layer or array of layers to the map layers collection.
-     * */
+     */
     addLayers(layers: __esri.Layer[], index?: number): Promise<void>;
     /**
-     * @deprecated **Deprecated** since 4.33. Use `element.map.tables.add(table)` instead.
+     * @deprecated
+     * **Deprecated** since 4.33. Use `element.map.tables.add(table)` instead.
      *
      * Adds a table to the map tables collection.
-     * */
+     */
     addTable(table: __esri.FeatureLayer): Promise<void>;
     /**
-     * @deprecated **Deprecated** since 4.33. Use `element.map.tables.addMany([table])` instead.
+     * @deprecated
+     * **Deprecated** since 4.33. Use `element.map.tables.addMany([table])` instead.
      *
      * Adds a table or array of tables to the map tables collection.
-     * */
+     */
     addTables(tables: __esri.FeatureLayer[], index?: number): Promise<void>;
     /** Closes the popup. */
     closePopup(): Promise<void>;
@@ -371,11 +436,7 @@ export declare class ArcgisMap extends LitElement {
      * This event will also emit if the `map` property is changed.
      */
     readonly arcgisViewReadyChange: TargetedEvent<this, void>;
-    /**
-     * This WebMap will be created only if user did not provide a map. Otherwise,
-     * it will be equal to this.view.map
-     */
-    private _map;
+    private _map: __esri.Map;
     readonly _setterTypes: {
         basemap?: __esri.Basemap | nullish | string;
         center?: __esri.MapView["center"] | Nil | number[] | string;

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

@@ -8,7 +8,7 @@ import { c as h, i as g } from "../../chunks/component-utils.js";
 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/4.33/esri/copyright.txt for details.
-v4.33.0-next.110 */
+v4.33.0-next.112 */
 const u = y`@layer{arcgis-map{display:block;height:100%;.esri-view{height:100%;width:100%}}}`, f = r(
   o,
   /**
@@ -34,13 +34,6 @@ class b extends l {
   static {
     this.styles = u;
   }
-  /**
-   * Represents the view's center point; when setting the center, you may pass a
-   * esri/geometry/Point instance or a string representing
-   * a longitude/latitude pair (`"-100.4593, 36.9014"`).
-   * Setting the center immediately changes the current view.
-   * For animating the view, see this component's goTo() method.
-   */
   get center() {
     return this.view.center ?? this._center;
   }
@@ -48,30 +41,18 @@ class b extends l {
     const t = h(i, this.ready ? this.view : void 0);
     t && (this.ready && (this.view.center = t), this._center = t);
   }
-  /**
-   * The extent represents the visible portion of a map within the view as an instance of esri/geometry/Extent.
-   * Setting the extent immediately changes the view without animation. To animate
-   * the view, see this component's goTo() method.
-   * When the view is rotated, the extent does not update to include the newly visible portions of the map.
-   */
   get extent() {
     return this.view.extent ?? this._extent;
   }
   set extent(i) {
     this.view.ready || (this._extent = i), i && !this.extent?.equals(i) && (this.view.extent = i);
   }
-  /** Gamepad input specific configuration settings. */
   get gamepad() {
     return this.ready ? this.view.input.gamepad : void 0;
   }
-  /** Indication whether the view is being interacted with (for example when panning or by an interactive tool). */
   get interacting() {
     return this.view.interacting;
   }
-  /** The ID of a WebMap from ArcGIS Online or ArcGIS Enterprise portal.
-   *
-   * To configure the portal url you must set the [`portalUrl` property on `config`](https://developers.arcgis.com/javascript/latest/api-reference/esri-config.html#portalUrl) before the `arcgis-map` component loads.
-   */
   get itemId() {
     return this._map.portalItem?.id ?? this._itemId;
   }
@@ -80,110 +61,57 @@ class b extends l {
       this.view.map = this._map;
     }).catch(console.error) : this.view.ready != null && (this._map.destroy(), this._map = new o(this._editMapProperties({ portalItem: { id: this._itemId } })), this.view.map = this._map);
   }
-  /** Indication whether the view is being navigated (for example when panning). */
   get navigating() {
     return this.view.navigating;
   }
-  /**
-   * Represents the map scale at the center of the view. Setting the scale immediately changes the view. For animating
-   * the view, see this component's goTo() method.
-   */
   get scale() {
     return this.view.scale ?? this._scale;
   }
   set scale(i) {
     this.ready && (this.view.scale = i), this._scale = i;
   }
-  /** Indication whether the view is animating, being navigated with or resizing. */
   get stationary() {
     return this.view.stationary;
   }
-  /**
-   * Represents the current view as a Viewpoint or point of observation on the view.
-   * Setting the viewpoint immediately changes the current view. For animating
-   * the view, see this component's goTo() method.
-   */
   get viewpoint() {
     return this.view.viewpoint ?? this._viewpoint;
   }
   set viewpoint(i) {
     this.ready && g(this.viewpoint, i) && (this.view.viewpoint = i), this._viewpoint = i;
   }
-  /**
-   * Represents the level of detail (LOD) at the center of the view.
-   * A zoom level (or scale) is a number that defines how large or small the contents of a map appear in a map view.
-   * Zoom level is a number usually between 0 (global view) and 23 (very detailed view) and is used as a shorthand for predetermined scale values.
-   * A value of -1 means the view has no LODs.
-   * When setting the zoom value, the MapView converts it to the corresponding scale, or interpolates it if the zoom is a fractional number.
-   * MapView can display maps with different projections at a full range of scales, and so use the scale property on this component rather than zoom level.
-   *
-   * Setting the zoom immediately changes the current view. For animating the view, see this component's goTo() method.
-   * Setting this property in conjunction with `center` is a convenient way to set the initial extent of the view.
-   */
   get zoom() {
     return this.view.zoom ?? this._zoom;
   }
   set zoom(i) {
     this.ready && (this.view.zoom = i), this._zoom = i;
   }
-  //#endregion
-  //#region Public Methods
-  /**
-   * @deprecated **Deprecated** since 4.33. Use `element.map.add(layer)` instead.
-   *
-   * Adds a layer to the map layers collection.
-   * */
   async addLayer(i, t) {
     this.map?.add(i, t);
   }
-  /**
-   * @deprecated **Deprecated** since 4.33. Use `element.map.addMany([layer])` instead.
-   *
-   * Adds a layer or array of layers to the map layers collection.
-   * */
   async addLayers(i, t) {
     this.map?.addMany(i, t);
   }
-  /**
-   * @deprecated **Deprecated** since 4.33. Use `element.map.tables.add(table)` instead.
-   *
-   * Adds a table to the map tables collection.
-   * */
   async addTable(i) {
     this.map?.tables.add(i);
   }
-  /**
-   * @deprecated **Deprecated** since 4.33. Use `element.map.tables.addMany([table])` instead.
-   *
-   * Adds a table or array of tables to the map tables collection.
-   * */
   async addTables(i, t) {
     this.map?.tables.addMany(i, t);
   }
-  /** Closes the popup. */
   async closePopup() {
     this.view?.closePopup();
   }
-  /** Destroys the view, and any associated resources, including its map, popup, and UI elements. */
   async destroy() {
     await this.manager.destroy();
   }
-  /** Sets the view to a given target. */
   async goTo(i, t) {
     return await this.view?.goTo(i, t);
   }
-  /** Returns hit test results from each layer that intersects the specified screen coordinates. */
   async hitTest(i, t) {
     return await this.view?.hitTest(i, t);
   }
-  /**
-   * Opens the popup at the given location with content defined either explicitly with content or driven
-   * from the PopupTemplate of input features.
-   */
   async openPopup(i) {
     await this.view?.openPopup(i);
   }
-  /** Create a screenshot of the current view. */
   async takeScreenshot(i) {
     return await this.view?.takeScreenshot(i);
   }
@@ -193,23 +121,15 @@ class b extends l {
   toScreen(i, t) {
     return this.view.toScreen(i, t);
   }
-  /** Call this method to clear any fatal errors resulting from a lost WebGL context. */
   async tryFatalErrorRecovery() {
     this.view?.tryFatalErrorRecovery();
   }
-  /** Gets the LayerView created on the view for the given layer. */
   async whenLayerView(i) {
     return await this.view?.whenLayerView(i);
   }
-  /**
-   * `viewOnReady()` may be leveraged once an instance of the component is created and ready.
-   * This method takes two input parameters: a `callback` function and an `errback` function.
-   */
   async viewOnReady(i, t) {
     return await this.componentOnReady(), await this.view.whenReady().then(() => i?.()).catch(t);
   }
-  //#endregion
-  //#region Lifecycle
   load() {
     const i = this;
     i.el.childElem = document.createElement("div"), i.el.append(i.el.childElem), this.view.container ??= i.el.childElem;
@@ -222,8 +142,6 @@ class b extends l {
       s(() => this.view.ready, () => this.arcgisViewReadyChange.emit(), { initial: this.view.ready })
     ]);
   }
-  //#endregion
-  //#region Private Methods
   _editMapProperties(i) {
     this.map && (this._map = this.map), this.itemId && (i.portalItem = { id: this.itemId });
     const { basemap: t, ...n } = i;

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

@@ -29,39 +29,84 @@ declare const useMeasurementWidget: (component: LitElement & Pick<Measurement, n
     editConstructorProperties(props: __esri.MeasurementProperties | undefined): __esri.MeasurementProperties | Promise<__esri.MeasurementProperties | undefined> | undefined;
 } | undefined) => Measurement;
 /**
+ * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-measurement/)
+ *
  * @internal
  */
 export declare class ArcgisMeasurement extends LitElement {
+    /**
+     * Specifies the current measurement tool to display.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Measurement.html#activeTool)
+     *
+     * @default null
+     */
     activeTool: "area" | nullish | "distance" | "direct-line";
+    /**
+     * The measurement widget that is currently being used.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Measurement.html#activeWidget)
+     *
+     * @default null
+     */
     readonly activeWidget: nullish | __esri.DistanceMeasurement2D | __esri.DirectLineMeasurement3D | __esri.AreaMeasurement3D | __esri.AreaMeasurement2D;
+    /**
+     * Unit system (imperial, metric) or specific unit used for displaying the area values.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Measurement.html#areaUnit)
+     */
     areaUnit: __esri.SystemOrAreaUnit;
     /**
      * 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-measurement/#destroy) method when you are done to
+     * prevent memory leaks.
+     *
+     * @default false
      */
     autoDestroyDisabled: 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-Measurement.html#icon)
+     *
+     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
+     * @default "measure"
      */
     icon: string;
-    /** The component's default label. */
+    /**
+     * The widget's default label.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Measurement.html#label)
+     */
     label: string;
+    /**
+     * Unit system (imperial, metric) or specific unit used for displaying the distance values.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Measurement.html#linearUnit)
+     */
     linearUnit: __esri.SystemOrLengthUnit;
+    /** @default "bottom-left" */
     position: __esri.UIPosition;
     referenceElement: ArcgisReferenceElement | Nil | string;
+    /**
+     * The ViewModel's state.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Measurement-MeasurementViewModel.html#state)
+     *
+     * @default "disabled"
+     */
     readonly state: "ready" | "disabled" | "measuring" | "measured";
     clear(): Promise<void>;
-    /** Permanently destroy the component */
+    /** Permanently destroy the component. */
     destroy(): Promise<void>;
     startMeasurement(): 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" | "activeTool";
     }>;
+    /** Emitted when the component associated with a map or scene view is is ready to be interacted with. */
     readonly arcgisReady: TargetedEvent<this, undefined>;
 }
 export {};