@arcgis/core 5.1.0-next.77 → 5.1.0-next.79

package/analysis/ElevationProfile/ElevationProfileGroup.d.ts

@@ -0,0 +1,74 @@
+import type Accessor from "../../core/Accessor.js";
+import type Collection from "../../core/Collection.js";
+import type { ElevationProfileLineUnion } from "./types.js";
+import type { ReadonlyArrayOrCollection } from "../../core/Collection.js";
+import type { ElevationProfileLineSceneProperties } from "./ElevationProfileLineScene.js";
+import type { ElevationProfileLineQueryProperties } from "./ElevationProfileLineQuery.js";
+import type { ElevationProfileLineInputProperties } from "./ElevationProfileLineInput.js";
+import type { ElevationProfileLineGroundProperties } from "./ElevationProfileLineGround.js";
+
+/** @since 5.1 */
+export interface ElevationProfileGroupProperties extends Partial<Pick<ElevationProfileGroup, "id" | "title">> {
+  /**
+   * The collection of [profile lines](https://developers.arcgis.com/javascript/latest/references/core/analysis/ElevationProfile/ElevationProfileLine/) that belong to this group.
+   *
+   * Each line defines a source for sampling elevation along the analysis geometry and is computed independently.
+   * The group itself is used for organization and does not produce a separate result line.
+   *
+   * Each line in the group will be included in both the [ElevationProfileAnalysisView2D.results](https://developers.arcgis.com/javascript/latest/references/core/views/2d/analysis/ElevationProfileAnalysisView2D/#results)
+   * and [ElevationProfileAnalysisView3D.results](https://developers.arcgis.com/javascript/latest/references/core/views/3d/analysis/ElevationProfileAnalysisView3D/#results) array of the analysis view, but the group will
+   * not have a corresponding result entry.
+   *
+   * @since 5.1
+   */
+  profiles?: ReadonlyArrayOrCollection<((ElevationProfileLineGroundProperties & { type: "ground" }) | (ElevationProfileLineInputProperties & { type: "input" }) | (ElevationProfileLineQueryProperties & { type: "query" }) | (ElevationProfileLineSceneProperties & { type: "scene" }))> | null;
+}
+
+/**
+ * Represents a logical container that organizes multiple profile lines.
+ *
+ * The group itself is not computed directly as a profile line. Instead, each individual line within
+ * [profiles](https://developers.arcgis.com/javascript/latest/references/core/analysis/ElevationProfile/ElevationProfileGroup/#profiles) is computed independently, with the resulting data
+ * exposed through the [ElevationProfileAnalysisView2D.results](https://developers.arcgis.com/javascript/latest/references/core/views/2d/analysis/ElevationProfileAnalysisView2D/#results) and
+ * [ElevationProfileAnalysisView3D.results](https://developers.arcgis.com/javascript/latest/references/core/views/3d/analysis/ElevationProfileAnalysisView3D/#results) properties.
+ *
+ * When using the
+ * [Elevation Profile component](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-elevation-profile/),
+ * the group serves to consolidate these profile lines under a single entry in the legend for better
+ * organization.
+ *
+ * @since 5.1
+ * @see [ElevationProfileAnalysis](https://developers.arcgis.com/javascript/latest/references/core/analysis/ElevationProfileAnalysis/)
+ * @see [ElevationProfileLine](https://developers.arcgis.com/javascript/latest/references/core/analysis/ElevationProfile/ElevationProfileLine/)
+ */
+export default class ElevationProfileGroup extends Accessor {
+  /** @since 5.1 */
+  constructor(properties?: ElevationProfileGroupProperties);
+  /**
+   * Unique identifier for the profile group. This value is automatically generated unless specified.
+   *
+   * @since 5.1
+   */
+  accessor id: string;
+  /**
+   * The collection of [profile lines](https://developers.arcgis.com/javascript/latest/references/core/analysis/ElevationProfile/ElevationProfileLine/) that belong to this group.
+   *
+   * Each line defines a source for sampling elevation along the analysis geometry and is computed independently.
+   * The group itself is used for organization and does not produce a separate result line.
+   *
+   * Each line in the group will be included in both the [ElevationProfileAnalysisView2D.results](https://developers.arcgis.com/javascript/latest/references/core/views/2d/analysis/ElevationProfileAnalysisView2D/#results)
+   * and [ElevationProfileAnalysisView3D.results](https://developers.arcgis.com/javascript/latest/references/core/views/3d/analysis/ElevationProfileAnalysisView3D/#results) array of the analysis view, but the group will
+   * not have a corresponding result entry.
+   *
+   * @since 5.1
+   */
+  get profiles(): Collection<ElevationProfileLineUnion>;
+  set profiles(value: ReadonlyArrayOrCollection<((ElevationProfileLineGroundProperties & { type: "ground" }) | (ElevationProfileLineInputProperties & { type: "input" }) | (ElevationProfileLineQueryProperties & { type: "query" }) | (ElevationProfileLineSceneProperties & { type: "scene" }))> | null | undefined);
+  /**
+   * Title of the group, shown in the chart legend.
+   *
+   * @since 5.1
+   */
+  accessor title: string | null | undefined;
+  readonly type: "group";
+}

package/analysis/ElevationProfile/ElevationProfileGroup.js

@@ -0,0 +1,2 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
+import{__decorate as o}from"tslib";import e from"./ElevationProfileLine.js";import r from"./ElevationProfileLineGround.js";import t from"./ElevationProfileLineInput.js";import i from"./ElevationProfileLineQuery.js";import s from"./ElevationProfileLineScene.js";import l from"../../core/Accessor.js";import{equals as p}from"../../core/arrayUtils.js";import n from"../../core/Collection.js";import{referenceSetter as f}from"../../core/collectionUtils.js";import{generateUUID as a}from"../../core/uuid.js";import{property as m,subclass as c}from"../../core/accessorSupport/decorators.js";var u;const y={base:e,key:"type",typeMap:{ground:r,input:t,query:i,scene:s},errorContext:"elevation-profile-line"},j=n.ofType(y);let v=u=class extends l{constructor(o){super(o),this.type="group",this.id=a(),this.title=null,o?.profiles||(this.profiles=new n)}get profiles(){return this._get("profiles")}set profiles(o){const e=this._get("profiles"),r=o??new n;this._set("profiles",f(r,e))}equals(o){return this===o||o instanceof u&&(this.title===o.title&&p(this.profiles.toArray(),o.profiles.toArray(),(o,e)=>o.equals(e)))}};o([m({nonNullable:!0})],v.prototype,"id",void 0),o([m({type:j,nonNullable:!0})],v.prototype,"profiles",null),o([m()],v.prototype,"title",void 0),v=u=o([c("esri.analysis.ElevationProfile.ElevationProfileGroup")],v);const d=v;export{d as default};

package/analysis/ElevationProfileAnalysis.d.ts

@@ -1,6 +1,7 @@
 import type Graphic from "../Graphic.js";
 import type Analysis from "./Analysis.js";
 import type ElevationProfileDisplayUnits from "./ElevationProfile/ElevationProfileDisplayUnits.js";
+import type ElevationProfileGroup from "./ElevationProfile/ElevationProfileGroup.js";
 import type ElevationProfileViewOptions from "./ElevationProfile/ElevationProfileViewOptions.js";
 import type Collection from "../core/Collection.js";
 import type Polyline from "../geometry/Polyline.js";
@@ -9,13 +10,14 @@ import type { AnalysisProperties } from "./Analysis.js";
 import type { ElevationProfileDisplayUnitsProperties } from "./ElevationProfile/ElevationProfileDisplayUnits.js";
 import type { ElevationProfileViewOptionsProperties } from "./ElevationProfile/ElevationProfileViewOptions.js";
 import type { ElevationProfileLineUnion } from "./ElevationProfile/types.js";
+import type { ReadonlyArrayOrCollection } from "../core/Collection.js";
 import type { ElevationInfoProperties } from "../symbols/support/ElevationInfo.js";
 import type { PolylineProperties } from "../geometry/Polyline.js";
+import type { ElevationProfileGroupProperties } from "./ElevationProfile/ElevationProfileGroup.js";
 import type { ElevationProfileLineSceneProperties } from "./ElevationProfile/ElevationProfileLineScene.js";
 import type { ElevationProfileLineQueryProperties } from "./ElevationProfile/ElevationProfileLineQuery.js";
 import type { ElevationProfileLineInputProperties } from "./ElevationProfile/ElevationProfileLineInput.js";
 import type { ElevationProfileLineGroundProperties } from "./ElevationProfile/ElevationProfileLineGround.js";
-import type { ReadonlyArrayOrCollection } from "../core/Collection.js";
 
 export interface ElevationProfileAnalysisProperties extends AnalysisProperties {
   /**
@@ -35,25 +37,32 @@ export interface ElevationProfileAnalysisProperties extends AnalysisProperties {
   /** The [Polyline](https://developers.arcgis.com/javascript/latest/references/core/geometry/Polyline/) along which elevation is to be sampled. */
   geometry?: PolylineProperties | null;
   /**
-   * The collection of profile lines to compute and display. Each profile line defines a different source for sampling
-   * elevation along the input geometry (such as ground, input geometry itself, custom elevation sources, or scene
-   * content), and includes settings for how the resulting line will appear in charts and in the view.
+   * The collection of profiles to compute and display.
+   *
+   * A profile can be either:
+   *
+   * * An [ElevationProfileLine](https://developers.arcgis.com/javascript/latest/references/core/analysis/ElevationProfile/ElevationProfileLine/) that defines a source for sampling elevation
+   * along the input geometry (such as ground, input geometry itself, custom elevation sources, or scene content),
+   * and includes settings for how the resulting line will appear in charts and in the view.
+   * * An [ElevationProfileGroup](https://developers.arcgis.com/javascript/latest/references/core/analysis/ElevationProfile/ElevationProfileGroup/) that organizes multiple profile lines under a single
+   * logical container, represented as a single legend entry.
    *
    * In a [MapView](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/), [ElevationProfileLineScene](https://developers.arcgis.com/javascript/latest/references/core/analysis/ElevationProfile/ElevationProfileLineScene/) is
    * not supported.
    */
-  profiles?: ReadonlyArrayOrCollection<((ElevationProfileLineGroundProperties & { type: "ground" }) | (ElevationProfileLineInputProperties & { type: "input" }) | (ElevationProfileLineQueryProperties & { type: "query" }) | (ElevationProfileLineSceneProperties & { type: "scene" }))> | null;
+  profiles?: ReadonlyArrayOrCollection<((ElevationProfileLineGroundProperties & { type: "ground" }) | (ElevationProfileLineInputProperties & { type: "input" }) | (ElevationProfileLineQueryProperties & { type: "query" }) | (ElevationProfileLineSceneProperties & { type: "scene" })) | (ElevationProfileGroupProperties & { type: "group" })> | null;
   /** Configuration options for visualizing an elevation profile within a view. */
   viewOptions?: ElevationProfileViewOptionsProperties;
 }
 
 /**
- * The `ElevationProfileAnalysis` class enables programmatic creation and management of elevation profiles in both,
+ * The `ElevationProfileAnalysis` class enables programmatic creation and management of elevation profiles in both
  * a [SceneView](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/) and a [MapView](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/). An elevation profile visualizes elevation
  * changes along a specified [Polyline](https://developers.arcgis.com/javascript/latest/references/core/geometry/Polyline/), which is provided via the [geometry](https://developers.arcgis.com/javascript/latest/references/core/analysis/ElevationProfileAnalysis/#geometry) property.
  *
- * This analysis supports multiple profile lines, each representing a different source or method for sampling elevation,
- * such as ground, input geometry, custom elevation sources, or scene content. The configuration of these lines is managed
+ * This analysis supports multiple profiles, each representing a different source or method for sampling elevation.
+ * A profile can be a line (such as ground, input geometry, custom elevation sources, or scene content)
+ * or a [group](https://developers.arcgis.com/javascript/latest/references/core/analysis/ElevationProfile/ElevationProfileGroup/). The configuration of these profiles is managed
  * through the [profiles](https://developers.arcgis.com/javascript/latest/references/core/analysis/ElevationProfileAnalysis/#profiles) property.
  *
  * To add an elevation profile analysis to a view:
@@ -79,7 +88,7 @@ export interface ElevationProfileAnalysisProperties extends AnalysisProperties {
  *
  * Use the [ElevationProfileAnalysisView2D](https://developers.arcgis.com/javascript/latest/references/core/views/2d/analysis/ElevationProfileAnalysisView2D/) or
  * [ElevationProfileAnalysisView3D](https://developers.arcgis.com/javascript/latest/references/core/views/3d/analysis/ElevationProfileAnalysisView3D/) to retrieve the analysis results.
- * The combined statistics, as well as results for each computed profile line, can be then visualized in a custom chart using any charting library,
+ * The combined statistics, as well as results for each computed profile line, can then be visualized in a custom chart using any charting library,
  * embedded in a dashboard, exported as a CSV file, or used for further calculations.
  *
  * ```js
@@ -156,15 +165,21 @@ export default class ElevationProfileAnalysis extends Analysis {
   get geometry(): Polyline | null | undefined;
   set geometry(value: PolylineProperties | null | undefined);
   /**
-   * The collection of profile lines to compute and display. Each profile line defines a different source for sampling
-   * elevation along the input geometry (such as ground, input geometry itself, custom elevation sources, or scene
-   * content), and includes settings for how the resulting line will appear in charts and in the view.
+   * The collection of profiles to compute and display.
+   *
+   * A profile can be either:
+   *
+   * * An [ElevationProfileLine](https://developers.arcgis.com/javascript/latest/references/core/analysis/ElevationProfile/ElevationProfileLine/) that defines a source for sampling elevation
+   * along the input geometry (such as ground, input geometry itself, custom elevation sources, or scene content),
+   * and includes settings for how the resulting line will appear in charts and in the view.
+   * * An [ElevationProfileGroup](https://developers.arcgis.com/javascript/latest/references/core/analysis/ElevationProfile/ElevationProfileGroup/) that organizes multiple profile lines under a single
+   * logical container, represented as a single legend entry.
    *
    * In a [MapView](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/), [ElevationProfileLineScene](https://developers.arcgis.com/javascript/latest/references/core/analysis/ElevationProfile/ElevationProfileLineScene/) is
    * not supported.
    */
-  get profiles(): Collection<ElevationProfileLineUnion>;
-  set profiles(value: ReadonlyArrayOrCollection<((ElevationProfileLineGroundProperties & { type: "ground" }) | (ElevationProfileLineInputProperties & { type: "input" }) | (ElevationProfileLineQueryProperties & { type: "query" }) | (ElevationProfileLineSceneProperties & { type: "scene" }))> | null | undefined);
+  get profiles(): Collection<ElevationProfileLineUnion | ElevationProfileGroup>;
+  set profiles(value: ReadonlyArrayOrCollection<((ElevationProfileLineGroundProperties & { type: "ground" }) | (ElevationProfileLineInputProperties & { type: "input" }) | (ElevationProfileLineQueryProperties & { type: "query" }) | (ElevationProfileLineSceneProperties & { type: "scene" })) | (ElevationProfileGroupProperties & { type: "group" })> | null | undefined);
   /** The analysis type. */
   get type(): "elevation-profile";
   /**

package/analysis/ElevationProfileAnalysis.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
-import{__decorate as e}from"tslib";import o from"./Analysis.js";import t from"./ElevationProfile/ElevationProfileDisplayUnits.js";import i from"./ElevationProfile/ElevationProfileLineGround.js";import{ElevationProfileLineCollection as r}from"./ElevationProfile/elevationProfileLineTypes.js";import s from"./ElevationProfile/ElevationProfileViewOptions.js";import{equals as l}from"../core/arrayUtils.js";import n from"../core/Collection.js";import{referenceSetter as a}from"../core/collectionUtils.js";import p from"../core/Logger.js";import{equalsMaybe as f}from"../core/maybe.js";import{property as m,subclass as y}from"../core/accessorSupport/decorators.js";import v from"../geometry/Polyline.js";import{geometryEquals as h}from"../layers/graphics/dehydratedFeatureComparison.js";import{getGraphicEffectiveElevationInfo as u}from"../support/elevationInfoUtils.js";import g from"../symbols/support/ElevationInfo.js";import{isValidInputPath as c}from"../views/analysis/ElevationProfile/elevationProfileGeometryUtils.js";let d=class extends o{constructor(e){super(e),this.type="elevation-profile",this.geometry=null,this.displayUnits=new t,this.viewOptions=new s,e?.profiles||(this.profiles=new n([new i]))}initialize(){const e=e=>!e?.declaredClass?.startsWith("esri.widgets.ElevationProfile")||(p.getLogger(this).errorOnce("Classes from the 'esri/widgets/ElevationProfile' namespace are meant for use with the Elevation Profile widget and are not supported in the 'profiles' collection of the ElevationProfileAnalysis. Use classes from 'esri/analysis/ElevationProfile' instead."),!1);this.profiles.on("before-changes",o=>{e(o.item)||o.preventDefault()});for(const o of Array.from(this.profiles))e(o)||this.profiles.remove(o)}get elevationInfo(){return this._get("elevationInfo")}set elevationInfo(e){this._set("elevationInfo",e)}get profiles(){return this._get("profiles")}set profiles(e){const o=this._get("profiles"),t=e??new n;this._set("profiles",a(t,o))}get valid(){return c(this.geometry)}equals(e){return this===e||super.equals(e)&&h(this.geometry,e.geometry)&&f(this.elevationInfo,e.elevationInfo)&&l(this.profiles.toArray(),e.profiles.toArray(),(e,o)=>e.equals(o))&&this.displayUnits.equals(e.displayUnits)&&this.viewOptions.equals(e.viewOptions)}clear(){this.geometry=null,this.elevationInfo=null}setGeometryFromFeature(e){e.geometry&&"polyline"===e.geometry.type?(this.geometry=e.geometry,this.elevationInfo=new g({...u(e)})):p.getLogger(this).errorOnce("The feature's geometry must be a polyline to set it as the geometry of the ElevationProfileAnalysis.")}};e([m({type:["elevation-profile"]})],d.prototype,"type",void 0),e([m({type:v})],d.prototype,"geometry",void 0),e([m({type:g})],d.prototype,"elevationInfo",null),e([m({type:r,nonNullable:!0})],d.prototype,"profiles",null),e([m({type:t,nonNullable:!0})],d.prototype,"displayUnits",void 0),e([m()],d.prototype,"valid",null),e([m({type:s,nonNullable:!0})],d.prototype,"viewOptions",void 0),d=e([y("esri.analysis.ElevationProfileAnalysis")],d);const P=d;export{P as default};
+import{__decorate as e}from"tslib";import o from"./Analysis.js";import t from"./ElevationProfile/ElevationProfileDisplayUnits.js";import i from"./ElevationProfile/ElevationProfileGroup.js";import r from"./ElevationProfile/ElevationProfileLineGround.js";import s from"./ElevationProfile/ElevationProfileLineInput.js";import l from"./ElevationProfile/ElevationProfileLineQuery.js";import n from"./ElevationProfile/ElevationProfileLineScene.js";import a from"./ElevationProfile/ElevationProfileViewOptions.js";import p from"../core/Accessor.js";import{equals as f}from"../core/arrayUtils.js";import m from"../core/Collection.js";import{referenceSetter as y}from"../core/collectionUtils.js";import v from"../core/Logger.js";import{equalsMaybe as u}from"../core/maybe.js";import{property as h,subclass as c}from"../core/accessorSupport/decorators.js";import g from"../geometry/Polyline.js";import{geometryEquals as d}from"../layers/graphics/dehydratedFeatureComparison.js";import{getGraphicEffectiveElevationInfo as P}from"../support/elevationInfoUtils.js";import E from"../symbols/support/ElevationInfo.js";import{isValidInputPath as j}from"../views/analysis/ElevationProfile/elevationProfileGeometryUtils.js";const w={base:p,key:"type",typeMap:{ground:r,input:s,query:l,scene:n,group:i},errorContext:"elevation-profile-line"},I=m.ofType(w);let U=class extends o{constructor(e){super(e),this.type="elevation-profile",this.geometry=null,this.displayUnits=new t,this.viewOptions=new a,e?.profiles||(this.profiles=new m([new r]))}initialize(){const e=e=>!e?.declaredClass?.startsWith("esri.widgets.ElevationProfile")||(v.getLogger(this).errorOnce("Classes from the 'esri/widgets/ElevationProfile' namespace are meant for use with the Elevation Profile widget and are not supported in the 'profiles' collection of the ElevationProfileAnalysis. Use classes from 'esri/analysis/ElevationProfile' instead."),!1);this.profiles.on("before-changes",o=>{e(o.item)||o.preventDefault()});for(const o of Array.from(this.profiles))e(o)||this.profiles.remove(o)}get elevationInfo(){return this._get("elevationInfo")}set elevationInfo(e){this._set("elevationInfo",e)}get profiles(){return this._get("profiles")}set profiles(e){const o=this._get("profiles"),t=e??new m;this._set("profiles",y(t,o))}get valid(){return j(this.geometry)}equals(e){return this===e||super.equals(e)&&d(this.geometry,e.geometry)&&u(this.elevationInfo,e.elevationInfo)&&f(this.profiles.toArray(),e.profiles.toArray(),(e,o)=>e.equals(o))&&this.displayUnits.equals(e.displayUnits)&&this.viewOptions.equals(e.viewOptions)}clear(){this.geometry=null,this.elevationInfo=null}setGeometryFromFeature(e){e.geometry&&"polyline"===e.geometry.type?(this.geometry=e.geometry,this.elevationInfo=new E({...P(e)})):v.getLogger(this).errorOnce("The feature's geometry must be a polyline to set it as the geometry of the ElevationProfileAnalysis.")}};e([h({type:["elevation-profile"]})],U.prototype,"type",void 0),e([h({type:g})],U.prototype,"geometry",void 0),e([h({type:E})],U.prototype,"elevationInfo",null),e([h({type:I,nonNullable:!0})],U.prototype,"profiles",null),e([h({type:t,nonNullable:!0})],U.prototype,"displayUnits",void 0),e([h()],U.prototype,"valid",null),e([h({type:a,nonNullable:!0})],U.prototype,"viewOptions",void 0),U=e([c("esri.analysis.ElevationProfileAnalysis")],U);const b=U;export{b as default};

package/analysis/ShadowCast/DiscreteOptions.d.ts

@@ -1,18 +1,32 @@
 import type Color from "../../Color.js";
+import type ColorStop from "../../renderers/visualVariables/support/ColorStop.js";
 import type { ColorLike } from "../../Color.js";
 import type { Clonable } from "../../core/Clonable.js";
+import type { ColorStopProperties } from "../../renderers/visualVariables/support/ColorStop.js";
 
 /** @since 5.0 */
 export interface DiscreteOptionsProperties extends Partial<Pick<DiscreteOptions, "interval">> {
   /**
-   * Color of the shadow visualization. The opacity of the visualization is mapped to the number of overlapping
-   * shadows. No shadow corresponds to opacity 0 and maximum number of shadows corresponds to the opacity set in this
-   * color value.
+   * Defines the color used by the default color ramp for the visualization. The opacity is mapped to the number of
+   * overlapping shadows. Areas without shadow are displayed with zero opacity and areas with the maximum number of
+   * overlapping shadows are displayed with the opacity specified in this color.
+   *
+   * When [colorStops](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCast/DiscreteOptions/#colorStops) is not specified, the visualization uses a default ramp between transparent and this color. When specified, those stops are used instead.
    *
    * @default [50, 50, 50, 0.7]
    * @since 5.0
    */
   color?: ColorLike;
+  /**
+   * The color stops for the visualization.
+   *
+   * - Each stop defines a color and the corresponding number of overlapping shadows.
+   * - Colors are interpolated between adjacent stops.
+   * - If omitted, the visualization uses a default ramp between transparent and [color](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCast/DiscreteOptions/#color). If specified, these stops are used.
+   *
+   * @since 5.1
+   */
+  colorStops?: ColorStopProperties[] | null;
 }
 
 /**
@@ -28,15 +42,28 @@ export default class DiscreteOptions extends Clonable {
   /** @since 5.0 */
   constructor(properties?: DiscreteOptionsProperties);
   /**
-   * Color of the shadow visualization. The opacity of the visualization is mapped to the number of overlapping
-   * shadows. No shadow corresponds to opacity 0 and maximum number of shadows corresponds to the opacity set in this
-   * color value.
+   * Defines the color used by the default color ramp for the visualization. The opacity is mapped to the number of
+   * overlapping shadows. Areas without shadow are displayed with zero opacity and areas with the maximum number of
+   * overlapping shadows are displayed with the opacity specified in this color.
+   *
+   * When [colorStops](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCast/DiscreteOptions/#colorStops) is not specified, the visualization uses a default ramp between transparent and this color. When specified, those stops are used instead.
    *
    * @default [50, 50, 50, 0.7]
    * @since 5.0
    */
   get color(): Color;
   set color(value: ColorLike);
+  /**
+   * The color stops for the visualization.
+   *
+   * - Each stop defines a color and the corresponding number of overlapping shadows.
+   * - Colors are interpolated between adjacent stops.
+   * - If omitted, the visualization uses a default ramp between transparent and [color](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCast/DiscreteOptions/#color). If specified, these stops are used.
+   *
+   * @since 5.1
+   */
+  get colorStops(): ColorStop[] | null | undefined;
+  set colorStops(value: ColorStopProperties[] | null | undefined);
   /**
    * Individual shadows are displayed at this time interval, starting with the start time of day.
    * The interval is expressed in milliseconds. If set to 0, we'll use the smallest possible interval, up to a

package/analysis/ShadowCast/DiscreteOptions.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
-import{__decorate as o}from"tslib";import r from"../../Color.js";import{Clonable as t}from"../../core/Clonable.js";import{convertTime as s}from"../../core/timeUtils.js";import{property as e,subclass as i}from"../../core/accessorSupport/decorators.js";let l=class extends t{constructor(o){super(o),this.color=new r([50,50,50,.7]),this.interval=s(1,"hours","milliseconds")}equals(o){return this===o||this.color.equals(o.color)&&this.interval===o.interval}};o([e({type:r,nonNullable:!0})],l.prototype,"color",void 0),o([e({type:Number})],l.prototype,"interval",void 0),l=o([i("esri.analysis.ShadowCast.DiscreteOptions")],l);const a=l;export{a as default};
+import{__decorate as o}from"tslib";import r from"../../Color.js";import{colorStopsEqual as t}from"./colorStopsUtils.js";import{Clonable as s}from"../../core/Clonable.js";import{convertTime as e}from"../../core/timeUtils.js";import{property as l,subclass as i}from"../../core/accessorSupport/decorators.js";import p from"../../renderers/visualVariables/support/ColorStop.js";let c=class extends s{constructor(o){super(o),this.color=new r([50,50,50,.7]),this.colorStops=null,this.interval=e(1,"hours","milliseconds")}equals(o){return this===o||this.color.equals(o.color)&&t(this.colorStops,o.colorStops)&&this.interval===o.interval}};o([l({type:r,nonNullable:!0})],c.prototype,"color",void 0),o([l({type:[p]})],c.prototype,"colorStops",void 0),o([l({type:Number})],c.prototype,"interval",void 0),c=o([i("esri.analysis.ShadowCast.DiscreteOptions")],c);const a=c;export{a as default};

package/analysis/ShadowCast/MinDurationOptions.d.ts

@@ -7,8 +7,9 @@ import type { Clonable } from "../../core/Clonable.js";
 /** @since 5.0 */
 export interface MinDurationOptionsProperties extends Partial<Pick<MinDurationOptions, "contextEnabled" | "minDuration">> {
   /**
-   * Color of the shadow visualization. The areas with cumulative shadow time longer than the
-   * [minDuration](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCast/MinDurationOptions/#minDuration) are displayed with this color.
+   * Defines the color used to display areas where the cumulative shadow duration meets or exceeds
+   * [minDuration](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCast/MinDurationOptions/#minDuration). Areas with shorter shadow duration are displayed with
+   * zero opacity.
    *
    * @default [255, 0, 0, 0.7]
    * @since 5.0
@@ -38,8 +39,9 @@ export default class MinDurationOptions extends Clonable {
   /** @since 5.0 */
   constructor(properties?: MinDurationOptionsProperties);
   /**
-   * Color of the shadow visualization. The areas with cumulative shadow time longer than the
-   * [minDuration](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCast/MinDurationOptions/#minDuration) are displayed with this color.
+   * Defines the color used to display areas where the cumulative shadow duration meets or exceeds
+   * [minDuration](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCast/MinDurationOptions/#minDuration). Areas with shorter shadow duration are displayed with
+   * zero opacity.
    *
    * @default [255, 0, 0, 0.7]
    * @since 5.0

package/analysis/ShadowCast/TotalDurationOptions.d.ts

@@ -1,19 +1,33 @@
 import type Color from "../../Color.js";
+import type ColorStop from "../../renderers/visualVariables/support/ColorStop.js";
 import type { ColorLike } from "../../Color.js";
 import type { ShadowCastTotalDurationMode } from "./types.js";
 import type { Clonable } from "../../core/Clonable.js";
+import type { ColorStopProperties } from "../../renderers/visualVariables/support/ColorStop.js";
 
 /** @since 5.0 */
 export interface TotalDurationOptionsProperties extends Partial<Pick<TotalDurationOptions, "mode">> {
   /**
-   * Color of the shadow visualization. The opacity is mapped to the time spent in shadow. Areas that don't receive any
-   * shadow are displayed with zero opacity and areas that receive shadows for the entire time range are displayed
-   * with the opacity specified in this property.
+   * Defines the color used by the default color ramp for the visualization. The opacity is mapped to the time spent
+   * in shadow. Areas that don't receive any shadow are displayed with zero opacity and areas that receive shadows for
+   * the entire time range are displayed with the opacity specified in this color.
+   *
+   * When [colorStops](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCast/TotalDurationOptions/#colorStops) is not specified, the visualization uses a default ramp between transparent and this color. When specified, those stops are used instead.
    *
    * @default [0, 0, 255, 0.7]
    * @since 5.0
    */
   color?: ColorLike;
+  /**
+   * The color stops for the visualization.
+   *
+   * - Each stop defines a color and a value in milliseconds.
+   * - Colors are interpolated between adjacent stops.
+   * - If omitted, the visualization uses a default ramp between transparent and [color](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCast/TotalDurationOptions/#color). If specified, these stops are used.
+   *
+   * @since 5.1
+   */
+  colorStops?: ColorStopProperties[] | null;
 }
 
 /**
@@ -29,15 +43,28 @@ export default class TotalDurationOptions extends Clonable {
   /** @since 5.0 */
   constructor(properties?: TotalDurationOptionsProperties);
   /**
-   * Color of the shadow visualization. The opacity is mapped to the time spent in shadow. Areas that don't receive any
-   * shadow are displayed with zero opacity and areas that receive shadows for the entire time range are displayed
-   * with the opacity specified in this property.
+   * Defines the color used by the default color ramp for the visualization. The opacity is mapped to the time spent
+   * in shadow. Areas that don't receive any shadow are displayed with zero opacity and areas that receive shadows for
+   * the entire time range are displayed with the opacity specified in this color.
+   *
+   * When [colorStops](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCast/TotalDurationOptions/#colorStops) is not specified, the visualization uses a default ramp between transparent and this color. When specified, those stops are used instead.
    *
    * @default [0, 0, 255, 0.7]
    * @since 5.0
    */
   get color(): Color;
   set color(value: ColorLike);
+  /**
+   * The color stops for the visualization.
+   *
+   * - Each stop defines a color and a value in milliseconds.
+   * - Colors are interpolated between adjacent stops.
+   * - If omitted, the visualization uses a default ramp between transparent and [color](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCast/TotalDurationOptions/#color). If specified, these stops are used.
+   *
+   * @since 5.1
+   */
+  get colorStops(): ColorStop[] | null | undefined;
+  set colorStops(value: ColorStopProperties[] | null | undefined);
   /**
    * Determines how cumulative shadow duration is visualized. Either as a `continuous` surface across the selected time
    * range or aggregated into discrete `hourly` intervals.

package/analysis/ShadowCast/TotalDurationOptions.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
-import{__decorate as o}from"tslib";import t from"../../Color.js";import{Clonable as r}from"../../core/Clonable.js";import{property as s,subclass as e}from"../../core/accessorSupport/decorators.js";let l=class extends r{constructor(o){super(o),this.color=new t([0,0,255,.7]),this.mode="continuous"}equals(o){return this===o||this.color.equals(o.color)&&this.mode===o.mode}};o([s({type:t,nonNullable:!0})],l.prototype,"color",void 0),o([s({type:["continuous","hourly"]})],l.prototype,"mode",void 0),l=o([e("esri.analysis.ShadowCast.TotalDurationOptions")],l);const i=l;export{i as default};
+import{__decorate as o}from"tslib";import t from"../../Color.js";import{colorStopsEqual as r}from"./colorStopsUtils.js";import{Clonable as s}from"../../core/Clonable.js";import{property as e,subclass as l}from"../../core/accessorSupport/decorators.js";import p from"../../renderers/visualVariables/support/ColorStop.js";let i=class extends s{constructor(o){super(o),this.color=new t([0,0,255,.7]),this.colorStops=null,this.mode="continuous"}equals(o){return this===o||this.color.equals(o.color)&&r(this.colorStops,o.colorStops)&&this.mode===o.mode}};o([e({type:t,nonNullable:!0})],i.prototype,"color",void 0),o([e({type:[p]})],i.prototype,"colorStops",void 0),o([e({type:["continuous","hourly"]})],i.prototype,"mode",void 0),i=o([l("esri.analysis.ShadowCast.TotalDurationOptions")],i);const c=i;export{c as default};

package/analysis/ShadowCast/colorStopsUtils.js

@@ -0,0 +1,2 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
+import{equals as l}from"../../core/arrayUtils.js";function r(r,n){return r===n||null==r&&null==n||null!=r&&null!=n&&l(r,n,(l,r)=>l.equals(r))}export{r as colorStopsEqual};

package/analysis/ShadowCastAnalysis.d.ts

@@ -2,14 +2,16 @@ import type Analysis from "./Analysis.js";
 import type DiscreteOptions from "./ShadowCast/DiscreteOptions.js";
 import type MinDurationOptions from "./ShadowCast/MinDurationOptions.js";
 import type TotalDurationOptions from "./ShadowCast/TotalDurationOptions.js";
+import type Polygon from "../geometry/Polygon.js";
 import type { AnalysisProperties } from "./Analysis.js";
 import type { DiscreteOptionsProperties } from "./ShadowCast/DiscreteOptions.js";
 import type { MinDurationOptionsProperties } from "./ShadowCast/MinDurationOptions.js";
 import type { TotalDurationOptionsProperties } from "./ShadowCast/TotalDurationOptions.js";
 import type { ShadowCastMode } from "./ShadowCast/types.js";
+import type { PolygonProperties } from "../geometry/Polygon.js";
 
 /** @since 5.0 */
-export interface ShadowCastAnalysisProperties extends AnalysisProperties, Partial<Pick<ShadowCastAnalysis, "endTimeOfDay" | "mode" | "startTimeOfDay" | "utcOffset">> {
+export interface ShadowCastAnalysisProperties extends AnalysisProperties, Partial<Pick<ShadowCastAnalysis, "endTimeOfDay" | "mode" | "startTimeOfDay" | "utcOffset" | "visualizeSunlight">> {
   /**
    * The calendar date used to calculate the shadow cast. This date excludes the time.
    * If a date with a time is set, the time value will be set to midnight (`00:00:00`) of that date in local system time.
@@ -24,6 +26,12 @@ export interface ShadowCastAnalysisProperties extends AnalysisProperties, Partia
    * @since 5.0
    */
   discreteOptions?: DiscreteOptionsProperties;
+  /**
+   * Area inside which to apply the shadow cast. If not set it will apply to the entire scene.
+   *
+   * @since 5.1
+   */
+  geometry?: PolygonProperties | null;
   /**
    * Options specific to the `min-duration` mode.
    *
@@ -173,6 +181,13 @@ export default class ShadowCastAnalysis extends Analysis {
    * @since 5.0
    */
   accessor endTimeOfDay: number;
+  /**
+   * Area inside which to apply the shadow cast. If not set it will apply to the entire scene.
+   *
+   * @since 5.1
+   */
+  get geometry(): Polygon | null | undefined;
+  set geometry(value: PolygonProperties | null | undefined);
   /**
    * Options specific to the `min-duration` mode.
    *
@@ -235,4 +250,12 @@ export default class ShadowCastAnalysis extends Analysis {
    * @since 5.0
    */
   get valid(): boolean;
+  /**
+   * When `true`, the analysis will visualize the sunlight duration instead of the shadow duration. This applies to all
+   * modes and their respective options.
+   *
+   * @default false
+   * @since 5.1
+   */
+  accessor visualizeSunlight: boolean;
 }

package/analysis/ShadowCastAnalysis.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
-import{__decorate as t}from"tslib";import o from"./Analysis.js";import e from"./ShadowCast/DiscreteOptions.js";import s from"./ShadowCast/MinDurationOptions.js";import i from"./ShadowCast/TotalDurationOptions.js";import{convertTime as a}from"../core/timeUtils.js";import{property as n,subclass as r}from"../core/accessorSupport/decorators.js";let p=class extends o{constructor(t){super(t),this.type="shadow-cast",this.utcOffset=null,this.startTimeOfDay=a(10,"hours","milliseconds"),this.endTimeOfDay=a(16,"hours","milliseconds"),this.mode="min-duration",this.discreteOptions=new e,this.totalDurationOptions=new i,this.minDurationOptions=new s,this.date??=new Date}set date(t){const o=new Date(t);o.setHours(0,0,0,0),this._set("date",o)}get valid(){return!0}equals(t){return this===t||super.equals(t)&&this.date.getTime()===t.date.getTime()&&this.utcOffset===t.utcOffset&&this.startTimeOfDay===t.startTimeOfDay&&this.endTimeOfDay===t.endTimeOfDay&&this.mode===t.mode&&this.discreteOptions.equals(t.discreteOptions)&&this.totalDurationOptions.equals(t.totalDurationOptions)&&this.minDurationOptions.equals(t.minDurationOptions)}clear(){throw new Error("clear() is not supported on ShadowCastAnalysis.")}};t([n({type:["shadow-cast"]})],p.prototype,"type",void 0),t([n({type:Date,nonNullable:!0})],p.prototype,"date",null),t([n({})],p.prototype,"utcOffset",void 0),t([n({type:Number,nonNullable:!0})],p.prototype,"startTimeOfDay",void 0),t([n({type:Number,nonNullable:!0})],p.prototype,"endTimeOfDay",void 0),t([n({type:["discrete","min-duration","total-duration"],nonNullable:!0})],p.prototype,"mode",void 0),t([n({type:e,nonNullable:!0})],p.prototype,"discreteOptions",void 0),t([n({type:i,nonNullable:!0})],p.prototype,"totalDurationOptions",void 0),t([n({type:s,nonNullable:!0})],p.prototype,"minDurationOptions",void 0),t([n({readOnly:!0})],p.prototype,"valid",null),p=t([r("esri.analysis.ShadowCastAnalysis")],p);const l=p;export{l as default};
+import{__decorate as t}from"tslib";import o from"./Analysis.js";import e from"./ShadowCast/DiscreteOptions.js";import i from"./ShadowCast/MinDurationOptions.js";import s from"./ShadowCast/TotalDurationOptions.js";import{equalsMaybe as a}from"../core/maybe.js";import{convertTime as r}from"../core/timeUtils.js";import{property as n,subclass as l}from"../core/accessorSupport/decorators.js";import p from"../geometry/Polygon.js";let u=class extends o{constructor(t){super(t),this.type="shadow-cast",this.geometry=null,this.utcOffset=null,this.startTimeOfDay=r(10,"hours","milliseconds"),this.endTimeOfDay=r(16,"hours","milliseconds"),this.mode="min-duration",this.visualizeSunlight=!1,this.discreteOptions=new e,this.totalDurationOptions=new s,this.minDurationOptions=new i,this.date??=new Date}set date(t){const o=new Date(t);o.setHours(0,0,0,0),this._set("date",o)}get valid(){return!0}equals(t){return this===t||super.equals(t)&&this.date.getTime()===t.date.getTime()&&this.utcOffset===t.utcOffset&&this.startTimeOfDay===t.startTimeOfDay&&this.endTimeOfDay===t.endTimeOfDay&&a(this.geometry,t.geometry)&&this.mode===t.mode&&this.visualizeSunlight===t.visualizeSunlight&&this.discreteOptions.equals(t.discreteOptions)&&this.totalDurationOptions.equals(t.totalDurationOptions)&&this.minDurationOptions.equals(t.minDurationOptions)}clear(){throw new Error("clear() is not supported on ShadowCastAnalysis.")}};t([n({type:["shadow-cast"]})],u.prototype,"type",void 0),t([n({type:Date,nonNullable:!0})],u.prototype,"date",null),t([n({type:p})],u.prototype,"geometry",void 0),t([n({})],u.prototype,"utcOffset",void 0),t([n({type:Number,nonNullable:!0})],u.prototype,"startTimeOfDay",void 0),t([n({type:Number,nonNullable:!0})],u.prototype,"endTimeOfDay",void 0),t([n({type:["discrete","min-duration","total-duration"],nonNullable:!0})],u.prototype,"mode",void 0),t([n({type:Boolean,nonNullable:!0})],u.prototype,"visualizeSunlight",void 0),t([n({type:e,nonNullable:!0})],u.prototype,"discreteOptions",void 0),t([n({type:s,nonNullable:!0})],u.prototype,"totalDurationOptions",void 0),t([n({type:i,nonNullable:!0})],u.prototype,"minDurationOptions",void 0),t([n({readOnly:!0})],u.prototype,"valid",null),u=t([l("esri.analysis.ShadowCastAnalysis")],u);const m=u;export{m as default};

package/analysis/Viewshed.d.ts

@@ -1,10 +1,24 @@
 import type Point from "../geometry/Point.js";
+import type ElevationInfo from "../symbols/support/ElevationInfo.js";
 import type { FeatureReference } from "./types.js";
 import type { Clonable } from "../core/Clonable.js";
 import type { JSONSupportMixin } from "../core/JSONSupport.js";
 import type { PointProperties } from "../geometry/Point.js";
+import type { ElevationInfoProperties } from "../symbols/support/ElevationInfo.js";
 
 export interface ViewshedProperties extends Partial<Pick<Viewshed, "farDistance" | "feature" | "heading" | "horizontalFieldOfView" | "tilt" | "verticalFieldOfView">> {
+  /**
+   * 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.
+   *
+   * > [!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.
+   * > If the elevation info is not specified, the effective elevation depends on the [observer](https://developers.arcgis.com/javascript/latest/references/core/analysis/Viewshed/#observer) properties.
+   *
+   * @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. */
   observer?: PointProperties | null;
 }
@@ -57,6 +71,19 @@ export interface ViewshedProperties extends Partial<Pick<Viewshed, "farDistance"
  */
 export default class Viewshed extends ViewshedSuperclass {
   constructor(properties?: ViewshedProperties);
+  /**
+   * 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.
+   *
+   * > [!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.
+   * > If the elevation info is not specified, the effective elevation depends on the [observer](https://developers.arcgis.com/javascript/latest/references/core/analysis/Viewshed/#observer) properties.
+   *
+   * @since 5.1
+   */
+  get elevationInfo(): ElevationInfo | null | undefined;
+  set elevationInfo(value: ElevationInfoProperties | null | undefined);
   /**
    * The maximum distance from the observer in which to perform the viewshed analysis (in meters).
    *

package/analysis/Viewshed.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
-import{__decorate as e}from"tslib";import{featureReferenceEquals as r,featureReferenceProperty as i}from"./featureReferenceUtils.js";import{Clonable as t}from"../core/Clonable.js";import{cyclicalDegrees as o}from"../core/Cyclical.js";import{JSONSupportMixin as s}from"../core/JSONSupport.js";import{equalsMaybe as l}from"../core/maybe.js";import{property as a,cast as n,subclass as p}from"../core/accessorSupport/decorators.js";import{ensureNumber as u}from"../core/accessorSupport/ensureType.js";import d from"../geometry/Point.js";let m=class extends(s(t)){constructor(e){super(e),this.observer=null,this.farDistance=1e3,this.heading=0,this.tilt=90,this.horizontalFieldOfView=45,this.verticalFieldOfView=45,this.feature=null}get valid(){return null!=this.observer&&this.farDistance>0}equals(e){return l(this.observer,e.observer)&&this.farDistance===e.farDistance&&this.heading===e.heading&&this.tilt===e.tilt&&this.horizontalFieldOfView===e.horizontalFieldOfView&&this.verticalFieldOfView===e.verticalFieldOfView&&r(this.feature,e.feature)}};e([a({type:d,json:{write:{isRequired:!0}}})],m.prototype,"observer",void 0),e([a({type:Number,nonNullable:!0,range:{min:0},json:{write:{isRequired:!0}}})],m.prototype,"farDistance",void 0),e([a({type:Number,nonNullable:!0,json:{write:{isRequired:!0}}}),n(e=>o.normalize(u(e),void 0,!0))],m.prototype,"heading",void 0),e([a({type:Number,nonNullable:!0,range:{min:0,max:180},json:{write:{isRequired:!0}}})],m.prototype,"tilt",void 0),e([a({type:Number,nonNullable:!0,range:{min:0,max:360},json:{write:{isRequired:!0}}})],m.prototype,"horizontalFieldOfView",void 0),e([a({type:Number,nonNullable:!0,range:{min:0,max:180},json:{write:{isRequired:!0}}})],m.prototype,"verticalFieldOfView",void 0),e([a(i)],m.prototype,"feature",void 0),e([a({readOnly:!0,json:{read:!1}})],m.prototype,"valid",null),m=e([p("esri.analysis.Viewshed")],m);export{m as default};
+import{__decorate as e}from"tslib";import{featureReferenceEquals as i,featureReferenceProperty as t}from"./featureReferenceUtils.js";import{Clonable as r}from"../core/Clonable.js";import{cyclicalDegrees as o}from"../core/Cyclical.js";import{JSONSupportMixin as s}from"../core/JSONSupport.js";import{equalsMaybe as l}from"../core/maybe.js";import{property as n,cast as a,subclass as p}from"../core/accessorSupport/decorators.js";import{ensureNumber as u}from"../core/accessorSupport/ensureType.js";import m from"../geometry/Point.js";import d from"../symbols/support/ElevationInfo.js";let f=class extends(s(r)){constructor(e){super(e),this.observer=null,this.farDistance=1e3,this.heading=0,this.tilt=90,this.horizontalFieldOfView=45,this.verticalFieldOfView=45,this.elevationInfo=null,this.feature=null}get valid(){return null!=this.observer&&this.farDistance>0}equals(e){return l(this.observer,e.observer)&&this.farDistance===e.farDistance&&this.heading===e.heading&&this.tilt===e.tilt&&this.horizontalFieldOfView===e.horizontalFieldOfView&&this.verticalFieldOfView===e.verticalFieldOfView&&l(this.elevationInfo,e.elevationInfo)&&i(this.feature,e.feature)}};e([n({type:m,json:{write:{isRequired:!0}}})],f.prototype,"observer",void 0),e([n({type:Number,nonNullable:!0,range:{min:0},json:{write:{isRequired:!0}}})],f.prototype,"farDistance",void 0),e([n({type:Number,nonNullable:!0,json:{write:{isRequired:!0}}}),a(e=>o.normalize(u(e),void 0,!0))],f.prototype,"heading",void 0),e([n({type:Number,nonNullable:!0,range:{min:0,max:180},json:{write:{isRequired:!0}}})],f.prototype,"tilt",void 0),e([n({type:Number,nonNullable:!0,range:{min:0,max:360},json:{write:{isRequired:!0}}})],f.prototype,"horizontalFieldOfView",void 0),e([n({type:Number,nonNullable:!0,range:{min:0,max:180},json:{write:{isRequired:!0}}})],f.prototype,"verticalFieldOfView",void 0),e([n({type:d})],f.prototype,"elevationInfo",void 0),e([n(t)],f.prototype,"feature",void 0),e([n({readOnly:!0,json:{read:!1}})],f.prototype,"valid",null),f=e([p("esri.analysis.Viewshed")],f);export{f as default};

package/analysis/ViewshedAnalysis.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
-import{__decorate as e}from"tslib";import t from"./Analysis.js";import n from"./Viewshed.js";import{equals as r}from"../core/arrayUtils.js";import i from"../core/Collection.js";import{referenceSetter as s,castForReferenceSetter as o}from"../core/collectionUtils.js";import{cyclicalDegrees as l}from"../core/Cyclical.js";import{deg2rad as a,clamp as u}from"../core/mathUtils.js";import{watch as p,syncAndInitial as c}from"../core/reactiveUtils.js";import{property as m,subclass as h}from"../core/accessorSupport/decorators.js";import d from"../geometry/Extent.js";import{projectOrLoadMany as f}from"../geometry/projectionUtils.js";const v=i.ofType(n);let y=class extends t{constructor(e){super(e),this.type="viewshed",this._extent=null}initialize(){this.addHandles(p(()=>this._computeExtent(),e=>{null==e.pending&&(this._extent=e.extent)},c))}get viewsheds(){return this._get("viewsheds")||new v}set viewsheds(e){this._set("viewsheds",s(e,this.viewsheds,v))}get spatialReference(){for(const e of this.viewsheds)if(null!=e.observer)return e.observer.spatialReference;return null}get extent(){return this._extent}get valid(){return this.viewsheds.every(e=>e.valid)}async waitComputeExtent(){const e=this._computeExtent();null!=e.pending&&await e.pending}_computeExtent(){const{spatialReference:e}=this;if(null==e)return{pending:null,extent:null};const t=this.viewsheds.filter(e=>null!=e.observer),n=t.map(e=>e.observer).toArray(),r=f(n,e);if(null!=r.pending)return{pending:r.pending,extent:null};return{pending:null,extent:r.geometries.map((e,n)=>{const r=t.at(n);return null!=e&&null!=r?this._computeViewshedExtent(this.viewsheds.at(n),e):null}).filter(e=>null!=e).reduce((e,t)=>x(e,t),null)}}_computeViewshedExtent(e,t){const{farDistance:n,heading:r,tilt:i,horizontalFieldOfView:s,verticalFieldOfView:o}=e,{spatialReference:p}=t,c=s/2,m=o/2,h=n/p.metersPerUnit,f=[l.normalize(r-c),r,l.normalize(r+c)],v=d.fromPoint(t),y=e=>{const t=f.map(t=>l.normalize(t-e));if(t[0]>t[2]||360===s)return h;const n=t.map(e=>Math.abs(e>180?360-e:e)).reduce((e,t)=>e>t?t:e);return n>90?0:h*Math.cos(a(n))};v.xmax+=y(90),v.xmin-=y(-90),v.ymax+=y(0),v.ymin-=y(180);const x=t.z;if(null!=x){let e=x,t=x;const r=i-90,s=u(r+m,-90,90),o=u(r-m,-90,90),l=p?.isGeographic?n:h;e+=l*g(s),t+=l*g(o);const a=w(m)*l,d=g(r)*a*(1-w(c));i<90&&(e-=d),i>90&&(t-=d),v.zmax=Math.max(e,x),v.zmin=Math.min(t,x)}return v}equals(e){return this===e||super.equals(e)&&r(this.viewsheds.toArray(),e.viewsheds.toArray(),(e,t)=>e.equals(t))}clear(){this.viewsheds.removeAll()}};function x(e,t){return null==e?t:null==t?e:e.union(t)}function w(e){return Math.cos(a(e))}function g(e){return Math.sin(a(e))}e([m({type:["viewshed"]})],y.prototype,"type",void 0),e([m({cast:o,type:v,nonNullable:!0})],y.prototype,"viewsheds",null),e([m({readOnly:!0})],y.prototype,"spatialReference",null),e([m()],y.prototype,"_extent",void 0),e([m()],y.prototype,"extent",null),e([m({readOnly:!0})],y.prototype,"valid",null),y=e([h("esri.analysis.ViewshedAnalysis")],y);export{y as default};
+import{__decorate as e}from"tslib";import t from"./Analysis.js";import n from"./Viewshed.js";import{equals as r}from"../core/arrayUtils.js";import i from"../core/Collection.js";import{referenceSetter as s,castForReferenceSetter as o}from"../core/collectionUtils.js";import{cyclicalDegrees as l}from"../core/Cyclical.js";import{deg2rad as a,clamp as u}from"../core/mathUtils.js";import{watch as p,syncAndInitial as c}from"../core/reactiveUtils.js";import{property as m,subclass as h}from"../core/accessorSupport/decorators.js";import d from"../geometry/Extent.js";import{projectOrLoadMany as f}from"../geometry/projectionUtils.js";import{getGeometryEffectiveElevationMode as v}from"../support/elevationInfoUtils.js";const y=i.ofType(n);let x=class extends t{constructor(e){super(e),this.type="viewshed",this._extent=null}initialize(){this.addHandles(p(()=>this._computeExtent(),e=>{null==e.pending&&(this._extent=e.extent)},c))}get viewsheds(){return this._get("viewsheds")||new y}set viewsheds(e){this._set("viewsheds",s(e,this.viewsheds,y))}get spatialReference(){for(const e of this.viewsheds)if(null!=e.observer)return e.observer.spatialReference;return null}get extent(){return this._extent}get valid(){return this.viewsheds.every(e=>e.valid)}async waitComputeExtent(){const e=this._computeExtent();null!=e.pending&&await e.pending}_computeExtent(){const{spatialReference:e}=this;if(null==e)return{pending:null,extent:null};const t=this.viewsheds.filter(e=>null!=e.observer),n=t.map(e=>e.observer).toArray(),r=f(n,e);if(null!=r.pending)return{pending:r.pending,extent:null};const i=r.geometries.map((e,n)=>{const r=t.at(n);return null!=e&&null!=r?this._computeViewshedExtent(this.viewsheds.at(n),e):null}).filter(e=>null!=e).reduce((e,t)=>g(e,t),null);return null!=i&&t.some(e=>!w(e))&&(i.zmin=void 0,i.zmax=void 0),{pending:null,extent:i}}_computeViewshedExtent(e,t){const{farDistance:n,heading:r,tilt:i,horizontalFieldOfView:s,verticalFieldOfView:o}=e,{spatialReference:p}=t,c=s/2,m=o/2,h=n/p.metersPerUnit,f=[l.normalize(r-c),r,l.normalize(r+c)],v=d.fromPoint(t),y=e=>{const t=f.map(t=>l.normalize(t-e));if(t[0]>t[2]||360===s)return h;const n=t.map(e=>Math.abs(e>180?360-e:e)).reduce((e,t)=>e>t?t:e);return n>90?0:h*Math.cos(a(n))};v.xmax+=y(90),v.xmin-=y(-90),v.ymax+=y(0),v.ymin-=y(180);const x=t.z;if(null!=x){let e=x,t=x;const r=i-90,s=u(r+m,-90,90),o=u(r-m,-90,90),l=p?.isGeographic?n:h;e+=l*_(s),t+=l*_(o);const a=j(m)*l,d=_(r)*a*(1-j(c));i<90&&(e-=d),i>90&&(t-=d),v.zmax=Math.max(e,x),v.zmin=Math.min(t,x)}return v}equals(e){return this===e||super.equals(e)&&r(this.viewsheds.toArray(),e.viewsheds.toArray(),(e,t)=>e.equals(t))}clear(){this.viewsheds.removeAll()}};function w(e){return"absolute-height"===v(e.observer,e.elevationInfo)}function g(e,t){return null==e?t:null==t?e:e.union(t)}function j(e){return Math.cos(a(e))}function _(e){return Math.sin(a(e))}e([m({type:["viewshed"]})],x.prototype,"type",void 0),e([m({cast:o,type:y,nonNullable:!0})],x.prototype,"viewsheds",null),e([m({readOnly:!0})],x.prototype,"spatialReference",null),e([m()],x.prototype,"_extent",void 0),e([m()],x.prototype,"extent",null),e([m({readOnly:!0})],x.prototype,"valid",null),x=e([h("esri.analysis.ViewshedAnalysis")],x);export{x as default};

package/applications/Components/OrientedImageryViewer/ImageViewer/utils.d.ts

@@ -0,0 +1,34 @@
+import type ImageryTileLayer from "../../../../layers/ImageryTileLayer.js";
+import type MapView from "../../../../views/MapView.js";
+
+/**
+ * @internal
+ * @internal
+ */
+export interface RotateDimensionsResult {
+  /** @internal */
+  width: number;
+  /** @internal */
+  height: number;
+}
+
+/**
+ * Rotates the dimensions of the image based on the given rotation angle.
+ *
+ * @param width - The width of the image.
+ * @param height - The height of the image.
+ * @param rotation - The rotation angle in degrees.
+ * @internal
+ * @internal
+ */
+export function rotateDimensions(width: number, height: number, rotation: number): RotateDimensionsResult;
+
+/**
+ * Registers a custom pan constraint on the view to restrict panning beyond the boundaries of the image.
+ *
+ * @param view - The [MapView](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/) instance to register the pan constraint on.
+ * @param image - The [ImageryTileLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/ImageryTileLayer/) representing the image being displayed in the viewer.
+ * @internal
+ * @internal
+ */
+export function registerPanConstraint(view: MapView, image: ImageryTileLayer): void;

package/applications/Components/OrientedImageryViewer/ImageViewer/utils.js

@@ -0,0 +1,2 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
+import t from"../../../../geometry/Point.js";function i(t,i,e){const n=e*(Math.PI/180);return{width:t*Math.cos(n)+i*Math.sin(n),height:t*Math.sin(n)+i*Math.cos(n)}}function e({viewpoint:e,imageWidth:n,imageHeight:o,containerWidth:a,containerHeight:r,rotation:h,constraints:s,imageExtent:c}){const g=a/r,{width:m,height:d}=i(n,o,h),{width:l,height:x}=i(c.xmin,c.ymin,h),{width:w,height:f}=i(c.xmax,c.ymax,h),p=m/a>d/r,u=s.scaleToZoom(e.scale),y=1/2**u;let M=y*m,v=y*d;u>=1&&(p?v=M/g:M=v*g);const{x:H,y:W,spatialReference:E}=e.targetGeometry,P=M/2,R=v/2,C=H<l+P?l+P:H>w-P?w-P:H,G=W<x+R?x+R:W>f-R?f-R:W;return e.targetGeometry=new t({x:C,y:G,spatialReference:E}),e}function n(t,i){const n=t.constraints.customConstraints;n.removeAll();const o=n=>{const{constraints:o,width:a,height:r}=t,{width:h,height:s}=i.serviceRasterInfo;return e({constraints:o,viewpoint:n,imageWidth:h,imageHeight:s,containerWidth:a,containerHeight:r,rotation:0,imageExtent:i.fullExtent})};n.add({constrain:o,applyPanConstraint:o})}export{n as registerPanConstraint,i as rotateDimensions};

package/arcade/FunctionWrapper.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
-import{isPromiseLike as t}from"../core/promiseUtils.js";class r{constructor(){}}function n(t,n,e){if(t instanceof r&&!(t instanceof s)){const r=new s;return r.fn=t,r.parameterEvaluator=e,r.context=n,r}return t}class e extends r{constructor(t){super(),this.fn=t}createFunction(t){return(...r)=>this.fn(t,{preparsed:!0,arguments:r})}call(t,r){return this.fn(t,r)}marshalledCall(e,a,l,c){return c(e,a,(a,o,i)=>{i=i.map(t=>t instanceof r&&!(t instanceof s)?n(t,e,c):t);const u=this.call(l,{args:i});return t(u)?u.then(t=>n(t,l,c)):u})}}class s extends r{constructor(){super(...arguments),this.fn=null,this.context=null}createFunction(t){return this.fn.createFunction(this.context)}call(t,r){return this.fn.marshalledCall(t,r,this.context,this.parameterEvaluator)}marshalledCall(t,r,n){return this.fn.marshalledCall(t,r,this.context,this.parameterEvaluator)}}export{r as ArcadeFunction,e as NativeFunction,s as ScopeMarshalledFunction,n as wrapModuleScopedResponse};
+import{isPromiseLike as t}from"../core/promiseUtils.js";class e{constructor(){}}function n(t,n,r){if(t instanceof e&&!(t instanceof a)){const e=new a;return e.fn=t,e.parameterEvaluator=r,e.context=n,e}return t}class r extends e{constructor(t,e){super(),this._name=e,this.fn=t}get debugName(){return null!=this._name?`<native>.${this._name}`:"<native>"}createFunction(t){return(...e)=>this.fn(t,{preparsed:!0,arguments:e})}call(t,e){return this.fn(t,e)}marshalledCall(r,s,l,i){return i(r,s,(s,u,c)=>{c=c.map(t=>t instanceof e&&!(t instanceof a)?n(t,r,i):t);const o=this.call(l,{args:c});return t(o)?o.then(t=>n(t,l,i)):o})}}class a extends e{constructor(){super(...arguments),this.fn=null,this.context=null}get debugName(){return null!=this.fn.debugName?`<imported>.${this.fn.debugName}`:null}createFunction(t){return this.fn.createFunction(this.context)}call(t,e){return this.fn.marshalledCall(t,e,this.context,this.parameterEvaluator)}marshalledCall(t,e,n){return this.fn.marshalledCall(t,e,this.context,this.parameterEvaluator)}}export{e as ArcadeFunction,r as NativeFunction,a as ScopeMarshalledFunction,n as wrapModuleScopedResponse};