@geoscene/map-components 4.33.20 → 4.34.9

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

@@ -1,16 +1,18 @@
 /// <reference types="@geoscene/core/interfaces.d.ts" />
-/// <reference types="../../index.d.ts" />
-import { Use } from '@geoscene/lumina/controllers';
-import { Nil } from '@arcgis/components-utils';
+/// <reference path="../../index.d.ts" />
 import { default as MapView } from '@geoscene/core/views/MapView.js';
 import { default as WebMap } from '@geoscene/core/WebMap.js';
-import { PublicLitElement as LitElement, TargetedEvent } from '@geoscene/lumina';
+import { JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@geoscene/lumina';
+import { Use } from '@geoscene/lumina/controllers';
+import { nil } from '@arcgis/toolkit/type';
+import { default as Collection } from '@geoscene/core/core/Collection.js';
+import { LoadErrorSource } from '../../controllers/useGeosceneLoadError';
 
-declare const useWebMap: (component: LitElement & Omit<Pick<WebMap, "basemap" | "focusAreas" | "ground" | "ipsInfo" | "layers" | "bookmarks" | "tables" | "presentation" | "widgets" | "applicationProperties" | "authoringApp" | "authoringAppVersion" | "floorInfo" | "geotriggersInfo" | "initialViewProperties" | "portalItem" | "thumbnailUrl" | "utilityNetworks">, "basemap" | "ground" | ("destroyed" | "initialized" | "declaredClass" | "set" | "watch" | "addHandles" | "removeHandles" | "hasHandles") | "layers" | "bookmarks" | "tables" | "presentation" | "widgets" | "applicationProperties" | "authoringApp" | "authoringAppVersion" | "floorInfo" | "geotriggersInfo" | "initialViewProperties" | "portalItem" | "thumbnailUrl" | "utilityNetworks"> & {
+declare const useWebMap: (component: LitElement & Omit<Pick<WebMap, "basemap" | "focusAreas" | "ground" | "ipsInfo" | "layers" | "presentation" | "tables" | "widgets" | "applicationProperties" | "authoringApp" | "authoringAppVersion" | "bookmarks" | "floorInfo" | "geotriggersInfo" | "initialViewProperties" | "portalItem" | "thumbnailUrl" | "utilityNetworks">, ("destroyed" | "initialized" | "declaredClass" | "set" | "watch" | "addHandles" | "removeHandles" | "hasHandles") | "basemap" | "ground" | "layers" | "presentation" | "tables" | "widgets" | "applicationProperties" | "authoringApp" | "authoringAppVersion" | "bookmarks" | "floorInfo" | "geotriggersInfo" | "initialViewProperties" | "portalItem" | "thumbnailUrl" | "utilityNetworks"> & {
     autoDestroyDisabled: boolean;
     destroy: () => Promise<void>;
 }) => WebMap;
-declare const useMapView: (component: LitElement & Omit<Pick<MapView, "container" | "map" | "background" | "basemapView" | "center" | "constraints" | "extent" | "fatalError" | "graphics" | "highlights" | "navigation" | "padding" | "popup" | "resizeAlign" | "rotation" | "scale" | "spatialReference" | "theme" | "timeExtent" | "timeZone" | "viewpoint" | "zoom" | "floors" | "highlightOptions" | "breakpoints" | "heightBreakpoint" | "popupEnabled" | "spatialReferenceLocked" | "widthBreakpoint" | "ui" | "animation" | "displayFilterEnabled">, "container" | ("destroyed" | "initialized" | "declaredClass" | "set" | "watch" | "addHandles" | "removeHandles" | "hasHandles") | "breakpoints" | "heightBreakpoint" | "popupEnabled" | "spatialReferenceLocked" | "widthBreakpoint" | "ui" | "animation" | "displayFilterEnabled"> & {
+declare const useMapView: (component: LitElement & Omit<Pick<MapView, "map" | "analyses" | "aria" | "background" | "basemapView" | "center" | "constraints" | "extent" | "fatalError" | "graphics" | "highlights" | "highlightOptions" | "navigation" | "padding" | "popup" | "resizeAlign" | "rotation" | "scale" | "spatialReference" | "theme" | "timeExtent" | "timeZone" | "viewpoint" | "zoom" | "floors" | "spatialReferenceLocked" | "breakpoints" | "heightBreakpoint" | "popupEnabled" | "widthBreakpoint" | "animationsEnabled" | "container" | "ui" | "animation" | "displayFilterEnabled">, ("destroyed" | "initialized" | "declaredClass" | "set" | "watch" | "addHandles" | "removeHandles" | "hasHandles") | "breakpoints" | "heightBreakpoint" | "popupEnabled" | "widthBreakpoint" | "animationsEnabled" | "container" | "ui" | "animation" | "displayFilterEnabled"> & {
     autoDestroyDisabled: boolean;
     destroy: () => Promise<void>;
 }) => MapView;
@@ -34,8 +36,8 @@ declare const useMapView: (component: LitElement & Omit<Pick<MapView, "container
  *
  * ```html
  * <geoscene-map item-id="05e015c5f0314db9a487a9b46cb37eca">
- *  <geoscene-zoom position="top-left"></geoscene-zoom>
- *  <geoscene-legend position="bottom-left"></geoscene-legend>
+ *  <geoscene-zoom slot="top-left"></geoscene-zoom>
+ *  <geoscene-legend slot="bottom-left"></geoscene-legend>
  * </geoscene-map>
  * ```
  *
@@ -55,15 +57,83 @@ declare const useMapView: (component: LitElement & Omit<Pick<MapView, "container
  * - [Programming patterns](https://doc.geoscene.cn/javascript/4.33/programming-patterns/)
  *
  * [Read more...](https://doc.geoscene.cn/javascript/4.33/references/map-components/geoscene-map/)
+ *
+ * @since 4.28
+ * @slot  - Default slot for adding components to the map. User is responsible for positioning the content via CSS.
+ * @slot [top-left] - Slot for components positioned in the top-left corner.
+ * @slot [top-right] - Slot for components positioned in the top-right corner.
+ * @slot [bottom-left] - Slot for components positioned in the bottom-left corner.
+ * @slot [bottom-right] - Slot for components positioned in the bottom-right corner.
+ * @slot [top-start] - Slot for components positioned at the top-start (top-left in LTR, top-right in RTL).
+ * @slot [top-end] - Slot for components positioned at the top-end (top-right in LTR, top-left in RTL).
+ * @slot [bottom-start] - Slot for components positioned at the bottom-start (bottom-left in LTR, bottom-right in RTL).
+ * @slot [bottom-end] - Slot for components positioned at the bottom-end (bottom-right in LTR, bottom-left in RTL).
+ * @slot [popup] - Slot for the [Popup](https://doc.geoscene.cn/javascript/4.33/references/map-components/geoscene-popup/) component to open automatically on click. When using this slot, the [`popup-disabled`](#popupDisabled) attribute must be set to `true`. Only the Popup component can be placed in this slot.
  */
 export declare class GeosceneMap extends LitElement {
-    /** The [MapView](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-views-MapView.html) instance created and manged by the component. Accessible once the component is fully loaded. */
+    /**
+     * Fires when a GeosceneMap fails to load or if one of its dependencies fails to load (e.g., basemap, ground, layers).
+     *
+     * @since 4.34
+     * @see [loadErrorSources](https://doc.geoscene.cn/javascript/4.33/references/map-components/geoscene-map/#loadErrorSources)
+     * @example
+     * ```js
+     * viewElement.addEventListener("geosceneLoadError", () => {
+     *   console.log(viewElement.loadErrorSources);
+     * });
+     * ```
+     */
+    readonly geosceneLoadError: TargetedEvent<this>;
+    /**
+     * Fires if the view encounters a content or rendering error.
+     *
+     * @since 4.34
+     * @example
+     * ```js
+     * viewElement.addEventListener("geosceneViewReadyError", () => {
+     *   // handle error
+     * });
+     * ```
+     */
+    readonly geosceneViewReadyError: TargetedEvent<this>;
+    /** The [MapView](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-views-MapView.html) instance created and managed by the component. Accessible once the component is fully loaded. */
     readonly view: MapView;
+    /**
+     * Indicates whether animations are disabled in the view. This includes animated symbols (animated
+     * [CIMSymbol](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-symbols-CIMSymbol.html),
+     * [PictureMarkerSymbol](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-symbols-PictureMarkerSymbol.html)
+     * from a GIF/animated PNG), animated renderers
+     * ([FlowRenderer](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-rasterRenderers.html#FlowRenderer)),
+     * animated layers ([MediaLayer](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-layers-MediaLayer.html),
+     * [VideoLayer](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-layers-VideoLayer.html)), and
+     * animations triggered by view navigation (for example,
+     * [goTo()](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-views-MapView.html#goTo)).
+     * Setting this property to `true` disables all animations in the view.
+     *
+     * @since 4.34
+     * @default false
+     */
+    animationsDisabled: boolean;
+    /**
+     * The ARIA attributes for the view container. Provides accessibility information to assistive technologies such as screen readers. Supports the following properties: [`label`](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-label), [`description`](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-description), [`describedByElements`](https://developer.mozilla.org/en-US/docs/Web/API/Element/ariaDescribedByElements), and [`labelledByElements`](https://developer.mozilla.org/en-US/docs/Web/API/Element/ariaLabelledByElements).
+     *
+     * @since 4.34
+     */
+    get aria(): __geoscene.MapView["aria"];
+    set aria(value: __geoscene.MapView["aria"]);
     /**
      * Collection containing a flat list of all the created LayerViews
      * related to the basemap, operational layers, and group layers in this view.
      */
-    readonly allLayerViews: __geoscene.Collection<__geoscene.LayerView>;
+    readonly allLayerViews: __geoscene.ReadonlyCollection<__geoscene.LayerView>;
+    /**
+     * A collection of analyses associated with the view.
+     *
+     * [Read more...](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-views-View2D.html#analyses)
+     *
+     * @since 4.34
+     */
+    analyses: Collection<__geoscene.Analysis>;
     /**
      * 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
@@ -75,8 +145,7 @@ export declare class GeosceneMap extends LitElement {
      */
     autoDestroyDisabled: boolean;
     /**
-     * The background color of the MapView. If the view's map changes, the view's `background` is reset to the map's background,
-     * even if the user set it previously.
+     * The background color of the Map component.
      *
      * @default null
      */
@@ -96,26 +165,26 @@ export declare class GeosceneMap extends LitElement {
     basemapView: __geoscene.BasemapView;
     /**
      * Represents the view's center point; when setting the center, you may pass a
-     * geoscene/geometry/Point instance or a string representing
+     * [Point](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-geometry-Point.html) instance or a string representing
      * a longitude/latitude pair (`"-100.4593, 36.9014"`).
      * Setting the center immediately changes the current view.
-     * For animating the view, see this component's goTo() method.
+     * For animating the view, see this component's [goTo()](#goTo) method.
      */
     get center(): __geoscene.MapView["center"];
-    set center(newValue: __geoscene.MapView["center"] | Nil | number[] | string);
-    /** Specifies constraints to scale, zoom, and rotation that may be applied to the MapView. */
+    set center(newValue: __geoscene.MapView["center"] | nil | number[] | string);
+    /** Specifies constraints to scale, zoom, and rotation that may be applied to the map. */
     constraints: __geoscene.View2DConstraints;
     /**
-     * Indicates whether layer's displayFilter are honored when rendering layers in the view.
+     * Indicates whether a layer's `displayFilter` is honored when rendering layers in the view.
      * If `false`, display filters are ignored and all features are rendered.
      *
      * @default false
      */
     displayFilterDisabled: boolean;
     /**
-     * The extent represents the visible portion of a map within the view as an instance of geoscene/geometry/Extent.
+     * The extent represents the visible portion of a map within the view as an instance of [Extent](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-geometry-Extent.html).
      * Setting the extent immediately changes the view without animation. To animate
-     * the view, see this component's 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.
      */
     get extent(): __geoscene.MapView["extent"];
@@ -126,7 +195,7 @@ export declare class GeosceneMap extends LitElement {
      * Applies a display filter on the view for a specific set of floor levels.
      * It can filter the map display on floor-aware layers by zero or more level IDs.
      */
-    floors: __geoscene.Collection<string>;
+    floors: Collection<string>;
     /** Gamepad input specific configuration settings. */
     get gamepad(): __geoscene.GamepadSettings;
     /**
@@ -143,28 +212,23 @@ export declare class GeosceneMap extends LitElement {
      * graphics.remove(pointGraphic);
      * ```
      */
-    graphics: __geoscene.Collection<__geoscene.Graphic>;
+    graphics: Collection<__geoscene.Graphic>;
     /** Specifies the surface properties for the map. */
     get ground(): typeof this._map.ground;
     set ground(value: __geoscene.Ground | string);
     /**
-     * The highlights property is a collection of HighlightGroup objects that
-     * allow you to visually emphasize specific features on the map.
+     * The highlights property is a collection of [HighlightOptions](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-views-support-HighlightOptions.html) objects that
+     * allow you to visually emphasize specific features on the map. See [MapView.highlights](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-views-MapView.html#highlights) for more information.
      */
-    highlights: __geoscene.Collection<__geoscene.HighlightOptions>;
+    highlights: Collection<__geoscene.HighlightOptions>;
     /**
      * Options for configuring the highlight.
      *
-     * @deprecated
-     * since 4.33, use [highlights](https://doc.geoscene.cn/javascript/4.33/references/map-components/geoscene-map/#highlights) instead.
-     *
-     * Options for configuring the highlight. Use the highlight method on the
-     * appropriate geoscene/views/layers/LayerView to highlight a feature.
-     * The layerView's `highlightOptions` will take precedence over the MapView's `highlightOptions` if both properties are set.
+     * @deprecated since version 4.32. Use the [highlights](#highlights) property instead.
      */
     highlightOptions: __geoscene.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 via an interactive tool).
      *
      * @default false
      */
@@ -176,17 +240,17 @@ export declare class GeosceneMap extends LitElement {
      *
      * To configure the portal url you must set the [`portalUrl` property on `config`](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-config.html#portalUrl) before the Map 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
-     * geoscene/views/layers/LayerView LayerViews of the
-     * geoscene/Map#layers operational layers in the map.
+     * [LayerView](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-views-layers-LayerView.html)s of the
+     * [operational layers](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-Map.html#layers) in the map.
      */
-    readonly layerViews: __geoscene.Collection<__geoscene.LayerView>;
+    readonly layerViews: Collection<__geoscene.LayerView>;
     /** The magnifier allows for showing a portion of the view as a magnifier image on top of the view. */
     readonly magnifier: __geoscene.Magnifier;
-    /** An instance of a geoscene/Map object to display in the view. */
+    /** An instance of a [Map](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-Map.html) object to display in the view. */
     map: __geoscene.Map | nullish;
     /**
      * Indication whether the view is being navigated (for example when panning).
@@ -197,9 +261,11 @@ export declare class GeosceneMap extends LitElement {
     /** Options to configure the navigation behavior of the View. */
     navigation: __geoscene.Navigation;
     /**
-     * Use the padding property to make the [center](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-views-MapView.html#center),
-     * and [extent](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-views-MapView.html#extent), etc.
+     * Padding to make the map's center and extent work off a
+     * subsection of the full map. This is particularly useful when layering UI
+     * elements or semi-transparent content on top of portions of the map.
      *
+     * @see [Sample: Map padding](https://doc.geoscene.cn/javascript/4.33/sample-code/map-padding/)
      * @default {left: 0, top: 0, right: 0, bottom: 0}
      */
     padding: __geoscene.ViewPadding;
@@ -211,14 +277,22 @@ export declare class GeosceneMap extends LitElement {
      */
     popup: nullish | __geoscene.Popup;
     /**
-     * Controls whether the popup opens when users click on the view.
+     * Controls whether the popup opens automatically when users click on the view.
      *
      * @default false
      */
     popupDisabled: boolean;
     /**
-     * When `true`, this property indicates whether the view successfully satisfied all dependencies,
-     * signaling that the following conditions are met.
+     * When `true`, this property indicates whether the [view](#view) has successfully satisfied all dependencies, signaling that the following conditions are met:
+     *
+     * * The view has a [map](#map). If [map](#map)
+     * is a [WebMap](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-WebMap.html), then the map
+     * must be [loaded](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-WebMap.html#loaded).
+     * * The view has a [spatialReference](#spatialReference), a [center](#center), and a [scale](#scale).
+     * These also can be inferred by setting an [extent](#extent).
+     *
+     * When a view becomes ready it will resolve itself and invoke
+     * the callback defined in [viewOnReady()](#viewOnReady) where code can execute on a working view.
      *
      * @default false
      */
@@ -230,7 +304,7 @@ export declare class GeosceneMap extends LitElement {
      *
      * @default "center"
      */
-    resizeAlign: "center" | "bottom-left" | "bottom-right" | "top-left" | "top-right" | "left" | "right" | "top" | "bottom";
+    resizeAlign: "bottom-left" | "bottom-right" | "top-left" | "top-right" | "center" | "left" | "right" | "top" | "bottom";
     /**
      * Represents the current value of one pixel in the unit of the view's spatialReference.
      * The value of resolution is calculated by dividing the view's extent width
@@ -250,7 +324,7 @@ export declare class GeosceneMap extends LitElement {
     rotation: 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() method.
+     * the view, see this component's [goTo()](#goTo) method.
      */
     get scale(): number;
     set scale(newValue: number);
@@ -262,6 +336,16 @@ export declare class GeosceneMap extends LitElement {
      * @default null
      */
     spatialReference: __geoscene.SpatialReference;
+    /**
+     * Indicates if the map's [spatialReference](#spatialReference) can be changed after it is ready.
+     * The default is `false`, indicating the map's spatialReference can be changed at runtime.
+     * When true, basemaps with spatial references that do not match the map's spatial reference
+     * will be disabled in [geoscene-basemap-gallery](https://doc.geoscene.cn/javascript/4.33/references/map-components/geoscene-basemap-gallery/) and [geoscene-basemap-toggle](https://doc.geoscene.cn/javascript/4.33/references/map-components/geoscene-basemap-toggle/) components and the map's spatialReference cannot be changed at runtime.
+     *
+     * @since 4.34
+     * @default false
+     */
+    spatialReferenceLocked: boolean;
     /**
      * Indication whether the view is animating, being navigated with or resizing.
      *
@@ -275,8 +359,7 @@ export declare class GeosceneMap 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.
      *
      * @default null
      */
@@ -308,7 +391,7 @@ export declare class GeosceneMap extends LitElement {
     /**
      * Represents the current view as a Viewpoint or point of observation on the view.
      * Setting the viewpoint immediately changes the current view. For animating
-     * the view, see this component's goTo() method.
+     * the view, see this component's [goTo()](#goTo) method.
      */
     get viewpoint(): __geoscene.Viewpoint;
     set viewpoint(newValue: __geoscene.Viewpoint);
@@ -320,18 +403,23 @@ export declare class GeosceneMap extends LitElement {
      */
     readonly visibleArea: nullish | __geoscene.Polygon;
     /**
-     * Represents the level of detail (LOD) at the center of the view.
-     * A zoom level (or scale) is a number that defines how large or small the contents of a map appear in a map view.
+     * Represents the level of detail (LOD) at the center of the map.
+     * A zoom level (or scale) is a number that defines how large or small the contents of a map appear in a Map component.
      * Zoom level is a number usually between 0 (global view) and 23 (very detailed view) and is used as a shorthand for predetermined scale values.
-     * A value of -1 means the view has no LODs.
-     * When setting the zoom value, the MapView converts it to the corresponding scale, or interpolates it if the zoom is a fractional number.
-     * MapView can display maps with different projections at a full range of scales, and so use the scale property on this component rather than zoom level.
+     * A value of -1 means the map has no LODs.
+     * When setting the zoom value, the component converts it to the corresponding scale, or interpolates it if the zoom is a fractional number.
      *
-     * Setting the zoom immediately changes the current view. For animating the view, see this component's goTo() method.
+     * 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` is a convenient way to set the initial extent of the view.
      */
     get zoom(): number;
     set zoom(newValue: number);
+    /**
+     * An array of objects that encountered an error while loading the component or any of its dependencies (e.g., basemap, ground, layers, tables). You may inspect the errors by accessing each object's `loadError` property.
+     *
+     * @since 4.34
+     */
+    loadErrorSources?: LoadErrorSource[];
     /**
      * @deprecated
      * since 4.33, use `element.map.add(layer)` instead.
@@ -379,8 +467,6 @@ export declare class GeosceneMap extends LitElement {
     toScreen(point: __geoscene.Point, options?: __geoscene.ToScreenOptions2D): __geoscene.MapViewScreenPoint | nullish;
     /** Call this method to clear any fatal errors resulting from a lost WebGL context. */
     tryFatalErrorRecovery(): Promise<void>;
-    /** Gets the LayerView created on the view for the given layer. */
-    whenLayerView(layer: __geoscene.Layer): Promise<__geoscene.LayerView>;
     /**
      * `viewOnReady()` may be leveraged once an instance of the component and its underlying [view](https://doc.geoscene.cn/javascript/4.33/references/map-components/geoscene-map/#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.
@@ -396,6 +482,140 @@ export declare class GeosceneMap extends LitElement {
      * ```
      */
     viewOnReady(callback?: () => void, errback?: (error: Error) => void): Promise<void>;
+    /**
+     * Gets the analysis view created for the given analysis object.
+     *
+     * [Read more](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-views-MapView.html#whenAnalysisView)
+     *
+     * @since 4.34
+     */
+    whenAnalysisView(analysis: __geoscene.ElevationProfileAnalysis): Promise<__geoscene.ElevationProfileAnalysisView2D>;
+    /**
+     * Gets the LayerView created on the view for the given layer.
+     *
+     * [Read more](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-views-MapView.html#whenLayerView)
+     */
+    whenLayerView(layer: __geoscene.PointCloudLayer): Promise<__geoscene.PointCloudLayerView>;
+    /**
+     * Gets the LayerView created on the view for the given layer.
+     *
+     * [Read more](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-views-MapView.html#whenLayerView)
+     */
+    whenLayerView(layer: __geoscene.StreamLayer): Promise<__geoscene.StreamLayerView>;
+    /**
+     * Gets the LayerView created on the view for the given layer.
+     *
+     * [Read more](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-views-MapView.html#whenLayerView)
+     */
+    whenLayerView(layer: __geoscene.WFSLayer): Promise<__geoscene.WFSLayerView>;
+    /**
+     * Gets the LayerView created on the view for the given layer.
+     *
+     * [Read more](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-views-MapView.html#whenLayerView)
+     */
+    whenLayerView(layer: __geoscene.OGCFeatureLayer): Promise<__geoscene.OGCFeatureLayerView>;
+    /**
+     * Gets the LayerView created on the view for the given layer.
+     *
+     * [Read more](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-views-MapView.html#whenLayerView)
+     */
+    whenLayerView(layer: __geoscene.FeatureLayer): Promise<__geoscene.FeatureLayerView>;
+    /**
+     * Gets the LayerView created on the view for the given layer.
+     *
+     * [Read more](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-views-MapView.html#whenLayerView)
+     */
+    whenLayerView(layer: __geoscene.CSVLayer): Promise<__geoscene.CSVLayerView>;
+    /**
+     * Gets the LayerView created on the view for the given layer.
+     *
+     * [Read more](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-views-MapView.html#whenLayerView)
+     */
+    whenLayerView(layer: __geoscene.GeoJSONLayer): Promise<__geoscene.GeoJSONLayerView>;
+    /**
+     * Gets the LayerView created on the view for the given layer.
+     *
+     * [Read more](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-views-MapView.html#whenLayerView)
+     */
+    whenLayerView(layer: __geoscene.GeoRSSLayer): Promise<__geoscene.GeoRSSLayerView>;
+    /**
+     * Gets the LayerView created on the view for the given layer.
+     *
+     * [Read more](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-views-MapView.html#whenLayerView)
+     */
+    whenLayerView(layer: __geoscene.GraphicsLayer): Promise<__geoscene.GraphicsLayerView>;
+    /**
+     * Gets the LayerView created on the view for the given layer.
+     *
+     * [Read more](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-views-MapView.html#whenLayerView)
+     */
+    whenLayerView(layer: __geoscene.ImageryLayer): Promise<__geoscene.ImageryLayerView>;
+    /**
+     * Gets the LayerView created on the view for the given layer.
+     *
+     * [Read more](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-views-MapView.html#whenLayerView)
+     */
+    whenLayerView(layer: __geoscene.KMLLayer): Promise<__geoscene.KMLLayerView>;
+    /**
+     * Gets the LayerView created on the view for the given layer.
+     *
+     * [Read more](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-views-MapView.html#whenLayerView)
+     */
+    whenLayerView(layer: __geoscene.SceneLayer): Promise<__geoscene.SceneLayerView>;
+    /**
+     * Gets the LayerView created on the view for the given layer.
+     *
+     * [Read more](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-views-MapView.html#whenLayerView)
+     */
+    whenLayerView(layer: __geoscene.DimensionLayer): Promise<__geoscene.DimensionLayerView>;
+    /**
+     * Gets the LayerView created on the view for the given layer.
+     *
+     * [Read more](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-views-MapView.html#whenLayerView)
+     */
+    whenLayerView(layer: __geoscene.MediaLayer): Promise<__geoscene.MediaLayerView>;
+    /**
+     * Gets the LayerView created on the view for the given layer.
+     *
+     * [Read more](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-views-MapView.html#whenLayerView)
+     */
+    whenLayerView(layer: __geoscene.ViewshedLayer): Promise<__geoscene.ViewshedLayerView>;
+    /**
+     * Gets the LayerView created on the view for the given layer.
+     *
+     * [Read more](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-views-MapView.html#whenLayerView)
+     */
+    whenLayerView(layer: __geoscene.LineOfSightLayer): Promise<__geoscene.LineOfSightLayerView>;
+    /**
+     * Gets the LayerView created on the view for the given layer.
+     *
+     * [Read more](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-views-MapView.html#whenLayerView)
+     */
+    whenLayerView(layer: __geoscene.Layer): Promise<__geoscene.LayerView>;
+    /**
+     * Fires when the view for an analysis is created.
+     *
+     * [Read more](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-views-MapView.html#event-analysis-view-create)
+     *
+     * @since 4.34
+     */
+    readonly geosceneViewAnalysisViewCreate: TargetedEvent<this, __geoscene.ViewAnalysisViewCreateEvent>;
+    /**
+     * Fires when an error occurs during the creation of an analysis view after an analysis is added to the view.
+     *
+     * [Read more](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-views-MapView.html#event-analysis-view-create-error)
+     *
+     * @since 4.34
+     */
+    readonly geosceneViewAnalysisViewCreateError: TargetedEvent<this, __geoscene.ViewAnalysisViewCreateErrorEvent>;
+    /**
+     * Fires after an analysis view is destroyed.
+     *
+     * [Read more](https://doc.geoscene.cn/javascript/4.33/api-reference/geoscene-views-MapView.html#event-analysis-view-destroy)
+     *
+     * @since 4.34
+     */
+    readonly geosceneViewAnalysisViewDestroy: TargetedEvent<this, __geoscene.ViewAnalysisViewDestroyEvent>;
     /**
      * This event is for view related property changes: zoom, scale, center, rotation, extent, camera, viewpoint.
      * This event will also emit if stationary toggles from true to false.
@@ -442,7 +662,7 @@ export declare class GeosceneMap extends LitElement {
     readonly geosceneViewReadyChange: TargetedEvent<this, void>;
     private _map: __geoscene.Map;
     readonly _setterTypes: {
-        center?: __geoscene.MapView["center"] | Nil | number[] | string;
+        center?: __geoscene.MapView["center"] | nil | number[] | string;
         ground?: __geoscene.Ground | string;
     };
 }