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

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

@@ -13,6 +13,7 @@ import type FocusAreas from "@arcgis/core/effects/FocusAreas.js";
 import type Basemap from "@arcgis/core/Basemap.js";
 import type Map from "@arcgis/core/Map.js";
 import type Graphic from "@arcgis/core/Graphic.js";
+import type Polygon from "@arcgis/core/geometry/Polygon.js";
 import type Collection from "@arcgis/core/core/Collection.js";
 import type BasemapView from "@arcgis/core/views/BasemapView.js";
 import type Extent from "@arcgis/core/geometry/Extent.js";
@@ -23,25 +24,50 @@ import type GroundView from "@arcgis/core/views/GroundView.js";
 import type HighlightOptions from "@arcgis/core/views/support/HighlightOptions.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";
 import type Theme from "@arcgis/core/views/Theme.js";
 import type TimeExtent from "@arcgis/core/time/TimeExtent.js";
-import type Polygon from "@arcgis/core/geometry/Polygon.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 import type { LoadErrorSource } from "../types.js";
 import type { ArcgisPopup } from "../arcgis-popup/customElement.js";
 import type { AnalysisView3DFor } from "@arcgis/core/views/3d/analysis/types.js";
 import type { LayerView3DFor } from "@arcgis/core/views/3d/types.js";
-import type { DoubleTapDragEvent, VerticalTwoFingerDragEvent, PointerUpEvent, PointerMoveEvent, PointerLeaveEvent, PointerEnterEvent, PointerDownEvent, ViewMouseWheelEvent, LayerViewDestroyEvent, LayerViewCreateErrorEvent, LayerViewCreateEvent, KeyUpEvent, KeyDownEvent, ImmediateDoubleClickEvent, ImmediateClickEvent, HoldEvent, DragEvent, DoubleClickEvent, ClickEvent } from "@arcgis/core/views/input/types.js";
+import type { DoubleTapDragEvent, FocusRegionSelectEvent, VerticalTwoFingerDragEvent, PointerUpEvent, PointerMoveEvent, PointerLeaveEvent, PointerEnterEvent, PointerDownEvent, ViewMouseWheelEvent, LayerViewDestroyEvent, LayerViewCreateErrorEvent, LayerViewCreateEvent, KeyUpEvent, KeyDownEvent, ImmediateDoubleClickEvent, ImmediateClickEvent, HoldEvent, DragEvent, DoubleClickEvent, ClickEvent } from "@arcgis/core/views/input/types.js";
 import type { AnalysisViewDestroyEvent, AnalysisViewCreateErrorEvent, AnalysisViewCreateEvent, HitTestOptions3D, Screenshot, UserSettings, SceneViewHitTestResult, GoToOptions3D, GoToTarget3D } from "@arcgis/core/views/types.js";
-import type { ScreenPoint, ScreenRect } from "@arcgis/core/core/types.js";
+import type { ScreenPoint, ScreenRect, ScreenPolygon } 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 Scene component is used to add 3D maps to web applications. For 2D maps, use the
  * [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/).
@@ -91,13 +117,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 scene. 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.
@@ -182,13 +201,15 @@ export abstract class ArcgisScene extends LitElement {
    */
   get attributionItems(): SceneView["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
@@ -197,6 +218,15 @@ export abstract class ArcgisScene extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-scene auto-destroy-disabled></arcgis-scene>
+   * ```
+   *
+   * ```js
+   * sceneElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**
@@ -311,7 +341,7 @@ export abstract class ArcgisScene extends LitElement {
   accessor constraints: Constraints;
   /**
    * Indicates whether a layer's `displayFilter` is honored when rendering layers in the view.
-   * If `false`, the display filters are ignored and all features are rendered.
+   * If `true`, the display filters are ignored and all features are rendered.
    *
    * @default false
    */
@@ -410,6 +440,50 @@ export abstract class ArcgisScene extends LitElement {
    * @since 4.33
    */
   accessor focusAreas: FocusAreas;
+  /**
+   * The screen rectangle of the active focus region, or `null` when [focusRegionVisible](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#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-scene/#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-scene/#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-scene/#--arcgis-focus-region-outer-border-color), [--arcgis-focus-region-inner-border-color](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#--arcgis-focus-region-inner-border-color), and [--arcgis-focus-region-border-width](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#--arcgis-focus-region-border-width) CSS variables.
+   * -  When the [focusRegionVisible](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#focusRegionVisible) is `true`, the opened [popupElement](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#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-scene/#focusRegionShortcutEnabled)
+   * @see [focusRegionVisible](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#focusRegionVisible)
+   * @see [@arcgisViewFocusRegionSelect](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#event-arcgisViewFocusRegionSelect)
+   */
+  get focusRegion(): SceneView["focusRegion"];
+  /**
+   * Enables the `Shift` + `Alt`/`Option` + `O` keyboard shortcut for showing the [focusRegion](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#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 ArcgisScene component, or when [popupComponentEnabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#popupComponentEnabled) is set, and when the [popupDisabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#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-scene/#focusRegionVisible) property.
+   *
+   * @default false
+   * @since 5.2
+   * @see [focusRegion](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#focusRegion)
+   * @see [focusRegionVisible](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#focusRegionVisible)
+   * @see [@arcgisViewFocusRegionSelect](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#event-arcgisViewFocusRegionSelect)
+   */
+  accessor focusRegionShortcutEnabled: boolean | undefined;
+  /**
+   * Indicates whether the [focusRegion](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#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 ArcgisScene 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-scene/#popupDisabled) is `false`. Use [focusRegionShortcutEnabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#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-scene/#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-scene/#focusRegion)
+   * @see [focusRegionShortcutEnabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#focusRegionShortcutEnabled)
+   * @see [@arcgisViewFocusRegionSelect](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#event-arcgisViewFocusRegionSelect)
+   */
+  accessor focusRegionVisible: boolean;
   /** Gamepad input specific configuration settings. */
   get gamepad(): GamepadSettings;
   /**
@@ -529,7 +603,7 @@ export abstract class ArcgisScene extends LitElement {
    * @example
    * // Override the default highlights collection
    *
-   * const view = new MapView({
+   * const view = new SceneView({
    *   map: map,
    *   container: "viewDiv",
    *
@@ -555,7 +629,7 @@ export abstract class ArcgisScene extends LitElement {
    */
   accessor highlights: Collection<HighlightOptions>;
   /**
-   * Indication whether the view is being interacted with (for example when panning or by an interactive tool).
+   * Indicates whether the view is being interacted with (for example when panning or by an interactive tool).
    *
    * @default false
    */
@@ -590,7 +664,7 @@ export abstract class ArcgisScene 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
    */
@@ -603,7 +677,7 @@ export abstract class ArcgisScene extends LitElement {
    * @since 4.9
    * @example
    * // Disable the gamepad usage, single touch panning, panning momentum and mouse wheel zooming.
-   * const view = new MapView({
+   * const view = new SceneView({
    *   container: "viewDiv",
    *   map: new Map({
    *     basemap: "satellite"
@@ -624,6 +698,16 @@ export abstract class ArcgisScene 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;
   /**
    * Use the padding property to make the [center](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/#center),
    * and [extent](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/#extent),
@@ -644,6 +728,7 @@ export abstract class ArcgisScene 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-scene/#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-scene/#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-scene/#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-scene/#popupElement) instead. Set the [popupComponentEnabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#popupComponentEnabled) property to `true` to enable the popup component.
    * @see [popupElement](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#popupElement)
    * @see [popupDisabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#popupDisabled)
    * @see [openPopup()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#openPopup)
@@ -778,7 +863,7 @@ export abstract class ArcgisScene extends LitElement {
    */
   accessor spatialReference: SpatialReference;
   /**
-   * Indication whether the view is animating, being navigated with or resizing.
+   * Indicates whether the view is animating, being navigated with or resizing.
    *
    * @default false
    */
@@ -824,7 +909,7 @@ export abstract class ArcgisScene extends LitElement {
    * });
    *
    * // Create a mapview showing sales for the last week of March 2019 only.
-   * const view = new MapView({
+   * const view = new SceneView({
    *   map: map,
    *   container: "viewDiv",
    *   timeExtent: {
@@ -834,6 +919,39 @@ export abstract class ArcgisScene extends LitElement {
    * });
    */
   accessor timeExtent: TimeExtent | null | undefined;
+  /**
+   * Defines the time zone of the view.
+   * The time zone property determines how dates and times are represented to the user,
+   * but the underlying data is unchanged.
+   *
+   * > [!IMPORTANT]
+   * >
+   * > This property does not apply to the [arcgis-daylight](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-daylight/) or
+   * > [arcgis-shadow-cast](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/) components. They use their own `utcOffset` properties. Support for using the
+   * > scene's time zone in these components is planned for a future release.
+   *
+   * The time zone can be set to one of the following values:
+   *
+   * **Possible Values**
+   *
+   * | Value | Description |
+   * | ----- | ----------- |
+   * | system | Dates and times will be displayed in the time zone of the device or browser. |
+   * | unknown | Dates and times will be displayed based on the time zone that has been defined for the layer. No adjustments are made to the display of date info. The [arcgis-time-bar](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar/) component is disabled. |
+   * | Specified IANA time zone | Dates and times will be displayed in the specified IANA time zone. See [wikipedia - List of tz database time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). |
+   *
+   * @default "system"
+   * @since 5.2
+   * @see [SceneView.timeZone](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/#timeZone)
+   * @see [wikipedia - List of tz database time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)
+   * @example
+   * ```js
+   * // Date and time will be displayed in Pacific/Auckland (NZ) time zone
+   * const viewElement = document.querySelector("arcgis-scene");
+   * viewElement.timeZone = "Pacific/Auckland";
+   * ```
+   */
+  accessor timeZone: string;
   /**
    * Indicates whether the view is being updated by additional data requests to the network,
    * or by processing received data.
@@ -876,7 +994,7 @@ export abstract class ArcgisScene extends LitElement {
    * @see [Sample: SceneView - visibleArea](https://developers.arcgis.com/javascript/latest/sample-code/sceneview-visible-area/)
    * @see [extent](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/#extent)
    */
-  get visibleArea(): Polygon | null | undefined;
+  get visibleArea(): null | undefined | Polygon;
   /**
    * Represents the level of detail (LOD) at the center of the view.
    *
@@ -896,6 +1014,8 @@ export abstract class ArcgisScene 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
@@ -905,7 +1025,8 @@ export abstract class ArcgisScene 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
@@ -918,7 +1039,7 @@ export abstract class ArcgisScene 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
    *   });
    *
@@ -957,8 +1078,9 @@ export abstract class ArcgisScene extends LitElement {
    *
    * @param hitTarget
    * @param options
+   * @see [Sample - Hit test by screen rectangle in 3D](https://developers.arcgis.com/javascript/latest/sample-code/scene-hittest-screen-rectangle/)
    */
-  hitTest(hitTarget: MouseEvent | ScreenPoint | ScreenRect, options?: HitTestOptions3D): Promise<SceneViewHitTestResult>;
+  hitTest(hitTarget: MouseEvent | ScreenPoint | ScreenPolygon | ScreenRect, options?: HitTestOptions3D): Promise<SceneViewHitTestResult>;
   /**
    * Opens the popup based on input options.
    *
@@ -1121,6 +1243,31 @@ export abstract class ArcgisScene extends LitElement {
    * [Read more](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/#event-drag)
    */
   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-scene/#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-scene/#focusRegion) and passing the returned graphics to the [selectionManager](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#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-scene/#focusRegion)
+   * @see [focusRegionVisible](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#focusRegionVisible)
+   * @see [focusRegionShortcutEnabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#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.
    *
@@ -1247,6 +1394,7 @@ export abstract class ArcgisScene extends LitElement {
     arcgisViewDoubleClick: ArcgisScene["arcgisViewDoubleClick"]["detail"];
     arcgisViewDoubleTapDrag: ArcgisScene["arcgisViewDoubleTapDrag"]["detail"];
     arcgisViewDrag: ArcgisScene["arcgisViewDrag"]["detail"];
+    arcgisViewFocusRegionSelect: ArcgisScene["arcgisViewFocusRegionSelect"]["detail"];
     arcgisViewHold: ArcgisScene["arcgisViewHold"]["detail"];
     arcgisViewImmediateClick: ArcgisScene["arcgisViewImmediateClick"]["detail"];
     arcgisViewImmediateDoubleClick: ArcgisScene["arcgisViewImmediateDoubleClick"]["detail"];
@@ -1265,4 +1413,6 @@ export abstract class ArcgisScene extends LitElement {
     arcgisViewReadyError: ArcgisScene["arcgisViewReadyError"]["detail"];
     arcgisViewVerticalTwoFingerDrag: ArcgisScene["arcgisViewVerticalTwoFingerDrag"]["detail"];
   };
-}
+}
+
+export type AttributionMode = SceneView["attributionMode"] | "auto";

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

@@ -1,31 +1,35 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import { c as p } from "../../chunks/runtime.js";
+import { c as l } from "../../chunks/runtime.js";
 import { html as a } from "lit";
-import l from "@arcgis/core/Camera.js";
+import p from "@arcgis/core/Camera.js";
 import { watch as s } from "@arcgis/core/core/reactiveUtils.js";
 import v from "@arcgis/core/geometry/Point.js";
 import u from "@arcgis/core/views/SceneView.js";
 import g from "@arcgis/core/WebScene.js";
-import { LitElement as d, createEvent as r, safeClassMap as n } from "@arcgis/lumina";
-import { reEmitEvent as t, reCreateAccessor as y, makeAccessorController as w } from "@arcgis/lumina/controllers/accessor";
-import { createRef as o, ref as h } from "lit/directives/ref.js";
-import { U as f, u as b, a as V } from "../../chunks/useArcgisViewReadyError.js";
-import { s as C } from "../../chunks/esri-main.js";
+import { LitElement as d, createEvent as r, safeClassMap as o } from "@arcgis/lumina";
+import { reEmitEvent as t } from "@arcgis/lumina-toolkit/reEmitEvent";
+import { makeAccessorController as w, reCreateAccessor as f } from "@arcgis/lumina-toolkit/useAccessor";
+import { createRef as n, ref as h } from "lit/directives/ref.js";
+import { U as y, u as b, a as V, b as C } from "../../chunks/useArcgisViewReadyError.js";
+import { s as _ } from "../../chunks/esri-main.js";
 import { s as E } from "../../chunks/slots.js";
 import { C as c } from "../../chunks/resources.js";
-import { b as _, c as P, p as A, i as R } from "../../chunks/component-utils.js";
-const D = w(g, {}), I = w(u, {});
-class M extends d {
+import { d as R, e as P, b as A, c as M, p as D, i as I } from "../../chunks/component-utils.js";
+const S = w(g, {}), k = w(u, {});
+class F extends d {
   constructor() {
-    super(), this._containerRef = o(), this._mapRef = o(), this._uiController = new f(this), this._cameraProperties = {}, this.arcgisLoadError = b(this), this.arcgisViewReadyError = V(this), this._map = D(this), this.view = I(this), this.allLayerViews = this.view.allLayerViews, this.alphaCompositingEnabled = this.view.alphaCompositingEnabled, this.analyses = this.view.analyses, this.animationsDisabled = this.view.animationsEnabled, this.attributionMode = this.view.attributionMode, this.autoDestroyDisabled = !1, this.basemap = this._map.basemap, this.basemapView = this.view.basemapView, this.canZoomIn = this.view.canZoomIn, this.canZoomOut = this.view.canZoomOut, this.clippingArea = this.view.clippingArea, this.constraints = this.view.constraints, this.displayFilterDisabled = this.view.displayFilterEnabled, this.environment = this.view.environment, this.fatalError = this.view.fatalError, this.floors = this.view.floors, this.graphics = this.view.graphics, this.ground = this._map.ground, this.groundView = this.view.groundView, this.highlights = this.view.highlights, this.layerViews = this.view.layerViews, this.magnifier = this.view.magnifier, this.map = this.view.map, this.navigation = this.view.navigation, this.padding = this.view.padding, this.popup = this.view.popup, this.popupDisabled = this.view.popupEnabled, this.popupComponentEnabled = !1, this.qualityProfile = this.view.qualityProfile, this.ready = this.view.ready, this.selectionManager = this.view.selectionManager, this.slotGroupRefs = this._uiController.slotGroupRefs, this.spatialReference = this.view.spatialReference, this.suspended = this.view.suspended, this.theme = this.view.theme, this.timeExtent = this.view.timeExtent, this.updating = this.view.updating, this.viewingMode = this.view.viewingMode, this.visibleArea = this.view.visibleArea, this.arcgisViewAnalysisViewCreate = t(() => this.view, "analysis-view-create"), this.arcgisViewAnalysisViewCreateError = t(() => this.view, "analysis-view-create-error"), this.arcgisViewAnalysisViewDestroy = t(() => this.view, "analysis-view-destroy"), this.arcgisViewChange = r(), this.arcgisViewClick = t(() => this.view, "click"), this.arcgisViewDoubleClick = t(() => this.view, "double-click"), this.arcgisViewDoubleTapDrag = t(() => this.view, "double-tap-drag"), this.arcgisViewDrag = t(() => this.view, "drag"), this.arcgisViewHold = t(() => this.view, "hold"), this.arcgisViewImmediateClick = t(() => this.view, "immediate-click"), this.arcgisViewImmediateDoubleClick = t(() => this.view, "immediate-double-click"), this.arcgisViewKeyDown = t(() => this.view, "key-down"), this.arcgisViewKeyUp = t(() => this.view, "key-up"), this.arcgisViewLayerviewCreate = t(() => this.view, "layerview-create"), this.arcgisViewLayerviewCreateError = t(() => this.view, "layerview-create-error"), this.arcgisViewLayerviewDestroy = t(() => this.view, "layerview-destroy"), this.arcgisViewMouseWheel = t(() => this.view, "mouse-wheel"), this.arcgisViewPointerDown = t(() => this.view, "pointer-down"), this.arcgisViewPointerEnter = t(() => this.view, "pointer-enter"), this.arcgisViewPointerLeave = t(() => this.view, "pointer-leave"), this.arcgisViewPointerMove = t(() => this.view, "pointer-move"), this.arcgisViewPointerUp = t(() => this.view, "pointer-up"), this.arcgisViewReadyChange = r(), this.arcgisViewVerticalTwoFingerDrag = t(() => this.view, "vertical-two-finger-drag"), this.view.ui = {
+    super(), this._attributionMode = null, this._containerRef = n(), this._mapRef = n(), this._uiController = new y(this), this._cameraProperties = {}, this.arcgisLoadError = b(this), this.arcgisViewReadyError = V(this), this._map = S(this), this.view = k(this), this.allLayerViews = this.view.allLayerViews, this.alphaCompositingEnabled = this.view.alphaCompositingEnabled, this.analyses = this.view.analyses, this.animationsDisabled = this.view.animationsEnabled, this.autoDestroyDisabled = !1, this.basemap = this._map.basemap, this.basemapView = this.view.basemapView, this.canZoomIn = this.view.canZoomIn, this.canZoomOut = this.view.canZoomOut, this.clippingArea = this.view.clippingArea, this.constraints = this.view.constraints, this.displayFilterDisabled = this.view.displayFilterEnabled, this.environment = this.view.environment, this.fatalError = this.view.fatalError, this.floors = this.view.floors, this.graphics = this.view.graphics, this.ground = this._map.ground, this.groundView = this.view.groundView, this.highlights = this.view.highlights, this.layerViews = this.view.layerViews, this.magnifier = this.view.magnifier, this.map = this.view.map, this.navigation = this.view.navigation, this.options = this.view.options, this.padding = this.view.padding, this.popup = this.view.popup, this.popupDisabled = this.view.popupEnabled, this.popupComponentEnabled = !1, this.qualityProfile = this.view.qualityProfile, this.ready = this.view.ready, this.selectionManager = this.view.selectionManager, this.focusRegionVisible = this.view.focusRegionVisible, this.slotGroupRefs = this._uiController.slotGroupRefs, this.spatialReference = this.view.spatialReference, this.suspended = this.view.suspended, this.theme = this.view.theme, this.timeExtent = this.view.timeExtent, this.timeZone = this.view.timeZone, this.viewingMode = this.view.viewingMode, this.arcgisViewAnalysisViewCreate = t(() => this.view, "analysis-view-create"), this.arcgisViewAnalysisViewCreateError = t(() => this.view, "analysis-view-create-error"), this.arcgisViewAnalysisViewDestroy = t(() => this.view, "analysis-view-destroy"), this.arcgisViewChange = r(), this.arcgisViewClick = t(() => this.view, "click"), this.arcgisViewDoubleClick = t(() => this.view, "double-click"), this.arcgisViewDoubleTapDrag = t(() => this.view, "double-tap-drag"), this.arcgisViewFocusRegionSelect = t(() => this.view, "focus-region-select"), this.arcgisViewDrag = t(() => this.view, "drag"), this.arcgisViewHold = t(() => this.view, "hold"), this.arcgisViewImmediateClick = t(() => this.view, "immediate-click"), this.arcgisViewImmediateDoubleClick = t(() => this.view, "immediate-double-click"), this.arcgisViewKeyDown = t(() => this.view, "key-down"), this.arcgisViewKeyUp = t(() => this.view, "key-up"), this.arcgisViewLayerviewCreate = t(() => this.view, "layerview-create"), this.arcgisViewLayerviewCreateError = t(() => this.view, "layerview-create-error"), this.arcgisViewLayerviewDestroy = t(() => this.view, "layerview-destroy"), this.arcgisViewMouseWheel = t(() => this.view, "mouse-wheel"), this.arcgisViewPointerDown = t(() => this.view, "pointer-down"), this.arcgisViewPointerEnter = t(() => this.view, "pointer-enter"), this.arcgisViewPointerLeave = t(() => this.view, "pointer-leave"), this.arcgisViewPointerMove = t(() => this.view, "pointer-move"), this.arcgisViewPointerUp = t(() => this.view, "pointer-up"), this.arcgisViewReadyChange = r(), this.arcgisViewVerticalTwoFingerDrag = t(() => this.view, "vertical-two-finger-drag"), C(this), this.view.ui = {
       components: []
     };
   }
   static {
-    this.properties = { _map: 16, aria: 0, view: 32, allLayerViews: 32, alphaCompositingEnabled: 5, analyses: 0, animationsDisabled: 5, attributionItems: 32, attributionMode: 1, autoDestroyDisabled: 5, basemap: 1, basemapView: 0, camera: 0, cameraFov: 9, cameraHeading: 9, cameraPosition: 1, cameraTilt: 9, canZoomIn: 36, canZoomOut: 36, center: 1, clippingArea: 0, constraints: 0, displayFilterDisabled: 5, environment: 0, extent: 0, fatalError: 0, floors: 0, focusAreas: 0, gamepad: 32, graphics: 0, ground: 1, groundView: 32, hideAttribution: 5, highlights: 0, interacting: 32, itemId: 3, layerViews: 32, magnifier: 32, map: 0, navigating: 32, navigation: 0, padding: 0, performanceInfo: 32, popup: 0, popupElement: 32, popupDisabled: 5, popupComponentEnabled: 5, qualityProfile: 1, ready: 36, resolution: 32, selectionManager: 32, scale: 9, slotGroupRefs: 32, spatialReference: 0, stationary: 32, suspended: 39, theme: 0, timeExtent: 0, updating: 36, viewingMode: 1, viewpoint: 0, visibleArea: 32, zoom: 9, loadErrorSources: 0 };
+    this.properties = { _map: 16, aria: 0, view: 32, allLayerViews: 32, alphaCompositingEnabled: 5, analyses: 0, animationsDisabled: 5, attributionItems: 32, attributionMode: 1, autoDestroyDisabled: 5, basemap: 1, basemapView: 0, camera: 0, cameraFov: 9, cameraHeading: 9, cameraPosition: 1, cameraTilt: 9, canZoomIn: 36, canZoomOut: 36, center: 1, clippingArea: 0, constraints: 0, displayFilterDisabled: 5, environment: 0, extent: 0, fatalError: 0, floors: 0, focusAreas: 0, gamepad: 32, graphics: 0, ground: 1, groundView: 32, hideAttribution: 5, highlights: 0, interacting: 32, itemId: 3, layerViews: 32, magnifier: 32, map: 0, navigating: 32, navigation: 0, options: 0, padding: 0, performanceInfo: 32, popup: 0, popupElement: 32, popupDisabled: 5, popupComponentEnabled: 5, qualityProfile: 1, ready: 36, resolution: 32, selectionManager: 32, focusRegionVisible: 5, focusRegionShortcutEnabled: 5, focusRegion: 32, scale: 9, slotGroupRefs: 32, spatialReference: 0, stationary: 32, suspended: 39, theme: 0, timeExtent: 0, timeZone: 1, updating: 32, viewingMode: 1, viewpoint: 0, visibleArea: 32, zoom: 9, loadErrorSources: 0 };
   }
   static {
-    this.styles = [C, E];
+    this.styles = [_, E];
+  }
+  static {
+    this.shadowRootOptions = { mode: "open", delegatesFocus: !0 };
   }
   get aria() {
     return this.view?.aria ?? null;
@@ -36,11 +40,17 @@ class M extends d {
   get attributionItems() {
     return this.view?.attributionItems ?? [];
   }
+  get attributionMode() {
+    return this._attributionMode;
+  }
+  set attributionMode(i) {
+    this._attributionMode = i, i !== "auto" && (this.view.attributionMode = i);
+  }
   get camera() {
     return this.view.camera;
   }
   set camera(i) {
-    _(this.camera, i) || (this.view.camera = i);
+    R(this.camera, i) || (this.view.camera = i);
   }
   get cameraFov() {
     const { view: i } = this;
@@ -86,7 +96,10 @@ class M extends d {
     return this.view.center;
   }
   set center(i) {
-    const e = A(i, this.view);
+    if (A(i, this._center))
+      return;
+    this._center = M(i);
+    const e = D(i, this.view);
     e && (this.view.center = e);
   }
   get extent() {
@@ -120,7 +133,7 @@ class M extends d {
     return this._map.portalItem?.id;
   }
   set itemId(i) {
-    y(this._map, this), this._map.portalItem = { id: i }, this.view.map = this._map;
+    f(this._map, this), this._map.portalItem = { id: i }, this.view.map = this._map;
   }
   get navigating() {
     return this.view.navigating;
@@ -134,6 +147,9 @@ class M extends d {
   get resolution() {
     return this.view.resolution;
   }
+  get focusRegion() {
+    return this.view.focusRegion;
+  }
   get scale() {
     return this.view.scale;
   }
@@ -143,11 +159,17 @@ class M extends d {
   get stationary() {
     return this.view.stationary;
   }
+  get updating() {
+    return this.view.updating;
+  }
   get viewpoint() {
     return this.view.viewpoint;
   }
   set viewpoint(i) {
-    R(this.viewpoint, i) && (this.view.viewpoint = i);
+    I(this.viewpoint, i) && (this.view.viewpoint = i);
+  }
+  get visibleArea() {
+    return this.view.visibleArea;
   }
   get zoom() {
     return this.view.zoom;
@@ -158,12 +180,12 @@ class M extends d {
   async closePopup() {
     this._uiController.closePopup();
   }
-  async fetchPopupFeatures(i, e) {
-    return this.view.fetchPopupFeatures(i, e);
-  }
   async destroy() {
     await this.manager.destroy();
   }
+  async fetchPopupFeatures(i, e) {
+    return this.view.fetchPopupFeatures(i, e);
+  }
   async goTo(i, e) {
     return await this.view.goTo(i, e);
   }
@@ -171,7 +193,7 @@ class M extends d {
     return await this.view.hitTest(i, e);
   }
   async openPopup(i) {
-    this._uiController.openPopup(i);
+    await this._uiController.openPopup(i);
   }
   async takeScreenshot(i) {
     return await this.view.takeScreenshot(i);
@@ -220,17 +242,17 @@ class M extends d {
       i(this._cameraProperties);
       return;
     }
-    const e = this.view.camera?.clone() ?? new l();
+    const e = this.view.camera?.clone() ?? new p();
     i(e), this.camera = e;
   }
   renderMain() {
-    return a`<div class=${n(c.base)} ${h(this._mapRef)}></div>`;
+    return a`<div class=${o(c.base)} ${h(this._mapRef)}></div>`;
   }
   render() {
-    return a`${this.renderMain()}<section class=${n(c.containerUI)} ${h(this._containerRef)}>${this._uiController.render()}</section>`;
+    return a`${this.renderMain()}<section class=${o(c.containerUI)} ${h(this._containerRef)}>${this._uiController.render()}</section>`;
   }
 }
-p("arcgis-scene", M);
+l("arcgis-scene", F);
 export {
-  M as ArcgisScene
+  F as ArcgisScene
 };