@arcgis/map-components 4.34.0-next.8 → 4.34.0-next.81

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

@@ -1,12 +1,12 @@
 /// <reference types="@arcgis/core/interfaces.d.ts" />
-/// <reference types="../../index.d.ts" />
-import { Nil } from '@arcgis/components-utils';
+/// <reference path="../../index.d.ts" />
+import { nil } from '@arcgis/toolkit/type';
 import { default as SceneView } from '@arcgis/core/views/SceneView.js';
 import { default as WebScene } from '@arcgis/core/WebScene.js';
 import { PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { Use } from '@arcgis/lumina/controllers';
 
-declare const useWebScene: (component: LitElement & Omit<Pick<WebScene, "basemap" | "ground" | "clippingArea" | "layers" | "tables" | "presentation" | "widgets" | "applicationProperties" | "authoringApp" | "authoringAppVersion" | "floorInfo" | "initialViewProperties" | "portalItem" | "thumbnailUrl" | "clippingEnabled" | "heightModelInfo">, "basemap" | "ground" | ("destroyed" | "initialized" | "declaredClass" | "set" | "watch" | "addHandles" | "removeHandles" | "hasHandles") | "layers" | "tables" | "presentation" | "widgets" | "applicationProperties" | "authoringApp" | "authoringAppVersion" | "floorInfo" | "initialViewProperties" | "portalItem" | "thumbnailUrl" | "clippingEnabled" | "heightModelInfo"> & {
+declare const useWebScene: (component: LitElement & Omit<Pick<WebScene, "basemap" | "focusAreas" | "ground" | "clippingArea" | "layers" | "applicationProperties" | "authoringApp" | "authoringAppVersion" | "floorInfo" | "initialViewProperties" | "portalItem" | "presentation" | "tables" | "thumbnailUrl" | "widgets" | "clippingEnabled" | "heightModelInfo">, "basemap" | "ground" | ("destroyed" | "initialized" | "declaredClass" | "set" | "watch" | "addHandles" | "removeHandles" | "hasHandles") | "layers" | "applicationProperties" | "authoringApp" | "authoringAppVersion" | "floorInfo" | "initialViewProperties" | "portalItem" | "presentation" | "tables" | "thumbnailUrl" | "widgets" | "clippingEnabled" | "heightModelInfo"> & {
     autoDestroyDisabled: boolean;
     destroy: () => Promise<void>;
 }) => WebScene;
@@ -51,15 +51,16 @@ declare const useSceneView: (component: LitElement & Omit<Pick<SceneView, "conta
  *
  * ```js
  * const viewElement = document.querySelector("arcgis-scene");
- * viewElement.addEventListener("arcgisViewReadyChange", () => {
- *   const layer = new GraphicsLayer({ title: "My layer"});
- *   viewElement.map.add(layer);
- * });
+ * await viewElement.viewOnReady();
+ * // The view is now ready to be used.
+ * const layer = new GraphicsLayer({ title: "My layer"});
+ * viewElement.map.add(layer);
  * ```
  *
- * See also:
+ * **See also**
+ *
  * - [SDK sample apps using the Scene component](https://developers.arcgis.com/javascript/latest/sample-code/?tagged=arcgis-scene)
- * - [Getting started](https://developers.arcgis.com/javascript/latest/get-started-overview/)
+ * - [Get started](https://developers.arcgis.com/javascript/latest/get-started/)
  * - [Programming patterns](https://developers.arcgis.com/javascript/latest/programming-patterns/)
  *
  * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/)
@@ -112,15 +113,10 @@ export declare class ArcgisScene extends LitElement {
     basemapView: __esri.BasemapView;
     /**
      * The [camera](https://developers.arcgis.com/javascript/latest/api-reference/esri-Camera.html) allows to set the observation point from which the visible portion (or perspective)
-     * of the view is determined. When set in the constructor, this property overrides the
-     * [center](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#center),
-     * [extent](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#extent),
-     * [scale](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#scale),
-     * [viewpoint](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#viewpoint), and
-     * [zoom](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#zoom) properties.
+     * of the view is determined. When set in the constructor, this property overrides the [center](#center), [extent](#extent), [scale](#scale), [viewpoint](#viewpoint), and [zoom](#zoom) properties.
      *
      * Setting the camera immediately changes the current view. For animating the view, see this component's
-     * [goTo()](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#goTo) method.
+     * [goTo()](#goTo) method.
      */
     get camera(): __esri.Camera;
     set camera(newValue: __esri.Camera);
@@ -128,57 +124,58 @@ export declare class ArcgisScene extends LitElement {
      * The diagonal field of view (fov) angle for the camera. The range of angles must be between 1 and 170 degrees.
      *
      * Setting the camera fov immediately changes the current view. For animating the view, see this component's
-     * [goTo()](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#goTo) method.
+     * [goTo()](#goTo) method.
      *
      * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-Camera.html#fov)
      */
-    get cameraFov(): Nil | number;
-    set cameraFov(newValue: Nil | number);
+    get cameraFov(): nil | number;
+    set cameraFov(newValue: nil | number);
     /**
      * The compass heading of the camera in degrees.
      *
      * Setting the camera heading immediately changes the current view. For animating the view, see this component's
-     * [goTo()](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#goTo) method.
+     * [goTo()](#goTo) method.
      *
      * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-Camera.html#heading)
      */
-    get cameraHeading(): Nil | number;
-    set cameraHeading(newValue: Nil | number);
+    get cameraHeading(): nil | number;
+    set cameraHeading(newValue: nil | number);
     /**
-     * The position of the camera defined by a map point. It can be a string with the format `"<longitude>, <latitude>, <elevation>"`
-     * or a [Point](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Point.html) instance.
+     * The position of the camera defined by a map point. It can either be set with a
+     * [Point](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Point.html) instance
+     * or a string in the format: longitude, latitude, elevation. E.g. `"12.3808, 46.3959, 4400"`.
      *
      * Setting the camera position immediately changes the current view. For animating the view, see this component's
-     * [goTo()](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#goTo) method.
+     * [goTo()](#goTo) method.
      *
      * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-Camera.html#position)
      */
-    get cameraPosition(): __esri.Point | Nil | number[] | string;
-    set cameraPosition(newValue: __esri.Point | Nil | number[] | string);
+    get cameraPosition(): __esri.Point | nil | number[] | string;
+    set cameraPosition(newValue: __esri.Point | nil | number[] | string);
     /**
      * The tilt of the camera in degrees with respect to the surface as projected down from the camera position.
      *
      * Setting the camera tilt immediately changes the current view. For animating the view, see this component's
-     * [goTo()](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#goTo) method.
+     * [goTo()](#goTo) method.
      *
      * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-Camera.html#tilt)
      */
-    get cameraTilt(): Nil | number;
-    set cameraTilt(newValue: Nil | number);
+    get cameraTilt(): nil | number;
+    set cameraTilt(newValue: nil | number);
     /**
      * Represents the center point of the view. It can be a string with the format `"<longitude>, <latitude>"`
      * or a [Point](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Point.html) instance.
      *
      * Setting the center immediately changes the current view. For animating the view, see this component's
-     * [goTo()](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#goTo) method.
+     * [goTo()](#goTo) method.
      *
      * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#center)
      */
     get center(): __esri.SceneView["center"];
-    set center(newValue: __esri.SceneView["center"] | Nil | number[] | string);
+    set center(newValue: __esri.SceneView["center"] | nil | number[] | string);
     /**
      * Represents an optional clipping area used to define the visible [extent](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Extent.html)
-     * of a [local scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#viewingMode).
+     * of a Scene in `local` [viewingMode](#viewingMode).
      *
      * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#clippingArea)
      */
@@ -197,17 +194,63 @@ export declare class ArcgisScene extends LitElement {
      */
     displayFilterDisabled: boolean;
     /**
-     * Specifies various properties of the environment's visualization in the view, like the lighting, background, weather, etc.
+     * Specifies various properties of the environment's visualization within the view, including lighting, background, weather, and more.
+     * The Scene will redraw automatically when any property of environment changes.
+     *
+     * Modifying the lighting:
+     *
+     * ```js
+     * viewElement.environment.lighting = {
+     *   type: "sun", // autocasts as new SunLighting()
+     *   date: new Date(), // sets the lighting to reflect the current time of day
+     *   directShadowsEnabled: true,
+     * };
+     * ```
+     *
+     * Setting the background:
+     *
+     * ```js
+     * viewElement.environment = {
+     *  background: {
+     *     type: "color",
+     *     color: [255, 252, 244, 1]
+     *  },
+     *   starsEnabled: false,
+     *   atmosphereEnabled: false
+     * };
+     * ```
+     *
+     * Changing the weather in the scene:
+     *
+     * ```js
+     * viewElement.environment.weather = {
+     *   type: "rainy", // autocasts as new RainyWeather({ cloudCover: 0.7, precipitation: 0.3 })
+     *   cloudCover: 0.7,
+     *   precipitation: 0.3
+     * };
+     * ```
+     *
+     * **See also**
+     *
+     * - [SunLighting](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-SunLighting.html)
+     * - [VirtualLighting](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-VirtualLighting.html)
+     * - [SunnyWeather](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-SunnyWeather.html)
+     * - [CloudyWeather](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-CloudyWeather.html)
+     * - [RainyWeather](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-RainyWeather.html)
+     * - [SnowyWeather](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-SnowyWeather.html)
+     * - [FoggyWeather](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-FoggyWeather.html)
+     * - [Sample - Daylight component](https://developers.arcgis.com/javascript/latest/sample-code/daylight/)
+     * - [Sample - Weather component](https://developers.arcgis.com/javascript/latest/sample-code/weather/)
      *
      * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#environment)
      */
     environment: __esri.SceneViewEnvironment;
     /**
-     * The extent represents the visible portion of a map within the view as an instance of
+     * The extent represents the visible portion of a [map](#map) within the view as an instance of
      * [Extent](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Extent.html).
      *
      * Setting the extent immediately changes the view without animation. To animate
-     * the view, see this component's [goTo()](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#goTo) method.
+     * the view, see this component's [goTo()](#goTo) method.
      * When the view is rotated, the extent does not update to include the newly visible portions of the map.
      *
      * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#extent)
@@ -226,12 +269,22 @@ export declare class ArcgisScene extends LitElement {
      * It can filter the map display on floor-aware layers by zero or more level IDs.
      */
     floors: __esri.Collection<string>;
+    /**
+     * A container of all [focus areas](https://developers.arcgis.com/javascript/latest/api-reference/esri-effects-FocusAreas.html) present in the map.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html#focusAreas)
+     *
+     * @since 4.33
+     */
+    get focusAreas(): __esri.FocusAreas;
+    set focusAreas(newValue: __esri.FocusAreas);
     /** Gamepad input specific configuration settings. */
     get gamepad(): __esri.GamepadSettings;
     /**
      * Allows for adding graphics directly to the default graphics in the view.
-     * Examples:
-     * ```
+     *
+     * @example
+     * ```js
      * // Adds a graphic to the View
      * graphics.add(pointGraphic);
      * // Removes a graphic from the View
@@ -240,7 +293,7 @@ export declare class ArcgisScene extends LitElement {
      */
     graphics: __esri.Collection<__esri.Graphic>;
     /**
-     * Specifies the surface properties for the map. It can be either a [Ground](https://developers.arcgis.com/javascript/latest/api-reference/esri-Ground.html)
+     * Specifies the surface properties for the [map](#map). It can be either a [Ground](https://developers.arcgis.com/javascript/latest/api-reference/esri-Ground.html)
      * instance or a string with one of the following values:
      *    * `"world-elevation"`
      *    * `"world-topobathymetry"`
@@ -265,7 +318,7 @@ export declare class ArcgisScene extends LitElement {
     /**
      * Options for configuring the highlight.
      *
-     * @deprecated since 4.32. Use [highlights](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#highlights) property instead.
+     * @deprecated since 4.32, use [highlights](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#highlights) property instead.
      */
     highlightOptions: __esri.HighlightOptions;
     /**
@@ -280,18 +333,18 @@ export declare class ArcgisScene extends LitElement {
      *
      * To configure the portal url you must set the [config.portalUrl](https://developers.arcgis.com/javascript/latest/api-reference/esri-config.html#portalUrl) property before the Scene component loads.
      */
-    get itemId(): Nil | string;
-    set itemId(newValue: Nil | string);
+    get itemId(): nil | string;
+    set itemId(newValue: nil | string);
     /**
      * A collection containing a hierarchical list of all the created
      * [LayerViews](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-layers-LayerView.html) of the
-     * [operational layers](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html#layers) in the map.
+     * [operational layers](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html#layers) in the [map](#map).
      */
     readonly layerViews: __esri.Collection<__esri.LayerView>;
     /** The magnifier allows for showing a portion of the view as a magnifier image on top of the view. */
     readonly magnifier: __esri.Magnifier;
     /** An instance of a [Map](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html) object to display in the view. */
-    map: __esri.Map;
+    map: __esri.Map | nullish;
     /**
      * Indication whether the view is being navigated (for example when panning).
      *
@@ -320,10 +373,11 @@ export declare class ArcgisScene extends LitElement {
      */
     get performanceInfo(): __esri.SceneViewPerformanceInfo;
     /**
-     * A [Popup](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Popup.html) object that displays general content or attributes from
-     * [layers](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html#layers) in the [map](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#map).
+     * A [Popup](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Popup.html)
+     * object that displays general content or attributes from [layers](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html#layers)
+     * in the [map](#map).
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#popup)
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#popup)
      */
     popup: nullish | __esri.Popup;
     /**
@@ -333,9 +387,9 @@ export declare class ArcgisScene extends LitElement {
      */
     popupDisabled: boolean;
     /**
-     * SceneView can draw scenes in three different quality modes: `high`, `medium` and `low`.
+     * Scenes can be drawn in three different quality modes: `high`, `medium` and `low`.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#qualityProfile)
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#qualityProfile)
      */
     qualityProfile: "medium" | "low" | "high";
     /**
@@ -349,16 +403,16 @@ export declare class ArcgisScene extends LitElement {
     readonly ready: boolean;
     /**
      * Represents the current value of one pixel in the unit of the view's
-     * [spatialReference](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#spatialReference).
-     * The resolution is calculated by dividing the view's [extent width](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Extent.html#width)
-     * by [its width](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#width).
+     * [spatialReference](#spatialReference).
+     * The resolution is calculated by dividing the Scene component's [extent](#extent) [width](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Extent.html#width)
+     * by its width.
      */
     get resolution(): number;
     /**
      * Represents the map scale at the center of the view.
      *
      * Setting the scale immediately changes the view. For animating
-     * the view, see this component's [goTo()](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#goTo) method.
+     * the view, see this component's [goTo()](#goTo) method.
      *
      * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#scale)
      */
@@ -389,8 +443,7 @@ export declare class ArcgisScene extends LitElement {
      */
     readonly suspended: boolean;
     /**
-     * This property specifies the base colors used by some widgets
-     * and components to render graphics and labels.
+     * This property specifies the base colors used by some components to render graphics and labels.
      * This only affects those elements that would otherwise use the default orange pattern.
      *
      * @default null
@@ -428,24 +481,24 @@ export declare class ArcgisScene extends LitElement {
      * or point of observation on the view.
      *
      * Setting the viewpoint immediately changes the current view. For animating
-     * the view, see this component's [goTo()](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#goTo) method.
+     * the view, see this component's [goTo()](#goTo) method.
      *
      * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#viewpoint)
      */
     get viewpoint(): __esri.Viewpoint;
     set viewpoint(newValue: __esri.Viewpoint);
     /**
-     * The visibleArea represents the visible portion of a [map](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html) within the view as
-     * an instance of a [Polygon](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Polygon.html).
+     * The visibleArea represents the visible portion of a [map](#map) within the view as an instance of a
+     * [Polygon](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Polygon.html).
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#visibleArea)
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#visibleArea)
      */
     readonly visibleArea: nullish | __esri.Polygon;
     /**
      * Represents the level of detail (LOD) at the center of the view.
      *
-     * Setting the zoom immediately changes the current view. For animating the view, see this component's [goTo()](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#goTo) method.
-     * Setting this property in conjunction with [center](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#center)
+     * Setting the zoom immediately changes the current view. For animating the view, see this component's [goTo()](#goTo) method.
+     * Setting this property in conjunction with [center](#center)
      * is a convenient way to set the initial extent of the view.
      *
      * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#zoom)
@@ -454,38 +507,36 @@ export declare class ArcgisScene extends LitElement {
     set zoom(newValue: number);
     /**
      * @deprecated
-     * since 4.33. Use `element.map.add(layer)` instead.
+     * since 4.33, use `element.map.add(layer)` instead.
      *
      * Adds a layer to the [map's](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#map) `layers` collection.
      */
     addLayer(layer: __esri.Layer | Promise<any>, index?: number): Promise<void>;
     /**
      * @deprecated
-     * since 4.33. Use `element.map.addMany([layer])` instead.
+     * since 4.33, use `element.map.addMany([layer])` instead.
      *
      * Adds a layer or array of layers to the [map's](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#map) `layers` collection.
      */
     addLayers(layers: __esri.Layer[], index?: number): Promise<void>;
     /**
      * @deprecated
-     * since 4.33. Use `element.map.tables.add(table)` instead.
+     * since 4.33, use `element.map.tables.add(table)` instead.
      *
      * Adds a table to the [map's](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#map) `tables` collection.
      */
     addTable(table: __esri.FeatureLayer): Promise<void>;
     /**
      * @deprecated
-     * since 4.33. Use `element.map.tables.addMany([table])` instead.
+     * since 4.33, use `element.map.tables.addMany([table])` instead.
      *
      * Adds a table or array of tables to the [map's](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#map) `tables` collection.
      */
     addTables(tables: __esri.FeatureLayer[], index?: number): Promise<void>;
-    /** Closes the [popup](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#popup). */
+    /** Closes the [popup](#popup). */
     closePopup(): Promise<void>;
     /**
-     * Destroys the Scene component, and any associated resources, including its
-     * [map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#map),
-     * [popup](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#popup),
+     * Destroys the Scene component, and any associated resources, including its [map](#map), [popup](#popup),
      * and removes components or other UI DOM elements added to it.
      */
     destroy(): Promise<void>;
@@ -499,7 +550,7 @@ export declare class ArcgisScene extends LitElement {
      * Returns [hit test results](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#HitTestResult)
      * from each layer that intersects the specified screen coordinates.
      *
-     * ```
+     * ```js
      * viewElement.addEventListener("arcgisViewClick", (event) => {
      *   viewElement.hitTest(event.detail).then((response) => {
      *      const result = response.results[0];
@@ -535,8 +586,18 @@ export declare class ArcgisScene extends LitElement {
     /** Call this method to clear any fatal errors resulting from a lost WebGL context. */
     tryFatalErrorRecovery(): Promise<void>;
     /**
-     * `viewOnReady()` may be leveraged once an instance of the component is created and ready.
-     * This method takes two input parameters: a `callback` function and an `errback` function.
+     * `viewOnReady()` may be leveraged once an instance of the component and its underlying [view](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#view) is created and ready.
+     * This method takes two input parameters, a `callback` function and an `errback` function, and returns a promise. The `callback` executes when the promise resolves, and the `errback` executes if the promise is rejected.
+     *
+     * @since 4.33
+     * @see [Watch for changes - waiting for components or views to be ready](https://developers.arcgis.com/javascript/latest/watch-for-changes/#waiting-for-components-or-views-to-be-ready)
+     * @example
+     * ```js
+     * const viewElement = document.querySelector("arcgis-scene");
+     * await viewElement.viewOnReady();
+     * // The view is now ready to be used.
+     * viewElement.map.add(new FeatureLayer({...}));
+     * ```
      */
     viewOnReady(callback?: () => void, errback?: (error: Error) => void): Promise<void>;
     /**
@@ -544,7 +605,7 @@ export declare class ArcgisScene extends LitElement {
      *
      * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#whenAnalysisView)
      */
-    whenAnalysisView(analysis: __esri.AreaMeasurementAnalysis | __esri.DimensionAnalysis | __esri.DirectLineMeasurementAnalysis | __esri.LineOfSightAnalysis | __esri.SliceAnalysis | __esri.ViewshedAnalysis): Promise<__esri.AreaMeasurementAnalysisView3D | __esri.DimensionAnalysisView3D | __esri.DirectLineMeasurementAnalysisView3D | __esri.LineOfSightAnalysisView3D | __esri.SliceAnalysisView3D | __esri.ViewshedAnalysisView3D>;
+    whenAnalysisView(analysis: __esri.AnalysisUnion): Promise<__esri.AnalysisViewUnion>;
     /**
      * Gets the layer view created on the view for the given layer.
      *
@@ -552,22 +613,14 @@ export declare class ArcgisScene extends LitElement {
      */
     whenLayerView(layer: __esri.Layer): Promise<__esri.LayerView>;
     /**
-     * This event is for view related property changes:
-     * [zoom](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#zoom),
-     * [scale](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#scale),
-     * [center](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#center),
-     * [rotation](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#rotation),
-     * [extent](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#extent),
-     * [camera](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#camera),
-     * [viewpoint](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#viewpoint).
-     * This event will also emit if [stationary](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#stationary)
-     * toggles from `true` to `false`.
+     * This event is for view related property changes: [zoom](#zoom), [scale](#scale), [center](#center), [rotation](#rotation), [extent](#extent),
+     * [camera](#camera), [viewpoint](#viewpoint). This event will also emit if [stationary](#stationary) toggles from `true` to `false`.
      */
     readonly arcgisViewChange: TargetedEvent<this, void>;
     /**
      * Fires after a user clicks on the view.
      *
-     * ```
+     * ```js
      * viewElement.addEventListener("arcgisViewClick", (event) => {
      *   viewElement.hitTest(event.detail).then((response) => {
      *      const result = response.results[0];
@@ -639,6 +692,24 @@ export declare class ArcgisScene extends LitElement {
      * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-layerview-destroy)
      */
     readonly arcgisViewLayerviewDestroy: TargetedEvent<this, __esri.ViewLayerviewDestroyEvent>;
+    /**
+     * Fires when the view for an analysis is created.
+     *
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-analysis-view-create)
+     */
+    readonly arcgisViewAnalysisViewCreate: TargetedEvent<this, __esri.ViewAnalysisViewCreateEvent>;
+    /**
+     * Fires when an error occurs during the creation of an analysis view after an analysis is added to the view.
+     *
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-analysis-view-create-error)
+     */
+    readonly arcgisViewAnalysisViewCreateError: TargetedEvent<this, __esri.ViewAnalysisViewCreateErrorEvent>;
+    /**
+     * Fires after an analysis view is destroyed.
+     *
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-analysis-view-destroy)
+     */
+    readonly arcgisViewAnalysisViewDestroy: TargetedEvent<this, __esri.ViewAnalysisViewDestroyEvent>;
     /**
      * Fires when a wheel button of a pointing device (typically a mouse) is scrolled on the view.
      *
@@ -676,21 +747,13 @@ export declare class ArcgisScene extends LitElement {
      */
     readonly arcgisViewPointerUp: TargetedEvent<this, __esri.ViewPointerUpEvent>;
     /**
-     * This event is for the [ready](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#ready)
-     * property and will be emitted when the view is ready.
-     * This event will also emit if the [map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#map) property is changed.
-     *
-     * ```
-     * viewElement.addEventListener("arcgisViewReadyChange", () => {
-     *    const layer = new GraphicsLayer({ title: "My layer"});
-     *    viewElement.map.add(layer);
-     * });
-     * ```
+     * This event is for the [ready](#ready) property and will be emitted when the view is ready.
+     * This event will also emit if the [map](#map) property is changed.
      */
     readonly arcgisViewReadyChange: TargetedEvent<this, void>;
     private _map: __esri.Map;
     readonly _setterTypes: {
-        center?: __esri.SceneView["center"] | Nil | number[] | string;
+        center?: __esri.SceneView["center"] | nil | number[] | string;
         ground?: __esri.Ground | string;
     };
 }

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

@@ -6,32 +6,32 @@ import w from "@arcgis/core/views/SceneView.js";
 import m from "@arcgis/core/WebScene.js";
 import { LitElement as p, createEvent as a, noShadowRoot as v } from "@arcgis/lumina";
 import { makeAccessorController as r, reEmitEvent as t, reCreateAccessor as l } from "@arcgis/lumina/controllers/accessor";
-import { b as d, p as g, c as y, i as u } from "../../chunks/component-utils.js";
-import { css as f } from "@lit/reactive-element/css-tag.js";
+import { b as g, p as d, c as y, i as u } from "../../chunks/component-utils.js";
+import { css as f } from "lit";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.8 */
-const b = f`@layer{arcgis-scene{display:block;height:100%;.esri-view{height:100%;width:100%}}}`, V = r(m, {}), E = r(w, {});
-class P extends p {
+v4.34.0-next.81 */
+const V = f`@layer{arcgis-scene{display:block;height:100%;.esri-view{height:100%;width:100%}}}`, b = r(m, {}), C = r(w, {});
+class E extends p {
   constructor() {
-    super(), this._cameraProperties = {}, this._map = V(this), this.view = E(this), this.allLayerViews = this.view.allLayerViews, this.alphaCompositingEnabled = this.view.alphaCompositingEnabled, this.analyses = this.view.analyses, this.autoDestroyDisabled = !1, this.basemap = this._map.basemap, this.basemapView = this.view.basemapView, 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.highlightOptions = this.view.highlightOptions, 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.qualityProfile = this.view.qualityProfile, this.ready = this.view.ready, 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.arcgisViewChange = a(), this.arcgisViewClick = t(() => this.view, "click"), this.arcgisViewDoubleClick = t(() => this.view, "double-click"), 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 = a(), this.view.ui = {
+    super(), this._cameraProperties = {}, this._map = b(this), this.view = C(this), this.allLayerViews = this.view.allLayerViews, this.alphaCompositingEnabled = this.view.alphaCompositingEnabled, this.analyses = this.view.analyses, this.autoDestroyDisabled = !1, this.basemap = this._map.basemap, this.basemapView = this.view.basemapView, 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.highlightOptions = this.view.highlightOptions, 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.qualityProfile = this.view.qualityProfile, this.ready = this.view.ready, 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.arcgisViewChange = a(), this.arcgisViewClick = t(() => this.view, "click"), this.arcgisViewDoubleClick = t(() => this.view, "double-click"), 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.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.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 = a(), this.view.ui = {
       components: ["attribution"]
     };
   }
   static {
-    this.properties = { _map: 16, view: 32, allLayerViews: 0, alphaCompositingEnabled: 5, analyses: 0, autoDestroyDisabled: 5, basemap: 1, basemapView: 0, camera: 0, cameraFov: 9, cameraHeading: 9, cameraPosition: 1, cameraTilt: 9, center: 1, clippingArea: 0, constraints: 0, displayFilterDisabled: 5, environment: 0, extent: 0, fatalError: 0, floors: 0, gamepad: 32, graphics: 0, ground: 1, groundView: 0, highlights: 0, highlightOptions: 0, interacting: 32, itemId: 3, layerViews: 0, magnifier: 0, map: 0, navigating: 32, navigation: 0, padding: 0, performanceInfo: 32, popup: 0, popupDisabled: 5, qualityProfile: 1, ready: 4, resolution: 32, scale: 9, spatialReference: 0, stationary: 32, suspended: 7, theme: 0, timeExtent: 0, updating: 4, viewingMode: 1, viewpoint: 0, visibleArea: 0, zoom: 9 };
+    this.properties = { _map: 16, view: 32, allLayerViews: 0, alphaCompositingEnabled: 5, analyses: 0, autoDestroyDisabled: 5, basemap: 1, basemapView: 0, camera: 0, cameraFov: 9, cameraHeading: 9, cameraPosition: 1, cameraTilt: 9, 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: 0, highlights: 0, highlightOptions: 0, interacting: 32, itemId: 3, layerViews: 0, magnifier: 0, map: 0, navigating: 32, navigation: 0, padding: 0, performanceInfo: 32, popup: 0, popupDisabled: 5, qualityProfile: 1, ready: 4, resolution: 32, scale: 9, spatialReference: 0, stationary: 32, suspended: 7, theme: 0, timeExtent: 0, updating: 4, viewingMode: 1, viewpoint: 0, visibleArea: 0, zoom: 9 };
   }
   static {
     this.shadowRootOptions = v;
   }
   static {
-    this.styles = b;
+    this.styles = V;
   }
   get camera() {
     return this.view.camera;
   }
   set camera(i) {
-    d(this.camera, i) || (this.view.camera = i);
+    g(this.camera, i) || (this.view.camera = i);
   }
   get cameraFov() {
     const { view: i } = this;
@@ -59,7 +59,7 @@ class P extends p {
     return e ? new c(e) : void 0;
   }
   set cameraPosition(i) {
-    const e = g(this.view.camera?.position, i);
+    const e = d(this.view.camera?.position, i);
     e && this._mutateCamera((h) => {
       h.position = e;
     });
@@ -86,6 +86,15 @@ class P extends p {
   set extent(i) {
     i && !this.extent.equals(i) && (this.view.extent = i);
   }
+  get focusAreas() {
+    return this.map ? this.map?.focusAreas : {
+      areas: [],
+      style: "bright"
+    };
+  }
+  set focusAreas(i) {
+    this.map && (this.map.focusAreas = i);
+  }
   get gamepad() {
     return this.view.input.gamepad;
   }
@@ -129,16 +138,16 @@ class P extends p {
     this.view.zoom = i;
   }
   async addLayer(i, e) {
-    this.map.add(i, e);
+    this.map?.add(i, e);
   }
   async addLayers(i, e) {
-    this.map.addMany(i, e);
+    this.map?.addMany(i, e);
   }
   async addTable(i) {
-    this.map.tables.add(i);
+    this.map?.tables.add(i);
   }
   async addTables(i, e) {
-    this.map.tables.addMany(i, e);
+    this.map?.tables.addMany(i, e);
   }
   async closePopup() {
     this.view.closePopup();
@@ -182,7 +191,9 @@ class P extends p {
   }
   loaded() {
     this.map ||= this._map, this.manager.onLifecycle(() => [
-      s(() => this.map, () => this._map = this.map, { initial: !0, sync: !0 }),
+      s(() => this.map, (i) => {
+        i && (this._map = i);
+      }, { initial: !0, sync: !0 }),
       s(() => this.view.stationary, () => this.arcgisViewChange.emit(), { initial: !0 }),
       s(() => this.view.ready, (i) => {
         i && (this.camera = this.view.camera.clone().set(this._cameraProperties), this._cameraProperties = {}), this.arcgisViewReadyChange.emit();
@@ -198,7 +209,7 @@ class P extends p {
     i(e), this.camera = e;
   }
 }
-n("arcgis-scene", P);
+n("arcgis-scene", E);
 export {
-  P as ArcgisScene
+  E as ArcgisScene
 };