@arcgis/core 5.0.0-next.51 → 5.0.0-next.53

package/views/3d/analysis/LineOfSightAnalysisView3D.d.ts

@@ -1,4 +1,124 @@
-import "../../../interfaces";
+import type LineOfSightAnalysis from "../../../analysis/LineOfSightAnalysis.js";
+import type Collection from "../../../core/Collection.js";
+import type LineOfSightAnalysisResult from "./LineOfSightAnalysisResult.js";
+import type { AbortOptions } from "../../../core/promiseUtils.js";
+import type { AnalysisView3D } from "./AnalysisView3D.js";
+import type { LineOfSightPlacementResult } from "./LineOfSight/types.js";
 
-import LineOfSightAnalysisView3D = __esri.LineOfSightAnalysisView3D;
-export default LineOfSightAnalysisView3D;
+export interface LineOfSightView3DEvents {}
+
+/**
+ * Represents the analysis view of a [LineOfSightAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-LineOfSightAnalysis.html)
+ * after it has been added to [SceneView#analyses](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#analyses).
+ *
+ * The LineOfSightAnalysisView3D is responsible for rendering a [LineOfSightAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-LineOfSightAnalysis.html)
+ * using custom visualizations.
+ *
+ * It allows to create an observer and/or targets interactively using the [place()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-analysis-LineOfSightAnalysisView3D.html#place) method, query analysis [results](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-analysis-LineOfSightAnalysisView3D.html#results),
+ * or make an existing analysis editable by enabling the [interactive](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-analysis-LineOfSightAnalysisView3D.html#interactive) property.
+ *
+ * The view for an analysis can be retrieved using [SceneView#whenAnalysisView()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#whenAnalysisView)
+ * similar to how layer views are retrieved for layers using [SceneView#whenLayerView()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#whenLayerView).
+ *
+ * ```js
+ * // retrieve analysis view for analysis
+ * const analysis = new LineOfSightAnalysis();
+ * view.analyses.add(analysis); // add to the view
+ * const analysisView = await view.whenAnalysisView(analysis);
+ * ```
+ *
+ * @see [LineOfSightAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-LineOfSightAnalysis.html)
+ * @see [LineOfSightLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-LineOfSightLayer.html)
+ * @see [LineOfSightLayerView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-layers-LineOfSightLayerView.html)
+ * @see [LineOfSightAnalysisTarget](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-LineOfSightAnalysisTarget.html)
+ * @see [LineOfSightAnalysisObserver](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-LineOfSightAnalysisObserver.html)
+ * @see [Line Of Sight component](https://developers.arcgis.com/javascript/latest/references/map-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/)
+ */
+export default abstract class LineOfSightAnalysisView3D extends AnalysisView3D {
+  /**
+   * The line of sight analysis object associated with the analysis view.
+   *
+   * @since 4.24
+   */
+  get analysis(): LineOfSightAnalysis;
+  /**
+   * Enables interactivity for the associated [analysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-analysis-LineOfSightAnalysisView3D.html#analysis). When set to `true`, manipulators will be displayed,
+   * allowing users to click and drag to edit the analysis if it has a valid
+   * [LineOfSightAnalysis#observer](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-LineOfSightAnalysis.html#observer) and
+   * [LineOfSightAnalysis#targets](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-LineOfSightAnalysis.html#targets). Right-clicking a target will remove it.
+   *
+   * This property is automatically set to `true` when the analysis is assigned to a
+   * [Line Of Sight component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-line-of-sight/).
+   *
+   * @default false
+   * @since 4.24
+   */
+  accessor interactive: boolean;
+  /**
+   * Analysis results for each target.
+   *
+   * The order of results matches the order of targets, so if the index of the target is known the collection can be
+   * indexed directly:
+   *
+   * ```js
+   * const analysisView = await view.whenAnalysisView(lineOfSightAnalysis);
+   * const result = analysisView.results.at(targetIdx);
+   * ```
+   *
+   * Given a [target](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-LineOfSightAnalysisTarget.html) object, the results collection can also be
+   * searched:
+   *
+   * ```js
+   * const result = analysisView.results.find((result) => result.target === targetObject);
+   * ```
+   */
+  get results(): Collection<LineOfSightAnalysisResult | null | undefined>;
+  /**
+   * The analysis view type.
+   *
+   * @since 4.24
+   */
+  get type(): "line-of-sight-view-3d";
+  /**
+   * When `true`, the [analysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-analysis-LineOfSightAnalysisView3D.html#analysis) is visualized in the view.
+   *
+   * @since 4.24
+   */
+  get visible(): boolean;
+  set visible(value: boolean | null | undefined);
+  /**
+   * Starts the interactive placement of an observer and/or targets on the [analysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-analysis-LineOfSightAnalysisView3D.html#analysis).
+   *
+   * If the analysis does not have a valid observer yet, this method will allow placing an observer, which can be followed
+   * by zero or more targets. Otherwise, if it already has a valid observer, it will allow placing targets.
+   *
+   * The placement operation will finish when the user presses the escape key.
+   * To stop the placing programmatically, pass an abort signal as an argument when calling the method.
+   * The promise resolves when the operation is productive, i.e. an oberver or any targets were added.
+   * Otherwise, if nothing was added or signal was aborted, the promise is rejected.
+   *
+   * Calling this method sets [interactive](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-analysis-LineOfSightAnalysisView3D.html#interactive) to `true`.
+   *
+   * @param options - An object specifying additional options.
+   * @returns A promise
+   * which resolves when the operation is completed successfully - i.e. the user places an observer and/or target(s),
+   * leaving the analysis in a valid state. Otherwise, the promise is rejected.
+   * @since 4.33
+   * @example
+   * const abortController = new AbortController();
+   *
+   * try {
+   *   await analysisView.place({ signal: abortController.signal });
+   * } catch (error) {
+   *   if (error.name === "AbortError") {
+   *     console.log("Placement operation was cancelled.");
+   *   }
+   * }
+   *
+   * // cancel the placement operation at some later point
+   * abortController.abort();
+   */
+  place(options?: AbortOptions | null | undefined): Promise<LineOfSightPlacementResult>;
+}

package/views/3d/analysis/ShadowCast/ShadowCastTooltip.js

@@ -0,0 +1,5 @@
+/*
+All material copyright Esri, All Rights Reserved, unless otherwise specified.
+See https://js.arcgis.com/5.0/esri/copyright.txt for details.
+*/
+import{__decorate as t}from"tslib";import o from"../../../../core/Accessor.js";import{createTask as e}from"../../../../core/asyncUtils.js";import{makeHandle as i}from"../../../../core/handleUtils.js";import{roundToNearest as s}from"../../../../core/mathUtils.js";import{removeMaybe as r,abortMaybe as a}from"../../../../core/maybe.js";import{throwIfAborted as n}from"../../../../core/promiseUtils.js";import{watch as l,syncAndInitial as d}from"../../../../core/reactiveUtils.js";import{createScreenPoint as h}from"../../../../core/screenUtils.js";import{throttle as p}from"../../../../core/throttle.js";import{convertTime as c}from"../../../../core/timeUtils.js";import{property as u,subclass as m}from"../../../../core/accessorSupport/decorators.js";import{formatDuration as _}from"../../../../intl/duration.js";import{onLocaleChange as w}from"../../../../intl/locale.js";import{fetchMessageBundle as v}from"../../../../intl/messages.js";import{substitute as f}from"../../../../intl/substitute.js";let y=class extends o{constructor(t){super(t),this.throttleDelay=x,this._tooltipElement=g(),this._tooltipContentElement=D(),this._messagesTask=null,this._screenPoint=null,this._shadowDurationTask=null,this._shadowDuration=null,this._throttledUpdateShadowDuration=null,this._onPointerMove=({x:t,y:o})=>{const e=h(t,o);this._screenPoint=e,this._throttledUpdateShadowDuration?.(this.view,e)},this._updateShadowDuration=(t,o)=>{this._abortShadowDurationTask(),this._shadowDurationTask=e(async e=>{const{results:i,ground:s}=await t.hitTest(o);if(n(e),0===i.length&&!s.mapPoint)return void(this._shadowDuration=null);const r=await this.getDuration(o,e);n(e),this._shadowDuration=r})}}initialize(){this._tooltipElement.appendChild(this._tooltipContentElement);const t=()=>{this._messagesTask?.abort(),this._messagesTask=e(()=>v("esri/views/3d/analysis/ShadowCast/t9n/ShadowCastAnalysis"))};t(),this.addHandles([w(t),l(()=>({enabled:this.isVisible(),surface:this.view.surface}),({enabled:t,surface:o})=>{t&&o?(o.appendChild(this._tooltipElement),this._startTracking(this.view)):(this.removeHandles(T),this._tooltipElement.remove())},d),l(()=>this._styles,t=>{Object.assign(this._tooltipElement.style,t)},d),l(()=>this._formattedText,t=>{this._tooltipContentElement.innerText=t},d),l(()=>this.throttleDelay,t=>{this._throttledUpdateShadowDuration=p(this._updateShadowDuration,t)},d),i(()=>{this._throttledUpdateShadowDuration=r(this._throttledUpdateShadowDuration)})])}destroy(){this._tooltipElement.remove()}get updating(){return null!=this._shadowDurationTask&&!this._shadowDurationTask?.finished||!0===this._throttledUpdateShadowDuration?.hasPendingUpdates()}get _formattedText(){const t=this._messagesTask?.value,o=this._shadowDuration;if(null==t||null==o)return"";const e=s(o,o<E?j:E);return f(t.shadowDuration,{duration:_(e)})}get _styles(){const t=this._screenPoint;return t&&this._formattedText?{display:"block",transform:`translate(${t.x}px, ${t.y}px)`}:{display:"none"}}_startTracking(t){if(this.hasHandles(T))return;const o=o=>{this.hasHandles(S)||(o&&this._onPointerMove(o),this.addHandles(t.on("pointer-move",this._onPointerMove),S))},e=()=>{this.removeHandles(S),this._abortShadowDurationTask(),this._screenPoint=null,this._shadowDuration=null};this.addHandles([t.on("pointer-enter",o),t.on("pointer-leave",e),t.on("pointer-down",e),t.on("pointer-up",o),t.on("pointer-drag",t=>{"end"===t.action?o(t):e()}),t.on("click",o=>{const e=h(o.x,o.y);this._screenPoint=e,this._updateShadowDuration(t,e)}),i(()=>this._abortShadowDurationTask())],T),o()}_abortShadowDurationTask(){this._shadowDurationTask=a(this._shadowDurationTask)}};function g(){const t=k(document.createElement("div"),{position:"absolute",top:"0",left:"0",pointerEvents:"none"});return t.style.setProperty("--tooltip-arrow-size","6px"),t.style.setProperty("--tooltip-background","var(--calcite-color-foreground-1)"),t.appendChild(b()),t}function D(){return k(document.createElement("div"),{color:"var(--calcite-color-text-1)",fontSize:"var(--calcite-font-size-sm)",position:"absolute",width:"max-content",transform:"translate(0, -100%)",insetInlineStart:"calc(var(--calcite-spacing-lg) * -1)",marginTop:"calc((var(--tooltip-arrow-size) * -1) - var(--calcite-spacing-xxs))",background:"var(--tooltip-background)",paddingInline:"var(--calcite-spacing-md)",paddingBlock:"var(--calcite-spacing-xs)",pointerEvents:"none",borderRadius:"var(--calcite-corner-radius-sm)"})}function b(){return k(document.createElement("div"),{display:"block",position:"absolute",width:"0",height:"0",bottom:"-1px",left:"50%",transform:"translate(-50%, 0)",borderTop:"var(--tooltip-arrow-size) solid var(--tooltip-background)",borderRight:"var(--tooltip-arrow-size) solid transparent",borderBottom:"var(--tooltip-arrow-size) solid transparent",borderLeft:"var(--tooltip-arrow-size) solid transparent",pointerEvents:"none"})}function k(t,o){return Object.assign(t.style,o),t}t([u()],y.prototype,"view",void 0),t([u()],y.prototype,"isVisible",void 0),t([u()],y.prototype,"getDuration",void 0),t([u()],y.prototype,"throttleDelay",void 0),t([u()],y.prototype,"updating",null),t([u()],y.prototype,"_messagesTask",void 0),t([u()],y.prototype,"_screenPoint",void 0),t([u()],y.prototype,"_shadowDurationTask",void 0),t([u()],y.prototype,"_shadowDuration",void 0),t([u()],y.prototype,"_throttledUpdateShadowDuration",void 0),t([u()],y.prototype,"_formattedText",null),t([u()],y.prototype,"_styles",null),y=t([m("esri.views.3d.analysis.ShadowCast.ShadowCastTooltip")],y);const T=Symbol("tracking"),S=Symbol("pointer"),x=300,j=c(1,"minutes","milliseconds"),E=c(15,"minutes","milliseconds");export{y as ShadowCastTooltip};

package/views/3d/analysis/ShadowCastAnalysisView3D.d.ts

@@ -1,4 +1,70 @@
-import "../../../interfaces";
+import type ShadowCastAnalysis from "../../../analysis/ShadowCastAnalysis.js";
+import type { ScreenPoint } from "../../../core/interfaces.js";
+import type { AnalysisView3D } from "./AnalysisView3D.js";
 
-import ShadowCastAnalysisView3D = __esri.ShadowCastAnalysisView3D;
-export default ShadowCastAnalysisView3D;
+/**
+ * Represents the analysis view of a [ShadowCastAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ShadowCastAnalysis.html) after it has been added to
+ * [SceneView#analyses](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#analyses).
+ *
+ * The ShadowCastAnalysisView3D is responsible for rendering a [ShadowCastAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ShadowCastAnalysis.html)
+ * using custom visualizations. The [methods](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-analysis-ShadowCastAnalysisView3D.html#getDurationAtScreen)
+ * on the analysis view provide developers with the ability to obtain the specific shadow duration at the certain
+ * [point](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-interfaces.html#ScreenPoint) on the screen.
+ *
+ * The view for an analysis can be retrieved using [SceneView#whenAnalysisView()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#whenAnalysisView)
+ * similar to how layer views are retrieved for layers using [SceneView#whenLayerView()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#whenLayerView).
+ * ```js
+ * // retrieve analysis view for analysis
+ * const analysis = new ShadowCastAnalysis();
+ * view.analyses.add(analysis); // add to the scene view
+ * const analysisView = await view.whenAnalysisView(analysis);
+ * ```
+ *
+ * @since 5.0
+ * @see [ShadowCastAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ShadowCastAnalysis.html)
+ * @see [DiscreteOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ShadowCast-DiscreteOptions.html)
+ * @see [MinDurationOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ShadowCast-MinDurationOptions.html)
+ * @see [TotalDurationOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ShadowCast-TotalDurationOptions.html)
+ * @see [Sample - Analysis objects](https://developers.arcgis.com/javascript/latest/sample-code/analysis-objects/)
+ * @see [Sample - Shadow Cast analysis](https://developers.arcgis.com/javascript/latest/sample-code/shadow-cast/)
+ * @see [Shadow Cast component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-shadow-cast/)
+ */
+export default abstract class ShadowCastAnalysisView3D extends AnalysisView3D {
+  /** The shadow cast analysis associated with the analysis view. */
+  get analysis(): ShadowCastAnalysis;
+  /**
+   * Enables interactivity for the [analysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-analysis-ShadowCastAnalysisView3D.html#analysis).
+   *
+   * @default true
+   */
+  accessor interactive: boolean;
+  /** The analysis view type. */
+  get type(): "shadow-cast-view-3d";
+  /** Whether the analysis is currently being updated. */
+  get updating(): boolean;
+  /**
+   * When `true`, the [analysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-analysis-ShadowCastAnalysisView3D.html#analysis) is visualized in the view.
+   *
+   * Only one [ShadowCastAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ShadowCastAnalysis.html) at a time can be visible in a [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html).
+   * When a shadow cast analysis is made visible by setting this property to `true`, all other shadow cast analysis
+   * views are automatically hidden.
+   */
+  accessor visible: boolean;
+  /**
+   * Returns the time (in milliseconds) spent in shadow for a certain point on the screen.
+   *
+   * @param point - The point on the screen for which shadow cast is calculated.
+   * @returns A promise that resolves to the duration (in milliseconds) spent in shadow for the given screen point.
+   * @example
+   * // use getDurationAtScreen method from the analysis view once available
+   * const analysisView = await view.whenAnalysisView(shadowCastAnalysis);
+   *
+   * // get shadow duration at the pointer location
+   * view.on("pointer-move", async (event) => {
+   *   // duration in milliseconds
+   *   const duration = await analysisView.getDurationAtScreen({ x: event.x, y: event.y });
+   *   // ... do something with the duration
+   * });
+   */
+  getDurationAtScreen(point: ScreenPoint): Promise<number>;
+}

package/views/3d/analysis/ShadowCastAnalysisView3D.js

@@ -2,4 +2,4 @@
 All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/5.0/esri/copyright.txt for details.
 */
-import{__decorate as e}from"tslib";import t from"../../../Color.js";import{isSome as i}from"../../../core/arrayUtils.js";import{createTask as r}from"../../../core/asyncUtils.js";import"../../../core/has.js";import{abortMaybe as s}from"../../../core/maybe.js";import{after as n,throwIfAborted as o}from"../../../core/promiseUtils.js";import{watch as a,syncAndInitial as l}from"../../../core/reactiveUtils.js";import{createScreenPointArray as c,createRenderScreenPointArray as d}from"../../../core/screenUtils.js";import{offsetDateUTC as u,convertTime as h}from"../../../core/timeUtils.js";import{property as p,subclass as _}from"../../../core/accessorSupport/decorators.js";import{create as m}from"../../../core/libs/gl-matrix-2/factories/vec3f64.js";import{AnalysisView3D as f}from"./AnalysisView3D.js";import{registerAnalysisView as v,hideOtherAnalysisViews as g}from"./ShadowCast/analysisViewRegister.js";import{longitudeToTimezone as y}from"../support/earthUtils.js";import{computeDirectionsOverTime as w}from"../support/sunUtils.js";import{breadthFirstBinaryPartitioning as D}from"../../../widgets/support/traversalUtils.js";let P=class extends f{constructor(e){super(e),this.type="shadow-cast-view-3d",this.analysis=null,this._stopPreviewingTask=null,this._forcePreview=!1,this._autoRestoreForcePreviewEnabled=!0}initialize(){this.addHandles([v(this.view,this),a(()=>this._forcePreviewDependencies,()=>{s(this._stopPreviewingTask),this._forcePreview=!0,this._autoRestoreForcePreviewEnabled&&(this._stopPreviewingTask=r(async e=>{await n(O,e),o(e),this._forcePreview=!1}))},l),a(()=>({renderer:this._renderer,visible:this.visible}),({renderer:e,visible:t})=>{t&&g(this.view,this),e?.setParameters({shadowCast:{enabled:t}})},l),a(()=>({renderer:this._renderer,parameters:this._visualizationParameters,visible:this.visible}),({renderer:e,parameters:t,visible:i})=>{b(e,i,t)},l),a(()=>({renderer:this._renderer,lightDirections:this._lightDirections,lightDirectionsContext:this._lightDirectionsContext,visible:this.visible}),({renderer:e,lightDirections:t,lightDirectionsContext:i,visible:r})=>{b(e,r,{lightDirections:t,lightDirectionsContext:i})},l),a(()=>({renderer:this._renderer,previewing:this._previewing,visible:this.visible}),({renderer:e,previewing:t,visible:i})=>{b(e,i,{previewing:t})},l)])}destroy(){this.visible&&b(this._renderer,!0,{enabled:!1})}get interactive(){return!1}set interactive(e){}get updating(){return!1}get visible(){return super.visible}set visible(e){super.visible=e}get _previewing(){const{view:e}=this;if(null==e?.allLayerViews)return!0;const{stationary:t,allLayerViews:i,graphicsView:r}=e;return this._forcePreview||!t||i.some(e=>T(e)&&e.updating)||!r?.suspended&&!!r?.updating}get _effectiveUtcOffset(){return this.analysis.utcOffset??this._utcOffsetAuto}get _utcOffsetAuto(){const e=this._referencePosition;return null!=e?y(e[0],!1):0}get _dateUTCOffset(){let e=this.analysis.date;return e=u(e,-e.getTimezoneOffset(),"minutes"),e=u(e,-this._effectiveUtcOffset,"hours"),e}get _startDateTimeUTC(){return u(this._dateUTCOffset,this.analysis.startTimeOfDay)}get _endDateTimeUTC(){return u(this._dateUTCOffset,this.analysis.endTimeOfDay)}get _referencePosition(){return this.view?.environmentManager?.referencePositionGeographic}get _durationInterval(){return this._duration>0?Math.floor(this._duration/(V-1)):V}get _interval(){const e=this._durationInterval;switch(this.analysis.mode){case"threshold":return this._duration>0?e:0;case"duration":return e;case"discrete":return this.analysis.discreteOptions.interval||e}}get _intervalContext(){const{mode:e,thresholdOptions:t}=this.analysis;return"threshold"===e&&t.contextEnabled?t.contextOptions.interval||this._durationInterval:-1}get _durationSampleCount(){return this._lightDirections.length}get _duration(){const{startTimeOfDay:e,endTimeOfDay:t}=this.analysis;return t-e}get _lightDirections(){return this._calculateLightDirections(this._interval)}get _lightDirectionsContext(){return this._calculateLightDirections(this._intervalContext)}_calculateLightDirections(e){const{view:t}=this;if(e<=0)return[];const i="global"===t.viewingMode?z:this._referencePosition;if(null==i)return[];const r=w(this._startDateTimeUTC,this._endDateTimeUTC,e,i,t.state.viewingMode,V),s=r.length;x.length=0;const n=D(0,s,x),o=new Array(s);for(let a=0;a<s;++a)o[a]=r[n[a]];return o}get _visualizationParameters(){if(!this.visible)return null;switch(this.analysis.mode){case"threshold":return this._thresholdVisualizationParameters;case"duration":return this._durationVisualizationParameters;case"discrete":return this._discreteVisualizationParameters}}get _thresholdVisualizationParameters(){const{threshold:e,color:i}=this.analysis.thresholdOptions,r=this._duration;return{visualization:2,thresholdColor:t.toUnitRGBA(i),threshold:r>0?e/this._duration:0,...this._thresholdDiscreteVisualizationParameters}}get _thresholdDiscreteVisualizationParameters(){const{thresholdOptions:e}=this.analysis;return e.contextEnabled?{visualization:3,gradientColor:t.toUnitRGBA(e.contextOptions.color)}:{}}get _durationVisualizationParameters(){const{color:e,mode:i}=this.analysis.durationOptions,r=this._duration,s=r>0&&"hourly"===i?U/r:0,n=t.toUnitRGBA(e);return 0===s?{...this._discreteVisualizationParameters,gradientColor:n}:{bandedGradientColor:n,visualization:1,bandSize:s}}get _discreteVisualizationParameters(){return{gradientColor:t.toUnitRGBA(this.analysis.discreteOptions.color),visualization:0}}get _forcePreviewDependencies(){const{view:e}=this,t=e.slice.plane,r=e.allLayerViews.toArray().filter(T),s=r.map(e=>e.layer).filter(i),n=r.map(e=>e.suspended),o=s.map(e=>e.visible),a=s.map(e=>e.opacity),l=!!e.graphicsView?.suspended,c=s.filter(e=>"definitionExpression"in e).map(e=>e.definitionExpression),d=r.filter(e=>"filter"in e).map(e=>e.filter);return{slicePlane:t,startDateUTC:this._startDateTimeUTC,endDateUTC:this._endDateTimeUTC,layerViewSuspended:n,graphicsViewSuspended:l,layerVisibilities:o,layerOpacities:a,filters:d,definitionExpressions:c}}get _renderer(){return this.view?.stage?.renderer}get testData(){}async getDurationAtScreen(e){const{_renderer:t,_durationSampleCount:i}=this;if(null==t||0===i)return 0;const r=this.view.state.camera.screenToRender(c(e.x,e.y),d());return t.readAccumulatedShadow(r)*this._duration}};e([p({readOnly:!0,type:["shadow-cast-view-3d"]})],P.prototype,"type",void 0),e([p({constructOnly:!0,nonNullable:!0})],P.prototype,"analysis",void 0),e([p({readOnly:!0})],P.prototype,"updating",null),e([p()],P.prototype,"_stopPreviewingTask",void 0),e([p()],P.prototype,"_forcePreview",void 0),e([p()],P.prototype,"_autoRestoreForcePreviewEnabled",void 0),e([p()],P.prototype,"_previewing",null),e([p()],P.prototype,"_effectiveUtcOffset",null),e([p()],P.prototype,"_utcOffsetAuto",null),e([p()],P.prototype,"_dateUTCOffset",null),e([p()],P.prototype,"_startDateTimeUTC",null),e([p()],P.prototype,"_endDateTimeUTC",null),e([p()],P.prototype,"_referencePosition",null),e([p()],P.prototype,"_interval",null),e([p()],P.prototype,"_intervalContext",null),e([p()],P.prototype,"_durationSampleCount",null),e([p()],P.prototype,"_duration",null),e([p()],P.prototype,"_lightDirections",null),e([p()],P.prototype,"_lightDirectionsContext",null),e([p()],P.prototype,"_visualizationParameters",null),e([p()],P.prototype,"_thresholdVisualizationParameters",null),e([p()],P.prototype,"_thresholdDiscreteVisualizationParameters",null),e([p()],P.prototype,"_durationVisualizationParameters",null),e([p()],P.prototype,"_discreteVisualizationParameters",null),e([p()],P.prototype,"_forcePreviewDependencies",null),e([p()],P.prototype,"_renderer",null),P=e([_("esri.views.3d.analysis.ShadowCastAnalysisView3D")],P);const C=P;function b(e,t,i){t&&null!=i&&e?.setParameters({shadowCast:i})}function T(e){if(e.suspended)return!1;switch(e.type){case"building-scene-3d":case"csv-3d":case"elevation-3d":case"feature-3d":case"geojson-3d":case"graphics-3d":case"integrated-mesh-3d":case"integrated-mesh-3dtiles":case"ogc-feature-3d":case"route-3d":case"scene-layer-3d":case"scene-layer-graphics-3d":case"stream-3d":case"wms-3d":case"catalog-footprint-3d":return!0;default:return!1}}const U=h(1,"hours","milliseconds"),O=500,V=255,z=m(),x=[];export{C as default};
+import{__decorate as t}from"tslib";import e from"../../../Color.js";import{isSome as i}from"../../../core/arrayUtils.js";import{createTask as r}from"../../../core/asyncUtils.js";import"../../../core/has.js";import{abortMaybe as s,destroyMaybe as n}from"../../../core/maybe.js";import{after as o,throwIfAborted as a}from"../../../core/promiseUtils.js";import{watch as l,syncAndInitial as u}from"../../../core/reactiveUtils.js";import{createScreenPointArray as c,createRenderScreenPointArray as p}from"../../../core/screenUtils.js";import{offsetDateUTC as h,convertTime as d}from"../../../core/timeUtils.js";import{property as m,subclass as _}from"../../../core/accessorSupport/decorators.js";import{create as v}from"../../../core/libs/gl-matrix-2/factories/vec3f64.js";import{AnalysisView3D as f}from"./AnalysisView3D.js";import{registerAnalysisView as g,hideOtherAnalysisViews as y}from"./ShadowCast/analysisViewRegister.js";import{ShadowCastTooltip as w}from"./ShadowCast/ShadowCastTooltip.js";import{longitudeToTimezone as D}from"../support/earthUtils.js";import{computeDirectionsOverTime as C}from"../support/sunUtils.js";import{breadthFirstBinaryPartitioning as P}from"../../../widgets/support/traversalUtils.js";let b=class extends f{constructor(t){super(t),this.type="shadow-cast-view-3d",this.analysis=null,this._stopPreviewingTask=null,this._forcePreview=!1,this._autoRestoreForcePreviewEnabled=!0,this._tooltip=null}initialize(){this.addHandles([g(this.view,this),l(()=>this._forcePreviewDependencies,()=>{s(this._stopPreviewingTask),this._forcePreview=!0,this._autoRestoreForcePreviewEnabled&&(this._stopPreviewingTask=r(async t=>{await o(x,t),a(t),this._forcePreview=!1}))},u),l(()=>({renderer:this._renderer,visible:this.visible}),({renderer:t,visible:e})=>{e&&y(this.view,this),t?.setParameters({shadowCast:{enabled:e}})},u),l(()=>({renderer:this._renderer,parameters:this._visualizationParameters,visible:this.visible}),({renderer:t,parameters:e,visible:i})=>{U(t,i,e)},u),l(()=>({renderer:this._renderer,lightDirections:this._lightDirections,lightDirectionsContext:this._lightDirectionsContext,visible:this.visible}),({renderer:t,lightDirections:e,lightDirectionsContext:i,visible:r})=>{U(t,r,{lightDirections:e,lightDirectionsContext:i})},u),l(()=>({renderer:this._renderer,previewing:this._previewing,visible:this.visible}),({renderer:t,previewing:e,visible:i})=>{U(t,i,{previewing:e})},u)]),this.interactive=!0,this._tooltip=new w({getDuration:this.getDurationAtScreen.bind(this),isVisible:()=>this.interactive&&this.visible,view:this.view})}destroy(){this.visible&&U(this._renderer,!0,{enabled:!1}),this._tooltip=n(this._tooltip)}get interactive(){return super.interactive}set interactive(t){super.interactive=t}get updating(){return this._previewing||null!=this._stopPreviewingTask&&!this._stopPreviewingTask.finished||!0===this._tooltip?.updating}get visible(){return super.visible}set visible(t){super.visible=t}get _previewing(){const{view:t}=this;if(null==t?.allLayerViews)return!0;const{stationary:e,allLayerViews:i,graphicsView:r}=t;return this._forcePreview||!e||i.some(t=>O(t)&&t.updating)||!r?.suspended&&!!r?.updating}get _effectiveUtcOffset(){return this.analysis.utcOffset??this._utcOffsetAuto}get _utcOffsetAuto(){const t=this._referencePosition;return null!=t?D(t[0],!1):0}get _dateUTCOffset(){let t=this.analysis.date;return t=h(t,-t.getTimezoneOffset(),"minutes"),t=h(t,-this._effectiveUtcOffset,"hours"),t}get _startDateTimeUTC(){return h(this._dateUTCOffset,this.analysis.startTimeOfDay)}get _endDateTimeUTC(){return h(this._dateUTCOffset,this.analysis.endTimeOfDay)}get _referencePosition(){return this.view?.environmentManager?.referencePositionGeographic}get _totalDurationInterval(){return this._totalDuration>0?Math.floor(this._totalDuration/(z-1)):z}get _interval(){const t=this._totalDurationInterval;switch(this.analysis.mode){case"min-duration":return this._totalDuration>0?t:0;case"total-duration":return t;case"discrete":return this.analysis.discreteOptions.interval||t}}get _intervalContext(){const{mode:t,minDurationOptions:e}=this.analysis;return"min-duration"===t&&e.contextEnabled?e.contextOptions.interval||this._totalDurationInterval:-1}get _totalDurationSampleCount(){return this._lightDirections.length}get _totalDuration(){const{startTimeOfDay:t,endTimeOfDay:e}=this.analysis;return e-t}get _lightDirections(){return this._calculateLightDirections(this._interval)}get _lightDirectionsContext(){return this._calculateLightDirections(this._intervalContext)}_calculateLightDirections(t){const{view:e}=this;if(t<=0)return[];const i="global"===e.viewingMode?j:this._referencePosition;if(null==i)return[];const r=C(this._startDateTimeUTC,this._endDateTimeUTC,t,i,e.state.viewingMode,z),s=r.length;A.length=0;const n=P(0,s,A),o=new Array(s);for(let a=0;a<s;++a)o[a]=r[n[a]];return o}get _visualizationParameters(){if(!this.visible)return null;switch(this.analysis.mode){case"min-duration":return this._minDurationVisualizationParameters;case"total-duration":return this._durationVisualizationParameters;case"discrete":return this._discreteVisualizationParameters}}get _minDurationVisualizationParameters(){const{minDuration:t,color:i}=this.analysis.minDurationOptions,r=this._totalDuration;return{visualization:2,thresholdColor:e.toUnitRGBA(i),threshold:r>0?t/this._totalDuration:0,...this._minDurationContextVisualizationParameters}}get _minDurationContextVisualizationParameters(){const{minDurationOptions:t}=this.analysis;return t.contextEnabled?{visualization:3,gradientColor:e.toUnitRGBA(t.contextOptions.color)}:{}}get _durationVisualizationParameters(){const{color:t,mode:i}=this.analysis.totalDurationOptions,r=this._totalDuration,s=r>0&&"hourly"===i?V/r:0,n=e.toUnitRGBA(t);return 0===s?{...this._discreteVisualizationParameters,gradientColor:n}:{bandedGradientColor:n,visualization:1,bandSize:s}}get _discreteVisualizationParameters(){return{gradientColor:e.toUnitRGBA(this.analysis.discreteOptions.color),visualization:0}}get _forcePreviewDependencies(){const{view:t}=this,e=t.slice.plane,r=t.allLayerViews.toArray().filter(O),s=r.map(t=>t.layer).filter(i),n=r.map(t=>t.suspended),o=s.map(t=>t.visible),a=s.map(t=>t.opacity),l=!!t.graphicsView?.suspended,u=s.filter(t=>"definitionExpression"in t).map(t=>t.definitionExpression),c=r.filter(t=>"filter"in t).map(t=>t.filter);return{slicePlane:e,startDateUTC:this._startDateTimeUTC,endDateUTC:this._endDateTimeUTC,layerViewSuspended:n,graphicsViewSuspended:l,layerVisibilities:o,layerOpacities:a,filters:c,definitionExpressions:u}}get _renderer(){return this.view?.stage?.renderer}get testData(){}async getDurationAtScreen(t){const{_renderer:e,_totalDurationSampleCount:i}=this;if(null==e||0===i)return 0;const r=this.view.state.camera.screenToRender(c(t.x,t.y),p());return e.readAccumulatedShadow(r)*this._totalDuration}};t([m({readOnly:!0,type:["shadow-cast-view-3d"]})],b.prototype,"type",void 0),t([m({constructOnly:!0,nonNullable:!0})],b.prototype,"analysis",void 0),t([m({readOnly:!0})],b.prototype,"updating",null),t([m()],b.prototype,"_stopPreviewingTask",void 0),t([m()],b.prototype,"_forcePreview",void 0),t([m()],b.prototype,"_autoRestoreForcePreviewEnabled",void 0),t([m()],b.prototype,"_tooltip",void 0),t([m()],b.prototype,"_previewing",null),t([m()],b.prototype,"_effectiveUtcOffset",null),t([m()],b.prototype,"_utcOffsetAuto",null),t([m()],b.prototype,"_dateUTCOffset",null),t([m()],b.prototype,"_startDateTimeUTC",null),t([m()],b.prototype,"_endDateTimeUTC",null),t([m()],b.prototype,"_referencePosition",null),t([m()],b.prototype,"_interval",null),t([m()],b.prototype,"_intervalContext",null),t([m()],b.prototype,"_totalDurationSampleCount",null),t([m()],b.prototype,"_totalDuration",null),t([m()],b.prototype,"_lightDirections",null),t([m()],b.prototype,"_lightDirectionsContext",null),t([m()],b.prototype,"_visualizationParameters",null),t([m()],b.prototype,"_minDurationVisualizationParameters",null),t([m()],b.prototype,"_minDurationContextVisualizationParameters",null),t([m()],b.prototype,"_durationVisualizationParameters",null),t([m()],b.prototype,"_discreteVisualizationParameters",null),t([m()],b.prototype,"_forcePreviewDependencies",null),t([m()],b.prototype,"_renderer",null),b=t([_("esri.views.3d.analysis.ShadowCastAnalysisView3D")],b);const T=b;function U(t,e,i){e&&null!=i&&t?.setParameters({shadowCast:i})}function O(t){if(t.suspended)return!1;switch(t.type){case"building-scene-3d":case"csv-3d":case"elevation-3d":case"feature-3d":case"geojson-3d":case"graphics-3d":case"integrated-mesh-3d":case"integrated-mesh-3dtiles":case"ogc-feature-3d":case"route-3d":case"scene-layer-3d":case"scene-layer-graphics-3d":case"stream-3d":case"wms-3d":case"catalog-footprint-3d":return!0;default:return!1}}const V=d(1,"hours","milliseconds"),x=500,z=255,j=v(),A=[];export{T as default};

package/views/3d/analysis/Slice/types.d.ts

@@ -1,3 +1,7 @@
-import "../../../../interfaces";
 
-export type SlicePlacementResult = __esri.SliceTypes.SlicePlacementResult;
+/**
+ * Types for the [SliceAnalysisView3D](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-analysis-SliceAnalysisView3D.html).
+ *
+ * @since 5.0
+ */
+export interface SlicePlacementResult {}

package/views/3d/analysis/SliceAnalysisView3D.d.ts

@@ -1,4 +1,120 @@
-import "../../../interfaces";
+import type SliceAnalysis from "../../../analysis/SliceAnalysis.js";
+import type { AbortOptions } from "../../../core/promiseUtils.js";
+import type { AnalysisView3D } from "./AnalysisView3D.js";
+import type { SlicePlacementResult } from "./Slice/types.js";
 
-import SliceAnalysisView3D = __esri.SliceAnalysisView3D;
-export default SliceAnalysisView3D;
+/**
+ * Represents the analysis view of a [SliceAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-SliceAnalysis.html)
+ * after it has been added to [SceneView#analyses](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#analyses).
+ *
+ * The SliceAnalysisView3D is responsible for rendering a [SliceAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-SliceAnalysis.html)
+ * using custom visualizations.
+ *
+ * It allows to create a new slice interactively using the [place()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-analysis-SliceAnalysisView3D.html#place) method,
+ * exclude layers from slicing using the [pickLayerToExclude()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-analysis-SliceAnalysisView3D.html#pickLayerToExclude) method,
+ * or make an existing analysis editable by enabling the [interactive](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-analysis-SliceAnalysisView3D.html#interactive) property.
+ *
+ * While multiple [SliceAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-SliceAnalysis.html) can be added to
+ * [SceneView#analyses](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#analyses), only one [SliceAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-SliceAnalysis.html) can be
+ * actively slicing the scene. The [SliceAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-SliceAnalysis.html) which
+ * is currently actively slicing the scene can be controlled by setting the [active](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-analysis-SliceAnalysisView3D.html#active) property on its analysis view to `true`.
+ *
+ * The view for an analysis can be retrieved using [SceneView#whenAnalysisView()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#whenAnalysisView)
+ * similar to how layer views are retrieved for layers using [SceneView#whenLayerView()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#whenLayerView).
+ *
+ * ```js
+ * // retrieve analysis view for analysis
+ * const sliceAnalysis = new SliceAnalysis();
+ * view.analyses.add(sliceAnalysis); // add to the scene view
+ * const sliceAnalysisView = await view.whenAnalysisView(sliceAnalysis);
+ * ```
+ *
+ * @see [SliceAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-SliceAnalysis.html)
+ * @see [SlicePlane](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-SlicePlane.html)
+ * @see [Slice component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-slice/)
+ * @see [Sample - Analysis objects](https://developers.arcgis.com/javascript/latest/sample-code/analysis-objects/)
+ */
+export default abstract class SliceAnalysisView3D extends AnalysisView3D {
+  /**
+   * Only one [SliceAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-SliceAnalysis.html) at a time can be active in a [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html).
+   * When a slice analysis view is activated by setting this property to `true`, all other slice analysis views are automatically deactivated.
+   *
+   * @default true
+   */
+  accessor active: boolean;
+  /**
+   * The slice analysis object associated with the analysis view.
+   *
+   * @since 4.24
+   */
+  get analysis(): SliceAnalysis;
+  /**
+   * Enables interactivity for the associated [analysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-analysis-SliceAnalysisView3D.html#analysis). When set to `true`, manipulators will be displayed,
+   * allowing users to click and drag to edit the analysis if it has a valid
+   * [SliceAnalysis#shape](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-SliceAnalysis.html#shape).
+   *
+   * This property is automatically set to `true` when the analysis is assigned to a
+   * [Slice component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-slice/).
+   *
+   * @default false
+   * @since 4.24
+   */
+  accessor interactive: boolean;
+  /** @since 4.24 */
+  get type(): "slice-view-3d";
+  /**
+   * When `true`, the analysis is visualized in the view.
+   *
+   * @since 4.24
+   */
+  get visible(): boolean;
+  set visible(value: boolean | null | undefined);
+  /**
+   * Starts an interactive operation to pick a layer to exclude from the slice analysis.
+   *
+   * If the user clicks on the ground, the
+   * [SliceAnalysis#excludeGroundSurface](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-SliceAnalysis.html#excludeGroundSurface) property is set to `true`.
+   * Otherwise, the clicked layer is added to the
+   * [SliceAnalysis#excludedLayers](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-SliceAnalysis.html#excludedLayers).
+   *
+   * This method can only be called when the analysis has a valid shape. Otherwise, an error is thrown.
+   * Calling this method sets [interactive](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-analysis-SliceAnalysisView3D.html#interactive) and [active](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-analysis-SliceAnalysisView3D.html#active) to `true`.
+   *
+   * @param options - An object specifying additional options.
+   * @returns A promise which resolves when the operation is completed successfully or rejected if it is
+   * canceled.
+   * @since 4.33
+   */
+  pickLayerToExclude(options?: AbortOptions | null | undefined): Promise<void>;
+  /**
+   * Starts the interactive placement of a slice plane.
+   *
+   * If the analysis does not have a [SliceAnalysis#shape](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-SliceAnalysis.html#shape) yet, the method allows
+   * placing the slice plane interactively in the view. If the analysis already has a shape, clicking in the view will
+   * replace the existing shape with a new one.
+   *
+   * The placement operation will finish when the user presses the escape key.
+   * To stop the placing programmatically, pass an abort signal as an argument when calling the method.
+   *
+   * Calling this method sets [interactive](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-analysis-SliceAnalysisView3D.html#interactive) and [active](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-analysis-SliceAnalysisView3D.html#active) to `true`.
+   *
+   * @param options - An object specifying additional options.
+   * @returns A promise which resolves
+   * when the operation is completed successfully or rejected if it is canceled.
+   * @since 4.33
+   * @example
+   * const abortController = new AbortController();
+   *
+   * try {
+   *   await analysisView.place({ signal: abortController.signal });
+   * } catch (error) {
+   *   if (error.name === "AbortError") {
+   *     console.log("Placement operation was cancelled.");
+   *   }
+   * }
+   *
+   * // cancel the placement operation at some later point
+   * abortController.abort();
+   */
+  place(options?: AbortOptions | null | undefined): Promise<SlicePlacementResult>;
+}

package/views/3d/analysis/Viewshed/types.d.ts

@@ -1,3 +1,7 @@
-import "../../../../interfaces";
 
-export type ViewshedPlacementResult = __esri.ViewshedTypes.ViewshedPlacementResult;
+/**
+ * Types for the [ViewshedAnalysisView3D](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-analysis-ViewshedAnalysisView3D.html).
+ *
+ * @since 5.0
+ */
+export interface ViewshedPlacementResult {}

package/views/3d/analysis/ViewshedAnalysisView3D.d.ts

@@ -1,4 +1,130 @@
-import "../../../interfaces";
+import type Viewshed from "../../../analysis/Viewshed.js";
+import type ViewshedAnalysis from "../../../analysis/ViewshedAnalysis.js";
+import type { AbortOptions } from "../../../core/promiseUtils.js";
+import type { AnalysisView3D } from "./AnalysisView3D.js";
+import type { ViewshedPlacementResult } from "./Viewshed/types.js";
 
-import ViewshedAnalysisView3D = __esri.ViewshedAnalysisView3D;
-export default ViewshedAnalysisView3D;
+/**
+ * Represents the analysis view of a [ViewshedAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ViewshedAnalysis.html)
+ * after it has been added to [SceneView#analyses](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#analyses).
+ *
+ * The ViewshedAnalysisView3D is responsible for rendering a [ViewshedAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ViewshedAnalysis.html)
+ * using custom visualizations.
+ *
+ * It allows to create new viewsheds interactively using the [place()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-analysis-ViewshedAnalysisView3D.html#place) method,
+ * or to make existing viewsheds selectable and editable by enabling the [interactive](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-analysis-ViewshedAnalysisView3D.html#interactive) property.
+ * To select a viewshed, hover and click on its field-of-view manipulators.
+ *
+ * The view for an analysis can be retrieved using [SceneView#whenAnalysisView()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#whenAnalysisView)
+ * similar to how layer views are retrieved for layers using [SceneView#whenLayerView()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#whenLayerView).
+ *
+ * ```js
+ * // create new analysis and add it to the view
+ * const viewshedAnalysis = new ViewshedAnalysis();
+ * view.analyses.add(viewshedAnalysis);
+ *
+ * // retrieve analysis view
+ * const viewshedAnalysisView = await view.whenAnalysisView(viewshedAnalysis);
+ * ```
+ *
+ * @since 4.30
+ * @see [ViewshedAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ViewshedAnalysis.html)
+ * @see [Viewshed](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-Viewshed.html)
+ * @see [ViewshedLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-ViewshedLayer.html)
+ * @see [ViewshedLayerView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-layers-ViewshedLayerView.html)
+ * @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/)
+ */
+export default abstract class ViewshedAnalysisView3D extends AnalysisView3D {
+  /** The viewshed analysis object associated with the analysis view. */
+  get analysis(): ViewshedAnalysis;
+  /**
+   * Enables interactivity for the [analysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-analysis-ViewshedAnalysisView3D.html#analysis). When set to `true` and the analysis includes any
+   * valid [ViewshedAnalysis#viewsheds](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ViewshedAnalysis.html#viewsheds), they become selectable and editable.
+   *
+   * @default false
+   */
+  accessor interactive: boolean;
+  /**
+   * The selected viewshed. If [interactive](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-analysis-ViewshedAnalysisView3D.html#interactive) is `true`, any viewshed in the
+   * [analysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-analysis-ViewshedAnalysisView3D.html#analysis) can be selected by clicking on it in the view. As long as [interactive](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-analysis-ViewshedAnalysisView3D.html#interactive)
+   * remains `true`, the properties of the selected viewshed can be edited by interacting with
+   * manipulators in the view.
+   */
+  accessor selectedViewshed: Viewshed | null | undefined;
+  /** The analysis view type. */
+  get type(): "viewshed-view-3d";
+  /** When `true`, the [analysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-analysis-ViewshedAnalysisView3D.html#analysis) is visualized in the view. */
+  get visible(): boolean;
+  set visible(value: boolean | null | undefined);
+  /**
+   * Starts the interactive creation of new viewsheds and adds them to the [analysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-analysis-ViewshedAnalysisView3D.html#analysis).
+   *
+   * The first click in the scene places the observer point and the second sets the viewshed's orientation and distance.
+   *
+   * The creation process will finish when the user double-clicks the mouse or presses the escape key.
+   * To stop the creation programmatically, pass an abort signal as an argument when calling the method.
+   *
+   * This method is similar to the [place()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-analysis-ViewshedAnalysisView3D.html#place) method, but it allows to create multiple viewsheds in a row.
+   *
+   * Calling this method sets [interactive](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-analysis-ViewshedAnalysisView3D.html#interactive) to `true`.
+   *
+   * > [!WARNING]
+   * >
+   * > Note that when placing viewsheds interactively, the viewshed is created with a 1.5 meter vertical offset from the scene.
+   * > _This behavior is subject to change in a future release._
+   *
+   * @param options - An object specifying additional options.
+   * @returns A promise which resolves when creation is completed successfully or rejected if it is
+   * canceled.
+   * @example
+   * const abortController = new AbortController();
+   *
+   * try {
+   *   await viewshedAnalysisView.createViewsheds({ signal: abortController.signal });
+   * } catch (error) {
+   *   if (error.name === "AbortError") {
+   *     console.log("Creation operation was cancelled.");
+   *   }
+   * }
+   *
+   * // cancel the placement operation at some later point
+   * abortController.abort();
+   */
+  createViewsheds(options?: AbortOptions | null | undefined): Promise<void>;
+  /**
+   * Starts the interactive placement of a single viewshed, adding it to the [analysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-analysis-ViewshedAnalysisView3D.html#analysis).
+   *
+   * The first click in the scene places the observer point and the second sets the viewshed's orientation.
+   *
+   * The placement operation will finish when the user presses the escape key.
+   * To stop the placing programmatically, pass an abort signal as an argument when calling the method.
+   *
+   * Calling this method sets [interactive](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-analysis-ViewshedAnalysisView3D.html#interactive) to `true`.
+   *
+   * > [!WARNING]
+   * >
+   * > Note that when placing viewsheds interactively, the viewshed is created with a 1.5 meter vertical offset from the scene.
+   * > _This behavior is subject to change in a future release._
+   *
+   * @param options - An object specifying additional options.
+   * @returns A promise which
+   * resolves when the operation is completed successfully or rejected if it is canceled.
+   * @since 4.33
+   * @example
+   * const abortController = new AbortController();
+   *
+   * try {
+   *   await analysisView.place({ signal: abortController.signal });
+   * } catch (error) {
+   *   if (error.name === "AbortError") {
+   *     console.log("Placement operation was cancelled.");
+   *   }
+   * }
+   *
+   * // cancel the placement operation at some later point
+   * abortController.abort();
+   */
+  place(options?: AbortOptions | null | undefined): Promise<ViewshedPlacementResult>;
+}

package/views/3d/analysis/VolumeMeasurement/VolumeMeasurementError.d.ts

@@ -1,4 +1,37 @@
-import "../../../../interfaces";
+import type Error from "../../../../core/Error.js";
 
-import VolumeMeasurementError = __esri.VolumeMeasurementError;
-export default VolumeMeasurementError;
+/** The volume measurement error name. */
+export type VolumeMeasurementErrorName = "distance-too-far" | "distance-too-close" | "perimeter-too-large" | "unsupported-coordinate-system" | "unsupported-layer-transparency" | "unknown";
+
+/**
+ * VolumeMeasurementError is an error class for reporting errors in a [VolumeMeasurementAnalysisView3D#result](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-analysis-VolumeMeasurementAnalysisView3D.html#result).
+ *
+ * The following error names are defined:
+ *
+ * - "distance-too-far": The view point is too far away from the volume measurement, making the measurement inaccurate.
+ * - "distance-too-close": The view point is too close to the volume measurement, making the measurement inaccurate.
+ * - "perimeter-too-large": The input geometry's perimeter is too large for the current coordinate system.
+ * - "unsupported-coordinate-system": The coordinate system of the view (viewing mode and spatial reference) is not supported.
+ * - "unsupported-layer-transparency": The volume measurement analysis does not support transparent layers.
+ * - "unknown": An unknown error occurred.
+ *
+ * @beta
+ * @since 4.34
+ * @see [VolumeMeasurementAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-VolumeMeasurementAnalysis.html)
+ * @see [VolumeMeasurementAnalysisView3D](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-analysis-VolumeMeasurementAnalysisView3D.html)
+ * @see [Sample - Volume measurement analysis object](https://developers.arcgis.com/javascript/latest/sample-code/analysis-volume-measurement/)
+ */
+export default class VolumeMeasurementError<T = any> extends Error {
+  constructor(name: VolumeMeasurementErrorName, message: string, details?: T);
+  /**
+   * The name of the volume measurement error.
+   *
+   * @default "unknown"
+   * @example
+   * someAsyncFunction.then(callback)
+   *   .catch(function(error){
+   *     console.log("Error name: ", error.name);
+   * });
+   */
+  name: VolumeMeasurementErrorName;
+}