@arcgis/core 6.0.0-next.15 → 6.0.0-next.16

package/analysis/LineOfSightAnalysis.d.ts

@@ -18,16 +18,10 @@ export interface LineOfSightAnalysisProperties extends AnalysisProperties {
  * LineOfSightAnalysis computes the line of sight from a single observer position towards
  * a set of targets. The results are visualized in a 3D [SceneView](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/).
  *
- * To display the line of sight between two points, create a new instance of LineOfSightAnalysis,
- * add it to [SceneView.analyses](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/#analyses), and set the [observer](https://developers.arcgis.com/javascript/latest/references/core/analysis/LineOfSightAnalysis/#observer) and
- * [targets](https://developers.arcgis.com/javascript/latest/references/core/analysis/LineOfSightAnalysis/#targets) properties.
- *
- * If the [observer position](https://developers.arcgis.com/javascript/latest/references/core/analysis/LineOfSightAnalysisObserver/#position) or
- * [target position](https://developers.arcgis.com/javascript/latest/references/core/analysis/LineOfSightAnalysisTarget/#position) have [z-values](https://developers.arcgis.com/javascript/latest/references/core/geometry/Point/#hasZ)
- * then these will be treated as absolute values, otherwise the points will be aligned to the ground.
- *
- * Use the [LineOfSightAnalysisView3D](https://developers.arcgis.com/javascript/latest/references/core/views/3d/analysis/LineOfSightAnalysisView3D/) to retrieve
- * analysis results.
+ * Create a new instance of LineOfSightAnalysis and add it to [SceneView.analyses](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/#analyses).
+ * The analysis may contain one [observer](https://developers.arcgis.com/javascript/latest/references/core/analysis/LineOfSightAnalysisObserver/) with multiple
+ * [targets](https://developers.arcgis.com/javascript/latest/references/core/analysis/LineOfSightAnalysisTarget/).
+ * The observer and targets can be created programmatically or interactively.
  *
  * ```js
  * // create line of sight analysis
@@ -38,9 +32,19 @@ export interface LineOfSightAnalysisProperties extends AnalysisProperties {
  *   ]
  * });
  *
- * // add to the view
+ * // add the analysis to the view
  * view.analyses.add(analysis);
+ * ```
+ *
+ * The analysis results are displayed as colored lines, where areas visible to the observer are
+ * shown green and occluded parts are marked in red. Also, the color of the target points indicates their visibility.
+ * When the line of sight cannot be calculated, it will be displayed with a gray color. This may happen if either
+ * the target or the observer is not in the view.
+ *
+ * Use the [LineOfSightAnalysisView3D](https://developers.arcgis.com/javascript/latest/references/core/views/3d/analysis/LineOfSightAnalysisView3D/) to retrieve more detailed
+ * analysis results.
  *
+ * ```js
  * // wait until the view finishes updating so the results are current
  * await reactiveUtils.whenOnce(() => !view.updating);
  *
@@ -49,19 +53,6 @@ export interface LineOfSightAnalysisProperties extends AnalysisProperties {
  * const results = analysisView.results;
  * ```
  *
- * The line of sight analysis can also be added to a [LineOfSightLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/LineOfSightLayer/) which can be persisted
- * in a web scene:
- *
- * ```js
- * // create line of sight layer containing the analysis
- * const lineOfSightLayer = new LineOfSightLayer({
- *   analysis: lineOfSightAnalysis
- * });
- *
- * // add to the map
- * view.map.add(lineOfSightLayer);
- * ```
- *
  * To place the observer and targets interactively, use the
  * [LineOfSightAnalysisView3D.place()](https://developers.arcgis.com/javascript/latest/references/core/views/3d/analysis/LineOfSightAnalysisView3D/#place) method.
  *
@@ -69,6 +60,10 @@ export interface LineOfSightAnalysisProperties extends AnalysisProperties {
  * const abortController = new AbortController();
  *
  * try {
+ *   // get a view for the analysis
+ *   const analysisView = await view.whenAnalysisView(analysis);
+ *
+ *   // start placing the observer and targets interactively
  *   await analysisView.place({ signal: abortController.signal });
  * } catch (error) {
  *   if (error.name === "AbortError") {
@@ -80,20 +75,41 @@ export interface LineOfSightAnalysisProperties extends AnalysisProperties {
  * abortController.abort();
  * ```
  *
- * The analysis results are displayed as colored lines, where areas visible to the observer are
- * shown green and occluded parts are marked in red. Also, the color of the target points indicates their visibility.
- * When the line of sight cannot be calculated, it will be displayed with a gray color. This may happen if either
- * the target or the observer is not in the view.
+ * To edit an existing line of sight analysis interactively, set the
+ * [LineOfSightAnalysisView3D.interactive](https://developers.arcgis.com/javascript/latest/references/core/views/3d/analysis/LineOfSightAnalysisView3D/#interactive) property to `true` and
+ * select the observer or any of the targets. Manipulators are then displayed and the selected item's position can be edited.
+ *
+ * ```js
+ * // allow the observer and targets in the analysis to be selected and edited
+ * analysisView.interactive = true;
+ * ```
+ *
+ * The line of sight analysis can be persisted in a [WebScene](https://developers.arcgis.com/javascript/latest/references/core/WebScene/) as part of a [LineOfSightLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/LineOfSightLayer/):
+ *
+ * ```js
+ * // create line of sight layer containing the analysis
+ * const lineOfSightLayer = new LineOfSightLayer({
+ *   analysis: analysis
+ * });
+ *
+ * // add the layer to the map
+ * view.map.add(lineOfSightLayer);
+ * ```
  *
  * Use the [Line Of Sight component](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-line-of-sight/) to display a user interface
  * for the line of sight analysis.
  *
  * > [!WARNING]
  * >
- * > **Known Limitations**
- * >
- * > This analysis is only supported in a 3D [SceneView](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/).
- * > The results of the tool vary depending on the zoom level, as changes in zoom level affect the level of detail (LOD) of the scene geometry.
+ * > **Things to consider:**
+ * > * This analysis is only supported in a 3D [SceneView](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/).
+ * > * The results of the tool vary depending on the zoom level, as changes in zoom level affect the level of detail (LOD) of the scene geometry.
+ * > * Snapping, tooltips, display units, and input units used during interactive placement and editing are inherited from
+ * [ViewOptions](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/options/ViewOptions/).
+ * >   * Snapping is enabled by default. This can be temporarily disabled by holding the `CTRL` key.
+ * >   * Layer types currently supported for snapping are: [FeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/), [GraphicsLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/GraphicsLayer/) (except Mesh geometries),
+ * > [GeoJSONLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/GeoJSONLayer/), [WFSLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/WFSLayer/), [CSVLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/CSVLayer/),
+ * > [3D Object SceneLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/SceneLayer/), and [BuildingSceneLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/BuildingSceneLayer/).
  *
  * @since 4.23
  * @see [LineOfSightAnalysisView3D](https://developers.arcgis.com/javascript/latest/references/core/views/3d/analysis/LineOfSightAnalysisView3D/)
@@ -101,6 +117,7 @@ export interface LineOfSightAnalysisProperties extends AnalysisProperties {
  * @see [LineOfSightLayerView](https://developers.arcgis.com/javascript/latest/references/core/views/layers/LineOfSightLayerView/)
  * @see [LineOfSightAnalysisTarget](https://developers.arcgis.com/javascript/latest/references/core/analysis/LineOfSightAnalysisTarget/)
  * @see [LineOfSightAnalysisObserver](https://developers.arcgis.com/javascript/latest/references/core/analysis/LineOfSightAnalysisObserver/)
+ * @see [ViewOptions](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/options/ViewOptions/)
  * @see [Line Of Sight component](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-line-of-sight/)
  * @see [Sample - Analysis objects](https://developers.arcgis.com/javascript/latest/sample-code/analysis-objects/)
  * @see [Sample - Line of sight component](https://developers.arcgis.com/javascript/latest/sample-code/line-of-sight/)

package/analysis/LineOfSightAnalysisObserver.d.ts

@@ -12,6 +12,9 @@ export interface LineOfSightAnalysisObserverProperties extends Partial<Pick<Line
    * Specifies how the observer is placed on the vertical axis (z). See the [ElevationInfo sample](https://developers.arcgis.com/javascript/latest/sample-code/scene-elevationinfo/)
    * for an example of how this property may be used.
    *
+   * When placing observers interactively, use the additional options on the [LineOfSightAnalysisView3D.place()](https://developers.arcgis.com/javascript/latest/references/core/views/3d/analysis/LineOfSightAnalysisView3D/#place)
+   * method to specify the elevation information.
+   *
    * > [!WARNING]
    * >
    * > [ElevationInfo.featureExpressionInfo](https://developers.arcgis.com/javascript/latest/references/core/symbols/support/ElevationInfo/#featureExpressionInfo) is not supported when the elevation info is specified for this class.
@@ -23,12 +26,17 @@ export interface LineOfSightAnalysisObserverProperties extends Partial<Pick<Line
    * sight analysis will synchronously calculate the intersection and the visibility to each target of the associated
    * [LineOfSightAnalysis](https://developers.arcgis.com/javascript/latest/references/core/analysis/LineOfSightAnalysis/).
    *
+   * If the position has a [z-value](https://developers.arcgis.com/javascript/latest/references/core/geometry/Point/#hasZ), it is treated as an absolute value.
+   * Optionally, with the [elevationInfo](https://developers.arcgis.com/javascript/latest/references/core/analysis/LineOfSightAnalysisObserver/#elevationInfo) property
+   * you can change how the z-value should be interpreted.
+   * If the observer has no z-value, it is aligned to the ground.
+   *
    * If the observer is assigned to a [LineOfSightLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/LineOfSightLayer/) then this property
    * must be defined before the layer can be saved to a [WebScene](https://developers.arcgis.com/javascript/latest/references/core/WebScene/).
    */
   position?: PointProperties | null;
   /**
-   * Indicates that this is an observer. This property is not persisted in a [WebScene](https://developers.arcgis.com/javascript/latest/references/core/WebScene/).
+   * Indicates that this is an observer.
    *
    * @since 5.2
    */
@@ -38,7 +46,7 @@ export interface LineOfSightAnalysisObserverProperties extends Partial<Pick<Line
 /**
  * The LineOfSightAnalysisObserver represents an observer of a [LineOfSightAnalysis](https://developers.arcgis.com/javascript/latest/references/core/analysis/LineOfSightAnalysis/).
  *
- * Use the position property to specify the position of the observer.
+ * Use the [position](https://developers.arcgis.com/javascript/latest/references/core/analysis/LineOfSightAnalysisObserver/#position) property to specify the position of the observer.
  *
  * @since 4.23
  * @see [LineOfSightAnalysis](https://developers.arcgis.com/javascript/latest/references/core/analysis/LineOfSightAnalysis/)
@@ -53,6 +61,9 @@ export default class LineOfSightAnalysisObserver extends LineOfSightAnalysisObse
    * Specifies how the observer is placed on the vertical axis (z). See the [ElevationInfo sample](https://developers.arcgis.com/javascript/latest/sample-code/scene-elevationinfo/)
    * for an example of how this property may be used.
    *
+   * When placing observers interactively, use the additional options on the [LineOfSightAnalysisView3D.place()](https://developers.arcgis.com/javascript/latest/references/core/views/3d/analysis/LineOfSightAnalysisView3D/#place)
+   * method to specify the elevation information.
+   *
    * > [!WARNING]
    * >
    * > [ElevationInfo.featureExpressionInfo](https://developers.arcgis.com/javascript/latest/references/core/symbols/support/ElevationInfo/#featureExpressionInfo) is not supported when the elevation info is specified for this class.
@@ -75,13 +86,18 @@ export default class LineOfSightAnalysisObserver extends LineOfSightAnalysisObse
    * sight analysis will synchronously calculate the intersection and the visibility to each target of the associated
    * [LineOfSightAnalysis](https://developers.arcgis.com/javascript/latest/references/core/analysis/LineOfSightAnalysis/).
    *
+   * If the position has a [z-value](https://developers.arcgis.com/javascript/latest/references/core/geometry/Point/#hasZ), it is treated as an absolute value.
+   * Optionally, with the [elevationInfo](https://developers.arcgis.com/javascript/latest/references/core/analysis/LineOfSightAnalysisObserver/#elevationInfo) property
+   * you can change how the z-value should be interpreted.
+   * If the observer has no z-value, it is aligned to the ground.
+   *
    * If the observer is assigned to a [LineOfSightLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/LineOfSightLayer/) then this property
    * must be defined before the layer can be saved to a [WebScene](https://developers.arcgis.com/javascript/latest/references/core/WebScene/).
    */
   get position(): Point | null | undefined;
   set position(value: PointProperties | null | undefined);
   /**
-   * Indicates that this is an observer. This property is not persisted in a [WebScene](https://developers.arcgis.com/javascript/latest/references/core/WebScene/).
+   * Indicates that this is an observer.
    *
    * @since 5.2
    */

package/analysis/LineOfSightAnalysisTarget.d.ts

@@ -11,6 +11,9 @@ export interface LineOfSightAnalysisTargetProperties extends Partial<Pick<LineOf
    * Specifies how the target is placed on the vertical axis (z). See the [ElevationInfo sample](https://developers.arcgis.com/javascript/latest/sample-code/scene-elevationinfo/)
    * for an example of how this property may be used.
    *
+   * When placing targets interactively, use the additional options on the [LineOfSightAnalysisView3D.place()](https://developers.arcgis.com/javascript/latest/references/core/views/3d/analysis/LineOfSightAnalysisView3D/#place)
+   * method to specify the elevation information.
+   *
    * > [!WARNING]
    * >
    * > [ElevationInfo.featureExpressionInfo](https://developers.arcgis.com/javascript/latest/references/core/symbols/support/ElevationInfo/#featureExpressionInfo) is not supported when the elevation info is specified for this class.
@@ -20,10 +23,15 @@ export interface LineOfSightAnalysisTargetProperties extends Partial<Pick<LineOf
   /**
    * A [Point](https://developers.arcgis.com/javascript/latest/references/core/geometry/Point/) representing the position of the target. Once the position is set, a new line of
    * sight analysis will synchronously calculate the intersection and the visibility.
+   *
+   * If the position has a [z-value](https://developers.arcgis.com/javascript/latest/references/core/geometry/Point/#hasZ), it is treated as an absolute value.
+   * Optionally, with the [elevationInfo](https://developers.arcgis.com/javascript/latest/references/core/analysis/LineOfSightAnalysisTarget/#elevationInfo) property
+   * you can change how the z-value should be interpreted.
+   * If the target has no z-value, it is aligned to the ground.
    */
   position?: PointProperties | null;
   /**
-   * Indicates that this is a target. This property is not persisted in a [WebScene](https://developers.arcgis.com/javascript/latest/references/core/WebScene/).
+   * Indicates that this is a target.
    *
    * @since 5.2
    */
@@ -33,7 +41,7 @@ export interface LineOfSightAnalysisTargetProperties extends Partial<Pick<LineOf
 /**
  * The LineOfSightAnalysisTarget represents a target of a [LineOfSightAnalysis](https://developers.arcgis.com/javascript/latest/references/core/analysis/LineOfSightAnalysis/).
  *
- * Use the position property to specify the position of the target.
+ * Use the [position](https://developers.arcgis.com/javascript/latest/references/core/analysis/LineOfSightAnalysisTarget/#position) property to specify the position of the target.
  *
  * @since 4.23
  * @see [LineOfSightAnalysis](https://developers.arcgis.com/javascript/latest/references/core/analysis/LineOfSightAnalysis/)
@@ -49,6 +57,9 @@ export default class LineOfSightAnalysisTarget extends LineOfSightAnalysisTarget
    * Specifies how the target is placed on the vertical axis (z). See the [ElevationInfo sample](https://developers.arcgis.com/javascript/latest/sample-code/scene-elevationinfo/)
    * for an example of how this property may be used.
    *
+   * When placing targets interactively, use the additional options on the [LineOfSightAnalysisView3D.place()](https://developers.arcgis.com/javascript/latest/references/core/views/3d/analysis/LineOfSightAnalysisView3D/#place)
+   * method to specify the elevation information.
+   *
    * > [!WARNING]
    * >
    * > [ElevationInfo.featureExpressionInfo](https://developers.arcgis.com/javascript/latest/references/core/symbols/support/ElevationInfo/#featureExpressionInfo) is not supported when the elevation info is specified for this class.
@@ -69,11 +80,16 @@ export default class LineOfSightAnalysisTarget extends LineOfSightAnalysisTarget
   /**
    * A [Point](https://developers.arcgis.com/javascript/latest/references/core/geometry/Point/) representing the position of the target. Once the position is set, a new line of
    * sight analysis will synchronously calculate the intersection and the visibility.
+   *
+   * If the position has a [z-value](https://developers.arcgis.com/javascript/latest/references/core/geometry/Point/#hasZ), it is treated as an absolute value.
+   * Optionally, with the [elevationInfo](https://developers.arcgis.com/javascript/latest/references/core/analysis/LineOfSightAnalysisTarget/#elevationInfo) property
+   * you can change how the z-value should be interpreted.
+   * If the target has no z-value, it is aligned to the ground.
    */
   get position(): Point | null | undefined;
   set position(value: PointProperties | null | undefined);
   /**
-   * Indicates that this is a target. This property is not persisted in a [WebScene](https://developers.arcgis.com/javascript/latest/references/core/WebScene/).
+   * Indicates that this is a target.
    *
    * @since 5.2
    */

package/analysis/Viewshed.d.ts

@@ -11,6 +11,9 @@ export interface ViewshedProperties extends Partial<Pick<Viewshed, "farDistance"
    * Specifies how the observer is placed on the vertical axis (z). See the [ElevationInfo sample](https://developers.arcgis.com/javascript/latest/sample-code/scene-elevationinfo/)
    * for an example of how this property may be used.
    *
+   * When placing viewsheds interactively, use the additional options on the [ViewshedAnalysisView3D.place()](https://developers.arcgis.com/javascript/latest/references/core/views/3d/analysis/ViewshedAnalysisView3D/#place)
+   * method to specify the elevation information.
+   *
    * > [!WARNING]
    * >
    * > [ElevationInfo.featureExpressionInfo](https://developers.arcgis.com/javascript/latest/references/core/symbols/support/ElevationInfo/#featureExpressionInfo) is not supported when the elevation info is specified for this class.
@@ -19,7 +22,14 @@ export interface ViewshedProperties extends Partial<Pick<Viewshed, "farDistance"
    * @since 5.1
    */
   elevationInfo?: ElevationInfoProperties | null;
-  /** A [Point](https://developers.arcgis.com/javascript/latest/references/core/geometry/Point/) specifying the position the viewshed is calculated from. */
+  /**
+   * A [Point](https://developers.arcgis.com/javascript/latest/references/core/geometry/Point/) specifying the position the viewshed is calculated from.
+   *
+   * If the observer has a [z-value](https://developers.arcgis.com/javascript/latest/references/core/geometry/Point/#hasZ), it is treated as an absolute value.
+   * Optionally, with the [elevationInfo](https://developers.arcgis.com/javascript/latest/references/core/analysis/Viewshed/#elevationInfo) property
+   * you can change how the z-value should be interpreted.
+   * If the observer has no z-value, it is aligned to the ground.
+   */
   observer?: PointProperties | null;
 }
 
@@ -70,6 +80,9 @@ export default class Viewshed extends ViewshedSuperclass {
    * Specifies how the observer is placed on the vertical axis (z). See the [ElevationInfo sample](https://developers.arcgis.com/javascript/latest/sample-code/scene-elevationinfo/)
    * for an example of how this property may be used.
    *
+   * When placing viewsheds interactively, use the additional options on the [ViewshedAnalysisView3D.place()](https://developers.arcgis.com/javascript/latest/references/core/views/3d/analysis/ViewshedAnalysisView3D/#place)
+   * method to specify the elevation information.
+   *
    * > [!WARNING]
    * >
    * > [ElevationInfo.featureExpressionInfo](https://developers.arcgis.com/javascript/latest/references/core/symbols/support/ElevationInfo/#featureExpressionInfo) is not supported when the elevation info is specified for this class.
@@ -112,7 +125,14 @@ export default class Viewshed extends ViewshedSuperclass {
    * @default 45
    */
   accessor horizontalFieldOfView: number;
-  /** A [Point](https://developers.arcgis.com/javascript/latest/references/core/geometry/Point/) specifying the position the viewshed is calculated from. */
+  /**
+   * A [Point](https://developers.arcgis.com/javascript/latest/references/core/geometry/Point/) specifying the position the viewshed is calculated from.
+   *
+   * If the observer has a [z-value](https://developers.arcgis.com/javascript/latest/references/core/geometry/Point/#hasZ), it is treated as an absolute value.
+   * Optionally, with the [elevationInfo](https://developers.arcgis.com/javascript/latest/references/core/analysis/Viewshed/#elevationInfo) property
+   * you can change how the z-value should be interpreted.
+   * If the observer has no z-value, it is aligned to the ground.
+   */
   get observer(): Point | null | undefined;
   set observer(value: PointProperties | null | undefined);
   /**
@@ -124,7 +144,7 @@ export default class Viewshed extends ViewshedSuperclass {
   accessor tilt: number;
   /**
    * Indicates whether the viewshed is ready to be computed and interacted with in the view.
-   * It requires the [observer](https://developers.arcgis.com/javascript/latest/references/core/analysis/Viewshed/#observer) to be set and have a position, and the [farDistance](https://developers.arcgis.com/javascript/latest/references/core/analysis/Viewshed/#farDistance) to be
+   * It requires the [observer](https://developers.arcgis.com/javascript/latest/references/core/analysis/Viewshed/#observer) to be set and the [farDistance](https://developers.arcgis.com/javascript/latest/references/core/analysis/Viewshed/#farDistance) to be
    * greater than 0.
    *
    * @since 4.33

package/analysis/ViewshedAnalysis.d.ts

@@ -13,9 +13,9 @@ export interface ViewshedAnalysisProperties extends AnalysisProperties {
 /**
  * ViewshedAnalysis enables the creation and display of viewshed and view dome type of visibility analysis in a 3D [SceneView](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/).
  *
- * The analysis can contain multiple viewsheds. These can be created interactively or programmatically, and the analysis can be added directly to
- * [SceneView.analyses](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/#analyses) or to the
- * [ViewshedLayer.source](https://developers.arcgis.com/javascript/latest/references/core/layers/ViewshedLayer/#source) in a [SceneView.map](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/#map).
+ * Create a new instance of ViewshedAnalysis and add it to [SceneView.analyses](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/#analyses).
+ * The analysis may contain multiple [viewsheds](https://developers.arcgis.com/javascript/latest/references/core/analysis/Viewshed/).
+ * The viewsheds can be created programmatically or interactively.
  *
  * ```js
  * const viewshed = new Viewshed({
@@ -34,6 +34,8 @@ export interface ViewshedAnalysisProperties extends AnalysisProperties {
  * view.analyses.add(analysis);
  * ```
  *
+ * The analysis colors the areas visible to the observer as green and occluded parts as red.
+ *
  * To add a viewshed interactively, use the
  * [ViewshedAnalysisView3D.place()](https://developers.arcgis.com/javascript/latest/references/core/views/3d/analysis/ViewshedAnalysisView3D/#place) method.
  *
@@ -56,29 +58,46 @@ export interface ViewshedAnalysisProperties extends AnalysisProperties {
  * abortController.abort();
  * ```
  *
- * To edit existing viewsheds interactively, set the
- * [ViewshedAnalysisView3D.interactive](https://developers.arcgis.com/javascript/latest/references/core/views/3d/analysis/ViewshedAnalysisView3D/#interactive) property
- * `true` and select a viewshed by hovering and clicking on their field-of-view manipulators.
+ * To edit any existing viewsheds interactively, set the
+ * [ViewshedAnalysisView3D.interactive](https://developers.arcgis.com/javascript/latest/references/core/views/3d/analysis/ViewshedAnalysisView3D/#interactive) property to `true` and
+ * select a viewshed by clicking on its observer. Manipulators for editing the observer's position
+ * and other parameters of the viewshed will then be displayed.
  *
  * ```js
  * // allow existing viewsheds in the analysis to be selected and edited
  * analysisView.interactive = true;
  * ```
  *
- * A ViewshedAnalysis can be persisted in a [WebScene](https://developers.arcgis.com/javascript/latest/references/core/WebScene/) as part of a [ViewshedLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/ViewshedLayer/).
+ * The viewshed analysis can be persisted in a [WebScene](https://developers.arcgis.com/javascript/latest/references/core/WebScene/) as part of a [ViewshedLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/ViewshedLayer/):
+ *
+ * ```js
+ * // create viewshed layer containing the analysis
+ * const viewshedLayer = new ViewshedLayer({
+ *   source: analysis
+ * });
+ *
+ * // add the layer to the map
+ * view.map.add(viewshedLayer);
+ * ```
  *
  * > [!WARNING]
  * >
- * > **Known Limitations**
- * >
- * > This analysis is only supported in a 3D [SceneView](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/).
- * > The results of the tool vary depending on the zoom level, as changes in zoom level affect the level of detail (LOD) of the scene geometry.
+ * > **Things to consider:**
+ * > * This analysis is only supported in a 3D [SceneView](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/).
+ * > * The results of the tool vary depending on the zoom level, as changes in zoom level affect the level of detail (LOD) of the scene geometry.
+ * > * Snapping, tooltips, display units, and input units used during interactive placement and editing are inherited from
+ * [ViewOptions](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/options/ViewOptions/).
+ * >   * Snapping is enabled by default. This can be temporarily disabled by holding the `CTRL` key.
+ * >   * Layer types currently supported for snapping are: [FeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/), [GraphicsLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/GraphicsLayer/) (except Mesh geometries),
+ * > [GeoJSONLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/GeoJSONLayer/), [WFSLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/WFSLayer/), [CSVLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/CSVLayer/),
+ * > [3D Object SceneLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/SceneLayer/), and [BuildingSceneLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/BuildingSceneLayer/).
  *
  * @since 4.30
  * @see [ViewshedAnalysisView3D](https://developers.arcgis.com/javascript/latest/references/core/views/3d/analysis/ViewshedAnalysisView3D/)
  * @see [Viewshed](https://developers.arcgis.com/javascript/latest/references/core/analysis/Viewshed/)
  * @see [ViewshedLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/ViewshedLayer/)
  * @see [ViewshedLayerView](https://developers.arcgis.com/javascript/latest/references/core/views/layers/ViewshedLayerView/)
+ * @see [ViewOptions](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/options/ViewOptions/)
  * @see [Sample - Interactive viewshed analysis](https://developers.arcgis.com/javascript/latest/sample-code/analysis-viewshed/)
  * @see [Sample - Analysis objects](https://developers.arcgis.com/javascript/latest/sample-code/analysis-objects/)
  * @see [3D viewshed overview](https://developers.arcgis.com/documentation/spatial-analysis-services/3d-visual/3d-viewshed/)
@@ -89,8 +108,9 @@ export default class ViewshedAnalysis extends Analysis {
   get type(): "viewshed";
   /**
    * Indicates whether the analysis is ready to be computed and interacted with in the view.
-   * It requires each of the [viewsheds](https://developers.arcgis.com/javascript/latest/references/core/analysis/ViewshedAnalysis/#viewsheds) to be valid, that is, to have an observer with a position and a far
-   * distance greater than 0. If the analysis has no viewshed, it is considered valid.
+   * It requires each of the [viewsheds](https://developers.arcgis.com/javascript/latest/references/core/analysis/ViewshedAnalysis/#viewsheds) to be valid, that is,
+   * the [Viewshed.observer](https://developers.arcgis.com/javascript/latest/references/core/analysis/Viewshed/#observer) needs to be set and the [Viewshed.farDistance](https://developers.arcgis.com/javascript/latest/references/core/analysis/Viewshed/#farDistance) to be
+   * greater than 0. If the analysis has no viewshed, it is considered valid.
    *
    * @since 4.33
    */

package/arcade/geometry/operatorsWorkerConnection.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/6.0/LICENSE.txt */
-import{open as e}from"../../core/workers/workers.js";let t,n=!1,r;function i(){return t??=e(`arcadeGeometryOperatorsWorker`).then(e=>{r=e,n=!0,t=void 0})}async function a(e,t){return n?r.apply(`invokeGeometryOp`,[e,t]):(await i(),a(e,t))}export{a as invokeRemoteGeometryOp};
+import{open as e}from"../../core/workers.js";let t,n=!1,r;function i(){return t??=e(`arcadeGeometryOperatorsWorker`).then(e=>{r=e,n=!0,t=void 0})}async function a(e,t){return n?r.apply(`invokeGeometryOp`,[e,t]):(await i(),a(e,t))}export{a as invokeRemoteGeometryOp};