@arcgis/map-components 5.0.0-next.75 → 5.0.0-next.77

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

@@ -7,12 +7,13 @@ 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';
+import { LayerView2DFor } from '@arcgis/core/views/2d/interfaces';
 
-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">, "basemap" | "ground" | "layers" | "presentation" | "tables" | "widgets" | "applicationProperties" | "authoringApp" | "authoringAppVersion" | "bookmarks" | "floorInfo" | "geotriggersInfo" | "initialViewProperties" | "portalItem" | "thumbnailUrl" | "utilityNetworks" | ("destroyed" | "initialized" | "declaredClass" | "set" | "watch" | "addHandles" | "removeHandles" | "hasHandles")> & {
+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">, "basemap" | "ground" | "layers" | "presentation" | "tables" | "widgets" | "applicationProperties" | "authoringApp" | "authoringAppVersion" | "bookmarks" | "floorInfo" | "geotriggersInfo" | "initialViewProperties" | "portalItem" | "thumbnailUrl" | "utilityNetworks" | ("declaredClass" | "destroyed" | "initialized" | "addHandles" | "hasHandles" | "removeHandles" | "set" | "watch")> & {
     autoDestroyDisabled: boolean;
     destroy: () => Promise<void>;
 }) => WebMap;
-declare const useMapView: (component: LitElement & Omit<Pick<MapView, "rotation" | "center" | "analyses" | "map" | "aria" | "attributionMode" | "background" | "basemapView" | "constraints" | "extent" | "fatalError" | "floors" | "graphics" | "highlights" | "highlightOptions" | "navigation" | "padding" | "popup" | "resizeAlign" | "scale" | "spatialReference" | "spatialReferenceLocked" | "theme" | "timeExtent" | "timeZone" | "viewpoint" | "zoom" | "widthBreakpoint" | "animation" | "animationsEnabled" | "attributionVisible" | "breakpoints" | "container" | "displayFilterEnabled" | "heightBreakpoint" | "popupEnabled" | "ui">, "widthBreakpoint" | "animation" | "animationsEnabled" | "attributionVisible" | "breakpoints" | "container" | "displayFilterEnabled" | "heightBreakpoint" | "popupEnabled" | "ui" | ("destroyed" | "initialized" | "declaredClass" | "set" | "watch" | "addHandles" | "removeHandles" | "hasHandles")> & {
+declare const useMapView: (component: LitElement & Omit<Pick<MapView, "rotation" | "center" | "analyses" | "map" | "aria" | "attributionMode" | "background" | "basemapView" | "constraints" | "extent" | "fatalError" | "floors" | "graphics" | "highlights" | "highlightOptions" | "navigation" | "padding" | "popup" | "resizeAlign" | "scale" | "spatialReference" | "spatialReferenceLocked" | "theme" | "timeExtent" | "timeZone" | "viewpoint" | "zoom" | "animation" | "animationsEnabled" | "attributionVisible" | "breakpoints" | "container" | "displayFilterEnabled" | "heightBreakpoint" | "popupEnabled" | "ui" | "widthBreakpoint">, "animation" | "animationsEnabled" | "attributionVisible" | "breakpoints" | "container" | "displayFilterEnabled" | "heightBreakpoint" | "popupEnabled" | "ui" | "widthBreakpoint" | ("declaredClass" | "destroyed" | "initialized" | "addHandles" | "hasHandles" | "removeHandles" | "set" | "watch")> & {
     autoDestroyDisabled: boolean;
     destroy: () => Promise<void>;
 }) => MapView;
@@ -155,16 +156,22 @@ export declare class ArcgisMap extends LitElement {
     /**
      * Collection containing a flat list of all the created LayerViews
      * related to the basemap, operational layers, and group layers in this view.
+     *
+     * @see [LayerView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-layers-LayerView.html)
      */
-    readonly allLayerViews: __esri.ReadonlyCollection<__esri.LayerView>;
+    allLayerViews: import('@arcgis/core/core/Collection.js').ReadonlyCollection<import('@arcgis/core/views/layers/LayerView').default>;
     /**
      * A collection of analyses associated with the view.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View2D.html#analyses)
-     *
      * @since 4.34
+     * @example
+     * // Adds an analysis to the View
+     * view.analyses.add(elevationProfileAnalysis);
+     * @example
+     * // Removes an analysis from the View
+     * view.analyses.remove(elevationProfileAnalysis);
      */
-    analyses: Collection<__esri.Analysis>;
+    analyses: Collection<import('@arcgis/core/analysis/Analysis').default>;
     /**
      * The attribution items displayed in the view's attribution.
      *
@@ -178,7 +185,7 @@ export declare class ArcgisMap extends LitElement {
      *
      * @since 5.0
      */
-    attributionMode: nullish | "light" | "dark";
+    attributionMode: import('@arcgis/core/support/modeUtils').Mode | null | undefined;
     /**
      * 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
@@ -192,9 +199,17 @@ export declare class ArcgisMap extends LitElement {
     /**
      * The background color of the Map component.
      *
-     * @default null
+     * @since 4.16
+     * @example
+     * let view = new MapView({
+     *   container: "viewDiv",
+     *   map: map,
+     *   background: { // autocasts new ColorBackground()
+     *     color: "magenta" // autocasts as new Color()
+     *   }
+     * });
      */
-    background: nullish | __esri.ColorBackground;
+    background: import('@arcgis/core/webmap/background/ColorBackground').default | null | undefined;
     /**
      * 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
@@ -207,7 +222,7 @@ export declare class ArcgisMap extends LitElement {
      */
     basemap?: __esri.Basemap | string;
     /** Represents the view for a single basemap after it has been added to the map. */
-    basemapView: __esri.BasemapView;
+    basemapView: import('@arcgis/core/views/BasemapView').default<import('@arcgis/core/views/layers/LayerView').default>;
     /**
      * Represents the view's center point; when setting the center, you may pass a
      * [Point](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Point.html) instance, numbers representing
@@ -273,8 +288,55 @@ export declare class ArcgisMap extends LitElement {
      */
     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 map. */
-    constraints: __esri.View2DConstraints;
+    /**
+     * Specifies constraints to scale, zoom, and rotation that may be applied to the map.
+     *
+     * @see [TileInfo#create()](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-TileInfo.html#create)
+     * @see [Zoom and LODs](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View2D.html#mapview-lods)
+     * @example
+     * view.constraints = {
+     *   geometry: { // Constrain lateral movement to Lower Manhattan
+     *     type: "extent",
+     *     xmin: -74.020,
+     *     ymin:  40.700,
+     *     xmax: -73.971,
+     *     ymax:  40.73
+     *   },
+     *   minScale: 500000, // User cannot zoom out beyond a scale of 1:500,000
+     *   maxScale: 0, // User can overzoom tiles
+     *   rotationEnabled: false // Disables map rotation
+     * };
+     * @example
+     * // This snippet shows how to set the MapView scale 1:1 while generating additional LODs for the MapView.constraints.
+     * const spatialReference = new SpatialReference({
+     *   wkid: 2154
+     * });
+     * const center = new Point({
+     *   x: 0,
+     *   y: 0,
+     *   spatialReference
+     * });
+     *
+     * // Create LODs from level 0 to 31
+     * const tileInfo = TileInfo.create({
+     *   spatialReference,
+     *   numLODs: 32
+     * });
+     * const lods = tileInfo.lods;
+     *
+     * let view = new MapView({
+     *   container: "viewDiv",
+     *   map,
+     *   scale: 1,
+     *   center,
+     *   spatialReference,
+     *   constraints: {
+     *     lods: lods,
+     *     snapToZoom: false
+     *   }
+     * });
+     */
+    constraints: import('@arcgis/core/views/2d/MapViewConstraints').default;
     /**
      * Indicates whether a layer's `displayFilterInfo` is honored when rendering layers in the view.
      * If `false`, display filters are ignored and all features are rendered.
@@ -300,11 +362,26 @@ export declare class ArcgisMap extends LitElement {
      */
     get extent(): __esri.MapView["extent"];
     set extent(newValue: __esri.MapView["extent"]);
-    /** A rejected view indicates a fatal error making it unable to display. */
-    fatalError: __esri.Error | nullish;
+    /**
+     * A rejected view indicates a fatal error making it unable to display.
+     *
+     * @since 4.12
+     * @see [tryFatalErrorRecovery()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View.html#tryFatalErrorRecovery)
+     * @example
+     * reactiveUtils.when(
+     *   () => view.fatalError,
+     *   () => {
+     *     console.error("Fatal Error! View has lost its WebGL context. Attempting to recover...");
+     *     view.tryFatalErrorRecovery();
+     *   }
+     * );
+     */
+    fatalError: import('@arcgis/core/core/Error').default<any> | null | undefined;
     /**
      * 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.
+     *
+     * @since 4.19
      */
     floors: Collection<string>;
     /** Gamepad input specific configuration settings. */
@@ -322,9 +399,43 @@ export declare class ArcgisMap extends LitElement {
      * // Removes a graphic from the View
      * graphics.remove(pointGraphic);
      * ```
+     * @see [Graphic](https://developers.arcgis.com/javascript/latest/api-reference/esri-Graphic.html)
+     * @see [GraphicsLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-GraphicsLayer.html)
+     * @see [Intro to graphics](https://developers.arcgis.com/javascript/latest/sample-code/intro-graphics/)
+     * @example
+     * // Adds a graphic to the View
+     * view.graphics.add(pointGraphic);
+     * @example
+     * // Removes a graphic from the View
+     * view.graphics.remove(pointGraphic);
+     */
+    graphics: Collection<import('@arcgis/core/Graphic').default>;
+    /**
+     * Specifies the surface properties for the map.
+     *
+     * @see [ElevationLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-ElevationLayer.html)
+     * @see [Ground](https://developers.arcgis.com/javascript/latest/api-reference/esri-Ground.html)
+     * @example
+     * // Use the world elevation service
+     * const map = new Map({
+     *   basemap: "topo-vector",
+     *   ground: "world-elevation"
+     * });
+     * @example
+     * // Create a map with the world elevation layer overlaid by a custom elevation layer
+     * const worldElevation = new ElevationLayer({
+     *   url: "//elevation3d.arcgis.com/arcgis/rest/services/WorldElevation3D/Terrain3D/ImageServer"
+     * });
+     * const customElevation = new ElevationLayer({
+     *   url: "https://my.server.com/arcgis/rest/service/MyElevationService/ImageServer"
+     * });
+     * const map = new Map({
+     *   basemap: "topo-vector",
+     *   ground: new Ground({
+     *    layers: [ worldElevation, customElevation ]
+     *   })
+     * });
      */
-    graphics: Collection<__esri.Graphic>;
-    /** Specifies the surface properties for the map. */
     get ground(): typeof this._map.ground;
     set ground(value: __esri.Ground | string);
     /**
@@ -367,22 +478,88 @@ export declare class ArcgisMap extends LitElement {
      *
      * @see [Sample: Highlight features by geometry](https://developers.arcgis.com/javascript/latest/sample-code/highlight-features-by-geometry/)
      * @see [Sample: Highlight point features](https://developers.arcgis.com/javascript/latest/sample-code/highlight-point-features/)
+     * @since 4.32
+     * @see [Sample: Highlight features by geometry](https://developers.arcgis.com/javascript/latest/sample-code/highlight-features-by-geometry/)
+     * @see [Sample: Highlight SceneLayer](https://developers.arcgis.com/javascript/latest/sample-code/highlight-scenelayer/)
+     * @see [Sample: Highlight point features](https://developers.arcgis.com/javascript/latest/sample-code/highlight-point-features/)
+     * @example
+     * // Use the default highlights collection to apply a highlight to features when you hover over them
+     *
+     * // A handler can be used to remove any previous highlight when applying a new one
+     * let hoverHighlight;
+     *
+     * view.on("pointer-move", (event) => {
+     *   // Search for the first feature in the featureLayer at the hovered location
+     *   view.hitTest(event, { include: featureLayer }).then((response) => {
+     *     if (response.results[0]) {
+     *        const graphic = response.results[0].graphic;
+     *        view.whenLayerView(graphic.layer).then((layerView) => {
+     *          // Remove any previous highlight, if it exists
+     *          hoverHighlight?.remove();
+     *          // Highlight the hit features with the temporary highlight options, which are pre-configured for this use case
+     *          hoverHighlight = layerView.highlight(graphic, { name: "temporary"});
+     *        });
+     *     }
+     *   });
+     * });
+     * @example
+     * // Override the default highlights collection
+     *
+     * const view = new MapView({
+     *   map: map,
+     *   container: "viewDiv",
+     *
+     *   // Set the highlight options to be used in the view
+     *   highlights: [
+     *     { name: "default", color: "orange" },
+     *     { name: "temporary", color: "magenta" },
+     *     { name: "table", color: "cyan", fillOpacity: 0.5, haloOpacity: 0}
+     *   ]
+     * });
+     * @example
+     * // Add highlight options to the collection after initialization
+     *
+     * const selectionHighlightOptions = {
+     *   name: "selection",
+     *   color: "#ff00ff", // bright fuchsia
+     *   haloOpacity: 0.8,
+     *   fillOpacity: 0.2
+     * };
+     *
+     * // Add the options to the highlights collection at the first position
+     * view.highlights.add(selectionGroup, 0);
      */
-    highlights: Collection<__esri.HighlightOptions>;
+    highlights: Collection<import('@arcgis/core/views/support/HighlightOptions').default>;
     /**
-     * Options for configuring the highlight.
+     * Options for configuring the highlight. Use the highlight method on the
+     * appropriate [LayerView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-layers-LayerView.html) to highlight a feature.
      *
-     * @deprecated since version 4.32. Use the [highlights](#highlights) property instead.
+     * @deprecated since version 4.32. Use the [highlights](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View2D.html#highlights) property instead.
+     * @see [Sample: Highlight SceneLayer](https://developers.arcgis.com/javascript/latest/sample-code/highlight-scenelayer/)
+     * @see [Sample: Highlight point features](https://developers.arcgis.com/javascript/latest/sample-code/highlight-point-features/)
+     * @example
+     * const view = new MapView({
+     *   map: map,
+     *   highlightOptions: {
+     *     color: [255, 255, 0, 1],
+     *     haloOpacity: 0.9,
+     *     fillOpacity: 0.2
+     *   }
+     * });
      */
-    highlightOptions: __esri.HighlightOptions;
+    highlightOptions: import('@arcgis/core/views/support/HighlightOptions').default;
     /**
      * Indicates whether the view is being interacted with (for example, when panning or via an interactive tool).
      *
      * @default false
      */
     get interacting(): boolean;
-    /** Contains indoor positioning system information for the map. */
-    ipsInfo: nullish | __esri.IPSInfo;
+    /**
+     * Contains indoor positioning system information for the map.
+     *
+     * @since 4.31
+     */
+    ipsInfo: import('@arcgis/core/webdoc/IPSInfo').default | null | undefined;
     /**
      * The ID of a WebMap from ArcGIS Online or ArcGIS Enterprise portal.
      *
@@ -394,20 +571,51 @@ export declare class ArcgisMap extends LitElement {
      * A collection containing a hierarchical list of all the created
      * [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.
+     *
+     * @see [LayerView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-layers-LayerView.html)
      */
-    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;
+    layerViews: Collection<import('@arcgis/core/views/layers/LayerView').default>;
+    /**
+     * The magnifier allows for showing a portion of the view as a magnifier image on top of the view.
+     *
+     * @since 4.19
+     */
+    magnifier: import('@arcgis/core/views/Magnifier').default;
     /** An instance of a [Map](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html) object to display in the view. */
-    map: nullish | __esri.Map;
+    map: import('@arcgis/core/Map').default | null | undefined;
     /**
      * 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;
+    /**
+     * Options to configure the navigation behavior of the View.
+     *
+     * @since 4.9
+     * @example
+     * // Disable the gamepad usage, single touch panning, panning momentum and mouse wheel zooming.
+     * const view = new MapView({
+     *   container: "viewDiv",
+     *   map: new Map({
+     *     basemap: "satellite"
+     *   }),
+     *   center: [176.185, -37.643],
+     *   zoom: 13,
+     *   navigation: {
+     *     gamepad: {
+     *       enabled: false
+     *     },
+     *     actionMap: {
+     *       dragSecondary: "none", // Disable rotating the view with the right mouse button
+     *       mouseWheel: "none" // Disable zooming with the mouse wheel
+     *     },
+     *     browserTouchPanEnabled: false,
+     *     momentumEnabled: false,
+     *   }
+     * });
+     */
+    navigation: import('@arcgis/core/views/navigation/Navigation').default;
     /**
      * Padding to make the map's center and extent work off a
      * subsection of the full map. This is particularly useful when layering UI
@@ -416,14 +624,38 @@ export declare class ArcgisMap extends LitElement {
      * @default {left: 0, top: 0, right: 0, bottom: 0}
      * @see [Sample: Map padding](https://developers.arcgis.com/javascript/latest/sample-code/map-padding/)
      */
-    padding: __esri.ViewPadding;
+    padding: import('@arcgis/core/views/ui/Padding').Padding;
     /**
      * 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).
+     * [Map#layers](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html#layers) in the {@link views /PopupView#map}.
+     *
+     * By default, the `popup` property is an empty object that allows you to set the popup options.
+     * A [Popup](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Popup.html) instance is automatically created and assigned to the view's [popup](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-PopupView.html#popup)
+     * when the user clicks on the view and [popupEnabled](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-PopupView.html#popupEnabled) is `true`, when the [View2D#openPopup()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View2D.html#openPopup) method is called,
+     * or when some widgets need the popup, such as [Search](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search.html). If [popup](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-PopupView.html#popup) is `null`, the popup instance will not be created.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View2D.html#popup)
+     * @see [popupEnabled](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-PopupView.html#popupEnabled)
+     * @see [openPopup()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-PopupView.html#openPopup)
+     * @see [Loading the Popup](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Popup.html#loading-the-popup)
+     * @example
+     * // Set the view's popup to a new Popup instance.
+     * // The popup will show anytime a popup is called such as when selecting features or displaying a Search result.
+     * view.popup = new Popup();
+     * @example
+     * // Set the popup to a PopupOptions object with popup properties set such as the dock options.
+     * // The popup will show anytime a popup is called.
+     * view.popup = {
+     *  dockEnabled: true,
+     *  dockOptions: {
+     *    position: "top-left",
+     *    breakpoint: false
+     *  }
+     * };
+     * @example
+     * // Set the popup to null. This disables the popup so it will never show up.
+     * view.popup = null;
      */
-    popup: nullish | __esri.Popup;
+    popup: import('@arcgis/core/widgets/Popup').default | null | undefined;
     /**
      * Controls whether the popup opens automatically when users click on the view.
      *
@@ -443,8 +675,9 @@ export declare class ArcgisMap extends LitElement {
      * the callback defined in [viewOnReady()](#viewOnReady) where code can execute on a working view.
      *
      * @default false
+     * @see [when()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View.html#when)
      */
-    readonly ready: boolean;
+    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
@@ -452,13 +685,15 @@ export declare class ArcgisMap extends LitElement {
      *
      * @default "center"
      */
-    resizeAlign: "center" | "top-left" | "top-right" | "bottom-left" | "bottom-right" | "left" | "right" | "top" | "bottom";
+    resizeAlign: import('@arcgis/core/views/2d/ViewStateManager').ResizeAlign;
     /**
      * 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
      * by its width.
+     *
+     * @since 4.9
      */
-    readonly resolution: number;
+    resolution: number;
     /**
      * The clockwise rotation of due north in relation to the top of the view in degrees.
      * The view may be rotated by directly setting
@@ -468,6 +703,23 @@ export declare class ArcgisMap extends LitElement {
      * an example of this.
      *
      * @default 0
+     * @example
+     * // Due north is rotated 90 degrees, pointing to the right side of the view
+     * view.rotation = 90;
+     * @example
+     * // Due north is rotated 180 degrees, pointing to the bottom of the view
+     * view.rotation = 180;
+     * @example
+     * // Due north is rotated 270 degrees, pointing to the left side of the view
+     * view.rotation = 270;
+     * @example
+     * // Due north is rotated 0 degrees, pointing to the top of the view (the default)
+     * view.rotation = 0; // 360 or multiple of 360 (e.g. 720) works here as well.
+     * @example
+     * // Disables map rotation
+     * view.constraints = {
+     *   rotationEnabled: false
+     * };
      */
     rotation: number;
     /**
@@ -530,7 +782,7 @@ export declare class ArcgisMap extends LitElement {
      * }
      * ```
      */
-    spatialReference: __esri.SpatialReference;
+    spatialReference: import('@arcgis/core/geometry/SpatialReference').default;
     /**
      * 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.
@@ -552,28 +804,64 @@ export declare class ArcgisMap extends LitElement {
      *
      * @default true
      */
-    readonly suspended: boolean;
+    suspended: boolean;
     /**
      * This property specifies the base colors used by some components to render graphics and labels.
      *
-     * @default null
+     * @since 4.28
+     * @see [Theme](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-Theme.html)
+     * @see [Sample - Color theming for interactive tools](https://developers.arcgis.com/javascript/latest/sample-code/view-theme/)
+     * @example
+     * // Update the theme to use purple graphics
+     * // and slightly transparent green text
+     * view.theme = new Theme({
+     *   accentColor: "purple",
+     *   textColor: [125, 255, 13, 0.9]
+     * });
      */
-    theme: nullish | __esri.Theme;
+    theme: import('@arcgis/core/views/Theme').default | null | undefined;
     /**
      * The view's time extent. Time-aware layers display their temporal data that falls within
      * 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
+     * @since 4.12
+     * @example
+     * // Create a csv layer from an online spreadsheet.
+     * let csvLayer = new CSVLayer({
+     *   url: "http://test.com/daily-magazines-sold-in-new-york.csv",
+     *   timeInfo: {
+     *     startField: "SaleDate" // The csv field contains date information.
+     *   }
+     * });
+     *
+     * // Create a mapview showing sales for the last week of March 2019 only.
+     * const view = new MapView({
+     *   map: map,
+     *   container: "viewDiv",
+     *   timeExtent: {
+     *     start: new Date("2019, 2, 24"),
+     *     end:   new Date("2019, 2, 31")
+     *   }
+     * });
      */
-    timeExtent: nullish | __esri.TimeExtent;
+    timeExtent: import('@arcgis/core/time/TimeExtent').default | null | undefined;
     /**
      * 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"
+     * @since 4.28
+     * @see [wikipedia - List of tz database time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)
+     * @example
+     * // Date and time will be displayed in Pacific/Auckland (NZ) time zone
+     * const view = new MapView({
+     *   map: map,
+     *   container: "viewDiv",
+     *   timeZone: "Pacific/Auckland"
+     * });
      */
     timeZone: string;
     /**
@@ -582,7 +870,7 @@ export declare class ArcgisMap extends LitElement {
      *
      * @default false
      */
-    readonly updating: boolean;
+    updating: boolean;
     /**
      * Represents the current view as a Viewpoint or point of observation on the view.
      * Setting the viewpoint immediately changes the current view. For animating
@@ -591,12 +879,16 @@ 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).
+     * 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). This is similar to the view
+     * [MapView#extent](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#extent) but is a more accurate representation of the visible area especially
+     * when the view is rotated. An example use of the visible area is to spatially filter visible features
+     * in a layer view query.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View2D.html#visibleArea)
+     * @since 4.31
+     * @see [MapView#extent](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#extent)
      */
-    readonly visibleArea: __esri.Polygon | nullish;
+    visibleArea: import('@arcgis/core/geometry/Polygon').default | null | undefined;
     /**
      * 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.
@@ -787,135 +1079,7 @@ export declare class ArcgisMap extends LitElement {
      *
      * @param layer
      */
-    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)
-     *
-     * @param layer
-     */
-    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)
-     *
-     * @param layer
-     */
-    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)
-     *
-     * @param layer
-     */
-    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)
-     *
-     * @param layer
-     */
-    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)
-     *
-     * @param layer
-     */
-    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)
-     *
-     * @param layer
-     */
-    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)
-     *
-     * @param layer
-     */
-    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)
-     *
-     * @param layer
-     */
-    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)
-     *
-     * @param layer
-     */
-    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)
-     *
-     * @param layer
-     */
-    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)
-     *
-     * @param layer
-     */
-    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)
-     *
-     * @param layer
-     */
-    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)
-     *
-     * @param layer
-     */
-    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)
-     *
-     * @param layer
-     */
-    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)
-     *
-     * @param layer
-     */
-    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)
-     *
-     * @param layer
-     */
-    whenLayerView(layer: __esri.Layer): Promise<__esri.LayerView>;
+    whenLayerView<TLayer extends __esri.Layer>(layer: TLayer): Promise<LayerView2DFor<TLayer>>;
     /**
      * Fires when the view for an analysis is created.
      *
@@ -923,7 +1087,7 @@ export declare class ArcgisMap extends LitElement {
      *
      * @since 4.34
      */
-    readonly arcgisViewAnalysisViewCreate: TargetedEvent<this, __esri.ViewAnalysisViewCreateEvent>;
+    readonly arcgisViewAnalysisViewCreate: TargetedEvent<this, import('@arcgis/core/views/IView').AnalysisViewCreateEvent>;
     /**
      * Fires when an error occurs during the creation of an analysis view after an analysis is added to the view.
      *
@@ -931,7 +1095,7 @@ export declare class ArcgisMap extends LitElement {
      *
      * @since 4.34
      */
-    readonly arcgisViewAnalysisViewCreateError: TargetedEvent<this, __esri.ViewAnalysisViewCreateErrorEvent>;
+    readonly arcgisViewAnalysisViewCreateError: TargetedEvent<this, import('@arcgis/core/views/IView').AnalysisViewCreateErrorEvent>;
     /**
      * Fires after an analysis view is destroyed.
      *
@@ -939,7 +1103,7 @@ export declare class ArcgisMap extends LitElement {
      *
      * @since 4.34
      */
-    readonly arcgisViewAnalysisViewDestroy: TargetedEvent<this, __esri.ViewAnalysisViewDestroyEvent>;
+    readonly arcgisViewAnalysisViewDestroy: TargetedEvent<this, import('@arcgis/core/views/IView').AnalysisViewDestroyEvent>;
     /**
      * This event is triggered when view-related properties change, such as [zoom](#zoom), [scale](#scale), [center](#center), [rotation](#rotation), [extent](#extent),
      * [viewpoint](#viewpoint), or [stationary](#stationary).
@@ -984,7 +1148,7 @@ export declare class ArcgisMap extends LitElement {
      * });
      * ```
      */
-    readonly arcgisViewClick: TargetedEvent<this, __esri.ViewClickEvent>;
+    readonly arcgisViewClick: TargetedEvent<this, import('@arcgis/core/views/input/IViewEvents').ClickEvent>;
     /**
      * Fires after double-clicking on the view.
      *
@@ -996,11 +1160,11 @@ export declare class ArcgisMap extends LitElement {
      * });
      * ```
      */
-    readonly arcgisViewDoubleClick: TargetedEvent<this, __esri.ViewDoubleClickEvent>;
+    readonly arcgisViewDoubleClick: TargetedEvent<this, import('@arcgis/core/views/input/IViewEvents').DoubleClickEvent>;
     /** Fires during a pointer drag on the view. */
-    readonly arcgisViewDrag: TargetedEvent<this, __esri.ViewDragEvent>;
+    readonly arcgisViewDrag: TargetedEvent<this, import('@arcgis/core/views/input/IViewEvents').DragEvent>;
     /** Fires after holding either a mouse button or a single finger on the view for a short amount of time. */
-    readonly arcgisViewHold: TargetedEvent<this, __esri.ViewHoldEvent>;
+    readonly arcgisViewHold: TargetedEvent<this, import('@arcgis/core/views/input/IViewEvents').HoldEvent>;
     /**
      * Fires right after a user clicks on the view. In contrast to the [arcgisViewClick](#arcgisViewClick) event, the `arcgisViewImmediateClick`
      * is emitted as soon as the user clicks on the view, and is not inhibited by a [arcgisViewDoubleClick](#arcgisViewDoubleClick) event.
@@ -1014,13 +1178,13 @@ export declare class ArcgisMap extends LitElement {
      * });
      * ```
      */
-    readonly arcgisViewImmediateClick: TargetedEvent<this, __esri.ViewImmediateClickEvent>;
+    readonly arcgisViewImmediateClick: TargetedEvent<this, import('@arcgis/core/views/input/IViewEvents').ImmediateClickEvent>;
     /**
      * Fires after two consecutive [arcgisViewImmediateClick](#arcgisViewImmediateClick) events. In contrast to [arcgisViewDoubleClick](#arcgisViewDoubleClick),
      * an `arcgisViewImmediateDoubleClick` cannot be prevented by use of `stopPropagation()` on the [arcgisViewImmediateClick](#arcgisViewImmediateClick)
      * event and can therefore be used to react to double-clicking independently of usage of the [arcgisViewImmediateClick](#arcgisViewImmediateClick) event.
      */
-    readonly arcgisViewImmediateDoubleClick: TargetedEvent<this, __esri.ViewImmediateDoubleClickEvent>;
+    readonly arcgisViewImmediateDoubleClick: TargetedEvent<this, import('@arcgis/core/views/input/IViewEvents').ImmediateDoubleClickEvent>;
     /**
      * Fires after a keyboard key is pressed.
      *
@@ -1039,25 +1203,25 @@ export declare class ArcgisMap extends LitElement {
      * });
      * ```
      */
-    readonly arcgisViewKeyDown: TargetedEvent<this, __esri.ViewKeyDownEvent>;
+    readonly arcgisViewKeyDown: TargetedEvent<this, import('@arcgis/core/views/input/IViewEvents').KeyDownEvent>;
     /** Fires after a keyboard key is released. */
-    readonly arcgisViewKeyUp: TargetedEvent<this, __esri.ViewKeyUpEvent>;
+    readonly arcgisViewKeyUp: TargetedEvent<this, import('@arcgis/core/views/input/IViewEvents').KeyUpEvent>;
     /**
      * Fires after each layer in the map has a corresponding
      * [LayerView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-layers-LayerView.html)
      * created and rendered in the view.
      */
-    readonly arcgisViewLayerviewCreate: TargetedEvent<this, __esri.ViewLayerviewCreateEvent>;
+    readonly arcgisViewLayerviewCreate: TargetedEvent<this, import('@arcgis/core/views/input/IViewEvents').LayerViewCreateEvent>;
     /**
      * Fires when an error occurs during the creation of a [LayerView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-layers-LayerView.html)
      * after a layer has been added to the map.
      */
-    readonly arcgisViewLayerviewCreateError: TargetedEvent<this, __esri.ViewLayerviewCreateErrorEvent>;
+    readonly arcgisViewLayerviewCreateError: TargetedEvent<this, import('@arcgis/core/views/input/IViewEvents').LayerViewCreateErrorEvent>;
     /**
      * Fires after a [LayerView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-layers-LayerView.html)
      * is destroyed and is no longer rendered in the view.
      */
-    readonly arcgisViewLayerviewDestroy: TargetedEvent<this, __esri.ViewLayerviewDestroyEvent>;
+    readonly arcgisViewLayerviewDestroy: TargetedEvent<this, import('@arcgis/core/views/input/IViewEvents').LayerViewDestroyEvent>;
     /**
      * Fires when a wheel button of a pointing device (typically a mouse) is scrolled on the view.
      *
@@ -1069,25 +1233,25 @@ export declare class ArcgisMap extends LitElement {
      * });
      * ```
      */
-    readonly arcgisViewMouseWheel: TargetedEvent<this, __esri.ViewMouseWheelEvent>;
+    readonly arcgisViewMouseWheel: TargetedEvent<this, import('@arcgis/core/views/input/IViewEvents').ViewMouseWheelEvent>;
     /**
      * Fires after a mouse button is pressed, or a finger touches the display.
      *
      * @see [Sample: Access features with hitTest](https://developers.arcgis.com/javascript/latest/sample-code/map-component-hittest/)
      */
-    readonly arcgisViewPointerDown: TargetedEvent<this, __esri.ViewPointerDownEvent>;
+    readonly arcgisViewPointerDown: TargetedEvent<this, import('@arcgis/core/views/input/IViewEvents').PointerDownEvent>;
     /** Fires after a mouse cursor enters the view, or a display touch begins. */
-    readonly arcgisViewPointerEnter: TargetedEvent<this, __esri.ViewPointerEnterEvent>;
+    readonly arcgisViewPointerEnter: TargetedEvent<this, import('@arcgis/core/views/input/IViewEvents').PointerEnterEvent>;
     /** Fires after a mouse cursor leaves the view, or a display touch ends. */
-    readonly arcgisViewPointerLeave: TargetedEvent<this, __esri.ViewPointerLeaveEvent>;
+    readonly arcgisViewPointerLeave: TargetedEvent<this, import('@arcgis/core/views/input/IViewEvents').PointerLeaveEvent>;
     /**
      * Fires after the mouse or a finger on the display moves.
      *
      * @see [Sample: Access features with hitTest](https://developers.arcgis.com/javascript/latest/sample-code/map-component-hittest/)
      */
-    readonly arcgisViewPointerMove: TargetedEvent<this, __esri.ViewPointerMoveEvent>;
+    readonly arcgisViewPointerMove: TargetedEvent<this, import('@arcgis/core/views/input/IViewEvents').PointerMoveEvent>;
     /** Fires after a mouse button is released, or a display touch ends. */
-    readonly arcgisViewPointerUp: TargetedEvent<this, __esri.ViewPointerUpEvent>;
+    readonly arcgisViewPointerUp: TargetedEvent<this, import('@arcgis/core/views/input/IViewEvents').PointerUpEvent>;
     /**
      * This event is for the `ready` property and is emitted when the view is ready.
      * Fires also when the [map](#map) is updated.