@arcgis/map-components 5.2.0-next.13 → 5.2.0-next.131

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,7 +30,7 @@ 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";
@@ -38,6 +39,33 @@ 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.2_ Specifies the corner radius for the view. */
+  "--arcgis-view-corner-radius": "*";
+  /** _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 +137,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 +202,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 +219,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 +413,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 +457,38 @@ 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 [focusRegionEnabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#focusRegionEnabled) 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 [focusRegionEnabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#focusRegionEnabled) 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 [focusRegionEnabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#focusRegionEnabled) 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 [focusRegionEnabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#focusRegionEnabled)
+   * @see [@arcgisViewFocusRegionSelect](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#event-arcgisViewFocusRegionSelect)
+   */
+  get focusRegion(): MapView["focusRegion"];
+  /**
+   * Indicates whether the [focusRegion](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#focusRegion) is enabled. Set this property to `true` to show the centered focus region, or `false` to hide it.
+   * The focus region can also be enabled/disabled by focusing on the ArcgisMap component and pressing the `Shift` + `Alt`/`Option` + `O` keyboard shortcut.
+   *
+   * **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 [@arcgisViewFocusRegionSelect](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#event-arcgisViewFocusRegionSelect)
+   */
+  accessor focusRegionEnabled: boolean;
   /** Gamepad input specific configuration settings. */
   get gamepad(): GamepadSettings;
   /**
@@ -608,7 +672,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 +699,14 @@ export abstract class ArcgisMap extends LitElement {
    * ```
    */
   accessor navigation: Navigation;
+  /**
+   * Configures snapping, tooltips, and measurement units for supported components and analyses configured to inherit these options from the view.
+   * See [ViewOptions](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/options/ViewOptions/) for details.
+   *
+   * @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 +721,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 +879,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 +918,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 +1049,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
@@ -1022,7 +1097,7 @@ export abstract class ArcgisMap extends LitElement {
    * | :--- | :--- |
    * | [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. |
+   * | [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. Support was added in version 5.1. 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. |
@@ -1032,9 +1107,9 @@ export abstract class ArcgisMap extends LitElement {
    * [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 5.1, **[beta](https://developers.arcgis.com/javascript/latest/faq/#what-does-the-beta-tag-mean)** support was added for [ScreenRect](https://developers.arcgis.com/javascript/latest/references/core/core/types/#ScreenRect), allowing hit tests across rectangular screen 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 4.23, all hit test features from feature layers are returned in the result. In prior releases, only the topmost feature was returned.
    *
    * @param hitTarget
    * @param options
@@ -1258,6 +1333,30 @@ 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 [selection toolbar](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-selection-toolbar/).
+   *           
+   * 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 [focusRegionEnabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#focusRegionEnabled)
+   * @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 +1488,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 +1507,6 @@ export abstract class ArcgisMap extends LitElement {
     arcgisViewReadyError: ArcgisMap["arcgisViewReadyError"]["detail"];
     arcgisViewVerticalTwoFingerDrag: ArcgisMap["arcgisViewVerticalTwoFingerDrag"]["detail"];
   };
-}
+}
+
+export type AttributionMode = MapView["attributionMode"] | "auto";