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

package/widgets/ShadowCast/DiscreteOptions.d.ts

@@ -1,4 +1,53 @@
-import "../../interfaces";
+import type Color from "../../Color.js";
+import type Accessor from "../../core/Accessor.js";
+import type Collection from "../../core/Collection.js";
+import type { ColorLike } from "../../Color.js";
+import type { ReadonlyArrayOrCollection } from "../../core/Collection.js";
 
-import ShadowCastDiscreteOptions = __esri.ShadowCastDiscreteOptions;
-export default ShadowCastDiscreteOptions;
+/** @deprecated since 5.0. Use the [ShadowCastAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ShadowCastAnalysis.html) or [Shadow Cast component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-shadow-cast/) instead. For information on widget deprecation, read about [Esri's move to web components](https://developers.arcgis.com/javascript/latest/components-transition-plan/). */
+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.
+   *
+   * @default [50, 50, 50, 0.7]
+   */
+  color?: ColorLike;
+  /** Values (in minutes) selectable in the UI for the interval used to accumulate shadows. */
+  intervalOptions?: ReadonlyArrayOrCollection<number>;
+}
+
+/**
+ * Configuration for the discrete visualization of the Shadow Cast
+ * [widget](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast.html) and
+ * [component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-shadow-cast/).
+ *
+ * @deprecated since 5.0. Use the [Shadow Cast component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-shadow-cast/) or [ShadowCastAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ShadowCastAnalysis.html) instead. For information on widget deprecation, read about [Esri's move to web components](https://developers.arcgis.com/javascript/latest/components-transition-plan/).
+ * @since 4.33
+ * @see [ShadowCast](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast.html) widget - Deprecated since 5.0. Use the [Shadow Cast component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-shadow-cast/) instead.
+ * @see [ShadowCastViewModel](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html) - Deprecated since 5.0. Use the [ShadowCastAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ShadowCastAnalysis.html) or [Shadow Cast component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-shadow-cast/) instead.
+ */
+export default class DiscreteOptions extends Accessor {
+  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.
+   *
+   * @default [50, 50, 50, 0.7]
+   */
+  get color(): Color;
+  set color(value: ColorLike);
+  /**
+   * 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
+   * maximum of 255 samples.
+   *
+   * @default 1 * 3600 * 1000
+   */
+  accessor interval: number;
+  /** Values (in minutes) selectable in the UI for the interval used to accumulate shadows. */
+  get intervalOptions(): Collection<number>;
+  set intervalOptions(value: ReadonlyArrayOrCollection<number>);
+}

package/widgets/ShadowCast/DurationMode.d.ts

@@ -0,0 +1,3 @@
+
+/** @deprecated since 5.0. Use the [Shadow Cast component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-shadow-cast/) or [ShadowCastAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ShadowCastAnalysis.html) instead. For information on widget deprecation, read about [Esri's move to web components](https://developers.arcgis.com/javascript/latest/components-transition-plan/). */
+export type DurationMode = "continuous" | "hourly";

package/widgets/ShadowCast/DurationOptions.d.ts

@@ -1,4 +1,46 @@
-import "../../interfaces";
+import type Color from "../../Color.js";
+import type Accessor from "../../core/Accessor.js";
+import type { DurationMode } from "./DurationMode.js";
+import type { ColorLike } from "../../Color.js";
 
-import ShadowCastDurationOptions = __esri.ShadowCastDurationOptions;
-export default ShadowCastDurationOptions;
+/** @deprecated since 5.0. Use the [ShadowCastAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ShadowCastAnalysis.html) or [Shadow Cast component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-shadow-cast/) instead. For information on widget deprecation, read about [Esri's move to web components](https://developers.arcgis.com/javascript/latest/components-transition-plan/). */
+export interface DurationOptionsProperties extends Partial<Pick<DurationOptions, "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.
+   *
+   * @default [0, 0, 255, 0.7]
+   */
+  color?: ColorLike;
+}
+
+/**
+ * Configuration for the duration visualization of the Shadow Cast
+ * [widget](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast.html) and
+ * [component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-shadow-cast/).
+ *
+ * @deprecated since 5.0. Use the [Shadow Cast component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-shadow-cast/) or [ShadowCastAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ShadowCastAnalysis.html) instead. For information on widget deprecation, read about [Esri's move to web components](https://developers.arcgis.com/javascript/latest/components-transition-plan/).
+ * @since 4.33
+ * @see [ShadowCast](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast.html) widget - Deprecated since 5.0. Use the [Shadow Cast component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-shadow-cast/) instead.
+ * @see [ShadowCastViewModel](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html) - Deprecated since 5.0. Use the [ShadowCastAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ShadowCastAnalysis.html) or [Shadow Cast component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-shadow-cast/) instead.
+ */
+export default class DurationOptions extends Accessor {
+  constructor(properties?: DurationOptionsProperties);
+  /**
+   * 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.
+   *
+   * @default [0, 0, 255, 0.7]
+   */
+  get color(): Color;
+  set color(value: ColorLike);
+  /**
+   * Mode in which the cumulative shadow duration should be displayed: as a continuous surface or as an hourly
+   * aggregation of values.
+   *
+   * @default "continuous"
+   */
+  accessor mode: DurationMode;
+}

package/widgets/ShadowCast/ShadowCastViewModel.d.ts

@@ -1,4 +1,118 @@
-import "../../interfaces";
+import type Accessor from "../../core/Accessor.js";
+import type SceneView from "../../views/SceneView.js";
+import type DiscreteOptions from "./DiscreteOptions.js";
+import type DurationOptions from "./DurationOptions.js";
+import type ThresholdOptions from "./ThresholdOptions.js";
+import type { ScreenPoint } from "../../core/interfaces.js";
+import type { ShadowVisualizationType } from "./ShadowVisualizationType.js";
+import type { ThresholdOptionsProperties } from "./ThresholdOptions.js";
+import type { DurationOptionsProperties } from "./DurationOptions.js";
+import type { DiscreteOptionsProperties } from "./DiscreteOptions.js";
 
-import ShadowCastViewModel = __esri.ShadowCastViewModel;
-export default ShadowCastViewModel;
+/** @deprecated since 5.0. Use the [ShadowCastAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ShadowCastAnalysis.html) or [Shadow Cast component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-shadow-cast/) instead. For information on widget deprecation, read about [Esri's move to web components](https://developers.arcgis.com/javascript/latest/components-transition-plan/). */
+export interface ShadowCastViewModelProperties extends Partial<Pick<ShadowCastViewModel, "endTimeOfDay" | "startTimeOfDay" | "utcOffset" | "view" | "visualizationType">> {
+  /**
+   * 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.
+   * If no date is set, then it defaults to the current date in local system time.
+   *
+   * @example widget.viewModel.date = new Date('June 1, 2021');
+   */
+  date?: (Date | number | string);
+  /** The configuration used when the widget's [visualizationType](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#visualizationType) is set to "discrete". */
+  discreteOptions?: DiscreteOptionsProperties;
+  /** The configuration used when the widget's [visualizationType](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#visualizationType) is set to "duration". */
+  durationOptions?: DurationOptionsProperties;
+  /** The configuration used when the widget's [visualizationType](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#visualizationType) is set to "threshold". */
+  thresholdOptions?: ThresholdOptionsProperties;
+}
+
+/** @deprecated since 5.0. Use the [ShadowCastAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ShadowCastAnalysis.html) or [Shadow Cast component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-shadow-cast/) instead. For information on widget deprecation, read about [Esri's move to web components](https://developers.arcgis.com/javascript/latest/components-transition-plan/). */
+export type ShadowCastState = "disabled" | "ready";
+
+/**
+ * Provides the logic for the [ShadowCast](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast.html) widget and [component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-shadow-cast/).
+ *
+ * @deprecated since 5.0. Use the [Shadow Cast component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-shadow-cast/) or [ShadowCastAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ShadowCastAnalysis.html) instead. For information on widget deprecation, read about [Esri's move to web components](https://developers.arcgis.com/javascript/latest/components-transition-plan/).
+ * @since 4.21
+ * @see [ShadowCast](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast.html) widget - _Deprecated since 5.0. Use the [Shadow Cast component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-shadow-cast/) instead._
+ * @see [Shadow Cast component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-shadow-cast/)
+ * @see [Sample - Shadow cast](https://developers.arcgis.com/javascript/latest/sample-code/widgets-shadow-cast/)
+ * @see [Programming patterns: Widget viewModel pattern](https://developers.arcgis.com/javascript/latest/programming-patterns/#widget-viewmodel-pattern)
+ */
+export default class ShadowCastViewModel extends Accessor {
+  constructor(properties?: ShadowCastViewModelProperties);
+  /**
+   * 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.
+   * If no date is set, then it defaults to the current date in local system time.
+   *
+   * @example widget.viewModel.date = new Date('June 1, 2021');
+   */
+  get date(): Date;
+  set date(value: (Date | number | string));
+  /** The configuration used when the widget's [visualizationType](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#visualizationType) is set to "discrete". */
+  get discreteOptions(): DiscreteOptions;
+  set discreteOptions(value: DiscreteOptionsProperties);
+  /** The configuration used when the widget's [visualizationType](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#visualizationType) is set to "duration". */
+  get durationOptions(): DurationOptions;
+  set durationOptions(value: DurationOptionsProperties);
+  /**
+   * Time (in milliseconds from midnight of the [date](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#date)) when the shadow cast computation should stop.
+   * By default the shadow cast end time is set to 4PM (16 * 3600 * 1000ms).
+   *
+   * @default 16 * 3600 * 1000
+   */
+  accessor endTimeOfDay: number;
+  /**
+   * Time (in milliseconds from midnight of the [date](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#date))
+   * when the shadow cast computation should start. By default the shadow
+   * cast start time is set to 10AM (10 * 3600 * 1000ms).
+   *
+   * @default 10 * 3600 * 1000
+   */
+  accessor startTimeOfDay: number;
+  /**
+   * The current state of the view model that can be used for rendering the UI
+   * of the widget.
+   *
+   * Value | Description
+   * ------------|-------------
+   * disabled | widget is being created
+   * ready | widget is ready
+   *
+   * @default "disabled"
+   */
+  get state(): ShadowCastState;
+  /** The configuration used when the widget's [visualizationType](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#visualizationType) is set to "threshold". */
+  get thresholdOptions(): ThresholdOptions;
+  set thresholdOptions(value: ThresholdOptionsProperties);
+  /** The difference in hours between UTC time and the times displayed in the widget. */
+  accessor utcOffset: number;
+  /**
+   * A reference to the [View](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View.html). This widget is only supported in a
+   * [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html).
+   */
+  accessor view: SceneView | null | undefined;
+  /**
+   * Type of visualization to use when showing the shadows. There are 3 types of visualization:
+   * - "threshold" only displays areas that receive shadows for a period longer than
+   * a given threshold value
+   * - "duration" displays all areas that receive shadows either in a continuous mode or in 1 hour time intervals
+   * - "discrete" mode displays individual shadows cast at a given time interval
+   *
+   * @default "threshold"
+   */
+  accessor visualizationType: ShadowVisualizationType;
+  /**
+   * 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 Resolves with the time in milliseconds spent in shadow for the given screenpoint.
+   */
+  getDuration(point: ScreenPoint): Promise<number>;
+  /** Starts the widget. While running it will automatically perform shadow accumulation. */
+  start(): void;
+  /** Stops the widget. */
+  stop(): void;
+}

package/widgets/ShadowCast/ShadowCastVisibleElements.d.ts

@@ -0,0 +1,81 @@
+import type Accessor from "../../core/Accessor.js";
+
+/** @deprecated since 5.0. Use the [ShadowCastAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ShadowCastAnalysis.html) or [Shadow Cast component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-shadow-cast/) instead. For information on widget deprecation, read about [Esri's move to web components](https://developers.arcgis.com/javascript/latest/components-transition-plan/). */
+export interface ShadowCastVisibleElementsProperties extends Partial<Pick<ShadowCastVisibleElements, "colorPicker" | "datePicker" | "thresholdContext" | "thresholdContextColor" | "thresholdContextTimeInterval" | "thresholdContextToggle" | "timeRangeSlider" | "timezone" | "tooltip" | "visualizationOptions">> {}
+
+/**
+ * The visible elements that are displayed within the widget.
+ * This provides the ability to turn individual elements of the widget's display on/off.
+ */
+export default abstract class ShadowCastVisibleElements extends Accessor {
+  /**
+   * When set to `false`, the color picker is not displayed in the options for any
+   *   of the visualization modes.
+   *
+   * @default true
+   */
+  accessor colorPicker: boolean;
+  /**
+   * When set to `false`, the date picker is not displayed.
+   *
+   * @default true
+   */
+  accessor datePicker: boolean;
+  /**
+   * When set to `false`, the discrete shadows configuration in the threshold
+   *   visualization mode is not displayed.
+   *
+   * @default true
+   */
+  accessor thresholdContext: boolean;
+  /**
+   * When set to `false`, the discrete shadows color picker in the
+   *   threshold visualization mode is not displayed.
+   *
+   * @default true
+   */
+  accessor thresholdContextColor: boolean;
+  /**
+   * When set to `false`, the discrete shadows time interval in
+   *   the threshold visualization mode is not displayed.
+   *
+   * @default true
+   */
+  accessor thresholdContextTimeInterval: boolean;
+  /**
+   * When set to `false`, the discrete shadows toggle in the threshold
+   *   visualization mode is not displayed. The discrete shadow configuration is not displayed when discreteToggle is
+   *   set to `false` and the discrete shadows visualization is turned off.
+   *
+   * @default true
+   */
+  accessor thresholdContextToggle: boolean;
+  /**
+   * When set to `false`, the slider used to select a time range for the
+   *   analysis is not displayed.
+   *
+   * @default true
+   */
+  accessor timeRangeSlider: boolean;
+  /**
+   * When set to `false`, the dropdown used to select a timezone for the time range
+   *   is not displayed.
+   *
+   * @default true
+   */
+  accessor timezone: boolean;
+  /**
+   * When set to `false`, the tooltip with the accumulated shadow time is not
+   *   displayed when hovering the view.
+   *
+   * @default true
+   */
+  accessor tooltip: boolean;
+  /**
+   * When set to `false`, the options for the various visualization modes
+   *   are not displayed.
+   *
+   * @default true
+   */
+  accessor visualizationOptions: boolean;
+}

package/widgets/ShadowCast/ShadowVisualizationType.d.ts

@@ -0,0 +1,3 @@
+
+/** @deprecated since 5.0. Use the [ShadowCastAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ShadowCastAnalysis.html) or [Shadow Cast component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-shadow-cast/) instead. For information on widget deprecation, read about [Esri's move to web components](https://developers.arcgis.com/javascript/latest/components-transition-plan/). */
+export type ShadowVisualizationType = "threshold" | "duration" | "discrete";

package/widgets/ShadowCast/ThresholdOptions.d.ts

@@ -1,4 +1,87 @@
-import "../../interfaces";
+import type Color from "../../Color.js";
+import type Accessor from "../../core/Accessor.js";
+import type DiscreteOptions from "./DiscreteOptions.js";
+import type { ColorLike } from "../../Color.js";
+import type { DiscreteOptionsProperties } from "./DiscreteOptions.js";
 
-import ShadowCastThresholdOptions = __esri.ShadowCastThresholdOptions;
-export default ShadowCastThresholdOptions;
+/** @deprecated since 5.0. Use the [ShadowCastAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ShadowCastAnalysis.html) or [Shadow Cast component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-shadow-cast/) instead. For information on widget deprecation, read about [Esri's move to web components](https://developers.arcgis.com/javascript/latest/components-transition-plan/). */
+export interface ThresholdOptionsProperties extends Partial<Pick<ThresholdOptions, "contextEnabled" | "maxValue" | "minValue" | "value">> {
+  /**
+   * Color of the shadow visualization. The areas with cumulative shadow time longer than the threshold value are
+   * displayed with this color.
+   *
+   * @default [255, 0 , 0, 0.7]
+   */
+  color?: ColorLike;
+  /**
+   * The configuration used when showing additional context by setting [contextEnabled](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ThresholdOptions.html#contextEnabled)
+   * to true. The default configuration will show the shadows at 1 hour intervals as context for the
+   * threshold visualization.
+   *
+   * @since 4.33
+   * @see [contextEnabled](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ThresholdOptions.html#contextEnabled)
+   */
+  contextOptions?: DiscreteOptionsProperties;
+}
+
+/**
+ * Configuration for the threshold visualization of the Shadow Cast
+ * [widget](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast.html) and
+ * [component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-shadow-cast/).
+ *
+ * @deprecated since 5.0. Use the [ShadowCastAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ShadowCastAnalysis.html) or [Shadow Cast component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-shadow-cast/) instead. For information on widget deprecation, read about [Esri's move to web components](https://developers.arcgis.com/javascript/latest/components-transition-plan/).
+ * @since 4.33
+ * @see [ShadowCast](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast.html) widget - Deprecated since 5.0. Use the [Shadow Cast component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-shadow-cast/) instead.
+ * @see [ShadowCastViewModel](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html) - Deprecated since 5.0. Use the [ShadowCastAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ShadowCastAnalysis.html) or [Shadow Cast component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-shadow-cast/) instead.
+ */
+export default class ThresholdOptions extends Accessor {
+  constructor(properties?: ThresholdOptionsProperties);
+  /**
+   * Color of the shadow visualization. The areas with cumulative shadow time longer than the threshold value are
+   * displayed with this color.
+   *
+   * @default [255, 0 , 0, 0.7]
+   */
+  get color(): Color;
+  set color(value: ColorLike);
+  /**
+   * Whether to enable additional context showing discrete shadows at the same time as displaying
+   * the threshold. The [contextOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ThresholdOptions.html#contextOptions) property is used to configure the
+   * visualization of the discrete shadows when context is enabled.
+   *
+   * @default false
+   * @since 4.33
+   * @see [contextOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ThresholdOptions.html#contextOptions)
+   */
+  accessor contextEnabled: boolean;
+  /**
+   * The configuration used when showing additional context by setting [contextEnabled](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ThresholdOptions.html#contextEnabled)
+   * to true. The default configuration will show the shadows at 1 hour intervals as context for the
+   * threshold visualization.
+   *
+   * @since 4.33
+   * @see [contextEnabled](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ThresholdOptions.html#contextEnabled)
+   */
+  get contextOptions(): DiscreteOptions;
+  set contextOptions(value: DiscreteOptionsProperties);
+  /**
+   * The maximum time period (in milliseconds) selectable in the UI for the threshold
+   * [value](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ThresholdOptions.html#value). The values in the widget slider are displayed in hours.
+   *
+   * @default 8 * 3600 * 1000
+   */
+  accessor maxValue: number;
+  /**
+   * The minimum time period (in milliseconds) selectable in the UI for the threshold
+   * [value](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ThresholdOptions.html#value). The values in the widget slider are displayed in hours.
+   *
+   * @default 0 * 3600 * 1000
+   */
+  accessor minValue: number;
+  /**
+   * Time period in milliseconds. Only shadows cast for more time than this value are displayed.
+   *
+   * @default 4 * 3600 * 1000
+   */
+  accessor value: number;
+}

package/widgets/ShadowCast.d.ts

@@ -1,4 +1,172 @@
-import "../interfaces";
+import type SceneView from "../views/SceneView.js";
+import type Widget from "./Widget.js";
+import type ShadowCastViewModel from "./ShadowCast/ShadowCastViewModel.js";
+import type ShadowCastVisibleElements from "./ShadowCast/ShadowCastVisibleElements.js";
+import type { Icon } from "@esri/calcite-components/components/calcite-icon";
+import type { WidgetProperties } from "./Widget.js";
+import type { HeadingLevel } from "./support/Heading.js";
+import type { ShadowCastViewModelProperties } from "./ShadowCast/ShadowCastViewModel.js";
+import type { ShadowCastVisibleElementsProperties } from "./ShadowCast/ShadowCastVisibleElements.js";
 
-import ShadowCast = __esri.ShadowCast;
-export default ShadowCast;
+export interface ShadowCastProperties extends WidgetProperties, Partial<Pick<ShadowCast, "headingLevel" | "view">> {
+  /**
+   * Icon which represents the widget. It is typically used when the widget is controlled by another
+   * one (e.g. in the Expand widget).
+   *
+   * @default "measure-building-height-shadow"
+   * @since 4.27
+   * @see [Calcite Icon Search](https://developers.arcgis.com/calcite-design-system/icons/)
+   * @see [Calcite Icon Search](https://developers.arcgis.com/calcite-design-system/icons/)
+   */
+  icon?: Icon["icon"] | null;
+  /**
+   * The widget's default label.
+   *
+   * @since 4.11
+   */
+  label?: string | null;
+  /**
+   * The view model for this widget. This is a class that contains all the logic (properties and methods)
+   * that controls this widget's behavior. See the [ShadowCastViewModel](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html)
+   * class to access all properties and methods on the widget.
+   */
+  viewModel?: ShadowCastViewModelProperties;
+  /**
+   * This property provides the ability to display or hide the individual elements of the widget.
+   *
+   * @example
+   * shadowCast.visibleElements = {
+   *   timeRangeSlider: true,
+   *   timezone: true,
+   *   datePicker: true,
+   *   visualizationOptions: true,
+   *   colorPicker: true,
+   *   tooltip: true
+   * }
+   */
+  visibleElements?: ShadowCastVisibleElementsProperties;
+}
+
+/**
+ * The ShadowCast widget displays the cumulative shadows of 3D features in a
+ * [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html). This type of analysis is helpful in urban development,
+ * where new projects have to satisfy certain shadow duration constraints.
+ *
+ * The widget 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, the [Daylight](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Daylight.html) widget can be used.
+ * Changing the timezone in the widget updates the visualization by interpreting the time range as being
+ * in that timezone. This behavior is different than for the [Daylight](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Daylight.html) widget
+ * where selecting a timezone updates the scene date and time according to the camera position.
+ *
+ * The widget provides three visualization modes.
+ *
+ * In the **threshold** mode, only the areas that receive
+ * shadows for more than a certain amount of time are displayed. In the image below, on May 1, 2021 the red areas receive
+ * shadow for more than 4 hours within the time interval of 10AM to 4PM.
+ *
+ * [![threshold mode](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/shadow-cast/shadow-cast-threshold.png)](https://developers.arcgis.com/javascript/latest/sample-code/widgets-shadow-cast/)
+ *
+ * **Total shadow duration** mode displays the duration of the cumulative shadow using opacity: areas that don't
+ * receive any shadow are fully transparent and areas that receive a maximum amount of shadow have a default opacity
+ * of 0.7. The values in between are interpolated. Hovering over the view will display a tooltip showing the
+ * amount of time that location is in shadow, rounded to 15 minute intervals. In this mode, the visualization
+ * can display shadow cast in a continuous way or in 1 hour intervals.
+ *
+ * [![duration mode](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/shadow-cast/shadow-cast-duration.png)](https://developers.arcgis.com/javascript/latest/sample-code/widgets-shadow-cast/)
+ *
+ * **Discrete shadows** is a third visualization mode which displays individual shadows at a given time interval.
+ * For example, setting the time range to 10AM-11AM and the visualization time interval to 30 minutes will display
+ * shadows for 10AM, 10:30AM and 11:00AM.
+ *
+ * [![discrete mode](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/shadow-cast/shadow-cast-discrete.png)](https://developers.arcgis.com/javascript/latest/sample-code/widgets-shadow-cast/)
+ *
+ * The defaults for the time range and visualization settings can be changed using the
+ * [ShadowCastViewModel](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html).
+ *
+ * > [!WARNING]
+ * >
+ * > **Known Limitations**
+ * >
+ * > Terrain does not cast shadows and it is therefore not taken into account in this analysis.
+ * >
+ * > The widget does not take into account the daylight savings.
+ * > 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 widget 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.
+ *
+ * You can use the view's [DefaultUI](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-ui-DefaultUI.html) to add widgets to the view's user interface via the
+ * `ui` property on the view. See the example below.
+ *
+ * @deprecated since 5.0. Use the [Shadow Cast component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-shadow-cast/) instead. For information on widget deprecation, read about [Esri's move to web components](https://developers.arcgis.com/javascript/latest/components-transition-plan/).
+ * @since 4.21
+ * @see [ShadowCastViewModel](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html) - _Deprecated since 5.0. Use the [ShadowCastAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ShadowCastAnalysis.html) or [Shadow Cast component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-shadow-cast/) instead._
+ * @see [SceneView#environment](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#environment)
+ * @see [DefaultUI](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-ui-DefaultUI.html)
+ * @see [Sample - Shadow cast](https://developers.arcgis.com/javascript/latest/sample-code/widgets-shadow-cast/)
+ * @example
+ * const shadowCast = new ShadowCast({
+ *   view: view
+ * });
+ * // Adds the shadow cast widget in
+ * // the top right corner of the view
+ * view.ui.add(shadowCast, "top-right");
+ */
+export default class ShadowCast extends Widget {
+  constructor(properties?: ShadowCastProperties);
+  /**
+   * Indicates the heading level to use for the titles "Time range" and "Visualization". By default, this message is rendered
+   * as level 4 headings (e.g. `<h4>Time range</h4>`). Depending on the widget's placement
+   * in your app, you may need to adjust this heading for proper semantics. This is
+   * important for meeting accessibility standards.
+   *
+   * @default 4
+   * @see [Heading Elements](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Heading_Elements)
+   * @example shadowCast.headingLevel = 3;
+   */
+  accessor headingLevel: HeadingLevel;
+  /**
+   * Icon which represents the widget. It is typically used when the widget is controlled by another
+   * one (e.g. in the Expand widget).
+   *
+   * @default "measure-building-height-shadow"
+   * @since 4.27
+   * @see [Calcite Icon Search](https://developers.arcgis.com/calcite-design-system/icons/)
+   * @see [Calcite Icon Search](https://developers.arcgis.com/calcite-design-system/icons/)
+   */
+  get icon(): Icon["icon"];
+  set icon(value: Icon["icon"] | null | undefined);
+  /**
+   * The widget's default label.
+   *
+   * @since 4.11
+   */
+  get label(): string;
+  set label(value: string | null | undefined);
+  /** A reference to the [View](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View.html). This widget is only supported in a [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html). */
+  accessor view: SceneView | null | undefined;
+  /**
+   * The view model for this widget. This is a class that contains all the logic (properties and methods)
+   * that controls this widget's behavior. See the [ShadowCastViewModel](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html)
+   * class to access all properties and methods on the widget.
+   */
+  get viewModel(): ShadowCastViewModel;
+  set viewModel(value: ShadowCastViewModelProperties);
+  /**
+   * This property provides the ability to display or hide the individual elements of the widget.
+   *
+   * @example
+   * shadowCast.visibleElements = {
+   *   timeRangeSlider: true,
+   *   timezone: true,
+   *   datePicker: true,
+   *   visualizationOptions: true,
+   *   colorPicker: true,
+   *   tooltip: true
+   * }
+   */
+  get visibleElements(): ShadowCastVisibleElements;
+  set visibleElements(value: ShadowCastVisibleElementsProperties);
+}