@arcgis/core 5.0.0-next.123 → 5.0.0-next.124

package/webscene/Environment.d.ts

@@ -27,11 +27,11 @@ export interface EnvironmentProperties extends Partial<Pick<Environment, "atmosp
    *
    *   Known Value | Example
    *   ------------|---------
-   *   [SunnyWeather](https://developers.arcgis.com/javascript/latest/references/core/views/3d/environment/SunnyWeather/) | ![scene-atmosphere](https://developers.arcgis.com/javascript/latest/assets/img/apiref/views/scene-weather-sunny.png)
-   *   [CloudyWeather](https://developers.arcgis.com/javascript/latest/references/core/views/3d/environment/CloudyWeather/) | ![scene-atmosphere](https://developers.arcgis.com/javascript/latest/assets/img/apiref/views/scene-weather-cloudy.png)
-   *   [RainyWeather](https://developers.arcgis.com/javascript/latest/references/core/views/3d/environment/RainyWeather/) | ![scene-atmosphere](https://developers.arcgis.com/javascript/latest/assets/img/apiref/views/scene-weather-rainy.png)
-   *   [SnowyWeather](https://developers.arcgis.com/javascript/latest/references/core/views/3d/environment/SnowyWeather/) | ![scene-atmosphere](https://developers.arcgis.com/javascript/latest/assets/img/apiref/views/scene-weather-snowy.png)
-   *   [FoggyWeather](https://developers.arcgis.com/javascript/latest/references/core/views/3d/environment/FoggyWeather/) | ![scene-atmosphere](https://developers.arcgis.com/javascript/latest/assets/img/apiref/views/scene-weather-foggy.png)
+   *   [SunnyWeather](https://developers.arcgis.com/javascript/latest/references/core/views/3d/environment/SunnyWeather/) | ![scene-atmosphere](https://developers.arcgis.com/javascript/latest/assets/images/apiref/views/scene-weather-sunny.png)
+   *   [CloudyWeather](https://developers.arcgis.com/javascript/latest/references/core/views/3d/environment/CloudyWeather/) | ![scene-atmosphere](https://developers.arcgis.com/javascript/latest/assets/images/apiref/views/scene-weather-cloudy.png)
+   *   [RainyWeather](https://developers.arcgis.com/javascript/latest/references/core/views/3d/environment/RainyWeather/) | ![scene-atmosphere](https://developers.arcgis.com/javascript/latest/assets/images/apiref/views/scene-weather-rainy.png)
+   *   [SnowyWeather](https://developers.arcgis.com/javascript/latest/references/core/views/3d/environment/SnowyWeather/) | ![scene-atmosphere](https://developers.arcgis.com/javascript/latest/assets/images/apiref/views/scene-weather-snowy.png)
+   *   [FoggyWeather](https://developers.arcgis.com/javascript/latest/references/core/views/3d/environment/FoggyWeather/) | ![scene-atmosphere](https://developers.arcgis.com/javascript/latest/assets/images/apiref/views/scene-weather-foggy.png)
    *
    * @default SunnyWeather
    */
@@ -51,7 +51,12 @@ export interface EnvironmentProperties extends Partial<Pick<Environment, "atmosp
 export default class Environment extends JSONSupport {
   constructor(properties?: EnvironmentProperties);
   /**
-   * Indicates whether atmosphere visualization (haze, sky) is enabled. Disabling the atmosphere will also disable weather.
+   * Indicates whether atmosphere visualization is enabled.
+   *
+   * Disabling the atmosphere will disable the following features:
+   * - Sky and haze
+   * - Any [weather](https://developers.arcgis.com/javascript/latest/references/core/webscene/Environment/#weather) visualization
+   * - Natural light scattering in fog and haze around light emitters.
    *
    * @default true
    */
@@ -78,11 +83,11 @@ export default class Environment extends JSONSupport {
    *
    *   Known Value | Example
    *   ------------|---------
-   *   [SunnyWeather](https://developers.arcgis.com/javascript/latest/references/core/views/3d/environment/SunnyWeather/) | ![scene-atmosphere](https://developers.arcgis.com/javascript/latest/assets/img/apiref/views/scene-weather-sunny.png)
-   *   [CloudyWeather](https://developers.arcgis.com/javascript/latest/references/core/views/3d/environment/CloudyWeather/) | ![scene-atmosphere](https://developers.arcgis.com/javascript/latest/assets/img/apiref/views/scene-weather-cloudy.png)
-   *   [RainyWeather](https://developers.arcgis.com/javascript/latest/references/core/views/3d/environment/RainyWeather/) | ![scene-atmosphere](https://developers.arcgis.com/javascript/latest/assets/img/apiref/views/scene-weather-rainy.png)
-   *   [SnowyWeather](https://developers.arcgis.com/javascript/latest/references/core/views/3d/environment/SnowyWeather/) | ![scene-atmosphere](https://developers.arcgis.com/javascript/latest/assets/img/apiref/views/scene-weather-snowy.png)
-   *   [FoggyWeather](https://developers.arcgis.com/javascript/latest/references/core/views/3d/environment/FoggyWeather/) | ![scene-atmosphere](https://developers.arcgis.com/javascript/latest/assets/img/apiref/views/scene-weather-foggy.png)
+   *   [SunnyWeather](https://developers.arcgis.com/javascript/latest/references/core/views/3d/environment/SunnyWeather/) | ![scene-atmosphere](https://developers.arcgis.com/javascript/latest/assets/images/apiref/views/scene-weather-sunny.png)
+   *   [CloudyWeather](https://developers.arcgis.com/javascript/latest/references/core/views/3d/environment/CloudyWeather/) | ![scene-atmosphere](https://developers.arcgis.com/javascript/latest/assets/images/apiref/views/scene-weather-cloudy.png)
+   *   [RainyWeather](https://developers.arcgis.com/javascript/latest/references/core/views/3d/environment/RainyWeather/) | ![scene-atmosphere](https://developers.arcgis.com/javascript/latest/assets/images/apiref/views/scene-weather-rainy.png)
+   *   [SnowyWeather](https://developers.arcgis.com/javascript/latest/references/core/views/3d/environment/SnowyWeather/) | ![scene-atmosphere](https://developers.arcgis.com/javascript/latest/assets/images/apiref/views/scene-weather-snowy.png)
+   *   [FoggyWeather](https://developers.arcgis.com/javascript/latest/references/core/views/3d/environment/FoggyWeather/) | ![scene-atmosphere](https://developers.arcgis.com/javascript/latest/assets/images/apiref/views/scene-weather-foggy.png)
    *
    * @default SunnyWeather
    */

package/webscene/Glow.d.ts

@@ -4,7 +4,8 @@ import type { JSONSupport } from "../core/JSONSupport.js";
 export interface GlowProperties extends Partial<Pick<Glow, "intensity">> {}
 
 /**
- * Glow accentuates the effects of light emitters for illustrative visualizations, such as highlighting or filtering.
+ * [Glow](https://developers.arcgis.com/javascript/latest/references/core/webscene/Glow/) accentuates the effects of light emitters for illustrative visualizations, such as highlighting
+ * or filtering. When [Glow](https://developers.arcgis.com/javascript/latest/references/core/webscene/Glow/) is `null`, mimic the natural behavior of light scattering in the atmosphere.
  *
  * > [!WARNING]
  * >
@@ -37,7 +38,8 @@ export interface GlowProperties extends Partial<Pick<Glow, "intensity">> {}
 export default class Glow extends GlowSuperclass {
   constructor(properties?: GlowProperties);
   /**
-   * Specifies the magnitude of the glow around light emitters.
+   * Specifies the magnitude of the glow around light emitters within a range of 0 to 1. Higher values will increase the
+   * affected area around light emitters.
    *
    * @default 0.5
    */

package/webscene/background/ColorBackground.d.ts

@@ -23,7 +23,7 @@ export interface ColorBackgroundProperties extends BackgroundProperties {
  *
  * The default for ColorBackground is a fully opaque, black color. The example below shows how to change this:
  *
- * ![background-color](https://developers.arcgis.com/javascript/latest/assets/img/apiref/views/background-color.png)
+ * ![background-color](https://developers.arcgis.com/javascript/latest/assets/images/apiref/views/background-color.png)
  *
  * ```js
  * const view = new SceneView({

package/widgets/AreaMeasurement2D.d.ts

@@ -87,7 +87,7 @@ export interface AreaMeasurement2DProperties extends WidgetProperties, Partial<P
  * * In geographic coordinate systems (GCS) and in Web Mercator, they are computed geodetically.
  * * In projected coordinate systems (PCS), apart from Web Mercator, they are computed in a Euclidean manner (in their respective PCS).
  *
- * [![measurement-area-2d](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/AreaMeasurement2D_widget.png)](https://developers.arcgis.com/javascript/latest/sample-code/widgets-measurement-2d/)
+ * [![measurement-area-2d](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/AreaMeasurement2D_widget.png)](https://developers.arcgis.com/javascript/latest/sample-code/widgets-measurement-2d/)
  *
  * ### Undo / Redo
  *

package/widgets/AreaMeasurement3D.d.ts

@@ -76,7 +76,7 @@ export interface AreaMeasurement3DProperties extends WidgetProperties, Partial<P
  * The AreaMeasurement3D widget calculates and displays the area and perimeter of a polygon.
  * This widget can be used in a [SceneView](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/) to measure the area and perimeter of a polygon.
  *
- * [![measurement-line-3d](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/3D_AreaMeasurement_widget.png)](https://developers.arcgis.com/javascript/latest/sample-code/widgets-measurement-3d/)
+ * [![measurement-line-3d](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/3D_AreaMeasurement_widget.png)](https://developers.arcgis.com/javascript/latest/sample-code/widgets-measurement-3d/)
  *
  * How the area and perimeter are computed depends on the scene's spatial reference and the length of the measured perimeter.
  *
@@ -95,7 +95,7 @@ export interface AreaMeasurement3DProperties extends WidgetProperties, Partial<P
  * 2. If the vertices have varying z-values and they create a **non-planar** surface, the visualization and the
  * measurements show the area and perimeter that are projected to a horizontal plane.
  *
- * ![area-measurement-3d-types](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/area-measurement-3d-types.png)
+ * ![area-measurement-3d-types](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/area-measurement-3d-types.png)
  *
  * When the widget is active, a horizontal "laser" line is drawn which indicates the height at the current mouse position.
  * This line can help in analyzing the heights of objects relative to each other and the terrain.

package/widgets/Attachments.d.ts

@@ -81,7 +81,7 @@ export interface VisibleElements {
  * > Editing attachments is currently available using the [Editor](https://developers.arcgis.com/javascript/latest/references/core/widgets/Editor/) widget.
  *
  * The following image displays the various displays of the attachment widget.
- * ![attachments](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/attachments-merged.png)
+ * ![attachments](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/attachments-merged.png)
  *
  * @deprecated since version 5.0. Use the [Popup](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/) and [Editor](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-editor/) components to view and edit attachments 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.15

package/widgets/Attribution.d.ts

@@ -51,7 +51,7 @@ export interface AttributionProperties extends WidgetProperties, Partial<Pick<At
  * [MapView](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/) and [SceneView](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/) by default.
  * See [DefaultUI](https://developers.arcgis.com/javascript/latest/references/core/views/ui/DefaultUI/) for more details.
  *
- * ![attribution](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/attribution.png)
+ * ![attribution](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/attribution.png)
  *
  * > [!WARNING]
  * >

package/widgets/BasemapGallery.d.ts

@@ -77,7 +77,7 @@ export interface BasemapGalleryProperties extends WidgetProperties, Partial<Pick
  * layers are removed and replaced with the basemap layers of the associated basemap selected in the gallery. By default,
  * the BasemapGallery widget looks like the following image.
  *
- * ![basemap-gallery](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/basemap-gallery.png)
+ * ![basemap-gallery](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/basemap-gallery.png)
  *
  * When a [global API key](https://developers.arcgis.com/javascript/latest/references/core/config/#Config-apiKey) is set, the default basemaps displayed in the BasemapGallery
  * widget will default to the basemaps defined by the [Portal.devBasemapGalleryGroupQuery](https://developers.arcgis.com/javascript/latest/references/core/portal/Portal/#devBasemapGalleryGroupQuery) property.

package/widgets/BasemapLayerList.d.ts

@@ -160,7 +160,7 @@ export default class BasemapLayerList extends BasemapLayerListSuperclass {
    * This list item will only be displayed when catalog layers are loaded in the map and will be displayed as a child of the catalog layer.
    * This property is useful for listening to the [CatalogLayerList.@trigger-action](https://developers.arcgis.com/javascript/latest/references/core/widgets/CatalogLayerList/#event-trigger-action) event and managing selections in catalog layers.
    *
-   * ![CatalogLayerList](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/catalog-layer-list.png)
+   * ![CatalogLayerList](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/catalog-layer-list.png)
    *
    * @since 4.30
    * @see [catalogOptions](https://developers.arcgis.com/javascript/latest/references/core/widgets/BasemapLayerList/#catalogOptions)
@@ -392,8 +392,8 @@ export default class BasemapLayerList extends BasemapLayerListSuperclass {
    *
    * | Value | Description | Example |
    * | ----- | ----------- | ------- |
-   * | default | Displays view icons on the far side. Icons are hidden except on hover or if they have keyboard focus. See [view-visible](https://developers.arcgis.com/calcite-design-system/icons/?icon=view-visible&library=Calcite%20UI&query=view) and [view-hide](https://developers.arcgis.com/calcite-design-system/icons/?icon=view-hide&library=Calcite%20UI&query=view) calcite icons. | ![visibilityAppearance-default](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/basemap-layer-list/visibilityAppearance-default.png) |
-   * | checkbox | Displays checkbox icons on the near side. See [check-square-f](https://developers.arcgis.com/calcite-design-system/icons/?icon=check-square-f&library=Calcite%20UI&query=check) and [square](https://developers.arcgis.com/calcite-design-system/icons/?icon=square&library=Calcite%20UI&query=square) calcite icons. | ![visibilityAppearance-checkbox](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/basemap-layer-list/visibilityAppearance-checkbox.png) |
+   * | default | Displays view icons on the far side. Icons are hidden except on hover or if they have keyboard focus. See [view-visible](https://developers.arcgis.com/calcite-design-system/icons/?icon=view-visible&library=Calcite%20UI&query=view) and [view-hide](https://developers.arcgis.com/calcite-design-system/icons/?icon=view-hide&library=Calcite%20UI&query=view) calcite icons. | ![visibilityAppearance-default](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/basemap-layer-list/visibilityAppearance-default.png) |
+   * | checkbox | Displays checkbox icons on the near side. See [check-square-f](https://developers.arcgis.com/calcite-design-system/icons/?icon=check-square-f&library=Calcite%20UI&query=check) and [square](https://developers.arcgis.com/calcite-design-system/icons/?icon=square&library=Calcite%20UI&query=square) calcite icons. | ![visibilityAppearance-checkbox](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/basemap-layer-list/visibilityAppearance-checkbox.png) |
    *
    * @default "default"
    * @since 4.29

package/widgets/BasemapToggle.d.ts

@@ -54,7 +54,7 @@ export interface VisibleElements {
  * two basemaps. The toggled basemap is set inside the [view's](https://developers.arcgis.com/javascript/latest/references/core/widgets/BasemapToggle/#view)
  * [View.map](https://developers.arcgis.com/javascript/latest/references/core/views/View/#map) object.
  *
- * ![basemap-toggle](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/basemap-toggle.png)
+ * ![basemap-toggle](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/basemap-toggle.png)
  *
  * Starting with version 4.23, the BasemapToggle widget can have two basemaps with different spatial references.
  * Set the [MapView.spatialReferenceLocked](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#spatialReferenceLocked) property to `true`

package/widgets/BatchAttributeForm/BatchAttributeFormViewModel.d.ts

@@ -131,7 +131,6 @@ export default class BatchAttributeFormViewModel extends EventedAccessor {
    * An array of objects containing a [FormTemplate](https://developers.arcgis.com/javascript/latest/references/core/form/FormTemplate/) and its corresponding layer.
    * This allows per-layer overrides which provides a [FormTemplate](https://developers.arcgis.com/javascript/latest/references/core/form/FormTemplate/) for building batch form templates. The `formTemplate` defined here overrides any `formTemplate` defined on the layer itself. Otherwise, the layer's own `formTemplate` is used if it exists.
    *
-   * @see [Map.editableLayers](https://developers.arcgis.com/javascript/latest/references/core/Map/#editableLayers)
    * @example
    * // Query for features
    * const { features } = await featureLayer.queryFeatures();
@@ -262,7 +261,7 @@ export default class BatchAttributeFormViewModel extends EventedAccessor {
    */
   getValues(feature: Graphic): Graphic["attributes"];
   /**
-   * This method triggers the `"submit"` event, and causes [submitHasBeenAttempted](https://developers.arcgis.com/javascript/latest/references/core/widgets/BatchAttributeForm/BatchAttributeFormViewModel/#submitHasBeenAttempted) to become `true`. It does _not_ do anything to persist the updated values. It is up to the client these values as appropriate — for example, by calling [FeatureLayer.applyEdits()](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#applyEdits) method to update the features' attributes.
+   * This method triggers the `"submit"` event, and causes [submitHasBeenAttempted](https://developers.arcgis.com/javascript/latest/references/core/widgets/BatchAttributeForm/BatchAttributeFormViewModel/#submitHasBeenAttempted) to become `true`. It does _not_ do anything to persist the updated values. It is up to the client to verify if these values are appropriate. For example, calling [FeatureLayer.applyEdits()](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#applyEdits) method to update the features' attributes.
    *
    * @example
    * // Listen for when 'submit' is called on the form.

package/widgets/BatchAttributeForm/inputs/BatchFormInputs.d.ts

@@ -9,7 +9,6 @@ export interface BatchFormInputsProperties {}
  * The `BatchFormInputs` class is a read-only class that acts as a container for a set of inputs in a [BatchAttributeFormViewModel](https://developers.arcgis.com/javascript/latest/references/core/widgets/BatchAttributeForm/BatchAttributeFormViewModel/).
  *
  * @since 4.33
- * @see [BatchAttributeFormViewModel](https://developers.arcgis.com/javascript/latest/references/core/widgets/BatchAttributeForm/BatchAttributeFormViewModel/)
  */
 export default class BatchFormInputs extends Accessor {
   constructor(properties?: BatchFormInputsProperties);

package/widgets/BatchAttributeForm.d.ts

@@ -153,8 +153,6 @@ export default class BatchAttributeForm extends Widget<BatchAttributeFormPropert
    * An array of objects containing a [FormTemplate](https://developers.arcgis.com/javascript/latest/references/core/form/FormTemplate/) and its corresponding layer.
    * This allows per-layer overrides which provides a [FormTemplate](https://developers.arcgis.com/javascript/latest/references/core/form/FormTemplate/) for building batch form templates. The `formTemplate` defined here overrides any `formTemplate` defined on the layer itself. Otherwise, the layer's own `formTemplate` is used if it exists.
    *
-   * @see [Map.editableLayers](https://developers.arcgis.com/javascript/latest/references/core/Map/#editableLayers)
-   * @see {@link}
    * @example
    * // Query for features
    * const { features } = await featureLayer.queryFeatures();

package/widgets/Bookmarks/BookmarksVisibleElements.d.ts

@@ -7,7 +7,7 @@ export interface BookmarksVisibleElementsProperties extends Partial<Pick<Bookmar
  * The visible elements that are displayed within the widget.
  * This provides the ability to turn individual elements of the widget's display on/off.
  *
- * ![bookmarks-visibleElements](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/bookmarks-visibleElements.png)
+ * ![bookmarks-visibleElements](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/bookmarks-visibleElements.png)
  *
  * @since 5.0
  */

package/widgets/Bookmarks.d.ts

@@ -139,12 +139,12 @@ export interface BookmarksEvents extends BookmarksViewModelEvents {}
  * It displays a list of [bookmarks](https://developers.arcgis.com/javascript/latest/references/core/webmap/Bookmark/),
  * which are typically defined inside the [WebMap.bookmarks](https://developers.arcgis.com/javascript/latest/references/core/WebMap/#bookmarks).
  *
- * ![bookmarks](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/bookmarks.png)
+ * ![bookmarks](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/bookmarks.png)
  *
  * Each bookmark may contain the following properties: `name`, `thumbnail`, `viewpoint` (defines rotation, scale, and target geometry), and `timeExtent`.
  * If the timeExtent is defined on a bookmark, it will be displayed in the bookmark widget as shown in the following image.
  *
- * ![bookmarks-time](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/bookmarks-time-enabled.png)
+ * ![bookmarks-time](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/bookmarks-time-enabled.png)
  *
  * When a bookmark with a timeExtent is selected, the [MapView.timeExtent](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#timeExtent) of the View will be set to the timeExtent of the selected bookmark.
  * To disable time capability in the Bookmarks widget, set [capabilities.time](https://developers.arcgis.com/javascript/latest/references/core/widgets/Bookmarks/BookmarksViewModel/#capabilities) in the BookmarksViewModel to `false`.

package/widgets/BuildingExplorer.d.ts

@@ -79,7 +79,7 @@ export interface VisibleElements {
  * the Level element, the Construction phases element and the Disciplines are Categories list.
  * The visibility of these elements can be configured using the widget's [visibleElements](https://developers.arcgis.com/javascript/latest/references/core/widgets/BuildingExplorer/#visibleElements).
  *
- * [![building-explorer](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/building-explorer.png)](https://developers.arcgis.com/javascript/latest/sample-code/building-scene-layer-filter/)
+ * [![building-explorer](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/building-explorer.png)](https://developers.arcgis.com/javascript/latest/sample-code/building-scene-layer-filter/)
  *
  * The [BuildingSceneLayers](https://developers.arcgis.com/javascript/latest/references/core/layers/BuildingSceneLayer/) to be explored
  * have to be set on the [layers](https://developers.arcgis.com/javascript/latest/references/core/widgets/BuildingExplorer/#layers) property of the widget. When setting multiple layers, the filters set

package/widgets/CatalogLayerList.d.ts

@@ -74,7 +74,7 @@ export interface CatalogLayerListEvents extends CatalogLayerListViewModelEvents
  * The [ListItem](https://developers.arcgis.com/javascript/latest/references/core/widgets/LayerList/ListItem/) API provides access to each layer's properties, allows
  * the developer to configure actions related to the layer, and allows the developer to add content to the item related to the layer.
  *
- * ![CatalogLayerList](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/catalog-layer-list.png)
+ * ![CatalogLayerList](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/catalog-layer-list.png)
  *
  * @deprecated since version 5.0. Use the [Catalog Layer List](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-catalog-layer-list/) component 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.30
@@ -281,8 +281,8 @@ export default class CatalogLayerList extends CatalogLayerListSuperclass {
    *
    * | Value | Description | Example |
    * | ----- | ----------- | ------- |
-   * | default | Displays view icons on the far side. Icons are hidden except on hover or if they have keyboard focus. See [view-visible](https://developers.arcgis.com/calcite-design-system/icons/?icon=view-visible&library=Calcite%20UI&query=view) and [view-hide](https://developers.arcgis.com/calcite-design-system/icons/?icon=view-hide&library=Calcite%20UI&query=view) calcite icons. | ![visibilityAppearance-default](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/layer-list/visibilityAppearance-default.png) |
-   * | checkbox | Displays checkbox icons on the near side. See [check-square-f](https://developers.arcgis.com/calcite-design-system/icons/?icon=check-square-f&library=Calcite%20UI&query=check) and [square](https://developers.arcgis.com/calcite-design-system/icons/?icon=square&library=Calcite%20UI&query=square) calcite icons. | ![visibilityAppearance-checkbox](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/layer-list/visibilityAppearance-checkbox.png) |
+   * | default | Displays view icons on the far side. Icons are hidden except on hover or if they have keyboard focus. See [view-visible](https://developers.arcgis.com/calcite-design-system/icons/?icon=view-visible&library=Calcite%20UI&query=view) and [view-hide](https://developers.arcgis.com/calcite-design-system/icons/?icon=view-hide&library=Calcite%20UI&query=view) calcite icons. | ![visibilityAppearance-default](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/layer-list/visibilityAppearance-default.png) |
+   * | checkbox | Displays checkbox icons on the near side. See [check-square-f](https://developers.arcgis.com/calcite-design-system/icons/?icon=check-square-f&library=Calcite%20UI&query=check) and [square](https://developers.arcgis.com/calcite-design-system/icons/?icon=square&library=Calcite%20UI&query=square) calcite icons. | ![visibilityAppearance-checkbox](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/layer-list/visibilityAppearance-checkbox.png) |
    *
    * @default "default"
    * @example catalogLayerList.visibilityAppearance = "checkbox";

package/widgets/Compass.d.ts

@@ -42,8 +42,8 @@ export interface CompassProperties extends WidgetProperties, Partial<Pick<Compas
  * For all other spatial references, the icon will be an arrow. For more information, see the
  * [Reference topic on Spatial references](https://developers.arcgis.com/documentation/spatial-references/).
  *
- * ![Compass for Web Mercator and WGS84](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/compass.png)
- * ![Compass for other spatial references](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/compass-other-sr.png)
+ * ![Compass for Web Mercator and WGS84](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/compass.png)
+ * ![Compass for other spatial references](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/compass-other-sr.png)
  *
  * You can use the view's [DefaultUI](https://developers.arcgis.com/javascript/latest/references/core/views/ui/DefaultUI/) to add the compass widget
  * to a 2D application via the [MapView.ui](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#ui) property on the view.

package/widgets/CoordinateConversion.d.ts

@@ -108,7 +108,7 @@ export interface VisibleElements {
  * as any of several popular coordinate notations.  Additionally, the widget provides a way to convert
  * user input coordinates into a [Point](https://developers.arcgis.com/javascript/latest/references/core/geometry/Point/).
  *
- * [![coordinate-conversion](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/coordinate-conversion-annotated.png)](https://developers.arcgis.com/javascript/latest/sample-code/widgets-coordinateconversion/)
+ * [![coordinate-conversion](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/coordinate-conversion-annotated.png)](https://developers.arcgis.com/javascript/latest/sample-code/widgets-coordinateconversion/)
  *
  * Several common [formats](https://developers.arcgis.com/javascript/latest/references/core/widgets/CoordinateConversion/support/Format/) are included by default:
  * * XY - Longitude, Latitude (WGS84)

package/widgets/Daylight.d.ts

@@ -71,7 +71,7 @@ export interface DaylightEvents extends DaylightViewModelEvents {}
  * and the stars get updated accordingly, changing the light and the shadows in the scene. This sets the `date` and `directShadowsEnabled` properties of
  * [SceneView.environment.lighting](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/#environment).
  *
- * [![daylight-default](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/daylight/daylight-default.png)](https://developers.arcgis.com/javascript/latest/sample-code/widgets-daylight/)
+ * [![daylight-default](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/daylight/daylight-default.png)](https://developers.arcgis.com/javascript/latest/sample-code/widgets-daylight/)
  *
  * The daytime slider has an option to select the timezone. When the user makes any adjustments here, a new time
  * in the chosen timezone is calculated and displayed in the slider. The timezone selector can be disabled
@@ -88,7 +88,7 @@ export interface DaylightEvents extends DaylightViewModelEvents {}
  * });
  * ```
  *
- * ![daylight-seasons](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/daylight/daylight-seasons.png)
+ * ![daylight-seasons](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/daylight/daylight-seasons.png)
  *
  * There are two play buttons, one corresponds to the daytime slider and it animates the time as
  * it cycles through the minutes of the day. The second button corresponds to the date picker
@@ -102,7 +102,7 @@ export interface DaylightEvents extends DaylightViewModelEvents {}
  * });
  * ```
  *
- * ![daylight-animation](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/daylight/daylight-animation.gif)
+ * ![daylight-animation](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/daylight/daylight-animation.gif)
  *
  * Except for the daytime slider, all the elements in the daylight widget can be hidden by using the
  * [visibleElements](https://developers.arcgis.com/javascript/latest/references/core/widgets/Daylight/#visibleElements) property:
@@ -122,11 +122,11 @@ export interface DaylightEvents extends DaylightViewModelEvents {}
  *
  * With these settings, the widget looks like this:
  *
- * ![daylight-no-elements](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/daylight/daylight-no-elements.png)
+ * ![daylight-no-elements](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/daylight/daylight-no-elements.png)
  *
  * Whenever the sun position option is unchecked, the scene applies the **virtual light source** relative to the camera. With this, the widget's time slider and date picker get automatically disabled:
  *
- * ![daylight-virtual](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/daylight/daylight-virtual.png)
+ * ![daylight-virtual](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/daylight/daylight-virtual.png)
  *
  * > [!WARNING]
  * >

package/widgets/DirectLineMeasurement3D.d.ts

@@ -81,7 +81,7 @@ export interface DirectLineMeasurement3DProperties extends WidgetProperties, Par
  * This widget can be used in a [SceneView](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/) to measure the vertical, horizontal,
  * and direct distance between two points.
  *
- * [![measurement-line-3d](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/3D_DirectLineMeasurement_widget.png)](https://developers.arcgis.com/javascript/latest/sample-code/widgets-measurement-3d/)
+ * [![measurement-line-3d](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/3D_DirectLineMeasurement_widget.png)](https://developers.arcgis.com/javascript/latest/sample-code/widgets-measurement-3d/)
  *
  * How distances are computed depends on the scene's spatial reference.
  *
@@ -98,7 +98,7 @@ export interface DirectLineMeasurement3DProperties extends WidgetProperties, Par
  * the measurement visualization is simplified, and only the horizontal and vertical distances are calculated.
  * The direct distance option becomes unavailable.
  *
- * ![measurement-line-3d](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/direct-line-measurement-3d.png)
+ * ![measurement-line-3d](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/direct-line-measurement-3d.png)
  *
  * When the widget is active, a horizontal "laser" line is drawn which indicates the height at the current mouse position.
  * This line can help in analyzing the heights of objects relative to each other and the terrain.

package/widgets/Directions/DirectionsViewModel.d.ts

@@ -289,6 +289,18 @@ export default class DirectionsViewModel extends DirectionsViewModelSuperclass {
    * @see [RouteLayer.saveAs()](https://developers.arcgis.com/javascript/latest/references/core/layers/RouteLayer/#saveAs)
    */
   saveAs(portalItem: PortalItem, options?: LayerSaveAsOptions): Promise<PortalItem>;
+  /**
+   * Starts an edit session.
+   *
+   * @internal
+   */
+  startEditing(): void;
+  /**
+   * Ends an edit session.
+   *
+   * @internal
+   */
+  stopEditing(): void;
   /** Zoom so that the full route is displayed within the current map extent. */
   zoomToRoute(): void;
 }

package/widgets/Directions/DirectionsViewModel.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.0/LICENSE.txt */
-import{__decorate as e}from"tslib";import t from"../../core/Collection.js";import r from"../../core/Error.js";import{EventedAccessor as i}from"../../core/Evented.js";import o from"../../core/Logger.js";import{clamp as s}from"../../core/mathUtils.js";import{debounce as a,throwIfNotAbortError as l,isAbortError as n}from"../../core/promiseUtils.js";import{watch as u,syncAndInitial as d,when as c,on as h}from"../../core/reactiveUtils.js";import{property as p,subclass as m}from"../../core/accessorSupport/decorators.js";import{resolveTimeZone as v,formatTimestamp as y,convertDateFormatToIntlOptions as g}from"../../intl/date.js";import{getLocale as f,getLocaleParts as w}from"../../intl/locale.js";import{fetchServiceDescription as _}from"../../rest/networkService.js";import T from"../../rest/support/RouteParameters.js";import S from"../../rest/support/Stop.js";import D from"../../rest/support/TravelMode.js";import{defaultDatePattern as b,defaultTimePattern as C}from"../../support/dateUtils.js";import{system as M}from"../../time/constants.js";import{shortTimeZoneName as I}from"../../time/timeZoneUtils.js";import{DepartureTimeOption as j}from"./support/directionsUtils.js";import{getDefaultLocaleOptions as A}from"../support/dateUtils.js";import{GoTo as P}from"../support/GoTo.js";import{DateTime as L,FixedOffsetZone as O,IANAZone as R}from"luxon";function E(e){return e.map(e=>({locale:e,parts:w(e)})).filter(({parts:e})=>!!e)}function U(e,t){return e.find(({parts:e})=>V(e.language,t.language)&&e.region===t.region)?.locale??e.find(({parts:e})=>V(e.language,t.language))?.locale}function N(e){return"esri.Graphic"===e?.declaredClass}function k(e){return"no"===e||"nb"===e}function V(e,t){return e===t||k(e)&&k(t)}function z(e){return"esri.rest.support.Stop"===e?.declaredClass}let F=class extends(P(i)){constructor(e){super(e),this._debouncedSolveHandler=a(async e=>{switch(e.type){case"create":switch(e.state){case"start":case"active":return}break;case"delete":break;case"update":switch(e.state){case"start":return void(this._networkFeatureUpdated=!1);case"active":if(this._networkFeatureUpdated=!0,this.autoSolveOn.includes("active"))break;return;case"complete":if(!this._networkFeatureUpdated)return;if(this.autoSolveOn.includes("complete"))break;return}}if((this.layer?.stops.filter(({geometry:e})=>!!e).length??0)<2||!this.autoSolve)return;const t="update"===e.type&&"active"===e.state;try{await this.getDirections({zoomToSolvedRoute:!1,ignoreSolvedStopGeometry:t,generalizeGeometry:t})}catch(r){o.getLogger(this).error(r)}}),this._highlight=null,this._loadController=null,this._loadPromise=null,this._networkFeatureUpdated=!1,this._layerView=null,this._routeController=null,this._serviceDescriptionStatus=3,this.apiKey=void 0,this.autoSolve=!0,this.autoSolveOn=["complete"],this.defaultTravelMode=null,this.departureIsoDate=void 0,this.departureIsoTime=void 0,this.departureOption=j.NOW,this.departureTime="now",this.lastError=null,this.lastRoute=null,this.layer=null,this.maxStops=50,this.routeParameters=new T({directionsLengthUnits:"kilometers",findBestSequence:!1,preserveFirstStop:!0,preserveLastStop:!0,returnZ:!0,useTimeWindows:!1}),this.serviceDescription=null,this.view=null}initialize(){this.addHandles([u(()=>this.layer,e=>{if(e){for(;e.stops.length<2;)e.stops.add(new S);this._set("defaultTravelMode",null),this.addHandles(c(()=>this.serviceDescription?e.routeInfo?.analysisSettings?.travelMode:null,e=>{this.defaultTravelMode=this._resolveDefaultTravelMode(e)},{once:!0}))}},d),u(()=>[this.layer,this.view],async()=>{this._layerView=await this._getRouteLayerView()},d),h(()=>this._layerView,["create","delete","update"],e=>{this._debouncedSolveHandler(e).catch(l)})]);const e=v(this.view?.timeZone??M),t=L.fromMillis(Date.now());this.departureIsoDate=t.toFormat(b,A(e)),this.departureIsoTime=t.toFormat(C,A(e))}get _directionsLanguage(){const e=this.serviceDescription?.directionsSupportedLanguages;if(!e)return;const t=this.routeParameters.directionsLanguage??f(),r=w(t),i=r?.language,o=r?.region;if(!i)return;return U(E(e),{language:i,region:o})}get formattedEta(){const e=this.layer?.routeInfo?.endTime,t=this.layer?.routeInfo?.endTimeOffset;if(this.departureOption===j.UNSPECIFIED||!e||!t)return null;const r=L.fromJSDate(e,{zone:O.instance(t)}),i=L.fromJSDate(e,{zone:R.create(v(this.view?.timeZone??M))}),o=L.fromJSDate(new Date,{zone:R.create(v(this.view?.timeZone??M))}),s=o.year===i.year&&o.month===i.month&&o.day===i.day,a=i.offset===t?void 0:I,l=s?void 0:g("short-date"),n=g("short-time");return y(r.toISO(),{...l,...n,timeZoneName:a})}get impedanceAttribute(){const e=this.routeParameters.travelMode?.impedanceAttributeName??this.routeParameters.impedanceAttribute??this.serviceDescription?.impedance??null;return this.getCostAttribute(e)}get selectedNetworkFeatures(){return this._layerView?.selectedNetworkFeatures??null}get selectedTravelMode(){return this.serviceDescription?this.defaultTravelMode??this.serviceDescription.defaultTravelMode??this.serviceDescription.supportedTravelModes?.[0]??null:null}set selectedTravelMode(e){this._override("selectedTravelMode",e)}get state(){if(this._routeController)return"routing";if(this.lastError)return"error";switch(this._serviceDescriptionStatus){case 4:return"unauthenticated";case 3:return"disabled";case 0:return"initializing";case 2:return"error";default:return"ready"}}get timeAttribute(){const e=this.routeParameters.travelMode?.timeAttributeName??this.routeParameters.directionsTimeAttribute??this.serviceDescription?.directionsTimeAttribute??null;return this.getCostAttribute(e)}get travelModes(){const e=this.serviceDescription?.supportedTravelModes?.slice()??[];return null==this.defaultTravelMode||e.includes(this.defaultTravelMode)||e.unshift(this.defaultTravelMode),e}async load(){if(this._loadPromise)return this._loadPromise;this._loadPromise=this._load(),await this._loadPromise,this._loadPromise=null}async highlight(e){this.clearHighlights();const t=await this._getRouteLayerView();this._highlight=t?.highlight(e)??null}clearHighlights(){this._highlight?.remove(),this._highlight=null}centerAt(e){if(!this.view)return;const t=z(e)||N(e)?e.geometry:e;t&&this.callGoTo({target:t})}clearResults(){this._set("lastRoute",null),this.layer?.removeResult()}async create(e){await(this._layerView?.create(e))}async getDirections(e={zoomToSolvedRoute:!0,ignoreSolvedStopGeometry:!1,generalizeGeometry:!1}){const{apiKey:t,layer:i,state:o}=this;if(!i)throw new r("directions-view-model:missing-route-layer","A route layer must be associated with the view model.");if("disabled"===o||"initializing"===o||"unauthenticated"===o||2===this._serviceDescriptionStatus)throw new r("directions-view-model:not-loaded","Cannot get directions until view model loads.");this._routeController?.abort(),this._routeController=null;const{startTime:s,startTimeIsUTC:a}=this._getStartTimeParameters(),l=this.view?.spatialReference??null,u=this.routeParameters.clone(),d=e.generalizeGeometry?this._getGeometryPrecision():null;u.set({apiKey:t,directionsLanguage:this._directionsLanguage,geometryPrecision:d,outSpatialReference:l,startTime:s,startTimeIsUTC:a}),this.selectedTravelMode&&(u.travelMode=this.selectedTravelMode);if(i.stops.filter(({geometry:e})=>!!e).length<2){const e=new r("directions-view-model:not-enough-stops","Not enough stops for routing");throw this._set("lastError",e),e}i.stops.forEach(e=>e.sequence=null),this._routeController=new AbortController;const{signal:c}=this._routeController;let h=null;try{h=await i.solve(u,{signal:c})}catch(p){if(!n(p)){const e=new r("directions-view-model:unable-to-route","Unable to route to these addresses",{error:p});throw this._set("lastError",e),this.clearResults(),e}}finally{this._routeController=null}this._set("lastError",null);for(const r of h.stops)r.geometry||(r.name=null);if(e.ignoreSolvedStopGeometry&&i.stops.every(({objectId:e})=>!!e)&&h.stops.every(({objectId:e})=>!!e))for(const r of h.stops){const e=i.stops.find(({objectId:e})=>e===r.objectId)?.geometry;e&&(r.geometry=e.clone())}return i.update(h),this._set("lastRoute",h),e.zoomToSolvedRoute&&this.zoomToRoute(),h}getCostAttribute(e){return(this.serviceDescription?.networkDataset?.networkAttributes??[]).find(({name:t,usageType:r})=>t===e&&"cost"===r)??null}remove(e){this._layerView?.remove(e)}reset(){this.clearHighlights(),this.clearResults(),null!=this.layer&&(this.layer.removeAll(),this.layer.stops=new t([new S,new S]))}save(){if(!this.layer)throw new r("directions-view-model:missing-layer","save() requires a layer");return this.layer.save()}saveAs(e,t={}){if(!this.layer)throw new r("directions-view-model:missing-layer","saveAs() requires a layer");return this.layer.saveAs(e,t)}async startEditing(){this._layerView&&(this._layerView.interactive=!0,this._layerView.interactiveOptions.waypointAdditionEnabled=!this.routeParameters.findBestSequence)}async stopEditing(){this._layerView&&(this._layerView.interactive=!1)}updateDepartureTime(){if(this.departureIsoDate&&this.departureIsoTime)switch(this.departureOption){case j.NOW:this.departureTime="now";break;case j.DEPART_AT:{const e=L.fromISO(`${this.departureIsoDate}T${this.departureIsoTime}`,{zone:O.instance(0)});this.departureTime=e.toJSDate();break}case j.UNSPECIFIED:this.departureTime=null}}zoomToRoute(){const{view:e,layer:t}=this,r=t?.routeInfo?.geometry?.extent;if(!e||!r)return;const i=r.width>r.height,o=r.clone().expand(i?2:1);this.callGoTo({target:o})}_getGeometryPrecision(){const e=this.view?.resolution;return e?s(Math.ceil(-Math.log10(e)),0,4):null}async _getRouteLayerView(){return this.view&&this.layer?this.view.whenLayerView(this.layer):null}_getStartTimeParameters(){if("now"===this.departureTime){return{startTime:this.serviceDescription?.capabilities.supportsNow??!1?"now":new Date,startTimeIsUTC:!0}}return null==this.departureTime?{startTime:void 0,startTimeIsUTC:void 0}:{startTime:this.departureTime,startTimeIsUTC:!1}}async _load(){if(null==this.layer)return;null!=this._loadController&&(this._loadController.abort(),this._loadController=null),this._loadController=new AbortController;const{signal:e}=this._loadController;try{this._serviceDescriptionStatus=0;const t=await _(this.layer.url,this.apiKey,{signal:e});this._set("serviceDescription",t),this._serviceDescriptionStatus=1}catch(t){if(n(t))return void(this._serviceDescriptionStatus=3);if("identity-manager:user-aborted"===t.name)return void(this._serviceDescriptionStatus=4);const e=new r("directions-view-model:service-metadata-unavailable","Cannot load route service metadata",{error:t});throw this._serviceDescriptionStatus=2,this._set("lastError",e),e}finally{this._loadController=null}}_resolveDefaultTravelMode(e){if(null==this.serviceDescription)return null;const{defaultTravelMode:t,supportedTravelModes:r}=this.serviceDescription,i=/^<(?<name>.*)>$/i.exec(e.name)?.groups?.name;if(i){const o=r?.find(({name:e})=>e.toLocaleLowerCase()===i.trim().toLocaleLowerCase()),s=o??t;return D.fromJSON({...s?.toJSON(),...e.toJSON()})}const o=r?.find(({name:t})=>t.toLocaleLowerCase()===e.name.toLocaleLowerCase());return o??t}};e([p()],F.prototype,"_directionsLanguage",null),e([p()],F.prototype,"_layerView",void 0),e([p()],F.prototype,"_routeController",void 0),e([p()],F.prototype,"_serviceDescriptionStatus",void 0),e([p()],F.prototype,"apiKey",void 0),e([p()],F.prototype,"autoSolve",void 0),e([p({nonNullable:!0})],F.prototype,"autoSolveOn",void 0),e([p()],F.prototype,"defaultTravelMode",void 0),e([p()],F.prototype,"departureTime",void 0),e([p()],F.prototype,"formattedEta",null),e([p({readOnly:!0})],F.prototype,"impedanceAttribute",null),e([p()],F.prototype,"lastError",void 0),e([p({readOnly:!0})],F.prototype,"lastRoute",void 0),e([p()],F.prototype,"layer",void 0),e([p({type:Number,range:{min:2,max:50},nonNullable:!0})],F.prototype,"maxStops",void 0),e([p({type:T,nonNullable:!0})],F.prototype,"routeParameters",void 0),e([p({readOnly:!0})],F.prototype,"selectedNetworkFeatures",null),e([p({type:D})],F.prototype,"selectedTravelMode",null),e([p({readOnly:!0})],F.prototype,"serviceDescription",void 0),e([p({readOnly:!0})],F.prototype,"state",null),e([p({readOnly:!0})],F.prototype,"timeAttribute",null),e([p()],F.prototype,"travelModes",null),e([p()],F.prototype,"view",void 0),e([p()],F.prototype,"zoomToRoute",null),F=e([m("esri.widgets.Directions.DirectionsViewModel")],F);const G=F;export{G as default};
+import{__decorate as e}from"tslib";import t from"../../core/Collection.js";import r from"../../core/Error.js";import{EventedAccessor as i}from"../../core/Evented.js";import o from"../../core/Logger.js";import{clamp as s}from"../../core/mathUtils.js";import{debounce as a,throwIfNotAbortError as l,isAbortError as n}from"../../core/promiseUtils.js";import{watch as u,syncAndInitial as d,when as c,on as h}from"../../core/reactiveUtils.js";import{property as p,subclass as m}from"../../core/accessorSupport/decorators.js";import{resolveTimeZone as v,formatTimestamp as y,convertDateFormatToIntlOptions as g}from"../../intl/date.js";import{getLocale as f,getLocaleParts as w}from"../../intl/locale.js";import{fetchServiceDescription as _}from"../../rest/networkService.js";import T from"../../rest/support/RouteParameters.js";import S from"../../rest/support/Stop.js";import D from"../../rest/support/TravelMode.js";import{defaultDatePattern as b,defaultTimePattern as C}from"../../support/dateUtils.js";import{system as M}from"../../time/constants.js";import{shortTimeZoneName as I}from"../../time/timeZoneUtils.js";import{DepartureTimeOption as j}from"./support/directionsUtils.js";import{getDefaultLocaleOptions as A}from"../support/dateUtils.js";import{GoTo as P}from"../support/GoTo.js";import{DateTime as L,FixedOffsetZone as O,IANAZone as R}from"luxon";function E(e){return e.map(e=>({locale:e,parts:w(e)})).filter(({parts:e})=>!!e)}function U(e,t){return e.find(({parts:e})=>V(e.language,t.language)&&e.region===t.region)?.locale??e.find(({parts:e})=>V(e.language,t.language))?.locale}function N(e){return"esri.Graphic"===e?.declaredClass}function k(e){return"no"===e||"nb"===e}function V(e,t){return e===t||k(e)&&k(t)}function z(e){return"esri.rest.support.Stop"===e?.declaredClass}let F=class extends(P(i)){constructor(e){super(e),this._debouncedSolveHandler=a(async e=>{switch(e.type){case"create":switch(e.state){case"start":case"active":return}break;case"delete":break;case"update":switch(e.state){case"start":return void(this._networkFeatureUpdated=!1);case"active":if(this._networkFeatureUpdated=!0,this.autoSolveOn.includes("active"))break;return;case"complete":if(!this._networkFeatureUpdated)return;if(this.autoSolveOn.includes("complete"))break;return}}if((this.layer?.stops.filter(({geometry:e})=>!!e).length??0)<2||!this.autoSolve)return;const t="update"===e.type&&"active"===e.state;try{await this.getDirections({zoomToSolvedRoute:!1,ignoreSolvedStopGeometry:t,generalizeGeometry:t})}catch(r){o.getLogger(this).error(r)}}),this._highlight=null,this._loadController=null,this._loadPromise=null,this._networkFeatureUpdated=!1,this._layerView=null,this._routeController=null,this._serviceDescriptionStatus=3,this.apiKey=void 0,this.autoSolve=!0,this.autoSolveOn=["complete"],this.defaultTravelMode=null,this.departureIsoDate=void 0,this.departureIsoTime=void 0,this.departureOption=j.NOW,this.departureTime="now",this.lastError=null,this.lastRoute=null,this.layer=null,this.maxStops=50,this.routeParameters=new T({directionsLengthUnits:"kilometers",findBestSequence:!1,preserveFirstStop:!0,preserveLastStop:!0,returnZ:!0,useTimeWindows:!1}),this.serviceDescription=null,this.view=null}initialize(){this.addHandles([u(()=>this.layer,e=>{if(e){for(;e.stops.length<2;)e.stops.add(new S);this._set("defaultTravelMode",null),this.addHandles(c(()=>this.serviceDescription?e.routeInfo?.analysisSettings?.travelMode:null,e=>{this.defaultTravelMode=this._resolveDefaultTravelMode(e)},{once:!0}))}},d),u(()=>[this.layer,this.view],async()=>{this._layerView=await this._getRouteLayerView()},d),h(()=>this._layerView,["create","delete","update"],e=>{this._debouncedSolveHandler(e).catch(l)})]);const e=v(this.view?.timeZone??M),t=L.fromMillis(Date.now());this.departureIsoDate=t.toFormat(b,A(e)),this.departureIsoTime=t.toFormat(C,A(e))}get _directionsLanguage(){const e=this.serviceDescription?.directionsSupportedLanguages;if(!e)return;const t=this.routeParameters.directionsLanguage??f(),r=w(t),i=r?.language,o=r?.region;if(!i)return;return U(E(e),{language:i,region:o})}get formattedEta(){const e=this.layer?.routeInfo?.endTime,t=this.layer?.routeInfo?.endTimeOffset;if(this.departureOption===j.UNSPECIFIED||!e||!t)return null;const r=L.fromJSDate(e,{zone:O.instance(t)}),i=L.fromJSDate(e,{zone:R.create(v(this.view?.timeZone??M))}),o=L.fromJSDate(new Date,{zone:R.create(v(this.view?.timeZone??M))}),s=o.year===i.year&&o.month===i.month&&o.day===i.day,a=i.offset===t?void 0:I,l=s?void 0:g("short-date"),n=g("short-time");return y(r.toISO(),{...l,...n,timeZoneName:a})}get impedanceAttribute(){const e=this.routeParameters.travelMode?.impedanceAttributeName??this.routeParameters.impedanceAttribute??this.serviceDescription?.impedance??null;return this.getCostAttribute(e)}get selectedNetworkFeatures(){return this._layerView?.selectedNetworkFeatures??null}get selectedTravelMode(){return this.serviceDescription?this.defaultTravelMode??this.serviceDescription.defaultTravelMode??this.serviceDescription.supportedTravelModes?.[0]??null:null}set selectedTravelMode(e){this._override("selectedTravelMode",e)}get state(){if(this._routeController)return"routing";if(this.lastError)return"error";switch(this._serviceDescriptionStatus){case 4:return"unauthenticated";case 3:return"disabled";case 0:return"initializing";case 2:return"error";default:return"ready"}}get timeAttribute(){const e=this.routeParameters.travelMode?.timeAttributeName??this.routeParameters.directionsTimeAttribute??this.serviceDescription?.directionsTimeAttribute??null;return this.getCostAttribute(e)}get travelModes(){const e=this.serviceDescription?.supportedTravelModes?.slice()??[];return null==this.defaultTravelMode||e.includes(this.defaultTravelMode)||e.unshift(this.defaultTravelMode),e}async load(){if(this._loadPromise)return this._loadPromise;this._loadPromise=this._load(),await this._loadPromise,this._loadPromise=null}async highlight(e){this.clearHighlights();const t=await this._getRouteLayerView();this._highlight=t?.highlight(e)??null}clearHighlights(){this._highlight?.remove(),this._highlight=null}centerAt(e){if(!this.view)return;const t=z(e)||N(e)?e.geometry:e;t&&this.callGoTo({target:t})}clearResults(){this._set("lastRoute",null),this.layer?.removeResult()}async create(e){await(this._layerView?.create(e))}async getDirections(e={zoomToSolvedRoute:!0,ignoreSolvedStopGeometry:!1,generalizeGeometry:!1}){const{apiKey:t,layer:i,state:o}=this;if(!i)throw new r("directions-view-model:missing-route-layer","A route layer must be associated with the view model.");if("disabled"===o||"initializing"===o||"unauthenticated"===o||2===this._serviceDescriptionStatus)throw new r("directions-view-model:not-loaded","Cannot get directions until view model loads.");this._routeController?.abort(),this._routeController=null;const{startTime:s,startTimeIsUTC:a}=this._getStartTimeParameters(),l=this.view?.spatialReference??null,u=this.routeParameters.clone(),d=e.generalizeGeometry?this._getGeometryPrecision():null;u.set({apiKey:t,directionsLanguage:this._directionsLanguage,geometryPrecision:d,outSpatialReference:l,startTime:s,startTimeIsUTC:a}),this.selectedTravelMode&&(u.travelMode=this.selectedTravelMode);if(i.stops.filter(({geometry:e})=>!!e).length<2){const e=new r("directions-view-model:not-enough-stops","Not enough stops for routing");throw this._set("lastError",e),e}i.stops.forEach(e=>e.sequence=null),this._routeController=new AbortController;const{signal:c}=this._routeController;let h=null;try{h=await i.solve(u,{signal:c})}catch(p){if(!n(p)){const e=new r("directions-view-model:unable-to-route","Unable to route to these addresses",{error:p});throw this._set("lastError",e),this.clearResults(),e}}finally{this._routeController=null}this._set("lastError",null);for(const r of h.stops)r.geometry||(r.name=null);if(e.ignoreSolvedStopGeometry&&i.stops.every(({objectId:e})=>!!e)&&h.stops.every(({objectId:e})=>!!e))for(const r of h.stops){const e=i.stops.find(({objectId:e})=>e===r.objectId)?.geometry;e&&(r.geometry=e.clone())}return i.update(h),this._set("lastRoute",h),e.zoomToSolvedRoute&&this.zoomToRoute(),h}getCostAttribute(e){return(this.serviceDescription?.networkDataset?.networkAttributes??[]).find(({name:t,usageType:r})=>t===e&&"cost"===r)??null}remove(e){this._layerView?.remove(e)}reset(){this.clearHighlights(),this.clearResults(),null!=this.layer&&(this.layer.removeAll(),this.layer.stops=new t([new S,new S]))}save(){if(!this.layer)throw new r("directions-view-model:missing-layer","save() requires a layer");return this.layer.save()}saveAs(e,t={}){if(!this.layer)throw new r("directions-view-model:missing-layer","saveAs() requires a layer");return this.layer.saveAs(e,t)}startEditing(){this._layerView&&(this._layerView.interactive=!0,this._layerView.interactiveOptions.waypointAdditionEnabled=!this.routeParameters.findBestSequence)}stopEditing(){this._layerView&&(this._layerView.interactive=!1)}updateDepartureTime(){if(this.departureIsoDate&&this.departureIsoTime)switch(this.departureOption){case j.NOW:this.departureTime="now";break;case j.DEPART_AT:{const e=L.fromISO(`${this.departureIsoDate}T${this.departureIsoTime}`,{zone:O.instance(0)});this.departureTime=e.toJSDate();break}case j.UNSPECIFIED:this.departureTime=null}}zoomToRoute(){const{view:e,layer:t}=this,r=t?.routeInfo?.geometry?.extent;if(!e||!r)return;const i=r.width>r.height,o=r.clone().expand(i?2:1);this.callGoTo({target:o})}_getGeometryPrecision(){const e=this.view?.resolution;return e?s(Math.ceil(-Math.log10(e)),0,4):null}async _getRouteLayerView(){return this.view&&this.layer?this.view.whenLayerView(this.layer):null}_getStartTimeParameters(){if("now"===this.departureTime){return{startTime:this.serviceDescription?.capabilities.supportsNow??!1?"now":new Date,startTimeIsUTC:!0}}return null==this.departureTime?{startTime:void 0,startTimeIsUTC:void 0}:{startTime:this.departureTime,startTimeIsUTC:!1}}async _load(){if(null==this.layer)return;null!=this._loadController&&(this._loadController.abort(),this._loadController=null),this._loadController=new AbortController;const{signal:e}=this._loadController;try{this._serviceDescriptionStatus=0;const t=await _(this.layer.url,this.apiKey,{signal:e});this._set("serviceDescription",t),this._serviceDescriptionStatus=1}catch(t){if(n(t))return void(this._serviceDescriptionStatus=3);if("identity-manager:user-aborted"===t.name)return void(this._serviceDescriptionStatus=4);const e=new r("directions-view-model:service-metadata-unavailable","Cannot load route service metadata",{error:t});throw this._serviceDescriptionStatus=2,this._set("lastError",e),e}finally{this._loadController=null}}_resolveDefaultTravelMode(e){if(null==this.serviceDescription)return null;const{defaultTravelMode:t,supportedTravelModes:r}=this.serviceDescription,i=/^<(?<name>.*)>$/i.exec(e.name)?.groups?.name;if(i){const o=r?.find(({name:e})=>e.toLocaleLowerCase()===i.trim().toLocaleLowerCase()),s=o??t;return D.fromJSON({...s?.toJSON(),...e.toJSON()})}const o=r?.find(({name:t})=>t.toLocaleLowerCase()===e.name.toLocaleLowerCase());return o??t}};e([p()],F.prototype,"_directionsLanguage",null),e([p()],F.prototype,"_layerView",void 0),e([p()],F.prototype,"_routeController",void 0),e([p()],F.prototype,"_serviceDescriptionStatus",void 0),e([p()],F.prototype,"apiKey",void 0),e([p()],F.prototype,"autoSolve",void 0),e([p({nonNullable:!0})],F.prototype,"autoSolveOn",void 0),e([p()],F.prototype,"defaultTravelMode",void 0),e([p()],F.prototype,"departureTime",void 0),e([p()],F.prototype,"formattedEta",null),e([p({readOnly:!0})],F.prototype,"impedanceAttribute",null),e([p()],F.prototype,"lastError",void 0),e([p({readOnly:!0})],F.prototype,"lastRoute",void 0),e([p()],F.prototype,"layer",void 0),e([p({type:Number,range:{min:2,max:50},nonNullable:!0})],F.prototype,"maxStops",void 0),e([p({type:T,nonNullable:!0})],F.prototype,"routeParameters",void 0),e([p({readOnly:!0})],F.prototype,"selectedNetworkFeatures",null),e([p({type:D})],F.prototype,"selectedTravelMode",null),e([p({readOnly:!0})],F.prototype,"serviceDescription",void 0),e([p({readOnly:!0})],F.prototype,"state",null),e([p({readOnly:!0})],F.prototype,"timeAttribute",null),e([p()],F.prototype,"travelModes",null),e([p()],F.prototype,"view",void 0),e([p()],F.prototype,"zoomToRoute",null),F=e([m("esri.widgets.Directions.DirectionsViewModel")],F);const G=F;export{G as default};

package/widgets/Directions.d.ts

@@ -98,7 +98,7 @@ export interface DirectionsProperties extends WidgetProperties, Partial<Pick<Dir
  *
  * | Directions with RouteLayer |
  * |------|
- * | ![Directions with 3 stops](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/DW1.png) |
+ * | ![Directions with 3 stops](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/DW1.png) |
  *
  * This routing service requires authentication.
  * If an API key is specified at the app level (see [Config](https://developers.arcgis.com/javascript/latest/references/core/config/#Config-apiKey)) or widget level (see [apiKey](https://developers.arcgis.com/javascript/latest/references/core/widgets/Directions/#apiKey)) then this key will accompany requests to both the routing service and geocoder/reverse-geocoder.
@@ -106,14 +106,14 @@ export interface DirectionsProperties extends WidgetProperties, Partial<Pick<Dir
  *
  * | Pick a location on the map |
  * |------|
- * | ![Directions with saving](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/Directions-3-PickLocation.png) |
+ * | ![Directions with saving](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/Directions-3-PickLocation.png) |
  *
  * Locations on the map can be reverse geocoded and used as stops in the route.
  * Click the button with a crosshairs icon to associate a location with a new or existing stop.  After clicking the button, click the map once. To cancel this process, press the `escape` key.
  *
  * | Route options |  Route options |
  * |------|------|
- * | ![Directions with saving](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/Directions-6-SaveDropdown.png) |  ![Directions with saving2](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/Directions-6-SaveDropdown-2.png) |
+ * | ![Directions with saving](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/Directions-6-SaveDropdown.png) |  ![Directions with saving2](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/Directions-6-SaveDropdown-2.png) |
  *
  * The resulting driving directions are automatically collapsed and can be optionally saved to a new or existing portal item. This can be achieved programically with [save()](https://developers.arcgis.com/javascript/latest/references/core/widgets/Directions/#save) and [saveAs()](https://developers.arcgis.com/javascript/latest/references/core/widgets/Directions/#saveAs).
  * The `Clear` button calls the [DirectionsViewModel.reset()](https://developers.arcgis.com/javascript/latest/references/core/widgets/Directions/DirectionsViewModel/#reset)
@@ -121,7 +121,7 @@ export interface DirectionsProperties extends WidgetProperties, Partial<Pick<Dir
  *
  * | Editing | Editing |
  * |------|------|
- * | ![Directions edit1](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/Directions-7-Edit.png) | ![Directions edit2](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/Directions-8-NoAuto.png) |
+ * | ![Directions edit1](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/Directions-7-Edit.png) | ![Directions edit2](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/Directions-8-NoAuto.png) |
  *
  * Selecting the `Edit route` button allows you to add/move/remove stops, add/move/remove/reshape polyline barriers.
  * By default the route will be automatically resolve at the completion of any editing operation. For more complex routes, it may be advantageous to disable auto-solving and solve as and when needed with the dedicated solve button.

package/widgets/DistanceMeasurement2D.d.ts

@@ -87,7 +87,7 @@ export interface DistanceMeasurement2DProperties extends WidgetProperties, Parti
  * * In geographic coordinate systems (GCS) and in Web Mercator, distances are computed geodetically.
  * * In projected coordinate systems (PCS), apart from Web Mercator, distances are computed in a Euclidean manner (in their respective PCS).
  *
- * [![measurement-line-2d](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/DistanceMeasurement2D_widget.png)](https://developers.arcgis.com/javascript/latest/sample-code/widgets-measurement-2d/)
+ * [![measurement-line-2d](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/DistanceMeasurement2D_widget.png)](https://developers.arcgis.com/javascript/latest/sample-code/widgets-measurement-2d/)
  *
  * ### Undo / Redo
  *

package/widgets/Editor/CreateFeaturesWorkflow.d.ts

@@ -12,7 +12,7 @@ export interface CreateFeaturesWorkflowProperties extends WorkflowProperties {}
  * the [Editor](https://developers.arcgis.com/javascript/latest/references/core/widgets/Editor/) widget. This workflow provides continuous creation of multiple features of the same type at once. After the initial sketch is created, the attribute form will display with the set field elements. These fields can be updated as the user creates new features. This workflow is designed for both individual and multiple feature creation.
  *
  *
- * ![create-feature](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/editor/initial-editor-panel2.png)
+ * ![create-feature](https://developers.arcgis.com/javascript/latest/assets/images/apiref/widgets/editor/initial-editor-panel2.png)
  *
  * > [!WARNING]
  * >