@arcgis/map-components 5.1.0-next.98 → 5.2.0-next.0

package/dist/components/arcgis-shadow-cast/customElement.d.ts

@@ -1,71 +1,64 @@
 /// <reference path="../../index.d.ts" />
-import type Point from "@arcgis/core/geometry/Point.js";
 import type ShadowCastAnalysis from "@arcgis/core/analysis/ShadowCastAnalysis.js";
 import type SceneView from "@arcgis/core/views/SceneView.js";
 import type Color from "@arcgis/core/Color.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 import type { ArcgisReferenceElement, HeadingLevel } from "../types.js";
 import type { ShadowCastMode, ShadowCastTotalDurationMode } from "@arcgis/core/analysis/ShadowCast/types.js";
+import type { ScreenPoint } from "@arcgis/core/core/types.js";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
 import type { Icon as Icon } from "@esri/calcite-components/components/calcite-icon";
 
 /**
- * The Shadow Cast component displays the cumulative shadows of 3D features in a
- * [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/).
- * This type of analysis is helpful in urban development, where new projects have to satisfy certain shadow duration constraints.
+ * The Shadow Cast component visualizes shadows cast by 3D features or sunlight exposure in an
+ * [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/). This is helpful in urban development, where projects may need to satisfy shadow or
+ * sunlight exposure requirements for a selected day and time range.
  *
- * The component calculates the cumulative shadows for a time range during a single day. The user can
- * configure the time range and select a calendar date. This time range and calendar date are only used
- * for the shadow analysis and are not connected to the lighting in the scene.
- * To control the lighting in the scene, use the
- * [arcgis-daylight](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-daylight/) component.
- * Changing the timezone in the component updates the visualization by interpreting the time range as being
- * in that timezone. This behavior is different from the
- * [arcgis-daylight](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-daylight/) component,
- * where selecting a timezone updates the
- * [arcgis-scene.environment](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#environment)
- * date and time according to the camera position.
+ * [![shadow cast component](https://developers.arcgis.com/javascript/latest/assets/references/core/analysis/shadow-cast-analysis-duration.avif)](https://developers.arcgis.com/javascript/latest/sample-code/shadow-cast/)
  *
- * The component provides three [mode](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#mode): minimum duration, total duration, and discrete mode.
+ * By default, the component visualizes shadows. When [visualizeSunlight](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#visualizeSunlight) is `true`,
+ * it visualizes sunlight exposure instead.
  *
- * **Minimum duration** mode displays shadows only in areas where shading accumulates for longer than a specified duration
- * within the selected time range. Areas that receive less shading than the minimum show no shadow. In the image below,
- * on May 1, 2021, shadows are displayed only where shading exceeds 4 hours between 10AM and 4PM.
+ * The component provides controls for the date, time range, timezone, visualization mode, colors, intervals, and whether
+ * to visualize shadows or sunlight.
  *
- * [![minimum-duration mode](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/shadow-cast/shadow-cast-threshold.avif)](https://developers.arcgis.com/javascript/latest/sample-code/shadow-cast/)
+ * The [date](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#date), [startTimeOfDay](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#startTimeOfDay),
+ * [endTimeOfDay](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#endTimeOfDay), and [utcOffset](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#utcOffset) properties
+ * define the date, time range, and UTC offset used to compute the analysis overlay. They do not change the lighting in
+ * the scene. To control scene lighting, use the [arcgis-daylight](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-daylight/) component.
  *
- * **Total shadow duration** mode displays the cumulative duration of shadow within the selected time range using opacity:
- * areas that receive no shadow remain fully transparent, while areas receiving the highest accumulated shadow duration
- * use a default opacity of 0.7. Intermediate values are interpolated. This mode can visualize shadows continuously or
- * in 1-hour intervals.
+ * The [utcOffset](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#utcOffset) property determines which timezone the selected date and time range
+ * are interpreted in for the analysis. This differs from the Daylight component, where selecting a timezone updates the
+ * [arcgis-scene.environment](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#environment) date and time according to the camera position.
  *
- * [![total-duration mode](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/shadow-cast/shadow-cast-duration.avif)](https://developers.arcgis.com/javascript/latest/sample-code/shadow-cast/)
+ * The [mode](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#mode) property controls how shadow or sunlight exposure is visualized:
  *
- * **Discrete shadows** mode displays individual shadows at regular intervals within the selected time range.
- * For example, with a time range from 10AM to 11AM and an interval set to 30 minutes, the shadows at 10AM, 10:30AM and
- * 11:00AM will be displayed.
+ * | Mode | Use for | Details |
+ * | --- | --- | --- |
+ * | `min-duration` | Highlighting areas that meet or exceed a minimum shadow or sunlight duration. | The threshold is defined by [minDuration](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#minDuration). |
+ * | `total-duration` | Showing cumulative shadow or sunlight duration across the analysis area. | Supports continuous visualization or 1-hour intervals. Areas with no duration remain transparent, intermediate values are interpolated, and the highest duration uses the opacity from [totalDurationColor](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#totalDurationColor). |
+ * | `discrete` | Displaying individual shadow or sunlight samples at regular intervals. | The interval is defined by [discreteInterval](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#discreteInterval). For example, a one-hour range with a 30-minute interval displays samples at the start, middle, and end of the range. |
  *
- * [![discrete mode](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/shadow-cast/shadow-cast-discrete.avif)](https://developers.arcgis.com/javascript/latest/sample-code/shadow-cast/)
- *
- * Hovering over the Scene will display a tooltip showing the  amount of time that location is in shadow, rounded to 15-minute intervals.
- *
- * The defaults for the time range and visualization settings can be changed using the [startTimeOfDay](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#startTimeOfDay),
- * [endTimeOfDay](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#endTimeOfDay), and [mode](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#mode) properties.
+ * Hovering over the scene displays a tooltip showing the shadow or sunlight duration at that location, rounded to
+ * 15-minute intervals. To disable this tooltip, set
+ * [hideShadowDurationTooltip](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#hideShadowDurationTooltip) to `true`.
  *
  * **Known limitations**
  *
  * * Shadow Cast is only supported in a 3D [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/) component.
- * * Terrain does not cast shadows in this analysis. As a result, to avoid incorrect shadow visualization, `startTimeOfDay`
- * should be set after local sunrise and `endTimeOfDay` before local sunset. If these times fall outside daylight hours,
- * shadows may be missing in areas where terrain would normally block sunlight.
- * * The analysis does not take daylight savings into account. Use the timezone dropdown to adjust the offset from the
- * Coordinated Universal Time (UTC) and account for the daylight saving time.
- * * The timezone is automatically detected by the component based on the camera location. In some situations, this might not be accurate.
- * In case of an inaccurate timezone, users can set it manually using the timezone dropdown.
+ * * Terrain does not cast shadows in this analysis.
+ * * As a result, shadow duration may be underestimated and sunlight duration may be overestimated in areas where terrain
+ * would normally block sunlight. To avoid incorrect visualization, `startTimeOfDay` should be set after local sunrise
+ * and `endTimeOfDay` before local sunset.
+ * * The analysis does not take daylight savings into account. Use the timezone picker to adjust the offset from the
+ * Coordinated Universal Time (UTC) and account for daylight saving time.
+ * * The timezone is automatically detected by the component based on the camera location. In some situations, this might
+ * not be accurate. In case of an inaccurate timezone, users can set it manually using the timezone picker.
  *
  * **See also**
  *
- * - [Sample - Shadow cast component](https://developers.arcgis.com/javascript/latest/sample-code/shadow-cast/)
+ * - [Sample - Shadow Cast component](https://developers.arcgis.com/javascript/latest/sample-code/shadow-cast/)
+ * - [ShadowCastAnalysis](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCastAnalysis/)
  *
  * @since 4.28
  */
@@ -93,14 +86,17 @@ export abstract class ArcgisShadowCast extends LitElement {
    * // Get the ShadowCastAnalysisView3D.
    * const analysisView = await viewElement.whenAnalysisView(analysis);
    *
-   * // Click in the Scene and get the shadow duration in that specific point.
+   * // Click in the Scene and get the shadow or sunlight duration at that specific point.
    * viewElement.addEventListener("arcgisViewClick", async (event) => {
    *   const screenPoint = { x: event.detail.x, y: event.detail.y };
    *   const duration = await analysisView.getDurationAtScreen(screenPoint);
-   *   console.log("Shadow duration (minutes):", duration);
+   *   console.log("Duration (milliseconds):", duration);
    * });
    * ```
    * Whenever the component is destroyed, the analysis is automatically removed from the collection.
+   * Use this property to configure analysis options that are not exposed by the component UI. For example, the component
+   * does not provide UI controls for setting a polygonal analysis area or custom color stops; configure those directly
+   * on the analysis.
    *
    * Alternatively, a programmatically created [ShadowCastAnalysis](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCastAnalysis/)
    * can be provided to the component.
@@ -137,7 +133,7 @@ export abstract class ArcgisShadowCast extends LitElement {
    */
   accessor autoDestroyDisabled: boolean;
   /**
-   * 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.
+   * The calendar date used to calculate the shadow or sunlight visualization. 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.
    * If no date is set, then it defaults to the current date in local system time.
    *
    * _See also_
@@ -147,23 +143,24 @@ export abstract class ArcgisShadowCast extends LitElement {
   get date(): Date;
   set date(value: Date | number | string);
   /**
-   * Color of the shadow visualization in "discrete" [mode](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#mode). 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.
+   * Color of the visualization in `"discrete"` [mode](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#mode). The opacity of the
+   * visualization is mapped to the number of overlapping shadow or sunlight samples. No duration corresponds to opacity
+   * 0 and the maximum sample count corresponds to the opacity set in this color value. The component UI exposes a single
+   * color for this mode.
    *
    * @since 5.0
    */
   accessor discreteColor: Color;
   /**
-   * Individual shadows are displayed at this time interval in "discrete" [mode](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#mode), 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
-   * maximum of 255 samples.
+   * Individual shadow or sunlight samples are displayed at this time interval in `"discrete"`
+   * [mode](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#mode), starting with the start time of day. The interval is expressed in
+   * milliseconds. If set to 0, the analysis uses the smallest possible interval, up to a maximum of 255 samples.
    *
    * @since 5.0
    */
   accessor discreteInterval: number;
   /**
-   * Time (in milliseconds from midnight of the [date](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#date)) when the shadow cast computation should stop.
+   * Time (in milliseconds from midnight of the [date](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#date)) when the shadow or sunlight computation should stop.
    *
    * [Read more](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCastAnalysis/#endTimeOfDay)
    */
@@ -251,7 +248,7 @@ export abstract class ArcgisShadowCast extends LitElement {
    */
   accessor hideMinDurationSlider: boolean;
   /**
-   * If true, the tooltip which displays the amount of shadow at a certain location will be hidden.
+   * If true, the tooltip which displays the shadow or sunlight duration at a certain location will be hidden.
    *
    * @default false
    * @since 5.0
@@ -343,7 +340,29 @@ export abstract class ArcgisShadowCast extends LitElement {
           continuousLabel: string;
           hourlyLabel: string;
       };
+      sunlight: {
+          discrete: {
+              optionLabel: string;
+              colorLabel: string;
+              intervalLabel: string;
+          };
+          minDuration: {
+              optionLabel: string;
+              colorLabel: string;
+              minDurationLabel: string;
+              discreteLabel: string;
+              discreteColorLabel: string;
+          };
+          totalDuration: {
+              optionLabel: string;
+              colorLabel: string;
+              modeLabel: string;
+              continuousLabel: string;
+              hourlyLabel: string;
+          };
+      };
       timeInShadow: string;
+      timeInSunlight: string;
       timeRangeHeading: string;
       timeRangeSliderLabel: string;
       timezoneLabel: string;
@@ -370,45 +389,72 @@ export abstract class ArcgisShadowCast extends LitElement {
           continuousLabel: string;
           hourlyLabel: string;
       };
+      sunlight: {
+          discrete: {
+              optionLabel: string;
+              colorLabel: string;
+              intervalLabel: string;
+          };
+          minDuration: {
+              optionLabel: string;
+              colorLabel: string;
+              minDurationLabel: string;
+              discreteLabel: string;
+              discreteColorLabel: string;
+          };
+          totalDuration: {
+              optionLabel: string;
+              colorLabel: string;
+              modeLabel: string;
+              continuousLabel: string;
+              hourlyLabel: string;
+          };
+      };
       timeInShadow: string;
+      timeInSunlight: string;
       timeRangeHeading: string;
       timeRangeSliderLabel: string;
       timezoneLabel: string;
       visualizationLabel: string;
   }>;
   /**
-   * The minimum duration (in milliseconds) used in "min-duration" [mode](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#mode) to determine which shadow areas are displayed.
+   * The minimum duration (in milliseconds) used in `"min-duration"` [mode](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#mode) to
+   * determine which shadowed or sunlit areas are displayed.
    *
    * @since 5.0
    */
   accessor minDuration: number;
   /**
-   * Color of the shadow visualization in "min-duration" [mode](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#mode). The areas with cumulative shadow time longer than
-   * the minimum duration value are displayed with this color.
+   * Color of the visualization in `"min-duration"` [mode](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#mode). Areas with cumulative
+   * shadow or sunlight time longer than the minimum duration value are displayed with this color.
    *
    * @since 5.0
    */
   accessor minDurationColor: Color;
   /**
-   * The color used when showing additional context in "min-duration" [mode](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#mode) when
-   * [minDurationContextEnabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#minDurationContextEnabled) is true.
+   * The color used when showing additional context in `"min-duration"` [mode](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#mode) when
+   * [minDurationContextEnabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#minDurationContextEnabled) is true. This context applies to shadow
+   * visualization and is not used when [visualizeSunlight](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#visualizeSunlight) is `true`.
    *
    * @since 5.0
    */
   accessor minDurationContextColor: Color;
   /**
    * Whether to enable additional context showing discrete shadows at the same time as displaying shadows above a
-   * minimum duration when in the "min-duration" [mode](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#mode). The [minDurationContextColor](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#minDurationContextColor)
+   * minimum duration when in `"min-duration"` [mode](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#mode). The [minDurationContextColor](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#minDurationContextColor)
    * and [minDurationContextInterval](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#minDurationContextInterval) properties are used to configure the visualization of the
-   * discrete shadows when context is enabled.
+   * discrete shadows when context is enabled. This context is hidden when
+   * [visualizeSunlight](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#visualizeSunlight) is `true` because the equivalent sunlight context would show
+   * broad areas not in shadow at each sample and can obscure the threshold result.
    *
    * @default false
    * @since 5.0
    */
   accessor minDurationContextEnabled: boolean;
   /**
-   * The interval in milliseconds used when showing additional context in "min-duration" [mode](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#mode) when
-   * [minDurationContextEnabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#minDurationContextEnabled) is true.
+   * The interval in milliseconds used when showing additional context in `"min-duration"` [mode](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#mode) when
+   * [minDurationContextEnabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#minDurationContextEnabled) is true. This context applies to shadow
+   * visualization and is not used when [visualizeSunlight](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#visualizeSunlight) is `true`.
    *
    * @since 5.0
    */
@@ -421,12 +467,11 @@ export abstract class ArcgisShadowCast extends LitElement {
    */
   accessor minMinDuration: number;
   /**
-   * Mode of analysis to use when computing and displaying the shadows. There are 3 types:
-   * - "discrete": Displays individual shadow snapshots at regular time intervals within the selected time range.
-   * - "min-duration": Displays shadows only in areas where accumulated shading exceeds a user‑defined minimum duration
-   * within the selected time range. Optional discrete shadow overlays can provide additional context.
-   * - "total-duration": Displays total shadow accumulation within the selected time range using opacity: areas with
-   * longer shadow duration appear more opaque. Supports continuous or 1‑hour aggregated modes.
+   * Mode of analysis to use when computing and displaying shadows or sunlight.
+   *
+   * - `"discrete"`: Displays individual shadow or sunlight snapshots at regular time intervals within the selected time range.
+   * - `"min-duration"`: Displays areas where accumulated shadow or sunlight exceeds a user-defined minimum duration within the selected time range. When visualizing shadows, optional discrete shadow overlays can provide additional context.
+   * - `"total-duration"`: Displays total shadow or sunlight accumulation within the selected time range. Supports continuous or 1-hour aggregated modes.
    *
    * @since 5.0
    */
@@ -438,7 +483,7 @@ export abstract class ArcgisShadowCast extends LitElement {
    */
   accessor referenceElement: ArcgisReferenceElement | string | undefined;
   /**
-   * Time (in milliseconds from midnight of the [date](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#date)) when the shadow cast computation should start.
+   * Time (in milliseconds from midnight of the [date](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#date)) when the shadow or sunlight computation should start.
    *
    * [Read more](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCastAnalysis/#startTimeOfDay)
    */
@@ -451,27 +496,43 @@ export abstract class ArcgisShadowCast extends LitElement {
    */
   get state(): "disabled" | "ready";
   /**
-   * Color of the shadow visualization in "total-duration" [mode](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#mode). 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.
+   * Color of the visualization in `"total-duration"` [mode](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#mode). The opacity is mapped
+   * to the time spent in shadow or sunlight. Areas with no duration are displayed with zero opacity and areas with the
+   * maximum duration use the opacity specified in this property. The component UI exposes a single color for this mode.
    *
    * @since 5.0
    */
   accessor totalDurationColor: Color;
   /**
-   * Mode in which the cumulative shadow duration should be displayed in "total-duration" [mode](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#mode): as a continuous
-   * surface or as an hourly aggregation of values.
+   * Mode in which the cumulative shadow or sunlight duration should be displayed in `"total-duration"`
+   * [mode](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#mode): as a continuous surface or as an hourly aggregation of values.
    *
    * @since 5.0
    */
   accessor totalDurationMode: ShadowCastTotalDurationMode;
-  /** The difference in hours between UTC time and the times displayed in the component. */
+  /**
+   * The UTC offset in hours used to interpret the selected date and time range for the analysis. If not specified, the
+   * component automatically determines an approximate UTC offset based on the camera location.
+   */
   accessor utcOffset: number | null | undefined;
   /**
    * The view associated with the component. 
    *   > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the arcgis-shadow-cast component will be associated with a map or scene component rather than using the `view` property.
    */
   accessor view: SceneView | undefined;
+  /**
+   * When `true`, the component visualizes sunlight duration instead of shadow duration. This applies to all modes,
+   * their respective options, and the duration returned by
+   * [getDurationAtScreen()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#getDurationAtScreen). In sunlight mode, the discrete context controls in the
+   * `"min-duration"` [mode](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#mode) are hidden because the equivalent sunlight context
+   * would show broad areas not in shadow at each sample and can obscure the threshold result.
+   *
+   * [Read more](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCastAnalysis/#visualizeSunlight)
+   *
+   * @default false
+   * @since 5.1
+   */
+  accessor visualizeSunlight: boolean;
   /**
    * Specifies the size of the component.
    *
@@ -483,14 +544,16 @@ export abstract class ArcgisShadowCast extends LitElement {
   /** Permanently destroy the component. */
   destroy(): Promise<void>;
   /**
-   * Returns the time (in milliseconds) spent in shadow for a certain point on the screen.
+   * Returns the duration (in milliseconds) for a certain point on the screen based on the current analysis settings.
+   * By default, this method returns the time spent in shadow. When
+   * [visualizeSunlight](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/#visualizeSunlight) is `true`, this method returns the time spent in sunlight.
    *
-   * [Read more](https://developers.arcgis.com/javascript/latest/references/core/views/3d/analysis/ShadowCast/ShadowCastAnalysisView3D/#getDurationAtScreen)
+   * [Read more](https://developers.arcgis.com/javascript/latest/references/core/views/3d/analysis/ShadowCastAnalysisView3D/#getDurationAtScreen)
    *
    * @param point
    * @since 5.0
    */
-  getDurationAtScreen(point: Point): Promise<number>;
+  getDurationAtScreen(point: ScreenPoint): Promise<number>;
   "@setterTypes": {
     date?: Date | number | string;
   };