@arcgis/map-components 4.34.0-next.9 → 4.34.0-next.90

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

@@ -1,16 +1,16 @@
 /// <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 { JsxNode, 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" | "tables" | "presentation" | "layers" | "widgets" | "applicationProperties" | "authoringApp" | "authoringAppVersion" | "floorInfo" | "initialViewProperties" | "portalItem" | "thumbnailUrl" | "clippingEnabled" | "heightModelInfo">, ("destroyed" | "initialized" | "declaredClass" | "set" | "watch" | "addHandles" | "removeHandles" | "hasHandles") | "basemap" | "ground" | "tables" | "presentation" | "layers" | "widgets" | "applicationProperties" | "authoringApp" | "authoringAppVersion" | "floorInfo" | "initialViewProperties" | "portalItem" | "thumbnailUrl" | "clippingEnabled" | "heightModelInfo"> & {
     autoDestroyDisabled: boolean;
     destroy: () => Promise<void>;
 }) => WebScene;
-declare const useSceneView: (component: LitElement & Omit<Pick<SceneView, "container" | "map" | "basemapView" | "center" | "constraints" | "extent" | "fatalError" | "graphics" | "highlights" | "navigation" | "padding" | "popup" | "scale" | "spatialReference" | "theme" | "timeExtent" | "viewpoint" | "zoom" | "floors" | "highlightOptions" | "alphaCompositingEnabled" | "analyses" | "camera" | "clippingArea" | "environment" | "qualityProfile" | "viewingMode" | "breakpoints" | "heightBreakpoint" | "popupEnabled" | "widthBreakpoint" | "ui" | "animation" | "displayFilterEnabled">, "container" | "center" | ("destroyed" | "initialized" | "declaredClass" | "set" | "watch" | "addHandles" | "removeHandles" | "hasHandles") | "breakpoints" | "heightBreakpoint" | "popupEnabled" | "widthBreakpoint" | "ui" | "animation" | "displayFilterEnabled"> & {
+declare const useSceneView: (component: LitElement & Omit<Pick<SceneView, "map" | "basemapView" | "center" | "constraints" | "extent" | "fatalError" | "graphics" | "highlights" | "navigation" | "padding" | "popup" | "scale" | "spatialReference" | "theme" | "timeExtent" | "viewpoint" | "zoom" | "floors" | "alphaCompositingEnabled" | "analyses" | "camera" | "clippingArea" | "environment" | "qualityProfile" | "viewingMode" | "breakpoints" | "heightBreakpoint" | "popupEnabled" | "widthBreakpoint" | "container" | "ui" | "animation" | "displayFilterEnabled">, ("destroyed" | "initialized" | "declaredClass" | "set" | "watch" | "addHandles" | "removeHandles" | "hasHandles") | "center" | "breakpoints" | "heightBreakpoint" | "popupEnabled" | "widthBreakpoint" | "container" | "ui" | "animation" | "displayFilterEnabled"> & {
     autoDestroyDisabled: boolean;
     destroy: () => Promise<void>;
 }) => SceneView;
@@ -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"`
@@ -262,12 +315,6 @@ export declare class ArcgisScene extends LitElement {
      * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View.html#highlights)
      */
     highlights: __esri.Collection<__esri.HighlightOptions>;
-    /**
-     * 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.
-     */
-    highlightOptions: __esri.HighlightOptions;
     /**
      * Indication whether the view is being interacted with (for example when panning or by an interactive tool).
      *
@@ -280,18 +327,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 +367,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 +381,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 +397,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 +437,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 +475,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 +501,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 +544,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 +580,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 +599,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 +607,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 +686,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 +741,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;
     };
 }