@arcgis/map-components 4.34.0-next.16 → 4.34.0-next.160

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

@@ -1,16 +1,18 @@
 /// <reference types="@arcgis/core/interfaces.d.ts" />
-/// <reference types="../../index.d.ts" />
-import { Use } from '@arcgis/lumina/controllers';
-import { Nil } from '@arcgis/components-utils';
+/// <reference path="../../index.d.ts" />
 import { default as MapView } from '@arcgis/core/views/MapView.js';
 import { default as WebMap } from '@arcgis/core/WebMap.js';
-import { PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
+import { JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
+import { Use } from '@arcgis/lumina/controllers';
+import { nil } from '@arcgis/toolkit/type';
+import { default as Collection } from '@arcgis/core/core/Collection.js';
+import { LoadErrorSource } from '../../controllers/useArcgisLoadError';
 
-declare const useWebMap: (component: LitElement & Omit<Pick<WebMap, "basemap" | "ground" | "ipsInfo" | "layers" | "bookmarks" | "tables" | "presentation" | "widgets" | "applicationProperties" | "authoringApp" | "authoringAppVersion" | "floorInfo" | "geotriggersInfo" | "initialViewProperties" | "portalItem" | "thumbnailUrl" | "utilityNetworks">, "basemap" | "ground" | ("destroyed" | "initialized" | "declaredClass" | "set" | "watch" | "addHandles" | "removeHandles" | "hasHandles") | "layers" | "bookmarks" | "tables" | "presentation" | "widgets" | "applicationProperties" | "authoringApp" | "authoringAppVersion" | "floorInfo" | "geotriggersInfo" | "initialViewProperties" | "portalItem" | "thumbnailUrl" | "utilityNetworks"> & {
+declare const useWebMap: (component: LitElement & Omit<Pick<WebMap, "basemap" | "focusAreas" | "ground" | "ipsInfo" | "layers" | "presentation" | "tables" | "widgets" | "applicationProperties" | "authoringApp" | "authoringAppVersion" | "bookmarks" | "floorInfo" | "geotriggersInfo" | "initialViewProperties" | "portalItem" | "thumbnailUrl" | "utilityNetworks">, ("destroyed" | "initialized" | "declaredClass" | "set" | "watch" | "addHandles" | "removeHandles" | "hasHandles") | "basemap" | "ground" | "layers" | "presentation" | "tables" | "widgets" | "applicationProperties" | "authoringApp" | "authoringAppVersion" | "bookmarks" | "floorInfo" | "geotriggersInfo" | "initialViewProperties" | "portalItem" | "thumbnailUrl" | "utilityNetworks"> & {
     autoDestroyDisabled: boolean;
     destroy: () => Promise<void>;
 }) => WebMap;
-declare const useMapView: (component: LitElement & Omit<Pick<MapView, "container" | "map" | "background" | "basemapView" | "center" | "constraints" | "extent" | "fatalError" | "graphics" | "highlights" | "navigation" | "padding" | "popup" | "resizeAlign" | "rotation" | "scale" | "spatialReference" | "theme" | "timeExtent" | "timeZone" | "viewpoint" | "zoom" | "floors" | "highlightOptions" | "breakpoints" | "heightBreakpoint" | "popupEnabled" | "spatialReferenceLocked" | "widthBreakpoint" | "ui" | "animation" | "displayFilterEnabled">, "container" | ("destroyed" | "initialized" | "declaredClass" | "set" | "watch" | "addHandles" | "removeHandles" | "hasHandles") | "breakpoints" | "heightBreakpoint" | "popupEnabled" | "spatialReferenceLocked" | "widthBreakpoint" | "ui" | "animation" | "displayFilterEnabled"> & {
+declare const useMapView: (component: LitElement & Omit<Pick<MapView, "map" | "analyses" | "aria" | "background" | "basemapView" | "center" | "constraints" | "extent" | "fatalError" | "graphics" | "highlights" | "highlightOptions" | "navigation" | "padding" | "popup" | "resizeAlign" | "rotation" | "scale" | "spatialReference" | "theme" | "timeExtent" | "timeZone" | "viewpoint" | "zoom" | "floors" | "spatialReferenceLocked" | "breakpoints" | "heightBreakpoint" | "popupEnabled" | "widthBreakpoint" | "animationsEnabled" | "container" | "ui" | "animation" | "displayFilterEnabled">, ("destroyed" | "initialized" | "declaredClass" | "set" | "watch" | "addHandles" | "removeHandles" | "hasHandles") | "breakpoints" | "heightBreakpoint" | "popupEnabled" | "widthBreakpoint" | "animationsEnabled" | "container" | "ui" | "animation" | "displayFilterEnabled"> & {
     autoDestroyDisabled: boolean;
     destroy: () => Promise<void>;
 }) => MapView;
@@ -34,8 +36,8 @@ declare const useMapView: (component: LitElement & Omit<Pick<MapView, "container
  *
  * ```html
  * <arcgis-map item-id="05e015c5f0314db9a487a9b46cb37eca">
- *  <arcgis-zoom position="top-left"></arcgis-zoom>
- *  <arcgis-legend position="bottom-left"></arcgis-legend>
+ *  <arcgis-zoom slot="top-left"></arcgis-zoom>
+ *  <arcgis-legend slot="bottom-left"></arcgis-legend>
  * </arcgis-map>
  * ```
  *
@@ -51,19 +53,85 @@ declare const useMapView: (component: LitElement & Omit<Pick<MapView, "container
  *
  * See also:
  * - [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/)
+ * - [Get started](https://developers.arcgis.com/javascript/latest/get-started/)
  * - [Programming patterns](https://developers.arcgis.com/javascript/latest/programming-patterns/)
  *
  * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/)
+ *
+ * @since 4.28
+ * @slot  - Default slot for adding components to the map. User is responsible for positioning the content via CSS.
+ * @slot [top-left] - Slot for components positioned in the top-left corner.
+ * @slot [top-right] - Slot for components positioned in the top-right corner.
+ * @slot [bottom-left] - Slot for components positioned in the bottom-left corner.
+ * @slot [bottom-right] - Slot for components positioned in the bottom-right corner.
+ * @slot [top-start] - Slot for components positioned at the top-start (top-left in LTR, top-right in RTL).
+ * @slot [top-end] - Slot for components positioned at the top-end (top-right in LTR, top-left in RTL).
+ * @slot [bottom-start] - Slot for components positioned at the bottom-start (bottom-left in LTR, bottom-right in RTL).
+ * @slot [bottom-end] - Slot for components positioned at the bottom-end (bottom-right in LTR, bottom-left in RTL).
+ * @slot [popup] - Slot for the [Popup](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-popup/) component to open automatically on click. When using this slot, the [`popup-disabled`](#popupDisabled) attribute must be set to `true`. Only the Popup component can be placed in this slot.
  */
 export declare class ArcgisMap extends LitElement {
-    /** 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. */
+    /**
+     * Fires when a ArcgisMap fails to load or if one of its dependencies fails to load (e.g., basemap, ground, layers).
+     *
+     * @since 4.34
+     * @see [loadErrorSources](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/#loadErrorSources)
+     * @example
+     * ```js
+     * viewElement.addEventListener("arcgisLoadError", () => {
+     *   console.log(viewElement.loadErrorSources);
+     * });
+     * ```
+     */
+    readonly arcgisLoadError: TargetedEvent<this>;
+    /**
+     * Fires if the view encounters a content or rendering error.
+     *
+     * @since 4.34
+     * @example
+     * ```js
+     * viewElement.addEventListener("arcgisViewReadyError", () => {
+     *   // handle error
+     * });
+     * ```
+     */
+    readonly arcgisViewReadyError: TargetedEvent<this>;
+    /** The [MapView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html) instance created and managed by the component. Accessible once the component is fully loaded. */
     readonly view: MapView;
+    /**
+     * Indicates whether animations are disabled in the view. This includes animated symbols (animated
+     * [CIMSymbol](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-CIMSymbol.html),
+     * [PictureMarkerSymbol](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-PictureMarkerSymbol.html)
+     * from a GIF/animated PNG), animated renderers
+     * ([FlowRenderer](https://developers.arcgis.com/javascript/latest/api-reference/esri-rasterRenderers.html#FlowRenderer)),
+     * animated layers ([MediaLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-MediaLayer.html),
+     * [VideoLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-VideoLayer.html)), and
+     * animations triggered by view navigation (for example,
+     * [goTo()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#goTo)).
+     * Setting this property to `true` disables all animations in the view.
+     *
+     * @since 4.34
+     * @default false
+     */
+    animationsDisabled: boolean;
+    /**
+     * The ARIA attributes for the view container. Provides accessibility information to assistive technologies such as screen readers. Supports the following properties: [`label`](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-label), [`description`](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-description), [`describedByElements`](https://developer.mozilla.org/en-US/docs/Web/API/Element/ariaDescribedByElements), and [`labelledByElements`](https://developer.mozilla.org/en-US/docs/Web/API/Element/ariaLabelledByElements).
+     *
+     * @since 4.34
+     */
+    get aria(): __esri.MapView["aria"];
+    set aria(value: __esri.MapView["aria"]);
     /**
      * Collection containing a flat list of all the created LayerViews
      * related to the basemap, operational layers, and group layers in this view.
      */
-    readonly allLayerViews: __esri.Collection<__esri.LayerView>;
+    readonly allLayerViews: __esri.ReadonlyCollection<__esri.LayerView>;
+    /**
+     * A collection of analyses associated with the view.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View2D.html#analyses)
+     */
+    analyses: Collection<__esri.Analysis>;
     /**
      * 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
@@ -75,8 +143,7 @@ export declare class ArcgisMap extends LitElement {
      */
     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.
+     * The background color of the Map component.
      *
      * @default null
      */
@@ -96,26 +163,26 @@ export declare class ArcgisMap extends LitElement {
     basemapView: __esri.BasemapView;
     /**
      * Represents the view's center point; when setting the center, you may pass a
-     * esri/geometry/Point instance or a string representing
+     * [Point](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Point.html) 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.
+     * For animating the view, see this component's [goTo()](#goTo) method.
      */
     get center(): __esri.MapView["center"];
-    set center(newValue: __esri.MapView["center"] | Nil | number[] | string);
-    /** Specifies constraints to scale, zoom, and rotation that may be applied to the MapView. */
+    set center(newValue: __esri.MapView["center"] | nil | number[] | string);
+    /** Specifies constraints to scale, zoom, and rotation that may be applied to the map. */
     constraints: __esri.View2DConstraints;
     /**
-     * Indicates whether layer's displayFilter are honored when rendering layers in the view.
+     * Indicates whether a layer's `displayFilter` is honored when rendering layers in the view.
      * If `false`, display filters are ignored and all features are rendered.
      *
      * @default false
      */
     displayFilterDisabled: boolean;
     /**
-     * The extent represents the visible portion of a map within the view as an instance of esri/geometry/Extent.
+     * The extent represents the visible portion of a map within the view as an instance of [Extent](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Extent.html).
      * Setting the extent immediately changes the view without animation. To animate
-     * the view, see this component's goTo() method.
+     * the view, see this component's [goTo()](#goTo) method.
      * When the view is rotated, the extent does not update to include the newly visible portions of the map.
      */
     get extent(): __esri.MapView["extent"];
@@ -126,7 +193,7 @@ export declare class ArcgisMap extends LitElement {
      * Applies a display filter on the view for a specific set of floor levels.
      * It can filter the map display on floor-aware layers by zero or more level IDs.
      */
-    floors: __esri.Collection<string>;
+    floors: Collection<string>;
     /** Gamepad input specific configuration settings. */
     get gamepad(): __esri.GamepadSettings;
     /**
@@ -143,26 +210,23 @@ export declare class ArcgisMap extends LitElement {
      * graphics.remove(pointGraphic);
      * ```
      */
-    graphics: __esri.Collection<__esri.Graphic>;
+    graphics: Collection<__esri.Graphic>;
     /** Specifies the surface properties for the map. */
     get ground(): typeof this._map.ground;
     set ground(value: __esri.Ground | string);
     /**
-     * The highlights property is a collection of HighlightGroup objects that
-     * allow you to visually emphasize specific features on the map.
+     * The highlights property is a collection of [HighlightOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-support-HighlightOptions.html) objects that
+     * allow you to visually emphasize specific features on the map. See [MapView.highlights](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#highlights) for more information.
      */
-    highlights: __esri.Collection<__esri.HighlightOptions>;
+    highlights: Collection<__esri.HighlightOptions>;
     /**
      * Options for configuring the highlight.
      *
-     * @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.
+     * @deprecated since version 4.32. Use the [highlights](#highlights) property instead.
      */
     highlightOptions: __esri.HighlightOptions;
     /**
-     * Indication whether the view is being interacted with (for example when panning or by an interactive tool).
+     * Indicates whether the view is being interacted with (for example, when panning or via an interactive tool).
      *
      * @default false
      */
@@ -174,17 +238,17 @@ export declare class ArcgisMap extends LitElement {
      *
      * 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 Map component loads.
      */
-    get itemId(): Nil | string;
-    set itemId(newValue: Nil | string);
+    get itemId(): nil | string;
+    set itemId(newValue: nil | string);
     /**
      * A collection containing a hierarchical list of all the created
-     * esri/views/layers/LayerView LayerViews of the
-     * esri/Map#layers operational layers in the map.
+     * [LayerView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-layers-LayerView.html)s of the
+     * [operational layers](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html#layers) in the map.
      */
-    readonly layerViews: __esri.Collection<__esri.LayerView>;
+    readonly layerViews: Collection<__esri.LayerView>;
     /** The magnifier allows for showing a portion of the view as a magnifier image on top of the view. */
     readonly magnifier: __esri.Magnifier;
-    /** An instance of a esri/Map object to display in the view. */
+    /** An instance of a [Map](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html) object to display in the view. */
     map: __esri.Map | nullish;
     /**
      * Indication whether the view is being navigated (for example when panning).
@@ -195,9 +259,11 @@ export declare class ArcgisMap extends LitElement {
     /** 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.
+     * Padding to make the map's center and extent work off a
+     * subsection of the full map. This is particularly useful when layering UI
+     * elements or semi-transparent content on top of portions of the map.
      *
+     * @see [Sample: Map padding](https://developers.arcgis.com/javascript/latest/sample-code/map-padding/)
      * @default {left: 0, top: 0, right: 0, bottom: 0}
      */
     padding: __esri.ViewPadding;
@@ -215,8 +281,16 @@ export declare class ArcgisMap extends LitElement {
      */
     popupDisabled: boolean;
     /**
-     * When `true`, this property indicates whether the view successfully satisfied all dependencies,
-     * signaling that the following conditions are met.
+     * When `true`, this property indicates whether the [view](#view) has successfully satisfied all dependencies, signaling that the following conditions are met:
+     *
+     * * The view has a [map](#map). If [map](#map)
+     * is a [WebMap](https://developers.arcgis.com/javascript/latest/api-reference/esri-WebMap.html), then the map
+     * must be [loaded](https://developers.arcgis.com/javascript/latest/api-reference/esri-WebMap.html#loaded).
+     * * The view has a [spatialReference](#spatialReference), a [center](#center), and a [scale](#scale).
+     * These also can be inferred by setting an [extent](#extent).
+     *
+     * When a view becomes ready it will resolve itself and invoke
+     * the callback defined in [viewOnReady()](#viewOnReady) where code can execute on a working view.
      *
      * @default false
      */
@@ -228,7 +302,7 @@ export declare class ArcgisMap extends LitElement {
      *
      * @default "center"
      */
-    resizeAlign: "center" | "bottom-left" | "bottom-right" | "top-left" | "top-right" | "left" | "right" | "top" | "bottom";
+    resizeAlign: "bottom-left" | "bottom-right" | "top-left" | "top-right" | "center" | "left" | "right" | "top" | "bottom";
     /**
      * Represents the current value of one pixel in the unit of the view's spatialReference.
      * The value of resolution is calculated by dividing the view's extent width
@@ -248,7 +322,7 @@ export declare class ArcgisMap extends LitElement {
     rotation: number;
     /**
      * 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.
+     * the view, see this component's [goTo()](#goTo) method.
      */
     get scale(): number;
     set scale(newValue: number);
@@ -260,6 +334,16 @@ export declare class ArcgisMap extends LitElement {
      * @default null
      */
     spatialReference: __esri.SpatialReference;
+    /**
+     * Indicates if the map's [spatialReference](#spatialReference) can be changed after it is ready.
+     * The default is `false`, indicating the map's spatialReference can be changed at runtime.
+     * When true, basemaps with spatial references that do not match the map's spatial reference
+     * will be disabled in [arcgis-basemap-gallery](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-basemap-gallery/) and [arcgis-basemap-toggle](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-basemap-toggle/) components and the map's spatialReference cannot be changed at runtime.
+     *
+     * @since 4.34
+     * @default false
+     */
+    spatialReferenceLocked: boolean;
     /**
      * Indication whether the view is animating, being navigated with or resizing.
      *
@@ -273,8 +357,7 @@ export declare class ArcgisMap extends LitElement {
      */
     readonly suspended: boolean;
     /**
-     * This property specifies the base colors used by some widgets
-     * and components to render graphics and labels.
+     * This property specifies the base colors used by some components to render graphics and labels.
      *
      * @default null
      */
@@ -306,7 +389,7 @@ export declare class ArcgisMap extends LitElement {
     /**
      * 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.
+     * the view, see this component's [goTo()](#goTo) method.
      */
     get viewpoint(): __esri.Viewpoint;
     set viewpoint(newValue: __esri.Viewpoint);
@@ -318,42 +401,47 @@ export declare class ArcgisMap extends LitElement {
      */
     readonly visibleArea: nullish | __esri.Polygon;
     /**
-     * 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.
+     * Represents the level of detail (LOD) at the center of the map.
+     * A zoom level (or scale) is a number that defines how large or small the contents of a map appear in a Map component.
      * 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.
+     * A value of -1 means the map has no LODs.
+     * When setting the zoom value, the component converts it to the corresponding scale, or interpolates it if the zoom is a fractional number.
      *
-     * Setting the zoom immediately changes the current view. For animating the view, see this component's goTo() method.
+     * Setting the zoom immediately changes the current view. For animating the view, see this component's [goTo()](#goTo) method.
      * Setting this property in conjunction with `center` is a convenient way to set the initial extent of the view.
      */
     get zoom(): number;
     set zoom(newValue: number);
+    /**
+     * An array of objects that encountered an error while loading the component or any of its dependencies (e.g., basemap, ground, layers, tables). You may inspect the errors by accessing each object's `loadError` property.
+     *
+     * @since 4.34
+     */
+    loadErrorSources?: LoadErrorSource[];
     /**
      * @deprecated
-     * since 4.33. Use `element.map.add(layer)` instead.
+     * 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
-     * since 4.33. Use `element.map.addMany([layer])` instead.
+     * 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
-     * since 4.33. Use `element.map.tables.add(table)` instead.
+     * 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
-     * since 4.33. Use `element.map.tables.addMany([table])` instead.
+     * since 4.33, use `element.map.tables.addMany([table])` instead.
      *
      * Adds a table or array of tables to the map tables collection.
      */
@@ -377,13 +465,147 @@ export declare class ArcgisMap extends LitElement {
     toScreen(point: __esri.Point, options?: __esri.ToScreenOptions2D): __esri.MapViewScreenPoint | nullish;
     /** Call this method to clear any fatal errors resulting from a lost WebGL context. */
     tryFatalErrorRecovery(): Promise<void>;
-    /** Gets the LayerView created on the view for the given layer. */
-    whenLayerView(layer: __esri.Layer): Promise<__esri.LayerView>;
     /**
-     * `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.
+     * `viewOnReady()` may be leveraged once an instance of the component and its underlying [view](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/#view) is created and ready.
+     * This method takes two input parameters, a `callback` function and an `errback` function, and returns a promise. The `callback` executes when the promise resolves, and the `errback` executes if the promise is rejected.
+     *
+     * @since 4.33
+     * @see [Watch for changes - waiting for components or views to be ready](https://developers.arcgis.com/javascript/latest/watch-for-changes/#waiting-for-components-or-views-to-be-ready)
+     * @example
+     * ```js
+     * const viewElement = document.querySelector("arcgis-map");
+     * await viewElement.viewOnReady();
+     * // The view is now ready to be used.
+     * viewElement.map.add(new FeatureLayer({...}));
+     * ```
      */
     viewOnReady(callback?: () => void, errback?: (error: Error) => void): Promise<void>;
+    /**
+     * Gets the analysis view created for the given analysis object.
+     *
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#whenAnalysisView)
+     */
+    whenAnalysisView(analysis: __esri.ElevationProfileAnalysis): Promise<__esri.ElevationProfileAnalysisView2D>;
+    /**
+     * Gets the LayerView created on the view for the given layer.
+     *
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#whenLayerView)
+     */
+    whenLayerView(layer: __esri.PointCloudLayer): Promise<__esri.PointCloudLayerView>;
+    /**
+     * Gets the LayerView created on the view for the given layer.
+     *
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#whenLayerView)
+     */
+    whenLayerView(layer: __esri.StreamLayer): Promise<__esri.StreamLayerView>;
+    /**
+     * Gets the LayerView created on the view for the given layer.
+     *
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#whenLayerView)
+     */
+    whenLayerView(layer: __esri.WFSLayer): Promise<__esri.WFSLayerView>;
+    /**
+     * Gets the LayerView created on the view for the given layer.
+     *
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#whenLayerView)
+     */
+    whenLayerView(layer: __esri.OGCFeatureLayer): Promise<__esri.OGCFeatureLayerView>;
+    /**
+     * Gets the LayerView created on the view for the given layer.
+     *
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#whenLayerView)
+     */
+    whenLayerView(layer: __esri.FeatureLayer): Promise<__esri.FeatureLayerView>;
+    /**
+     * Gets the LayerView created on the view for the given layer.
+     *
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#whenLayerView)
+     */
+    whenLayerView(layer: __esri.CSVLayer): Promise<__esri.CSVLayerView>;
+    /**
+     * Gets the LayerView created on the view for the given layer.
+     *
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#whenLayerView)
+     */
+    whenLayerView(layer: __esri.GeoJSONLayer): Promise<__esri.GeoJSONLayerView>;
+    /**
+     * Gets the LayerView created on the view for the given layer.
+     *
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#whenLayerView)
+     */
+    whenLayerView(layer: __esri.GeoRSSLayer): Promise<__esri.GeoRSSLayerView>;
+    /**
+     * Gets the LayerView created on the view for the given layer.
+     *
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#whenLayerView)
+     */
+    whenLayerView(layer: __esri.GraphicsLayer): Promise<__esri.GraphicsLayerView>;
+    /**
+     * Gets the LayerView created on the view for the given layer.
+     *
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#whenLayerView)
+     */
+    whenLayerView(layer: __esri.ImageryLayer): Promise<__esri.ImageryLayerView>;
+    /**
+     * Gets the LayerView created on the view for the given layer.
+     *
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#whenLayerView)
+     */
+    whenLayerView(layer: __esri.KMLLayer): Promise<__esri.KMLLayerView>;
+    /**
+     * Gets the LayerView created on the view for the given layer.
+     *
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#whenLayerView)
+     */
+    whenLayerView(layer: __esri.SceneLayer): Promise<__esri.SceneLayerView>;
+    /**
+     * Gets the LayerView created on the view for the given layer.
+     *
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#whenLayerView)
+     */
+    whenLayerView(layer: __esri.DimensionLayer): Promise<__esri.DimensionLayerView>;
+    /**
+     * Gets the LayerView created on the view for the given layer.
+     *
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#whenLayerView)
+     */
+    whenLayerView(layer: __esri.MediaLayer): Promise<__esri.MediaLayerView>;
+    /**
+     * Gets the LayerView created on the view for the given layer.
+     *
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#whenLayerView)
+     */
+    whenLayerView(layer: __esri.ViewshedLayer): Promise<__esri.ViewshedLayerView>;
+    /**
+     * Gets the LayerView created on the view for the given layer.
+     *
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#whenLayerView)
+     */
+    whenLayerView(layer: __esri.LineOfSightLayer): Promise<__esri.LineOfSightLayerView>;
+    /**
+     * Gets the LayerView created on the view for the given layer.
+     *
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#whenLayerView)
+     */
+    whenLayerView(layer: __esri.Layer): Promise<__esri.LayerView>;
+    /**
+     * Fires when the view for an analysis is created.
+     *
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#event-analysis-view-create)
+     */
+    readonly arcgisViewAnalysisViewCreate: TargetedEvent<this, __esri.ViewAnalysisViewCreateEvent>;
+    /**
+     * Fires when an error occurs during the creation of an analysis view after an analysis is added to the view.
+     *
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#event-analysis-view-create-error)
+     */
+    readonly arcgisViewAnalysisViewCreateError: TargetedEvent<this, __esri.ViewAnalysisViewCreateErrorEvent>;
+    /**
+     * Fires after an analysis view is destroyed.
+     *
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#event-analysis-view-destroy)
+     */
+    readonly arcgisViewAnalysisViewDestroy: TargetedEvent<this, __esri.ViewAnalysisViewDestroyEvent>;
     /**
      * This event is for view related property changes: zoom, scale, center, rotation, extent, camera, viewpoint.
      * This event will also emit if stationary toggles from true to false.
@@ -430,7 +652,7 @@ export declare class ArcgisMap extends LitElement {
     readonly arcgisViewReadyChange: TargetedEvent<this, void>;
     private _map: __esri.Map;
     readonly _setterTypes: {
-        center?: __esri.MapView["center"] | Nil | number[] | string;
+        center?: __esri.MapView["center"] | nil | number[] | string;
         ground?: __esri.Ground | string;
     };
 }