@arcgis/core 5.1.0-next.92 → 5.1.0-next.93

package/analysis/ShadowCast/DiscreteOptions.d.ts

@@ -8,8 +8,9 @@ import type { ColorStopProperties } from "../../renderers/visualVariables/suppor
 export interface DiscreteOptionsProperties extends Partial<Pick<DiscreteOptions, "interval">> {
   /**
    * 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.
+   * overlapping shadows. When [ShadowCastAnalysis.visualizeSunlight](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCastAnalysis/#visualizeSunlight) is `true`, the opacity is mapped
+   * to the number of overlapping sunlight samples instead. Areas with no shadow or sunlight are displayed with zero
+   * opacity and areas with the maximum overlap 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.
    *
@@ -20,7 +21,9 @@ export interface DiscreteOptionsProperties extends Partial<Pick<DiscreteOptions,
   /**
    * The color stops for the visualization.
    *
-   * - Each stop defines a color and the corresponding number of overlapping shadows.
+   * - Each stop defines a color and the corresponding number of overlapping shadows. When
+   *   [ShadowCastAnalysis.visualizeSunlight](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCastAnalysis/#visualizeSunlight) is `true`, each stop defines the corresponding number of
+   *   overlapping sunlight samples instead.
    * - 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.
    *
@@ -49,8 +52,9 @@ export default class DiscreteOptions extends Clonable {
   constructor(properties?: DiscreteOptionsProperties);
   /**
    * 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.
+   * overlapping shadows. When [ShadowCastAnalysis.visualizeSunlight](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCastAnalysis/#visualizeSunlight) is `true`, the opacity is mapped
+   * to the number of overlapping sunlight samples instead. Areas with no shadow or sunlight are displayed with zero
+   * opacity and areas with the maximum overlap 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.
    *
@@ -62,7 +66,9 @@ export default class DiscreteOptions extends Clonable {
   /**
    * The color stops for the visualization.
    *
-   * - Each stop defines a color and the corresponding number of overlapping shadows.
+   * - Each stop defines a color and the corresponding number of overlapping shadows. When
+   *   [ShadowCastAnalysis.visualizeSunlight](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCastAnalysis/#visualizeSunlight) is `true`, each stop defines the corresponding number of
+   *   overlapping sunlight samples instead.
    * - 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.
    *

package/analysis/ShadowCast/MinDurationOptions.d.ts

@@ -7,9 +7,11 @@ import type { Clonable } from "../../core/Clonable.js";
 /** @since 5.0 */
 export interface MinDurationOptionsProperties extends Partial<Pick<MinDurationOptions, "contextEnabled" | "minDuration">> {
   /**
-   * 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.
+   * Defines the color used to display areas where the cumulative shadow duration meets
+   * [minDuration](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCast/MinDurationOptions/#minDuration). When
+   * [ShadowCastAnalysis.visualizeSunlight](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCastAnalysis/#visualizeSunlight) is `true`, this color displays areas where cumulative
+   * sunlight duration meets [minDuration](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCast/MinDurationOptions/#minDuration). Areas with shorter duration are
+   * displayed with zero opacity.
    *
    * @default [255, 0, 0, 0.7]
    * @since 5.0
@@ -18,7 +20,8 @@ export interface MinDurationOptionsProperties extends Partial<Pick<MinDurationOp
   /**
    * The configuration used when showing additional context by setting
    * [contextEnabled](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCast/MinDurationOptions/#contextEnabled) to true.
-   * The default configuration will show the shadows at one hour intervals as context for the visualization.
+   * The default configuration will show shadows at one hour intervals as context for the visualization. When
+   * [ShadowCastAnalysis.visualizeSunlight](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCastAnalysis/#visualizeSunlight) is `true`, it will show sunlight at one hour intervals.
    *
    * @since 5.0
    * @see [contextEnabled](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCast/MinDurationOptions/#contextEnabled)
@@ -39,9 +42,11 @@ export default class MinDurationOptions extends Clonable {
   /** @since 5.0 */
   constructor(properties?: MinDurationOptionsProperties);
   /**
-   * 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.
+   * Defines the color used to display areas where the cumulative shadow duration meets
+   * [minDuration](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCast/MinDurationOptions/#minDuration). When
+   * [ShadowCastAnalysis.visualizeSunlight](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCastAnalysis/#visualizeSunlight) is `true`, this color displays areas where cumulative
+   * sunlight duration meets [minDuration](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCast/MinDurationOptions/#minDuration). Areas with shorter duration are
+   * displayed with zero opacity.
    *
    * @default [255, 0, 0, 0.7]
    * @since 5.0
@@ -50,6 +55,7 @@ export default class MinDurationOptions extends Clonable {
   set color(value: ColorLike);
   /**
    * Whether to enable additional context showing discrete shadows at the same time as displaying the minimum duration.
+   * When [ShadowCastAnalysis.visualizeSunlight](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCastAnalysis/#visualizeSunlight) is `true`, the context shows discrete sunlight instead.
    * The [contextOptions](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCast/MinDurationOptions/#contextOptions) property is used to configure the visualization
    * of the discrete shadows when context is enabled.
    *
@@ -61,7 +67,8 @@ export default class MinDurationOptions extends Clonable {
   /**
    * The configuration used when showing additional context by setting
    * [contextEnabled](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCast/MinDurationOptions/#contextEnabled) to true.
-   * The default configuration will show the shadows at one hour intervals as context for the visualization.
+   * The default configuration will show shadows at one hour intervals as context for the visualization. When
+   * [ShadowCastAnalysis.visualizeSunlight](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCastAnalysis/#visualizeSunlight) is `true`, it will show sunlight at one hour intervals.
    *
    * @since 5.0
    * @see [contextEnabled](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCast/MinDurationOptions/#contextEnabled)
@@ -70,7 +77,8 @@ export default class MinDurationOptions extends Clonable {
   set contextOptions(value: DiscreteOptionsProperties);
   /**
    * Minimum shadow duration (in milliseconds). Shadows are only displayed in areas where the cumulative shadow duration
-   * meets or exceeds this value. Areas with shorter shadow durations will appear without shadows.
+   * meets this value. When [ShadowCastAnalysis.visualizeSunlight](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCastAnalysis/#visualizeSunlight) is `true`, this value is interpreted
+   * as the minimum sunlight duration and areas with shorter sunlight duration will appear without sunlight.
    *
    * @default 4 * 3600 * 1000
    * @since 5.0

package/analysis/ShadowCast/TotalDurationOptions.d.ts

@@ -9,8 +9,9 @@ import type { ColorStopProperties } from "../../renderers/visualVariables/suppor
 export interface TotalDurationOptionsProperties extends Partial<Pick<TotalDurationOptions, "mode">> {
   /**
    * 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.
+   * in shadow. When [ShadowCastAnalysis.visualizeSunlight](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCastAnalysis/#visualizeSunlight) is `true`, the opacity is mapped to the time
+   * spent in sunlight instead. Areas that don't receive any shadow or sunlight are displayed with zero opacity and areas
+   * that receive shadow or sunlight 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.
    *
@@ -21,7 +22,8 @@ export interface TotalDurationOptionsProperties extends Partial<Pick<TotalDurati
   /**
    * The color stops for the visualization.
    *
-   * - Each stop defines a color and a value in milliseconds.
+   * - Each stop defines a color and a duration value in milliseconds. The value represents shadow duration by default
+   *   and sunlight duration when [ShadowCastAnalysis.visualizeSunlight](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCastAnalysis/#visualizeSunlight) is `true`.
    * - 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.
    *
@@ -50,8 +52,9 @@ export default class TotalDurationOptions extends Clonable {
   constructor(properties?: TotalDurationOptionsProperties);
   /**
    * 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.
+   * in shadow. When [ShadowCastAnalysis.visualizeSunlight](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCastAnalysis/#visualizeSunlight) is `true`, the opacity is mapped to the time
+   * spent in sunlight instead. Areas that don't receive any shadow or sunlight are displayed with zero opacity and areas
+   * that receive shadow or sunlight 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.
    *
@@ -63,7 +66,8 @@ export default class TotalDurationOptions extends Clonable {
   /**
    * The color stops for the visualization.
    *
-   * - Each stop defines a color and a value in milliseconds.
+   * - Each stop defines a color and a duration value in milliseconds. The value represents shadow duration by default
+   *   and sunlight duration when [ShadowCastAnalysis.visualizeSunlight](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCastAnalysis/#visualizeSunlight) is `true`.
    * - 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.
    *

package/analysis/ShadowCastAnalysis.d.ts

@@ -47,9 +47,9 @@ export interface ShadowCastAnalysisProperties extends AnalysisProperties, Partia
 }
 
 /**
- * The ShadowCastAnalysis displays the cumulative shadows of 3D features in a
+ * The ShadowCastAnalysis displays the cumulative shadows or sunlight of 3D features in a
  * [SceneView](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/). This type of analysis is helpful in urban development,
- * where new projects have to satisfy certain shadow duration constraints.
+ * where new projects have to satisfy certain shadow or sunlight duration constraints.
  *
  * The analysis 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
@@ -64,27 +64,30 @@ export interface ShadowCastAnalysisProperties extends AnalysisProperties, Partia
  * The analysis provides three visualization modes.
  *
  * **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,
+ * within the selected time range. When [visualizeSunlight](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCastAnalysis/#visualizeSunlight) is `true`, the same mode
+ * displays sunlight only in areas where sunlight accumulates for longer than the specified duration. In the image below,
  * on May 1, 2021, shadows are displayed only where shading exceeds 4 hours between 10AM and 4PM.
  *
  * [![minimum duration mode](https://developers.arcgis.com/javascript/latest/assets/references/core/analysis/shadow-cast-analysis-threshold.avif)](https://developers.arcgis.com/javascript/latest/sample-code/shadow-cast/)
  *
- * **Total shadow duration** mode displays the cumulative duration of shadow within the selected time range using opacity:
+ * **Total 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.
+ * use a default opacity of 0.7. Intermediate values are interpolated. When
+ * [visualizeSunlight](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCastAnalysis/#visualizeSunlight) is `true`, opacity is mapped to cumulative sunlight duration
+ * instead. This mode can visualize duration continuously or in 1-hour intervals.
  *
  * [![total duration mode](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/)
  *
- * **Discrete shadows** mode displays individual shadows at regular intervals within the selected time range.
+ * **Discrete** mode displays individual shadows at regular intervals within the selected time range. When
+ * [visualizeSunlight](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCastAnalysis/#visualizeSunlight) is `true`, it displays the sunlight at those intervals instead.
  * 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.
  *
  * [![discrete mode](https://developers.arcgis.com/javascript/latest/assets/references/core/analysis/shadow-cast-analysis-discrete.avif)](https://developers.arcgis.com/javascript/latest/sample-code/shadow-cast/)
  *
- * By default, the analysis also displays a tooltip next to the pointer that reports the total shadow duration at that
- * location, rounded to 15‑minute increments. This allows you to inspect precise shadow durations anywhere within the
- * view without additional configuration.
+ * By default, the analysis also displays a tooltip next to the pointer that reports the total duration at that
+ * location, rounded to 15-minute increments. The tooltip reports shadow duration by default and sunlight duration when
+ * [visualizeSunlight](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCastAnalysis/#visualizeSunlight) is `true`.
  *
  * To perform a shadow cast analysis in your [WebScene](https://developers.arcgis.com/javascript/latest/references/core/WebScene/):
  * - Create a new instance of ShadowCastAnalysis.
@@ -99,7 +102,7 @@ export interface ShadowCastAnalysisProperties extends AnalysisProperties, Partia
  *
  * Use the [ShadowCastAnalysisView3D](https://developers.arcgis.com/javascript/latest/references/core/views/3d/analysis/ShadowCastAnalysisView3D/) class and its
  * [ShadowCastAnalysisView3D.getDurationAtScreen()](https://developers.arcgis.com/javascript/latest/references/core/views/3d/analysis/ShadowCastAnalysisView3D/#getDurationAtScreen) method to
- * obtain the shadow duration at a specific screen location programmatically.
+ * obtain the shadow or sunlight duration at a specific screen location programmatically.
  * To disable the shadow tooltip next to the pointer set the [ShadowCastAnalysisView3D.interactive](https://developers.arcgis.com/javascript/latest/references/core/views/3d/analysis/ShadowCastAnalysisView3D/#interactive)
  * property to `false`.
  *
@@ -123,7 +126,7 @@ export interface ShadowCastAnalysisProperties extends AnalysisProperties, Partia
  * // use getDurationAtScreen method from the analysis view once available
  * const analysisView = await view.whenAnalysisView(shadowCastAnalysis);
  *
- * // get shadow duration at the pointer location
+ * // get shadow or sunlight duration at the pointer location
  * view.on("pointer-move", async (event) => {
  *   // duration in milliseconds
  *   const duration = await analysisView.getDurationAtScreen({ x: event.x, y: event.y });
@@ -196,11 +199,14 @@ export default class ShadowCastAnalysis extends Analysis {
   get minDurationOptions(): MinDurationOptions;
   set minDurationOptions(value: MinDurationOptionsProperties);
   /**
-   * Mode of analysis to use when computing and displaying shadows.
+   * Mode of analysis to use when computing and displaying shadows or sunlight.
    *
    * - "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.
+   * - "min-duration": Displays areas where accumulated shading exceeds a user-defined minimum duration within the selected time range. Optional discrete 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.
+   *
+   * When [visualizeSunlight](https://developers.arcgis.com/javascript/latest/references/core/analysis/ShadowCastAnalysis/#visualizeSunlight) is `true`, the selected mode displays sunlight duration
+   * instead of shadow duration.
    *
    * @default "min-duration"
    * @since 5.0
@@ -251,8 +257,8 @@ export default class ShadowCastAnalysis extends Analysis {
    */
   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.
+   * When `true`, the analysis visualizes sunlight duration instead of shadow duration. This applies to all modes and
+   * their respective options.
    *
    * @default false
    * @since 5.1

package/assets/components/assets/combobox/t9n/messages.fr.json

@@ -1 +1 @@
-{"add":"Ajouter : {text}","all":"Tout","allSelected":"Toute la sélection","clear":"Effacer la valeur","noMatches":"Aucune correspondance","removeTag":"Supprimer la balise","required":"Obligatoire","selectAll":"Sélectionner tout","selected":"sélectionné(s)","nonEditable":"{value} en lecture seule","disabledSelectedCount":"+{count}"}
+{"add":"Ajouter : {text}","all":"Tout","allSelected":"Toute la sélection","clear":"Effacer la valeur","noMatches":"Aucune correspondance","removeTag":"Supprimer la balise","required":"Obligatoire","selectAll":"Sélectionner tout","selected":"sélectionné(s)","nonEditable":"{value} en lecture seule","disabledSelectedCount":"+ {count}"}