@arcgis/map-components 5.1.0-next.1 → 5.1.0-next.10

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

@@ -26,7 +26,7 @@ import type Theme from "@arcgis/core/views/Theme.js";
 import type TimeExtent from "@arcgis/core/time/TimeExtent.js";
 import type Polygon from "@arcgis/core/geometry/Polygon.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
-import type { LoadErrorSource } from "../../controllers/useArcgisLoadError.js";
+import type { LoadErrorSource } from "../types.js";
 import type { ArcgisPopup } from "../arcgis-popup/customElement.js";
 import type { LayerView2DFor } from "@arcgis/core/views/2d/types";
 import type { DoubleClickEvent, DoubleTapDragEvent, VerticalTwoFingerDragEvent, PointerUpEvent, PointerMoveEvent, PointerLeaveEvent, PointerEnterEvent, PointerDownEvent, ViewMouseWheelEvent, LayerViewDestroyEvent, LayerViewCreateErrorEvent, LayerViewCreateEvent, KeyUpEvent, KeyDownEvent, ImmediateDoubleClickEvent, ImmediateClickEvent, HoldEvent, DragEvent, ClickEvent } from "@arcgis/core/views/input/types";
@@ -40,14 +40,14 @@ import type { ResizeAlign } from "@arcgis/core/views/2d/types.js";
 
 /**
  * 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/).
+ * [ArcGIS Scene component](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/).
  *
  * #### Initializing the Map component
- * The Map component creates a [MapView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html)
+ * The Map component creates a [MapView](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/)
  * and can be initialized in one of three ways:
  *
  * ##### 1. Using a WebMap
- * Load a [WebMap](https://developers.arcgis.com/javascript/latest/api-reference/esri-WebMap.html) from [ArcGIS Online](https://www.arcgis.com/home/index.html)
+ * Load a [WebMap](https://developers.arcgis.com/javascript/latest/references/core/WebMap/) from [ArcGIS Online](https://www.arcgis.com/home/index.html)
  * or an [ArcGIS Enterprise portal](https://enterprise.arcgis.com/en/portal/latest/administer/windows/what-is-portal-for-arcgis-.htm) by specifying the [item-id](#itemId) attribute.
  *
  * ```html
@@ -62,8 +62,8 @@ import type { ResizeAlign } from "@arcgis/core/views/2d/types.js";
  * ```
  *
  * ##### 3. Providing a Map instance
- * Alternatively, you can provide your own [Map](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html) instance to the component.
- * This allows full control over map configuration, including [basemap](#basemap), operational [layers](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html#layers)
+ * Alternatively, you can provide your own [Map](https://developers.arcgis.com/javascript/latest/references/core/Map/) instance to the component.
+ * This allows full control over map configuration, including [basemap](#basemap), operational [layers](https://developers.arcgis.com/javascript/latest/references/core/Map/#layers)
  * and [spatial reference](#spatialReference). See the [Select features by rectangle sample](https://developers.arcgis.com/javascript/latest/sample-code/highlight-features-by-geometry/)
  * for an example of this approach in action.
  *
@@ -94,7 +94,7 @@ import type { ResizeAlign } from "@arcgis/core/views/2d/types.js";
  * </arcgis-map>
  * ```
  *
- * The Map component can be customized further using any of the [core API functionalities](https://developers.arcgis.com/javascript/latest/api-reference/) of the ArcGIS Maps SDK for JavaScript.
+ * The Map component can be customized further using any of the [core API functionalities](https://developers.arcgis.com/javascript/latest/references/core/) of the ArcGIS Maps SDK for JavaScript.
  *
  * ```js
  * const viewElement = document.querySelector("arcgis-map");
@@ -123,7 +123,7 @@ import type { ResizeAlign } from "@arcgis/core/views/2d/types.js";
  * @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. Only the Popup component can be placed in this slot.
+ * @slot [popup] - Slot for the [Popup](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/) component to open automatically on click. Only the Popup component can be placed in this slot.
  * @since 4.28
  */
 export abstract class ArcgisMap extends LitElement {
@@ -131,7 +131,7 @@ export abstract 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)
+   * @see [LayerView](https://developers.arcgis.com/javascript/latest/references/core/views/layers/LayerView/)
    */
   get allLayerViews(): ReadonlyCollection<LayerView>;
   /**
@@ -148,14 +148,14 @@ export abstract class ArcgisMap extends LitElement {
   accessor analyses: Collection<Analysis2>;
   /**
    * 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)
+   * [CIMSymbol](https://developers.arcgis.com/javascript/latest/references/core/symbols/CIMSymbol/),
+   * [PictureMarkerSymbol](https://developers.arcgis.com/javascript/latest/references/core/symbols/PictureMarkerSymbol/)
    * 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
+   * ([FlowRenderer](https://developers.arcgis.com/javascript/latest/references/core/rasterRenderers/#FlowRenderer)),
+   * animated layers ([MediaLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/MediaLayer/),
+   * [VideoLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/VideoLayer/)), and
    * animations triggered by view navigation (for example,
-   * [goTo()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#goTo)).
+   * [goTo()](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#goTo)).
    * Setting this property to `true` disables all animations in the view.
    *
    * @default false
@@ -181,7 +181,7 @@ export abstract class ArcgisMap extends LitElement {
    *
    * @since 5.0
    */
-  accessor attributionMode: "light" | "dark" | null | undefined;
+  accessor attributionMode: "dark" | "light" | 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
@@ -209,34 +209,48 @@ export abstract class ArcgisMap extends LitElement {
    * 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).
+   * It can either be set using a basemap ID string ([see values](https://developers.arcgis.com/javascript/latest/references/core/Map/#basemap)),
+   * [Basemap](https://developers.arcgis.com/javascript/latest/references/core/Basemap/)
+   * or [BasemapStyle](https://developers.arcgis.com/javascript/latest/references/core/support/BasemapStyle/).
    *
-   * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html#basemap)
+   * [Read more](https://developers.arcgis.com/javascript/latest/references/core/Map/#basemap)
    */
   accessor basemap: Basemap | string | undefined;
   /** Represents the view for a single basemap after it has been added to the map. */
   accessor basemapView: BasemapView<LayerView>;
+  /**
+   * Indicates if the view component can zoom in.
+   *
+   * @default false
+   * @since 5.0
+   */
+  get canZoomIn(): boolean;
+  /**
+   * Indicates if the view component can zoom out.
+   *
+   * @default false
+   * @since 5.0
+   */
+  get canZoomOut(): boolean;
   /**
    * 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
+   * [Point](https://developers.arcgis.com/javascript/latest/references/core/geometry/Point/) instance, numbers representing
    * a longitude/latitude pair (`[-100.4593, 36.9014]`), or a string attribute 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()](#goTo) method.
    *
-   * The returned [Point](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Point.html) object is always
+   * The returned [Point](https://developers.arcgis.com/javascript/latest/references/core/geometry/Point/) object is always
    * in the spatial reference of the view and may be modified internally.
-   * To persist the returned object, create a clone using [clone()](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Point.html#clone) method.
+   * To persist the returned object, create a clone using [clone()](https://developers.arcgis.com/javascript/latest/references/core/geometry/Point/#clone) method.
    *
    * **Notes**
    *
    * * If the spatial reference of `center` set in the constructor does not match the [spatialReference](#spatialReference) of the view, then the
-   * [projectOperator](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-operators-projectOperator.html) will be loaded dynamically.
-   * * At runtime, the [projectOperator](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-operators-projectOperator.html) must be
-   * [loaded](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-operators-projectOperator.html#load) when
+   * [projectOperator](https://developers.arcgis.com/javascript/latest/references/core/geometry/operators/projectOperator/) will be loaded dynamically.
+   * * At runtime, the [projectOperator](https://developers.arcgis.com/javascript/latest/references/core/geometry/operators/projectOperator/) must be
+   * [loaded](https://developers.arcgis.com/javascript/latest/references/core/geometry/operators/projectOperator/#load) when
    * setting the `center` to a spatial reference that doesn't match the view spatial reference. You can check if the projectOperator is
-   * loaded prior to setting the center by calling [isLoaded()](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-operators-projectOperator.html#isLoaded)
-   * method. If it is not yet loaded, you can call [load()](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-operators-projectOperator.html#load) method.
+   * loaded prior to setting the center by calling [isLoaded()](https://developers.arcgis.com/javascript/latest/references/core/geometry/operators/projectOperator/#isLoaded)
+   * method. If it is not yet loaded, you can call [load()](https://developers.arcgis.com/javascript/latest/references/core/geometry/operators/projectOperator/#load) method.
    *
    * @example
    * ```html
@@ -286,8 +300,8 @@ export abstract class ArcgisMap extends LitElement {
   /**
    * 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)
+   * @see [TileInfo#create()](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TileInfo/#create)
+   * @see [Zoom and LODs](https://developers.arcgis.com/javascript/latest/references/core/views/View2D/#mapview-lods)
    * @example
    * view.constraints = {
    *   geometry: { // Constrain lateral movement to Lower Manhattan
@@ -340,7 +354,7 @@ export abstract class ArcgisMap extends LitElement {
    */
   accessor displayFilterDisabled: boolean;
   /**
-   * 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).
+   * The extent represents the visible portion of a map within the view as an instance of [Extent](https://developers.arcgis.com/javascript/latest/references/core/geometry/Extent/).
    * Setting the extent immediately changes the view without animation. To animate
    * 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.
@@ -348,19 +362,19 @@ export abstract class ArcgisMap extends LitElement {
    * **Notes**
    *
    * * If the spatial reference of `extent` set does not match the [spatialReference](#spatialReference) of the view, then the
-   * [projectOperator](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-operators-projectOperator.html) will be loaded dynamically.
-   * * At runtime, the [projectOperator](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-operators-projectOperator.html)
-   * must be [loaded](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-operators-projectOperator.html#load) when
+   * [projectOperator](https://developers.arcgis.com/javascript/latest/references/core/geometry/operators/projectOperator/) will be loaded dynamically.
+   * * At runtime, the [projectOperator](https://developers.arcgis.com/javascript/latest/references/core/geometry/operators/projectOperator/)
+   * must be [loaded](https://developers.arcgis.com/javascript/latest/references/core/geometry/operators/projectOperator/#load) when
    * setting the `extent` to a spatial reference that doesn't match the view spatial reference. You can check if the projectOperator is
-   * loaded prior to setting the extent by calling [isLoaded()](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-operators-projectOperator.html#isLoaded)
-   * method. If it is not yet loaded, you can call the [load](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-operators-projectOperator.html#load) method.
+   * loaded prior to setting the extent by calling [isLoaded()](https://developers.arcgis.com/javascript/latest/references/core/geometry/operators/projectOperator/#isLoaded)
+   * method. If it is not yet loaded, you can call the [load](https://developers.arcgis.com/javascript/latest/references/core/geometry/operators/projectOperator/#load) method.
    */
   accessor extent: MapView["extent"];
   /**
    * 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)
+   * @see [tryFatalErrorRecovery()](https://developers.arcgis.com/javascript/latest/references/core/views/View/#tryFatalErrorRecovery)
    * @example
    * reactiveUtils.when(
    *   () => view.fatalError,
@@ -391,16 +405,16 @@ export abstract 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 [Graphic](https://developers.arcgis.com/javascript/latest/references/core/Graphic/)
+   * @see [GraphicsLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/GraphicsLayer/)
    * @see [Intro to graphics](https://developers.arcgis.com/javascript/latest/sample-code/intro-graphics/)
    */
   accessor graphics: Collection<Graphic>;
   /**
    * 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)
+   * @see [ElevationLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/ElevationLayer/)
+   * @see [Ground](https://developers.arcgis.com/javascript/latest/references/core/Ground/)
    * @example
    * // Use the world elevation service
    * const map = new Map({
@@ -436,37 +450,21 @@ export abstract class ArcgisMap extends LitElement {
    */
   accessor hideAttribution: boolean;
   /**
-   * Options for configuring the highlight. Use the highlight method on the appropriate LayerView to highlight a feature. The layerView's `highlightOptions` will take precedence over the component's `highlightOptions` if both properties are set.
-   *
-   * @deprecated since version 4.32. Use the [highlights](#highlights) property instead.
-   * @see [Sample: Highlight SceneLayer](https://developers.arcgis.com/javascript/latest/sample-code/highlight-scenelayer/)
-   * @example
-   * const view = new MapView({
-   *   map: map,
-   *   highlightOptions: {
-   *     color: [255, 255, 0, 1],
-   *     haloOpacity: 0.9,
-   *     fillOpacity: 0.2
-   *   }
-   * });
-   */
-  accessor highlightOptions: HighlightOptions;
-  /**
-   * Represents a collection of [HighlightOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-support-HighlightOptions.html)
+   * Represents a collection of [HighlightOptions](https://developers.arcgis.com/javascript/latest/references/core/views/support/HighlightOptions/)
    * objects which can be used to highlight features throughout an application. Highlighting works by applying highlight options to one or
    * more features. You can configure these options (such as color or opacity) to define how a feature will be visually
    * emphasized.
    *
-   * A maximum of six [HighlightOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-support-HighlightOptions.html)
+   * A maximum of six [HighlightOptions](https://developers.arcgis.com/javascript/latest/references/core/views/support/HighlightOptions/)
    * objects are supported in the collection, and they can be added, removed, and reordered freely. Their order in the collection determines priority, with the last
    * object having the highest priority. If you apply more than one highlight to a feature, the one that is last within
-   * the collection will be applied. The [HighlightOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-support-HighlightOptions.html)
+   * the collection will be applied. The [HighlightOptions](https://developers.arcgis.com/javascript/latest/references/core/views/support/HighlightOptions/)
    * object must be part of this collection in order to be applied to features.
    *
-   * To highlight a feature, use the [highlight()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-layers-FeatureLayerView.html#highlight)
-   * method on the relevant [LayerView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-layers-LayerView.html) instance. To apply specific
-   * [HighlightOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-support-HighlightOptions.html), include the
-   * [name](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-support-HighlightOptions.html#name) in the `highlight()` method's `options` parameter.
+   * To highlight a feature, use the [highlight()](https://developers.arcgis.com/javascript/latest/references/core/views/layers/FeatureLayerView/#highlight)
+   * method on the relevant [LayerView](https://developers.arcgis.com/javascript/latest/references/core/views/layers/LayerView/) instance. To apply specific
+   * [HighlightOptions](https://developers.arcgis.com/javascript/latest/references/core/views/support/HighlightOptions/), include the
+   * [name](https://developers.arcgis.com/javascript/latest/references/core/views/support/HighlightOptions/#name) in the `highlight()` method's `options` parameter.
    * If no `name` is provided, the feature will use the `default` highlight options.
    *
    * The table below shows the default highlight options in the View's highlights collection if the collection has not
@@ -543,15 +541,15 @@ export abstract class ArcgisMap extends LitElement {
   /**
    * 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 Map component loads.
+   * To configure the portal url you must set the [`portalUrl` property on `config`](https://developers.arcgis.com/javascript/latest/references/core/config/#portalUrl) before the Map component loads.
    */
   accessor itemId: null | undefined | string;
   /**
    * 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.
+   * [LayerView](https://developers.arcgis.com/javascript/latest/references/core/views/layers/LayerView/)s of the
+   * [operational layers](https://developers.arcgis.com/javascript/latest/references/core/Map/#layers) in the map.
    *
-   * @see [LayerView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-layers-LayerView.html)
+   * @see [LayerView](https://developers.arcgis.com/javascript/latest/references/core/views/layers/LayerView/)
    */
   get layerViews(): Collection<LayerView>;
   /**
@@ -566,7 +564,7 @@ export abstract class ArcgisMap extends LitElement {
    * @since 4.19
    */
   get magnifier(): Magnifier;
-  /** An instance of a [Map](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html) object to display in the view. */
+  /** An instance of a [Map](https://developers.arcgis.com/javascript/latest/references/core/Map/) object to display in the view. */
   accessor map: Map2 | null | undefined;
   /**
    * Indication whether the view is being navigated (for example when panning).
@@ -611,9 +609,9 @@ export abstract class ArcgisMap extends LitElement {
    */
   accessor padding: ViewPadding;
   /**
-   * A [Popup](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Popup.html) widget 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-View.html#map). Consider using the [popupElement](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#popupElement) (beta), which represents the Popup component, instead.
+   * A [Popup](https://developers.arcgis.com/javascript/latest/references/core/widgets/Popup/) widget object that displays general content or attributes from [layers](https://developers.arcgis.com/javascript/latest/references/core/Map/#layers) in the [map](https://developers.arcgis.com/javascript/latest/references/core/views/View/#map). Consider using the [popupElement](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#popupElement) (beta), which represents the Popup component, instead.
    *
-   * 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/references/map-components/components/arcgis-map/#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 [openPopup()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#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/references/map-components/components/arcgis-map/#popup) is `null`, the popup instance will not be created.
+   * 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/references/core/widgets/Popup/) instance is automatically created and assigned to the view's [popup](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#popup) when the user clicks on the view and [popupEnabled](https://developers.arcgis.com/javascript/latest/references/core/views/PopupView/#popupEnabled) is `true`, when the [openPopup()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#openPopup) method is called, or when some widgets need the popup, such as [Search](https://developers.arcgis.com/javascript/latest/references/core/widgets/Search/). If [popup](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#popup) is `null`, the popup instance will not be created.
    *
    * @see [popupElement](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#popupElement)
    * @see [popupDisabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#popupDisabled)
@@ -670,8 +668,8 @@ export abstract class ArcgisMap extends LitElement {
    * 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).
+   * is a [WebMap](https://developers.arcgis.com/javascript/latest/references/core/WebMap/), then the map
+   * must be [loaded](https://developers.arcgis.com/javascript/latest/references/core/WebMap/#loaded).
    * * The view has a [spatialReference](#spatialReference), a [center](#center), and a [scale](#scale).
    * These also can be inferred by setting an [extent](#extent).
    *
@@ -679,7 +677,7 @@ export abstract 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)
+   * @see [when()](https://developers.arcgis.com/javascript/latest/references/core/views/View/#when)
    */
   get ready(): boolean;
   /**
@@ -734,28 +732,28 @@ export abstract 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.
    * You can change the spatialReference of the view after it is initialized by either directly changing
-   * this property, or by changing the basemap from the [Basemap Gallery](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-basemap-gallery/)
-   * and [Basemap Toggle](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-basemap-toggle/) components.
+   * this property, or by changing the basemap from the [Basemap Gallery](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-basemap-gallery/)
+   * and [Basemap Toggle](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-basemap-toggle/) components.
    * Set [spatialReferenceLocked](#spatialReferenceLocked) property to `true` to prevent users from changing the view's spatial reference at runtime.
    *
-   * Prior to changing the spatial reference, check if the [projectOperator](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-operators-projectOperator.html)
-   * is loaded by calling [projectOperator.isLoaded()](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-operators-projectOperator.html#isLoaded) method.
-   * If it is not yet loaded, call [projectOperator.load()](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-operators-projectOperator.html#load) method.
+   * Prior to changing the spatial reference, check if the [projectOperator](https://developers.arcgis.com/javascript/latest/references/core/geometry/operators/projectOperator/)
+   * is loaded by calling [projectOperator.isLoaded()](https://developers.arcgis.com/javascript/latest/references/core/geometry/operators/projectOperator/#isLoaded) method.
+   * If it is not yet loaded, call [projectOperator.load()](https://developers.arcgis.com/javascript/latest/references/core/geometry/operators/projectOperator/#load) method.
    * If the `projectOperator` is not loaded, the view's [center](#center) will default to `[0, 0]` in the new spatial reference of the view and a console error will be thrown.
    *
    * **Notes**
    *
-   * * [LayerViews](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-layers-LayerView.html) not compatible with the view's spatial reference
-   * are not displayed. In such case, the layer view's [suspended](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-layers-LayerView.html#suspended)
-   * property is `true` and [spatialReferenceSupported](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-layers-LayerView.html#spatialReferenceSupported)
+   * * [LayerViews](https://developers.arcgis.com/javascript/latest/references/core/views/layers/LayerView/) not compatible with the view's spatial reference
+   * are not displayed. In such case, the layer view's [suspended](https://developers.arcgis.com/javascript/latest/references/core/views/layers/LayerView/#suspended)
+   * property is `true` and [spatialReferenceSupported](https://developers.arcgis.com/javascript/latest/references/core/views/layers/LayerView/#spatialReferenceSupported)
    * property is `false`.
    * * When setting view's spatial reference, the [center](#center), [extent](#extent) or [viewpoint.targetGeometry](#viewpoint) properties are projected to the new spatial
    * reference. The [scale](#scale) and [rotation](#rotation) properties are adjusted to keep the content of the map at the same size and orientation on screen.
-   * * To ensure [TileLayers](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-TileLayer.html) and
-   * [VectorTileLayers](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-VectorTileLayer.html)
+   * * To ensure [TileLayers](https://developers.arcgis.com/javascript/latest/references/core/layers/TileLayer/) and
+   * [VectorTileLayers](https://developers.arcgis.com/javascript/latest/references/core/layers/VectorTileLayer/)
    * are displayed in a [basemap](#basemap) correctly, the spatialReference of the view must be set match their
-   * [tileInfo's](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-TileInfo.html) spatial reference.
-   * * Switching spatial reference with an [imageCoordinateSystem](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-SpatialReference.html#imageCoordinateSystem)
+   * [tileInfo's](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TileInfo/) spatial reference.
+   * * Switching spatial reference with an [imageCoordinateSystem](https://developers.arcgis.com/javascript/latest/references/core/geometry/SpatialReference/#imageCoordinateSystem)
    * is not supported.
    *
    * @see [spatialReferenceLocked](#spatialReferenceLocked)
@@ -807,7 +805,7 @@ export abstract class ArcgisMap extends LitElement {
    * This property specifies the base colors used by some components to render graphics and labels.
    *
    * @since 4.28
-   * @see [Theme](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-Theme.html)
+   * @see [Theme](https://developers.arcgis.com/javascript/latest/references/core/views/Theme/)
    * @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
@@ -868,7 +866,7 @@ export abstract class ArcgisMap extends LitElement {
    * @default false
    */
   get updating(): boolean;
-  /** 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. */
+  /** The [MapView](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/) instance created and managed by the component. Accessible once the component is fully loaded. */
   get view(): MapView;
   /**
    * Represents the current view as a Viewpoint or point of observation on the view.
@@ -877,14 +875,14 @@ export abstract class ArcgisMap extends LitElement {
    */
   accessor viewpoint: 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). 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
+   * The visibleArea represents the visible portion of a [Map](https://developers.arcgis.com/javascript/latest/references/core/Map/) within the view as
+   * an instance of a [Polygon](https://developers.arcgis.com/javascript/latest/references/core/geometry/Polygon/). This is similar to the view
+   * [MapView#extent](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#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.
    *
    * @since 4.31
-   * @see [MapView#extent](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#extent)
+   * @see [MapView#extent](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#extent)
    */
   get visibleArea(): Polygon | null | undefined;
   /**
@@ -910,42 +908,42 @@ export abstract class ArcgisMap extends LitElement {
    */
   goTo(target: GoToTarget2D, options?: GoToOptions2D): Promise<unknown>;
   /**
-   * Returns [hit test results](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#HitTestResult)
+   * Returns [hit test results](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#HitTestResult)
    * from each layer that intersects the specified screen coordinates. The results are
-   * organized as an array of objects containing different [result types](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#HitTestResult).
-   *
-   * The following layer types will return all [features](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#GraphicHit) if a hit is
-   * made on intersecting features: [FeatureLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html),
-   * [CatalogLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-CatalogLayer.html),
-   * [CSVLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-CSVLayer.html),
-   * [GeoJSONLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-GeoJSONLayer.html),
-   * [GeoRSSLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-GeoRSSLayer.html),
-   * [GraphicsLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-GraphicsLayer.html),
-   * [KMLLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-KMLLayer.html),
-   * [MapNotesLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-MapNotesLayer.html),
-   * [OGCFeatureLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-OGCFeatureLayer.html),
-   * [StreamLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-StreamLayer.html),
-   * [SubtypeSublayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-SubtypeSublayer.html),
-   * [VectorTileLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-VectorTileLayer.html), and
-   * [WFSLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-WFSLayer.html).
-   *
-   * The [ParquetLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-ParquetLayer.html) hit result returns only the topmost feature
+   * organized as an array of objects containing different [result types](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#HitTestResult).
+   *
+   * The following layer types will return all [features](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#GraphicHit) if a hit is
+   * made on intersecting features: [FeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/),
+   * [CatalogLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/CatalogLayer/),
+   * [CSVLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/CSVLayer/),
+   * [GeoJSONLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/GeoJSONLayer/),
+   * [GeoRSSLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/GeoRSSLayer/),
+   * [GraphicsLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/GraphicsLayer/),
+   * [KMLLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/KMLLayer/),
+   * [MapNotesLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/MapNotesLayer/),
+   * [OGCFeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/OGCFeatureLayer/),
+   * [StreamLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/StreamLayer/),
+   * [SubtypeSublayer](https://developers.arcgis.com/javascript/latest/references/core/layers/support/SubtypeSublayer/),
+   * [VectorTileLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/VectorTileLayer/), and
+   * [WFSLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/WFSLayer/).
+   *
+   * The [ParquetLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/ParquetLayer/) hit result returns only the topmost feature
    * when the hit occurs on overlapping features in a ParquetLayer.
    *
-   * The [VectorTileLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-VectorTileLayer.html) hit test result contains an array of objects containing
-   * a [graphic](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#GraphicHit).
-   * The graphic returns attributes of a style layer. In addition, the graphic's [origin](https://developers.arcgis.com/javascript/latest/api-reference/esri-Graphic.html#origin)
+   * The [VectorTileLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/VectorTileLayer/) hit test result contains an array of objects containing
+   * a [graphic](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#GraphicHit).
+   * The graphic returns attributes of a style layer. In addition, the graphic's [origin](https://developers.arcgis.com/javascript/latest/references/core/Graphic/#origin)
    * contains the style layer's [id](https://maplibre.org/maplibre-style-spec/layers/#id) and layer index within the [vector tile style](https://doc.arcgis.com/en/arcgis-online/reference/tile-layers.htm#ESRI_SECTION1_8F68399EB47B48FF9EF46719FCC96978).
    * Spatial information about the actual feature represented in the style layer is returned only if the style layer is a [symbol layer](https://maplibre.org/maplibre-style-spec/layers/#symbol).
    * Otherwise, the graphic's geometry is `null`.
    *
-   * The [MediaLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-MediaLayer.html) hit test result contains all media elements if the hit is made on intersecting elements.
-   * The [RouteLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-RouteLayer.html) hit test result contains all route elements if the hit is made on intersecting elements.
+   * The [MediaLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/MediaLayer/) hit test result contains all media elements if the hit is made on intersecting elements.
+   * The [RouteLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/RouteLayer/) hit test result contains all route elements if the hit is made on intersecting elements.
    *
-   * If the [polygon](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Polygon.html) feature's symbol
-   * [style](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-SimpleFillSymbol.html#style) is set to `none`, the hitTest method will not
+   * If the [polygon](https://developers.arcgis.com/javascript/latest/references/core/geometry/Polygon/) feature's symbol
+   * [style](https://developers.arcgis.com/javascript/latest/references/core/symbols/SimpleFillSymbol/#style) is set to `none`, the hitTest method will not
    * return results when the fill is clicked. However, it will return results when the outline is clicked. To get results when clicking the fill, set the
-   * [color](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-SimpleFillSymbol.html#color) to a transparent color instead.
+   * [color](https://developers.arcgis.com/javascript/latest/references/core/symbols/SimpleFillSymbol/#color) to a transparent color instead.
    *
    * @param screenPoint
    * @param options
@@ -1022,7 +1020,7 @@ export abstract class ArcgisMap extends LitElement {
   /**
    * 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)
+   * [Read more](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#whenAnalysisView)
    *
    * @param analysis
    * @since 4.34
@@ -1031,11 +1029,23 @@ export abstract class ArcgisMap extends LitElement {
   /**
    * 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)
+   * [Read more](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#whenLayerView)
    *
    * @param layer
    */
   whenLayerView<TLayer extends Layer>(layer: TLayer): Promise<LayerView2DFor<TLayer>>;
+  /**
+   * Zooms in the view component by a factor of 2.
+   *
+   * @since 5.0
+   */
+  zoomIn(): Promise<void>;
+  /**
+   * Zooms out the view component by a factor of 2.
+   *
+   * @since 5.0
+   */
+  zoomOut(): Promise<void>;
   "@setterTypes": {
     center?: MapView["center"] | null | undefined | number[] | string;
     ground?: Ground | string;
@@ -1056,7 +1066,7 @@ export abstract class ArcgisMap extends LitElement {
   /**
    * 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)
+   * [Read more](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#event-analysis-view-create)
    *
    * @since 4.34
    */
@@ -1064,7 +1074,7 @@ export abstract class ArcgisMap extends LitElement {
   /**
    * 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)
+   * [Read more](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#event-analysis-view-create-error)
    *
    * @since 4.34
    */
@@ -1072,7 +1082,7 @@ export abstract class ArcgisMap extends LitElement {
   /**
    * 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)
+   * [Read more](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#event-analysis-view-destroy)
    *
    * @since 4.34
    */
@@ -1137,7 +1147,7 @@ export abstract class ArcgisMap extends LitElement {
   /**
    * Fires while the pointer is dragged following a double-tap gesture on the view.
    *
-   * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#event-double-tap-drag)
+   * [Read more](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#event-double-tap-drag)
    *
    * @since 5.0
    * @example
@@ -1196,17 +1206,17 @@ export abstract class ArcgisMap extends LitElement {
   readonly arcgisViewKeyUp: import("@arcgis/lumina").TargetedEvent<this, 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)
+   * [LayerView](https://developers.arcgis.com/javascript/latest/references/core/views/layers/LayerView/)
    * created and rendered in the view.
    */
   readonly arcgisViewLayerviewCreate: import("@arcgis/lumina").TargetedEvent<this, 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)
+   * Fires when an error occurs during the creation of a [LayerView](https://developers.arcgis.com/javascript/latest/references/core/views/layers/LayerView/)
    * after a layer has been added to the map.
    */
   readonly arcgisViewLayerviewCreateError: import("@arcgis/lumina").TargetedEvent<this, LayerViewCreateErrorEvent>;
   /**
-   * Fires after a [LayerView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-layers-LayerView.html)
+   * Fires after a [LayerView](https://developers.arcgis.com/javascript/latest/references/core/views/layers/LayerView/)
    * is destroyed and is no longer rendered in the view.
    */
   readonly arcgisViewLayerviewDestroy: import("@arcgis/lumina").TargetedEvent<this, LayerViewDestroyEvent>;
@@ -1260,7 +1270,7 @@ export abstract class ArcgisMap extends LitElement {
   /**
    * Fires while the two pointers are dragged vertically on the view.
    *
-   * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#event-vertical-two-finger-drag)
+   * [Read more](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#event-vertical-two-finger-drag)
    *
    * @since 5.0
    * @example