@arcgis/map-components 4.33.0-next.110 → 4.33.0-next.112

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

@@ -8,7 +8,7 @@ import { b as h, p as n, c as o, i as g } from "../../chunks/component-utils.js"
 import { css as y } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.110 */
+v4.33.0-next.112 */
 const u = y`@layer{arcgis-scene{display:block;height:100%;.esri-view{height:100%;width:100%}}}`, f = c(m, {}), _ = c(d, {});
 class b extends l {
   constructor() {
@@ -23,31 +23,12 @@ class b extends l {
   static {
     this.styles = u;
   }
-  /** 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.
-   *
-   * 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.
-   */
   get camera() {
     return this.view.camera ?? this._camera;
   }
   set camera(i) {
     this._camera = i, this.ready && !h(this.camera, i) && (this.view.camera = i);
   }
-  /**
-   * 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.
-   *
-   * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-Camera.html#fov)
-   */
   get cameraFov() {
     return this.view.camera?.fov ?? this._cameraFov;
   }
@@ -56,14 +37,6 @@ class b extends l {
       e.fov = i;
     }), this._cameraFov = i;
   }
-  /**
-   * 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.
-   *
-   * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-Camera.html#heading)
-   */
   get cameraHeading() {
     return this.view.camera?.heading ?? this._cameraHeading;
   }
@@ -72,16 +45,6 @@ class b extends l {
       e.heading = i;
     }), this._cameraHeading = i;
   }
-  /**
-   * 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.
-   *
-   * 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.
-   *
-   * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-Camera.html#position)
-   *
-   */
   get cameraPosition() {
     return this.view.camera?.position ?? this._cameraPosition;
   }
@@ -94,14 +57,6 @@ class b extends l {
     } else
       this._cameraPosition = i;
   }
-  /**
-   * 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.
-   *
-   * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-Camera.html#tilt)
-   */
   get cameraTilt() {
     return this.view.camera?.tilt ?? this._cameraTilt;
   }
@@ -110,15 +65,6 @@ class b extends l {
       e.tilt = i;
     }), this._cameraTilt = i;
   }
-  /**
-   * 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.
-   *
-   * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#center)
-   */
   get center() {
     return this.view.center ?? this._center;
   }
@@ -126,36 +72,18 @@ class b extends l {
     const e = o(i, this.ready ? this.view : void 0);
     e && (this.ready && (this.view.center = e), this._center = e);
   }
-  /**
-   * The extent represents the visible portion of a 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.
-   * 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)
-   */
   get extent() {
     return this.view.extent ?? this._extent;
   }
   set extent(i) {
     this.ready && i && !this.extent?.equals(i) && (this.view.extent = i), this._extent = i;
   }
-  /** Gamepad input specific configuration settings. */
   get gamepad() {
     return this.ready ? this.view.input.gamepad : void 0;
   }
-  /** Indication whether the view is being interacted with (for example when panning or by an interactive tool). */
   get interacting() {
     return this.view.interacting;
   }
-  /**
-   * The ID of a [WebScene](https://developers.arcgis.com/javascript/latest/api-reference/esri-WebScene.html) item from either
-   * [ArcGIS Online](https://www.arcgis.com/home/index.html) or [ArcGIS Enterprise portal](https://enterprise.arcgis.com/en/portal/latest/administer/windows/what-is-portal-for-arcgis-.htm).
-   *
-   * 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() {
     return this._map.portalItem?.id ?? this._itemId;
   }
@@ -164,204 +92,84 @@ class b extends l {
       this.view.map = this._map;
     }).catch(console.error) : this.view.ready != null && (this._map.destroy(), this._map = new m(this._editMapProperties({ portalItem: { id: this._itemId } })), this.view.map = this._map);
   }
-  /** Indication whether the view is being navigated (for example when panning). */
   get navigating() {
     return this.view.navigating;
   }
-  /**
-   * This property contains performance information of the view, e.g. global memory usage and additional
-   * details for layers about memory consumption and number of features.
-   */
   get performanceInfo() {
     return this.view.performanceInfo;
   }
-  /**
-   * 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).
-   */
   get resolution() {
     return this.view.resolution;
   }
-  /**
-   * 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.
-   *
-   * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#scale)
-   */
   get scale() {
     return this.view.scale ?? this._scale;
   }
   set scale(i) {
     this.ready && (this.view.scale = i), this._scale = i;
   }
-  /** Indication whether the view is animating, being navigated with or resizing. */
   get stationary() {
     return this.view.stationary;
   }
-  /**
-   * Represents the current view as a [Viewpoint](https://developers.arcgis.com/javascript/latest/api-reference/esri-Viewpoint.html)
-   * 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.
-   *
-   * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#viewpoint)
-   */
   get viewpoint() {
     return this.view.viewpoint ?? this._viewpoint;
   }
   set viewpoint(i) {
     this.ready && g(this.viewpoint, i) && (this.view.viewpoint = i), this._viewpoint = i;
   }
-  /**
-   * 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)
-   * 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)
-   */
   get zoom() {
     return this.view.zoom ?? this._zoom;
   }
   set zoom(i) {
     this.ready && (this.view.zoom = i), this._zoom = i;
   }
-  //#endregion
-  //#region Public Methods
-  /**
-   * @deprecated **Deprecated** 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.
-   * */
   async addLayer(i, e) {
     this.map?.add(i, e);
   }
-  /**
-   * @deprecated **Deprecated** 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.
-   * */
   async addLayers(i, e) {
     this.map?.addMany(i, e);
   }
-  /**
-   * @deprecated **Deprecated** 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.
-   * */
   async addTable(i) {
     this.map?.tables.add(i);
   }
-  /**
-   * @deprecated **Deprecated** 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.
-   * */
   async addTables(i, e) {
     this.map?.tables.addMany(i, e);
   }
-  /** Closes the [popup](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#popup). */
   async closePopup() {
     this.view?.closePopup();
   }
-  /** 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),
-   * and removes components or other UI DOM elements added to it.
-   */
   async destroy() {
     await this.manager.destroy();
   }
-  /** Sets the view to a given target.
-   *
-   * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#goTo)
-   */
   async goTo(i, e) {
     return await this.view?.goTo(i, e);
   }
-  /** 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.
-   *
-   * ```
-   * arcgisScene.addEventListener("arcgisViewClick", (event) => {
-   *    arcgisScene.hitTest(event.detail).then((response) => {
-   *       const result = response.results[0];
-   *       if (result?.type === "graphic") {
-   *          const { longitude, latitude } = result.mapPoint;
-   *          console.log("Hit graphic at (" + longitude + ", " + latitude + ")", result.graphic);
-   *       } else {
-   *          console.log("Did not hit any graphic");
-   *       }
-   *    });
-   * });
-   * ```
-   *
-   * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#hitTest)
-   */
   async hitTest(i, e) {
     return await this.view?.hitTest(i, e);
   }
-  /**
-   * Opens the popup based on input options.
-   *
-   * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#openPopup)
-   */
   async openPopup(i) {
     await this.view?.openPopup(i);
   }
-  /** Creates a screenshot of the current view.
-   *
-   * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#takeScreenshot)
-   */
   async takeScreenshot(i) {
     return await this.view?.takeScreenshot(i);
   }
-  /**
-   * Converts the given screen point to a [map point](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Point.html).
-   */
   toMap(i, e) {
     return this.view.toMap(i, e);
   }
-  /**
-   * Converts the given [map point](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Point.html) to a screen point.
-   */
   toScreen(i) {
     return this.view.toScreen(i);
   }
-  /** Call this method to clear any fatal errors resulting from a lost WebGL context. */
   async tryFatalErrorRecovery() {
     this.view?.tryFatalErrorRecovery();
   }
-  /**
-   * `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.
-   */
   async viewOnReady(i, e) {
     return await this.componentOnReady(), await this.view.whenReady().then(() => i?.()).catch(e);
   }
-  /**
-   * Gets the analysis view created for the given analysis object.
-   *
-   * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#whenAnalysisView)
-   */
   async whenAnalysisView(i) {
     return await this.view?.whenAnalysisView(i);
   }
-  /** Gets the layer view created on the view for the given layer.
-   *
-   * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#whenLayerView)
-   */
   async whenLayerView(i) {
     return await this.view?.whenLayerView(i);
   }
-  //#endregion
-  //#region Lifecycle
   load() {
     const i = this;
     i.el.childElem = document.createElement("div"), i.el.append(i.el.childElem), this.view.container ??= i.el.childElem;
@@ -374,8 +182,6 @@ class b extends l {
       s(() => this.view.ready, () => this.arcgisViewReadyChange.emit(), { initial: this.view.ready })
     ]);
   }
-  //#endregion
-  //#region Private Methods
   _editMapProperties(i) {
     this.map && (this._map = this.map), this.itemId && (i.portalItem = { id: this.itemId });
     const { basemap: e, ...a } = i;