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

package/dist/components/arcgis-link-chart-layout-switcher/customElement.d.ts

@@ -30,6 +30,15 @@ export abstract class ArcgisLinkChartLayoutSwitcher extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-link-chart-layout-switcher auto-destroy-disabled></arcgis-link-chart-layout-switcher>
+   * ```
+   *
+   * ```js
+   * linkChartLayoutSwitcherElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**
@@ -131,8 +140,8 @@ export abstract class ArcgisLinkChartLayoutSwitcher extends LitElement {
    */
   get state(): LinkChartLayoutSwitcherViewModelState;
   /**
-   * The view associated with the component. 
-   *   > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the arcgis-link-chart-layout-switcher component will be associated with a map or scene component rather than using the `view` property.
+   * The view associated with the component.
+   * > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the arcgis-link-chart-layout-switcher component will be associated with a map or scene component rather than using the `view` property.
    */
   accessor view: LinkChartView | null | undefined;
   /** Permanently destroy the component. */
@@ -149,10 +158,10 @@ export abstract class ArcgisLinkChartLayoutSwitcher extends LitElement {
   };
   /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
   readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "state"; }>;
-  /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
+  /** Emitted when the component associated with a map or scene view is ready for user interaction. */
   readonly arcgisReady: import("@arcgis/lumina").TargetedEvent<this, void>;
   /**
-   * Fires when component has completed the layout switch
+   * Fires when the component has completed the layout switch.
    *
    * @example
    * ```js

package/dist/components/arcgis-link-chart-layout-switcher/customElement.js

@@ -1,11 +1,11 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
 import { c as h } from "../../chunks/runtime.js";
 import { html as i } from "lit";
-import d from "@arcgis/core/widgets/LinkChartLayoutSwitcher/LinkChartLayoutSwitcherViewModel.js";
-import { usePropertyChange as m } from "@arcgis/lumina/controllers";
+import m from "@arcgis/core/widgets/LinkChartLayoutSwitcher/LinkChartLayoutSwitcherViewModel.js";
+import { usePropertyChange as d } from "@arcgis/lumina/controllers";
 import { m as g } from "../../chunks/useViewModel.js";
 import { u as p } from "../../chunks/useT9n.js";
-import { reEmitEvent as u } from "@arcgis/lumina/controllers/accessor";
+import { reEmitEvent as u } from "@arcgis/lumina-toolkit/reEmitEvent";
 import { LitElement as y, createEvent as w } from "@arcgis/lumina";
 const e = {
   forceDirected: "organic-standard",
@@ -47,10 +47,10 @@ const e = {
   [e.geographic]: "geographic",
   [e.chronologicalSingle]: "chronologicalSingle",
   [e.chronologicalMultiple]: "chronologicalMultiple"
-}, v = g(d);
+}, v = g(m);
 class L extends y {
   constructor() {
-    super(...arguments), this.messages = p(), this.viewModel = v(this), this.view = this.viewModel.view, this.appearance = "dropdown", this.autoDestroyDisabled = !1, this.closeOnSelectDisabled = !1, this.icon = "nodes-link", this.layout = this.viewModel.layout, this.preventExtentUpdate = this.viewModel.preventExtentUpdate, this.state = this.viewModel.state, this.arcgisSwitchLayout = u(() => this.viewModel, "switchLayout"), this.arcgisPropertyChange = m()("state"), this.arcgisReady = w();
+    super(...arguments), this.messages = p(), this.viewModel = v(this), this.view = this.viewModel.view, this.appearance = "dropdown", this.autoDestroyDisabled = !1, this.closeOnSelectDisabled = !1, this.icon = "nodes-link", this.layout = this.viewModel.layout, this.preventExtentUpdate = this.viewModel.preventExtentUpdate, this.state = this.viewModel.state, this.arcgisSwitchLayout = u(() => this.viewModel, "switchLayout"), this.arcgisPropertyChange = d()("state"), this.arcgisReady = w();
   }
   static {
     this.properties = { view: 0, appearance: 1, autoDestroyDisabled: 5, closeOnSelectDisabled: 5, icon: 1, label: 1, layout: 32, messageOverrides: 0, preventExtentUpdate: 5, referenceElement: 1, state: 32 };
@@ -69,7 +69,7 @@ class L extends y {
   }
   _renderMenuBar() {
     const { messages: t } = this;
-    return i`<calcite-action-bar scale=s floating overflow-actions-disabled>${Object.entries(l).map(([o, c]) => i`<calcite-action-group .label=${this.messages[o]}>${c.map((a) => i`<calcite-action scale=s .icon=${s[a]} .active=${a === this.layout ? !0 : void 0} @click=${() => {
+    return i`<calcite-action-bar scale=s floating overflow-mode=none>${Object.entries(l).map(([o, c]) => i`<calcite-action-group .label=${this.messages[o]}>${c.map((a) => i`<calcite-action scale=s .icon=${s[a]} .active=${a === this.layout ? !0 : void 0} @click=${() => {
       this.switchLayout(a);
     }} .text=${t[n[a]]}></calcite-action>`)}</calcite-action-group>`)}</calcite-action-bar>`;
   }

package/dist/components/arcgis-link-chart-nonspatial-visibility-toggle/customElement.d.ts

@@ -6,9 +6,11 @@ import type { State, NonspatialMode } from "./types.js";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
 
 /**
- * The <link-chart-nonspatial-visibility-toggle> component is for use in link charts that allows users to switch whether or not nonspatial data is visible in the view.  Spatial entities are those with a value in a defined geometry property in a traditional map context.  A Spatial relationship is one where both endpoints are spatial
+ * The <link-chart-nonspatial-visibility-toggle> component is used in conjunction with link chart. The component toggles visibility of nonspatial data.
  *
- * Note: Sign in to access the data in this demo, U/P: `viewer01`/`I68VGU^nMurF`
+ * Note: Use the following credentials to sign in to the demo:
+ *   - Username: `viewer01`
+ *   - Password: `I68VGU^nMurF`
  *
  * @since 5.0
  */
@@ -21,6 +23,15 @@ export abstract class ArcgisLinkChartNonspatialVisibilityToggle extends LitEleme
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-link-chart-nonspatial-visibility-toggle auto-destroy-disabled></arcgis-link-chart-nonspatial-visibility-toggle>
+   * ```
+   *
+   * ```js
+   * linkChartNonspatialVisibilityToggleElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   accessor icon: IconName | undefined;
@@ -48,8 +59,8 @@ export abstract class ArcgisLinkChartNonspatialVisibilityToggle extends LitEleme
    */
   get state(): State;
   /**
-   * The view associated with the component. 
-   *   > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the arcgis-link-chart-nonspatial-visibility-toggle component will be associated with a map or scene component rather than using the `view` property.
+   * The view associated with the component.
+   * > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the arcgis-link-chart-nonspatial-visibility-toggle component will be associated with a map or scene component rather than using the `view` property.
    */
   accessor view: LinkChartView | undefined;
   /**
@@ -68,7 +79,7 @@ export abstract class ArcgisLinkChartNonspatialVisibilityToggle extends LitEleme
   switchNonspatialVisibility(nonspatialVisibilitySetting: NonspatialMode): Promise<void>;
   /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
   readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "state"; }>;
-  /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
+  /** Emitted when the component associated with a map or scene view is ready for user interaction. */
   readonly arcgisReady: import("@arcgis/lumina").TargetedEvent<this, void>;
   readonly "@eventTypes": {
     arcgisPropertyChange: ArcgisLinkChartNonspatialVisibilityToggle["arcgisPropertyChange"]["detail"];

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

@@ -36,11 +36,20 @@ export abstract class ArcgisLocate extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-locate auto-destroy-disabled></arcgis-locate>
+   * ```
+   *
+   * ```js
+   * locateElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   accessor geolocationOptions: PositionOptions | undefined;
   /**
-   * Indicates whether to navigate the view to the position and scale of the geolocated result.
+   * Indicates whether navigation to the position and scale of the geolocated result is disabled.
    *
    * @default false
    */
@@ -145,8 +154,8 @@ export abstract class ArcgisLocate extends LitElement {
   /** The current state of the component. */
   get state(): State;
   /**
-   * The view associated with the component. 
-   *   > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the arcgis-locate component will be associated with a map or scene component rather than using the `view` property.
+   * The view associated with the component.
+   * > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the arcgis-locate component will be associated with a map or scene component rather than using the `view` property.
    */
   accessor view: MapView | SceneView | undefined;
   /**
@@ -167,7 +176,7 @@ export abstract class ArcgisLocate extends LitElement {
   readonly arcgisError: import("@arcgis/lumina").TargetedEvent<this, { error: GeolocationPositionError; }>;
   /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
   readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "state"; }>;
-  /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
+  /** Emitted when the component associated with a map or scene view is ready for user interaction. */
   readonly arcgisReady: import("@arcgis/lumina").TargetedEvent<this, void>;
   readonly arcgisSuccess: import("@arcgis/lumina").TargetedEvent<this, { position: GeolocationPosition; }>;
   readonly "@eventTypes": {

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

@@ -4,8 +4,8 @@ import { css as y, html as p } from "lit";
 import { usePropertyChange as E } from "@arcgis/lumina/controllers";
 import { classes as _ } from "@arcgis/toolkit/dom";
 import { watch as u } from "@arcgis/core/core/reactiveUtils.js";
-import { LitElement as C, createEvent as d, safeClassMap as m, nothing as P } from "@arcgis/lumina";
-import { u as M } from "../../chunks/useT9n.js";
+import { LitElement as C, createEvent as d, safeClassMap as m, nothing as M } from "@arcgis/lumina";
+import { u as P } from "../../chunks/useT9n.js";
 import { createRef as T, ref as O } from "lit/directives/ref.js";
 import { m as L } from "../../chunks/useViewModel.js";
 import { l as S } from "../../chunks/legacyIcon.js";
@@ -27,7 +27,6 @@ const R = new x({
   icon: "trash",
   id: "remove-selected-feature",
   title: "{messages.remove}"
-  // eslint-disable-next-line @typescript-eslint/no-deprecated
 })._internalSetClassName("esri-icon-trash");
 function U(e) {
   return new N({
@@ -181,10 +180,10 @@ s([
 r = s([
   $("map-components.locate.LocateViewModel")
 ], r);
-const v = "gps-off", j = L(r);
-class k extends C {
+const j = r, v = "gps-off", k = L(j);
+class F extends C {
   constructor() {
-    super(), this.locateButtonElement = T(), this.messages = M(), this.viewModel = j(this), this.hideErrorTooltip = () => {
+    super(), this.locateButtonElement = T(), this.messages = P(), this.viewModel = k(this), this.hideErrorTooltip = () => {
       this.isErrorTooltipOpen = !1;
     }, this.isErrorTooltipOpen = !1, this.view = this.viewModel.view, this.autoDestroyDisabled = !1, this.geolocationOptions = this.viewModel.geolocationOptions, this.goToLocationDisabled = this.viewModel.goToLocationEnabled, this.goToOverride = this.viewModel.goToOverride, this.graphic = this.viewModel.graphic, this.icon = v, this.popupDisabled = this.viewModel.popupEnabled, this.scale = this.viewModel.scale, this.state = this.viewModel.state, this.visualScale = "m", this.arcgisError = d(), this.arcgisPropertyChange = E()("state"), this.arcgisReady = d(), this.arcgisSuccess = d(), this.listenOn(document, "click", this.hideErrorTooltip);
   }
@@ -226,10 +225,10 @@ class k extends C {
   }
   render() {
     const { viewModel: t, icon: o } = this, { state: a } = t, i = a === "locating", l = i ? this.messages.cancel : this.messages.title, n = a === "feature-unsupported", b = S === void 0 ? v : void 0, h = this._localizeError(this.viewModel?.error);
-    return p`<div class=${m(_("root", g.arcgisButton))}>${!n && p`<calcite-button class=${m(g.widgetButton)} .disabled=${a === "disabled"} .loading=${i} .iconStart=${i ? void 0 : o ?? b} kind=neutral .label=${l} @click=${this._locate} .scale=${this.visualScale} title=${l ?? P} ${O(this.locateButtonElement)}></calcite-button>` || ""}${h ? p`<calcite-tooltip .open=${this.isErrorTooltipOpen} overlay-positioning=fixed .referenceElement=${this.locateButtonElement.value}>${h}</calcite-tooltip>` : null}</div>`;
+    return p`<div class=${m(_("root", g.arcgisButton))}>${!n && p`<calcite-button class=${m(g.widgetButton)} .disabled=${a === "disabled"} .loading=${i} .iconStart=${i ? void 0 : o ?? b} kind=neutral .label=${l} @click=${this._locate} .scale=${this.visualScale} title=${l ?? M} ${O(this.locateButtonElement)}></calcite-button>` || ""}${h ? p`<calcite-tooltip .open=${this.isErrorTooltipOpen} overlay-positioning=fixed .referenceElement=${this.locateButtonElement.value}>${h}</calcite-tooltip>` : null}</div>`;
   }
 }
-w("arcgis-locate", k);
+w("arcgis-locate", F);
 export {
-  k as ArcgisLocate
+  F as ArcgisLocate
 };

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

@@ -19,6 +19,7 @@ import type HighlightOptions from "@arcgis/core/views/support/HighlightOptions.j
 import type IPSInfo from "@arcgis/core/webdoc/IPSInfo.js";
 import type Magnifier from "@arcgis/core/views/Magnifier.js";
 import type Navigation from "@arcgis/core/views/navigation/Navigation.js";
+import type ViewOptions from "@arcgis/core/views/interactive/options/ViewOptions.js";
 import type Popup from "@arcgis/core/widgets/Popup.js";
 import type SelectionManager from "@arcgis/core/views/SelectionManager.js";
 import type SpatialReference from "@arcgis/core/geometry/SpatialReference.js";
@@ -29,15 +30,40 @@ import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 import type { LoadErrorSource } from "../types.js";
 import type { ArcgisPopup } from "../arcgis-popup/customElement.js";
 import type { LayerView2DFor, ResizeAlign } from "@arcgis/core/views/2d/types.js";
-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.js";
+import type { DoubleClickEvent, DoubleTapDragEvent, FocusRegionSelectEvent, VerticalTwoFingerDragEvent, PointerUpEvent, PointerMoveEvent, PointerLeaveEvent, PointerEnterEvent, PointerDownEvent, ViewMouseWheelEvent, LayerViewDestroyEvent, LayerViewCreateErrorEvent, LayerViewCreateEvent, KeyUpEvent, KeyDownEvent, ImmediateDoubleClickEvent, ImmediateClickEvent, HoldEvent, DragEvent, ClickEvent } from "@arcgis/core/views/input/types.js";
 import type { AnalysisViewDestroyEvent, AnalysisViewCreateErrorEvent, AnalysisViewCreateEvent, ToScreenOptions2D, Screenshot, UserSettings, ViewHitTestResult, HitTestOptions, GoToOptions2D, GoToTarget2D } from "@arcgis/core/views/types.js";
 import type { AnalysisView2DUnion } from "@arcgis/core/views/2d/analysis/types.js";
-import type { ScreenPoint, ScreenRect } from "@arcgis/core/core/types.js";
+import type { ScreenPoint, ScreenPolygon, ScreenRect } from "@arcgis/core/core/types.js";
 import type { FetchPopupFeaturesOptions, ViewPopupOpenOptions } from "@arcgis/core/views/PopupView.js";
 import type { ReadonlyCollection } from "@arcgis/core/core/Collection.js";
 import type { ViewPadding } from "@arcgis/core/views/ui/types.js";
 import type { SlotGroupRefs } from "../../support/slots.js";
 
+declare module "@arcgis/lumina" {
+export interface DeclareCssProperties {
+  /** _Since 4.34_ Specifies the top padding for the layout. */
+  "--arcgis-layout-overlay-space-top": "*";
+  /** _Since 4.34_ Specifies the bottom padding for the layout. */
+  "--arcgis-layout-overlay-space-bottom": "*";
+  /** _Since 4.34_ Specifies the left padding for the layout. */
+  "--arcgis-layout-overlay-space-left": "*";
+  /** _Since 4.34_ Specifies the right padding for the layout. */
+  "--arcgis-layout-overlay-space-right": "*";
+  /** _Since 5.0_ Specifies the focus outline color for the view. */
+  "--arcgis-view-color-focus": "*";
+  /** _Since 5.1_ Specifies the background color for table rows. */
+  "--arcgis-table-row-background-color": "*";
+  /** _Since 5.1_ Specifies the background color for alternate table rows. */
+  "--arcgis-table-row-alt-background-color": "*";
+  /** _Since 5.2_ Specifies the outer border color of the focus region. */
+  "--arcgis-focus-region-outer-border-color": "*";
+  /** _Since 5.2_ Specifies the inner border color of the focus region. */
+  "--arcgis-focus-region-inner-border-color": "*";
+  /** _Since 5.2_ Specifies the border width of the focus region. */
+  "--arcgis-focus-region-border-width": "*";
+}
+}
+
 /**
  * The ArcGIS Map component is used to add 2D maps to web applications. For 3D maps, use the
  * [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/).
@@ -109,13 +135,6 @@ import type { SlotGroupRefs } from "../../support/slots.js";
  * - [Get started](https://developers.arcgis.com/javascript/latest/get-started/)
  * - [Programming patterns](https://developers.arcgis.com/javascript/latest/programming-patterns/)
  *
- * @cssproperty [--arcgis-layout-overlay-space-top] - _Since 4.34_ Specifies the top padding for the layout.
- * @cssproperty [--arcgis-layout-overlay-space-bottom] - _Since 4.34_ Specifies the bottom padding for the layout.
- * @cssproperty [--arcgis-layout-overlay-space-left] - _Since 4.34_ Specifies the left padding for the layout.
- * @cssproperty [--arcgis-layout-overlay-space-right] - _Since 4.34_ Specifies the right padding for the layout.
- * @cssproperty [--arcgis-view-color-focus] - _Since 5.0_ Specifies the focus outline color for the view.
- * @cssproperty [--arcgis-table-row-background-color] - _Since 5.1_ Specifies the background color for table rows.
- * @cssproperty [--arcgis-table-row-alt-background-color] - _Since 5.1_ Specifies the background color for alternate table rows.
  * @slot  - Default slot for adding components to the map. User is responsible for positioning the content via CSS.
  * @slot [top-left] - Slot for components positioned in the top-left corner.
  * @slot [top-right] - Slot for components positioned in the top-right corner.
@@ -181,13 +200,15 @@ export abstract class ArcgisMap extends LitElement {
    */
   get attributionItems(): MapView["attributionItems"];
   /**
-   * The light or dark mode used to display the attribution.
-   * By default, the mode is inherited from the [Calcite's mode](https://developers.arcgis.com/calcite-design-system/core-concepts/#modes).
-   * You can override the value to style the attribution alongside the map or scene content.
+   * The display mode used for the attribution. Defaults to null.
+   *
+   * Set this property to "auto" to automatically synchronize the attribution with the nearest [Calcite mode](https://developers.arcgis.com/calcite-design-system/core-concepts/#modes). If no Calcite mode is detected, the attribution defaults to light mode. **The "auto" mode was added in version 5.2.**
+   *
+   * Set this property to "light" or "dark" to explicitly use that mode without synchronization.
    *
    * @since 5.0
    */
-  accessor attributionMode: "dark" | "light" | null | undefined;
+  accessor attributionMode: AttributionMode;
   /**
    * 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
@@ -196,6 +217,15 @@ export abstract class ArcgisMap extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-map auto-destroy-disabled></arcgis-map>
+   * ```
+   *
+   * ```js
+   * mapElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**
@@ -381,7 +411,7 @@ export abstract class ArcgisMap extends LitElement {
   accessor constraints: MapViewConstraints;
   /**
    * 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.
+   * If `true`, display filters are ignored and all features are rendered.
    *
    * @default false
    */
@@ -425,6 +455,50 @@ export abstract class ArcgisMap extends LitElement {
    * It can filter the map display on floor-aware layers by zero or more level IDs.
    */
   accessor floors: Collection<string>;
+  /**
+   * The screen rectangle of the active focus region, or `null` when [focusRegionVisible](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#focusRegionVisible) is `false`.
+   * This screen rectangle represents the area of the view that is currently in focus and can be used with methods that require a screen rectangle as input, such as `hitTest()`.
+   *
+   * | Action | Keyboard Shortcut / Property |
+   * |--------|----------------------------|
+   * | Enable or disable focus region | Use the `Shift` + `Alt`/`Option` + `O` keyboard shortcut while the view component is in focus or set the [focusRegionVisible](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#focusRegionVisible) property to `true` or `false`. |
+   * | Resize focus region | Use the `Shift` + `Alt`/`Option` + Up/Down arrow keys while the focus region is enabled. |
+   * | Open the [popup](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/) for features in the focus region | Press `Enter` or `Spacebar` while the focus region is enabled. |
+   *
+   * **Notes:**
+   * - To know when this focus region is selected, listen for the [@arcgisViewFocusRegionSelect](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#event-arcgisViewFocusRegionSelect) event. The default behavior of the popup component opening with features in the focus region can be prevented by calling `event.preventDefault()` within the event handler.
+   * - The styling of the focus region can be customized using the [--arcgis-focus-region-outer-border-color](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#--arcgis-focus-region-outer-border-color), [--arcgis-focus-region-inner-border-color](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#--arcgis-focus-region-inner-border-color), and [--arcgis-focus-region-border-width](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#--arcgis-focus-region-border-width) CSS variables.
+   * -  When the [focusRegionVisible](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#focusRegionVisible) is `true`, the opened [popupElement](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#popupElement) or slotted [popup component](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/) will be docked with the dock button hidden by default to prevent it from overlapping the focus region.
+   *
+   * @since 5.2
+   * @see [focusRegionShortcutEnabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#focusRegionShortcutEnabled)
+   * @see [focusRegionVisible](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#focusRegionVisible)
+   * @see [@arcgisViewFocusRegionSelect](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#event-arcgisViewFocusRegionSelect)
+   */
+  get focusRegion(): MapView["focusRegion"];
+  /**
+   * Enables the `Shift` + `Alt`/`Option` + `O` keyboard shortcut for showing the [focusRegion](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#focusRegion). When `undefined`, the shortcut is enabled only when a [popup](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/) component is slotted into the ArcgisMap component, or when [popupComponentEnabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#popupComponentEnabled) is set, and when the [popupDisabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#popupDisabled) property is `false`. Set to `true` to handle focus-region selection in a custom application, or `false` to disable the shortcut. When `false`, the shortcut does not change the [focusRegionVisible](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#focusRegionVisible) property.
+   *
+   * @default false
+   * @since 5.2
+   * @see [focusRegion](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#focusRegion)
+   * @see [focusRegionVisible](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#focusRegionVisible)
+   * @see [@arcgisViewFocusRegionSelect](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#event-arcgisViewFocusRegionSelect)
+   */
+  accessor focusRegionShortcutEnabled: boolean | undefined;
+  /**
+   * Indicates whether the [focusRegion](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#focusRegion) is visible. Set this property to `true` to show the centered focus region, or `false` to hide it.
+   * The focus region can also be shown or hidden by focusing on the ArcgisMap component and pressing the `Shift` + `Alt`/`Option` + `O` keyboard shortcut. By default, this shortcut is available only when a popup component is available and [popupDisabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#popupDisabled) is `false`. Use [focusRegionShortcutEnabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#focusRegionShortcutEnabled) to explicitly enable or disable it.
+   *
+   * **Note:** When the focus region is enabled, the [popupElement](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#popupElement) or slotted [popup component](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/) will be docked with the dock button hidden by default to prevent it from overlapping the focus region.
+   *
+   * @default false
+   * @since 5.2
+   * @see [focusRegion](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#focusRegion)
+   * @see [focusRegionShortcutEnabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#focusRegionShortcutEnabled)
+   * @see [@arcgisViewFocusRegionSelect](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#event-arcgisViewFocusRegionSelect)
+   */
+  accessor focusRegionVisible: boolean;
   /** Gamepad input specific configuration settings. */
   get gamepad(): GamepadSettings;
   /**
@@ -608,7 +682,7 @@ export abstract class ArcgisMap extends LitElement {
   /** An instance of a [Map](https://developers.arcgis.com/javascript/latest/references/core/Map/) object to display in the view. */
   accessor map: Map | null | undefined;
   /**
-   * Indication whether the view is being navigated (for example when panning).
+   * Indicates whether the view is being navigated (for example when panning).
    *
    * @default false
    */
@@ -635,6 +709,16 @@ export abstract class ArcgisMap extends LitElement {
    * ```
    */
   accessor navigation: Navigation;
+  /**
+   * Configures snapping, tooltips, display units, and input units for supported components, view models, and analyses.
+   * See [ViewOptions](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/options/ViewOptions/) for supported options, exceptions, and opt-in requirements.
+   *
+   * These options are not saved in a WebMap or WebScene.
+   *
+   * @since 5.2
+   * @beta
+   */
+  accessor options: ViewOptions;
   /**
    * Padding to make the map's center and extent work off a
    * subsection of the full map. This is particularly useful when layering UI
@@ -649,6 +733,7 @@ export abstract class ArcgisMap extends LitElement {
    *
    * 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.
    *
+   * @deprecated since 5.2, use [popupElement](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#popupElement) instead. Set the [popupComponentEnabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#popupComponentEnabled) property to `true` to enable the popup component.
    * @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)
    * @see [openPopup()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#openPopup)
@@ -806,7 +891,7 @@ export abstract class ArcgisMap extends LitElement {
    * reference. The [scale](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#scale) and [rotation](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#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/references/core/layers/TileLayer/) and
    * [VectorTileLayers](https://developers.arcgis.com/javascript/latest/references/core/layers/VectorTileLayer/)
-   * are displayed in a [basemap](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#basemap) correctly, the spatialReference of the view must be set match their
+   * are displayed in a [basemap](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#basemap) correctly, the spatialReference of the view must be set to match their
    * [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.
@@ -845,7 +930,7 @@ export abstract class ArcgisMap extends LitElement {
    */
   accessor spatialReferenceLocked: boolean;
   /**
-   * Indication whether the view is animating, being navigated with or resizing.
+   * Indicates whether the view is animating, being navigated with or resizing.
    *
    * @default false
    */
@@ -976,6 +1061,8 @@ export abstract class ArcgisMap extends LitElement {
   destroy(): Promise<void>;
   /**
    * Use this method to query for features at a given screen location. These features come from origins (layers and sublayers) configured with a [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/) and have its [FeatureLayer.popupEnabled](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#popupEnabled) set. One example could be a custom side panel that displays feature-specific information based on an end user's click location. This method allows a developer to control how the input location is handled, and then subsequently, what to do with the results.
+   * > [!WARNING]
+   * > Using [ScreenRect](https://developers.arcgis.com/javascript/latest/references/core/core/types/#ScreenRect) as the hit target is considered **[beta](https://developers.arcgis.com/javascript/latest/faq/#what-does-the-beta-tag-mean)** functionality.
    *
    * @param hitTarget
    * @param options
@@ -985,7 +1072,8 @@ export abstract class ArcgisMap extends LitElement {
    * const viewElement = document.querySelector("arcgis-map");
    * // Get viewElement's click event
    * viewElement.addEventListener("arcgisViewClick", async (event) => {
-   *   const generator = await viewElement.fetchPopupFeatures(event.detail.screenPoint, {
+   *   const screenPoint = { x: event.detail.x, y: event.detail.y };
+   *   const generator = await viewElement.fetchPopupFeatures(screenPoint, {
    *     pointerType: event.detail.pointerType
    *   });
    *   // Access the features returned from the generator
@@ -998,7 +1086,7 @@ export abstract class ArcgisMap extends LitElement {
    * ```js
    * // Wait for all the features to be available
    * view.on("click", async (event) => {
-   *   const generator = view.fetchPopupFeatures(event.screenPoint, {
+   *   const generator = view.fetchPopupFeatures({ x: event.x, y: event.y }, {
    *     pointerType: event.pointerType
    *   });
    *
@@ -1014,30 +1102,31 @@ export abstract class ArcgisMap extends LitElement {
    */
   goTo(target: GoToTarget2D, options?: GoToOptions2D): Promise<unknown>;
   /**
-   * Returns [hit test results](https://developers.arcgis.com/javascript/latest/references/core/views/types/#ViewHitTestResult) from each layer that intersects the specified screen point or screen rectangle.
-   * The results are organized as an array of objects containing different [ViewHit](https://developers.arcgis.com/javascript/latest/references/core/views/types/#ViewHit) result types such as  graphics, raster pixels, media elements, or routes.
+   * Returns [hit test results](https://developers.arcgis.com/javascript/latest/references/core/views/types/#ViewHitTestResult) from each layer that intersects the specified hit target.
+   * The returned object contains an array of different [result types](https://developers.arcgis.com/javascript/latest/references/core/views/types/#ViewHit)
+   * such as graphics, raster pixels, media elements, or routes.
    *
    * **2D hitTest() behavior by layer type**
    * | Layer type | Hit test behavior |
    * | :--- | :--- |
-   * | [FeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer), [CatalogFootprintLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/catalog/CatalogFootprintLayer), [CSVLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/CSVLayer), [GeoJSONLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/GeoJSONLayer), [OGCFeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/OGCFeatureLayer), [OrientedImageryLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/OrientedImageryLayer), [ParquetLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/ParquetLayer), [StreamLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/StreamLayer), [SubtypeGroupLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/SubtypeGroupLayer), [WFSLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/WFSLayer) | Returns all intersecting [GraphicHit](https://developers.arcgis.com/javascript/latest/references/core/views/types/#GraphicHit) features at the hit location. |
-   * | [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) | Returns all intersecting [GraphicHit](https://developers.arcgis.com/javascript/latest/references/core/views/types/#GraphicHit) features at the hit location. |
-   * | [ImageryLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/ImageryLayer),  [ImageryTileLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/ImageryTileLayer)| Returns [RasterHit](https://developers.arcgis.com/javascript/latest/references/core/views/types/#RasterHit) result containing raster pixel value used in rendering and bandId info on intersecting pixels. The `screenRect` hitTarget returns hit result at the center of the rectangle. |
-   * | [VectorTileLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/VectorTileLayer) | Returns a result for all intersecting [GraphicHit](https://developers.arcgis.com/javascript/latest/references/core/views/types/#GraphicHit) features containing attributes of style layers (as of version 4.29; in prior releases, only the topmost style layer result was returned). 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`. |
-   * | [MediaLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/MediaLayer) | Returns [MediaHit](https://developers.arcgis.com/javascript/latest/references/core/views/types/#MediaHit) result containing all media elements if the hit is made on intersecting elements. |
-   * | [RouteLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/RouteLayer) | Returns [RouteHit](https://developers.arcgis.com/javascript/latest/references/core/views/types/#RouteHit) result containing all intersecting route elements if the hit is made on intersecting elements. |
+   * | [FeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer), [CatalogFootprintLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/catalog/CatalogFootprintLayer), [CSVLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/CSVLayer), [GeoJSONLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/GeoJSONLayer), [OGCFeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/OGCFeatureLayer), [OrientedImageryLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/OrientedImageryLayer), [ParquetLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/ParquetLayer), [StreamLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/StreamLayer), [SubtypeGroupLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/SubtypeGroupLayer), [WFSLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/WFSLayer) | Returns all [features](https://developers.arcgis.com/javascript/latest/references/core/views/types/#GraphicHit) that intersect the hit target. |
+   * | [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), [SketchLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/SketchLayer) | Returns all [features](https://developers.arcgis.com/javascript/latest/references/core/views/types/#GraphicHit) that intersect the hit target. |
+   * | [ImageryLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/ImageryLayer),  [ImageryTileLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/ImageryTileLayer)| Returns a [result](https://developers.arcgis.com/javascript/latest/references/core/views/types/#RasterHit) containing raster pixel value used in rendering and bandId info on intersecting pixels. Support was added in version 5.1. For a `ScreenRect` hit target, the hit result is returned for the center of the specified shape. |
+   * | [VectorTileLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/VectorTileLayer) | Returns a result for all intersecting [features](https://developers.arcgis.com/javascript/latest/references/core/views/types/#GraphicHit) containing attributes of style layers (as of version 4.29; in prior releases, only the topmost style layer result was returned). 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`. |
+   * | [MediaLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/MediaLayer) | Returns a [result](https://developers.arcgis.com/javascript/latest/references/core/views/types/#MediaHit) for each media element that intersects the hit target. |
+   * | [RouteLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/RouteLayer) | Returns a [result](https://developers.arcgis.com/javascript/latest/references/core/views/types/#RouteHit) for each route element that intersects the hit target. |
    *
    * **Note:** If the [Polygon](https://developers.arcgis.com/javascript/latest/references/core/geometry/Polygon) feature's symbol [SimpleFillSymbol.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
    * [SimpleFillSymbol.color](https://developers.arcgis.com/javascript/latest/references/core/symbols/SimpleFillSymbol#color) to a transparent color instead.
    *
    * Release-specific changes:
-   * * At version 5.1, the [ScreenRect](https://developers.arcgis.com/javascript/latest/references/core/core/types/#ScreenRect) option was added to perform hit tests on rectangular areas.
-   * * At version 4.24, [ViewHitTestResult](https://developers.arcgis.com/javascript/latest/references/core/views/types/#ViewHitTestResult) returns an array of objects containing [GraphicHit](https://developers.arcgis.com/javascript/latest/references/core/views/types/#GraphicHit) graphic, [MediaHit](https://developers.arcgis.com/javascript/latest/references/core/views/types/#MediaHit) media element, and [RouteHit](https://developers.arcgis.com/javascript/latest/references/core/views/types/#RouteHit) route.
-   * * At version 4.23, all hit test features from feature layers are returned in the result. In prior releases, only the top most feature was returned.
+   * * At version 5.2, support for [ScreenPolygon](https://developers.arcgis.com/javascript/latest/references/core/core/types/#ScreenPolygon) hit targets was added.
+   * * At version 5.1, support for [ScreenRect](https://developers.arcgis.com/javascript/latest/references/core/core/types/#ScreenRect) hit targets was added.
    *
-   * @param hitTarget
-   * @param options
+   * @param hitTarget - The screen point, screen rectangle, screen polygon, or native mouse event identifying where to perform the hit test.
+   * @param options - Options to specify what is included in or excluded from the hitTest.
+   * @returns When resolved, returns an object containing an array of [hit test results](https://developers.arcgis.com/javascript/latest/references/core/views/types/#ViewHit).
    * @see [Sample - Access features with hitTest](https://developers.arcgis.com/javascript/latest/sample-code/map-component-hittest/)
    * @see [Sample - Hit test features by screen rectangle](https://developers.arcgis.com/javascript/latest/sample-code/map-hittest-screen-rectangle/)
    * @see [Sample - VectorTileLayer hitTest](https://developers.arcgis.com/javascript/latest/sample-code/layers-vectortilelayer-hittest/)
@@ -1060,7 +1149,7 @@ export abstract class ArcgisMap extends LitElement {
    * viewElement.addEventListener("arcgisViewClick", async (event) => {
    *   // Search for all media elements only on included mediaLayer at the clicked location
    *   const response = await viewElement.hitTest(event.detail, {
-   *     include: {mediaLayer}
+   *     include: mediaLayer
    *   });
    *   // if media elements are returned from the mediaLayer, do something with results
    *   if (response.results.length){
@@ -1070,7 +1159,7 @@ export abstract class ArcgisMap extends LitElement {
    * });
    * ```
    */
-  hitTest(hitTarget: MouseEvent | ScreenPoint | ScreenRect, options?: HitTestOptions): Promise<ViewHitTestResult>;
+  hitTest(hitTarget: MouseEvent | ScreenPoint | ScreenPolygon | ScreenRect, options?: HitTestOptions): Promise<ViewHitTestResult>;
   /**
    * Opens the popup at the given location with content defined either explicitly with content or driven
    * from the PopupTemplate of input features.
@@ -1258,6 +1347,31 @@ export abstract class ArcgisMap extends LitElement {
   readonly arcgisViewDoubleTapDrag: import("@arcgis/lumina").TargetedEvent<this, DoubleTapDragEvent>;
   /** Fires during a pointer drag on the view. */
   readonly arcgisViewDrag: import("@arcgis/lumina").TargetedEvent<this, DragEvent>;
+  /**
+   * Fires when the focus region is selected using the `Enter` or `Space` key. Use this event to react to the selection of the [focusRegion](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#focusRegion) via keyboard input and perform any necessary actions based on that selection, such as performing a `hitTest()` on the [focusRegion](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#focusRegion) and passing the returned graphics to the [selectionManager](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#selectionManager).
+   *
+   * Call `event.detail.preventDefault()` to suppress the default behavior of the [popup](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/) opening with the features in the focus region.
+   *
+   * @since 5.2
+   * @see [focusRegion](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#focusRegion)
+   * @see [focusRegionVisible](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#focusRegionVisible)
+   * @see [focusRegionShortcutEnabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#focusRegionShortcutEnabled)
+   * @example
+   * ```js
+   * viewElement.addEventListener("arcgisViewFocusRegionSelect", async (event) => {
+   *   // prevent the default popup from appearing
+   *   event.detail.preventDefault();
+   *   // get the focus region and fetch the popup features for it
+   *   const focusRegion = viewElement.focusRegion;
+   *   const generator = await viewElement.fetchPopupFeatures(focusRegion, {
+   *     pointerType: event.detail.pointerType,
+   *   });
+   *   // process the features as needed
+   *   const features = await Array.fromAsync(generator);
+   * });
+   * ```
+   */
+  readonly arcgisViewFocusRegionSelect: import("@arcgis/lumina").TargetedEvent<this, FocusRegionSelectEvent>;
   /** Fires after holding either a mouse button or a single finger on the view for a short amount of time. */
   readonly arcgisViewHold: import("@arcgis/lumina").TargetedEvent<this, HoldEvent>;
   /**
@@ -1389,6 +1503,7 @@ export abstract class ArcgisMap extends LitElement {
     arcgisViewDoubleClick: ArcgisMap["arcgisViewDoubleClick"]["detail"];
     arcgisViewDoubleTapDrag: ArcgisMap["arcgisViewDoubleTapDrag"]["detail"];
     arcgisViewDrag: ArcgisMap["arcgisViewDrag"]["detail"];
+    arcgisViewFocusRegionSelect: ArcgisMap["arcgisViewFocusRegionSelect"]["detail"];
     arcgisViewHold: ArcgisMap["arcgisViewHold"]["detail"];
     arcgisViewImmediateClick: ArcgisMap["arcgisViewImmediateClick"]["detail"];
     arcgisViewImmediateDoubleClick: ArcgisMap["arcgisViewImmediateDoubleClick"]["detail"];
@@ -1407,4 +1522,6 @@ export abstract class ArcgisMap extends LitElement {
     arcgisViewReadyError: ArcgisMap["arcgisViewReadyError"]["detail"];
     arcgisViewVerticalTwoFingerDrag: ArcgisMap["arcgisViewVerticalTwoFingerDrag"]["detail"];
   };
-}
+}
+
+export type AttributionMode = MapView["attributionMode"] | "auto";