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

package/widgets/LineOfSight/LineOfSightTarget.d.ts

@@ -3,6 +3,7 @@ import type Accessor from "../../core/Accessor.js";
 import type Point from "../../geometry/Point.js";
 import type { PointProperties } from "../../geometry/Point.js";
 
+/** @deprecated since 4.33. Use the [LineOfSightAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-LineOfSightAnalysis.html) or [Line Of Sight component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-line-of-sight/) 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 LineOfSightTargetProperties {
   /**
    * A [Point](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Point.html) representing the location of the target. Once the location is set, a new line of

package/widgets/LineOfSight/LineOfSightViewModel.d.ts

@@ -9,6 +9,7 @@ import type { PointProperties } from "../../geometry/Point.js";
 import type { LineOfSightTargetProperties } from "./LineOfSightTarget.js";
 import type { ReadonlyArrayOrCollection } from "../../core/Collection.js";
 
+/** @deprecated since 4.33. Use the [LineOfSightAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-LineOfSightAnalysis.html) or [Line Of Sight component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-line-of-sight/) 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 LineOfSightViewModelProperties extends Partial<Pick<LineOfSightViewModel, "view">> {
   /**
    * The line of sight analysis object being created or modified by the view model.

package/widgets/LineOfSight.d.ts

@@ -7,6 +7,7 @@ import type { LineOfSightAnalysisProperties } from "../analysis/LineOfSightAnaly
 import type { WidgetProperties } from "./Widget.js";
 import type { LineOfSightViewModelProperties } from "./LineOfSight/LineOfSightViewModel.js";
 
+/** @deprecated since 4.33. Use the [Line Of Sight component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-line-of-sight/) 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 LineOfSightProperties extends WidgetProperties, Partial<Pick<LineOfSight, "view">> {
   /**
    * The line of sight analysis object being created or modified by the widget. This property is an

package/widgets/Locate/LocateViewModel.d.ts

@@ -7,7 +7,7 @@ export type LocateViewModelState = "disabled" | "ready" | "locating" | "feature-
 
 export interface LocateViewModelEvents {
   /**
-   * Fires after the [Locate#locate()](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Locate.html#locate) method is called and succeeds.
+   * Fires after the `locate()` method is called and succeeds.
    *
    * @see [locate()](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Locate-LocateViewModel.html#locate)
    * @example

package/widgets/Locate.d.ts

@@ -182,7 +182,7 @@ export default class Locate extends Widget {
   accessor popupEnabled: boolean;
   /**
    * Indicates the scale to set on the view when navigating to the position of the geolocated
-   * result once a location is returned from the {@link widgets/Locate#event-track} event.
+   * result once a location is returned from the [locate](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Locate.html#event-locate) event.
    * If a scale value is not explicitly set, then the view will navigate to a default scale of `2500`.
    * For 2D views the value should be within the [effectiveMinScale](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#constraints)
    * and [effectiveMaxScale](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#constraints).

package/widgets/Measurement/MeasurementViewModel.d.ts

@@ -5,8 +5,8 @@ import type DirectLineMeasurement3DViewModel from "../DirectLineMeasurement3D/Di
 import type DistanceMeasurement2DViewModel from "../DistanceMeasurement2D/DistanceMeasurement2DViewModel.js";
 import type { SystemOrAreaUnit, SystemOrLengthUnit } from "../../core/units.js";
 import type { MapViewOrSceneView } from "../../views/MapViewOrSceneView.js";
-import type { MeasurementState } from "../interfaces.js";
-import type { MeasurementComponentType } from "./interfaces.js";
+import type { MeasurementState } from "../types.js";
+import type { MeasurementComponentType } from "./types.js";
 
 export interface MeasurementViewModelProperties extends Partial<Pick<MeasurementViewModel, "activeTool" | "areaUnit" | "linearUnit" | "view">> {}
 

package/widgets/Measurement.d.ts

@@ -7,7 +7,7 @@ import type MeasurementViewModel from "./Measurement/MeasurementViewModel.js";
 import type { Icon } from "@esri/calcite-components/components/calcite-icon";
 import type { SystemOrAreaUnit, SystemOrLengthUnit } from "../core/units.js";
 import type { MapViewOrSceneView } from "../views/MapViewOrSceneView.js";
-import type { MeasurementComponentType } from "./Measurement/interfaces.js";
+import type { MeasurementComponentType } from "./Measurement/types.js";
 import type { MeasurementViewModelProperties } from "./Measurement/MeasurementViewModel.js";
 import type { WidgetProperties } from "./Widget.js";
 

package/widgets/Popup.d.ts

@@ -6,11 +6,11 @@ import type Widget from "./Widget.js";
 import type PopupViewModel from "./Popup/PopupViewModel.js";
 import type PopupVisibleElements from "./Popup/PopupVisibleElements.js";
 import type { Icon } from "@esri/calcite-components/components/calcite-icon";
-import type { ScreenPoint } from "../core/interfaces.js";
+import type { ScreenPoint } from "../core/types.js";
 import type { MapViewOrSceneView } from "../views/MapViewOrSceneView.js";
-import type { FetchPopupFeaturesResult } from "../views/interfaces.js";
+import type { FetchPopupFeaturesResult } from "../views/types.js";
 import type { FeaturesViewModelEvents } from "./Features/FeaturesViewModel.js";
-import type { PopupAction, Alignment, DockOptions, PopupPositionResult, PopupOpenOptions, FetchFeaturesOptions, InitialDisplayOptions } from "./Popup/interfaces.js";
+import type { PopupAction, Alignment, DockOptions, PopupPositionResult, PopupOpenOptions, FetchFeaturesOptions, InitialDisplayOptions } from "./Popup/types.js";
 import type { GoToOverride } from "./support/goToUtils.js";
 import type { HeadingLevel } from "./support/Heading.js";
 import type { ActionToggleProperties } from "../support/actions/ActionToggle.js";
@@ -640,9 +640,9 @@ export default class Popup extends Widget {
    * control how the input location is handled, and then subsequently, what to do with the results.
    *
    * @param screenPoint - An object representing a point on the screen. This point can be in either the
-   * [ScreenPoint](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-interfaces.html#ScreenPoint) or
-   * [ScreenPoint](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-interfaces.html#ScreenPoint).
-   * @param options - The [options](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Popup-interfaces.html#FetchFeaturesOptions)
+   * [ScreenPoint](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-types.html#ScreenPoint) or
+   * [ScreenPoint](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-types.html#ScreenPoint).
+   * @param options - The [options](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Popup-types.html#FetchFeaturesOptions)
    * to pass into the `fetchFeatures` method.
    * @returns Resolves with the selected `hitTest`
    * location. In addition, it also returns an array of [graphics](https://developers.arcgis.com/javascript/latest/api-reference/esri-Graphic.html) if the `hitTest` is
@@ -651,7 +651,7 @@ export default class Popup extends Widget {
    * [LayerView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-layers-LayerView.html).
    *
    * Most commonly if accessing all features, use the single promise returned in the
-   * [result's allGraphicsPromise](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-interfaces.html#FetchPopupFeaturesResult) and call `.then()`
+   * [result's allGraphicsPromise](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-types.html#FetchPopupFeaturesResult) and call `.then()`
    * as seen in the example snippet.
    * @since 4.15
    * @example

package/widgets/Print/CustomTemplate.d.ts

@@ -3,7 +3,7 @@ import type { JSONSupport, JSONSupportMixinProperties } from "../../core/JSONSup
 import type { Unit } from "../../core/units.js";
 import type { FileFormat } from "../../rest/support/fileFormat.js";
 import type { LayoutTemplate } from "../../rest/support/layoutTemplate.js";
-import type { LayoutTemplateInfo, MapSurroundInfo } from "./interfaces.js";
+import type { LayoutTemplateInfo, MapSurroundInfo } from "./types.js";
 
 export interface CustomTemplateProperties extends JSONSupportMixinProperties, Partial<Pick<CustomTemplate, "format">> {}
 

package/widgets/Print/PrintViewModel.d.ts

@@ -11,8 +11,8 @@ import type TemplateOptions from "./TemplateOptions.js";
 import type { EventedAccessor, EventedMixinProperties } from "../../core/Evented.js";
 import type { LoadableMixin, LoadableMixinProperties } from "../../core/Loadable.js";
 import type { EsriPromiseMixin, EsriPromiseMixinProperties } from "../../core/Promise.js";
-import type { PrintResponse } from "../../rest/interfaces.js";
-import type { Formats, Layouts, State, TemplateCustomTextElements, TemplatesInfo } from "./interfaces.js";
+import type { PrintResponse } from "../../rest/types.js";
+import type { Formats, Layouts, State, TemplateCustomTextElements, TemplatesInfo } from "./types.js";
 import type { FileLinkProperties } from "./FileLink.js";
 import type { ReadonlyArrayOrCollection } from "../../core/Collection.js";
 import type { SpatialReferenceProperties } from "../../geometry/SpatialReference.js";

package/widgets/Print.d.ts

@@ -7,8 +7,8 @@ import type PrintViewModel from "./Print/PrintViewModel.js";
 import type TemplateOptions from "./Print/TemplateOptions.js";
 import type { Icon } from "@esri/calcite-components/components/calcite-icon";
 import type { WidgetProperties } from "./Widget.js";
-import type { Formats, Layouts } from "./Print/interfaces.js";
 import type { PrintViewModelEvents, PrintViewModelProperties } from "./Print/PrintViewModel.js";
+import type { Formats, Layouts } from "./Print/types.js";
 import type { HeadingLevel } from "./support/Heading.js";
 import type { FileLinkProperties } from "./Print/FileLink.js";
 import type { ReadonlyArrayOrCollection } from "../core/Collection.js";

package/widgets/ScaleRangeSlider.d.ts

@@ -4,7 +4,7 @@ import type Widget from "./Widget.js";
 import type ScaleRangeSliderViewModel from "./ScaleRangeSlider/ScaleRangeSliderViewModel.js";
 import type { Icon } from "@esri/calcite-components/components/calcite-icon";
 import type { MapViewOrSceneView } from "../views/MapViewOrSceneView.js";
-import type { SupportedRegion } from "./ScaleRangeSlider/interfaces.js";
+import type { SupportedRegion } from "./ScaleRangeSlider/types.js";
 import type { ScaleRangeSliderViewModelProperties } from "./ScaleRangeSlider/ScaleRangeSliderViewModel.js";
 import type { WidgetProperties } from "./Widget.js";
 
@@ -145,7 +145,7 @@ export default class ScaleRangeSlider extends Widget {
   /**
    * The region that the scale thumbnails will focus on.
    * Each region comes from the [ISO 3166-1 alpha-2 code](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes).
-   * See [SupportedRegion](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ScaleRangeSlider-interfaces.html#SupportedRegion) for the list of regions that are currently supported.
+   * See [SupportedRegion](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ScaleRangeSlider-types.html#SupportedRegion) for the list of regions that are currently supported.
    *
    * @default "US"
    */

package/widgets/Search/LocatorSearchSource.d.ts

@@ -1,7 +1,7 @@
 import type SearchSource from "./SearchSource.js";
-import type { LocationType } from "../../rest/interfaces.js";
+import type { LocationType } from "../../rest/types.js";
 import type { SearchSourceProperties } from "./SearchSource.js";
-import type { SearchFilter } from "./support/interfaces.js";
+import type { SearchFilter } from "./types.js";
 
 export interface LocatorSearchSourceProperties extends SearchSourceProperties, Partial<Pick<LocatorSearchSource, "apiKey" | "categories" | "countryCode" | "defaultZoomScale" | "language" | "localSearchDisabled" | "locationType" | "name" | "searchTemplate" | "singleLineFieldName" | "url">> {
   /**

package/widgets/Search/SearchSource.d.ts

@@ -2,7 +2,7 @@ import type PopupTemplate from "../../PopupTemplate.js";
 import type { IdentifiableMixin, IdentifiableMixinProperties } from "../../core/Identifiable.js";
 import type { JSONSupport, JSONSupportMixinProperties } from "../../core/JSONSupport.js";
 import type { SymbolUnion } from "../../symbols/support/typeUtils.js";
-import type { GetResultsCallback, GetSuggestionsCallback, SearchFilter } from "./support/interfaces.js";
+import type { GetResultsCallback, GetSuggestionsCallback, SearchFilter } from "./types.js";
 import type { PopupTemplateProperties } from "../../PopupTemplate.js";
 
 export interface SearchSourceProperties extends JSONSupportMixinProperties, IdentifiableMixinProperties, Partial<Pick<SearchSource, "autoNavigate" | "filter" | "getResults" | "getSuggestions" | "maxResults" | "maxSuggestions" | "minSuggestCharacters" | "outFields" | "placeholder" | "popupEnabled" | "prefix" | "resultGraphicEnabled" | "resultSymbol" | "suffix" | "suggestionsEnabled" | "withinViewEnabled" | "zoomScale">> {
@@ -81,7 +81,7 @@ export default class SearchSource extends SearchSourceSuperclass {
    */
   accessor filter: SearchFilter | null | undefined;
   /**
-   * Function used to get search results. See [GetResultsCallback](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search-support-interfaces.html#GetResultsCallback) for the function definition.
+   * Function used to get search results. See {@link widgets/Search/support/types!GetResultsCallback} for the function definition.
    * When resolved, returns an object containing an array of [search results](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search-types.html#SearchResult).
    *
    * @returns When resolved, returns an object containing an array of [search results](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search-types.html#SearchResult).
@@ -89,7 +89,7 @@ export default class SearchSource extends SearchSourceSuperclass {
    */
   accessor getResults: GetResultsCallback | null | undefined;
   /**
-   * Function used to get search suggestions. See [GetSuggestionsCallback](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search-support-interfaces.html#GetSuggestionsCallback) for the function definition.
+   * Function used to get search suggestions. See {@link widgets/Search/support/types!GetSuggestionsCallback} for the function definition.
    * When resolved, returns an object containing an array of [suggest results](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search-types.html#SuggestResult).
    *
    * @returns When resolved, returns an object containing an array of [suggest results](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search-types.html#SuggestResult).

package/widgets/Search/types.d.ts

@@ -2,7 +2,11 @@ import type Graphic from "../../Graphic.js";
 import type Collection from "../../core/Collection.js";
 import type EsriError from "../../core/Error.js";
 import type Extent from "../../geometry/Extent.js";
+import type Multipoint from "../../geometry/Multipoint.js";
 import type Point from "../../geometry/Point.js";
+import type Polygon from "../../geometry/Polygon.js";
+import type Polyline from "../../geometry/Polyline.js";
+import type SpatialReference from "../../geometry/SpatialReference.js";
 import type CIMSymbol from "../../symbols/CIMSymbol.js";
 import type LineSymbol3D from "../../symbols/LineSymbol3D.js";
 import type PictureMarkerSymbol from "../../symbols/PictureMarkerSymbol.js";
@@ -15,6 +19,8 @@ import type TextSymbol from "../../symbols/TextSymbol.js";
 import type WebStyleSymbol from "../../symbols/WebStyleSymbol.js";
 import type LayerSearchSource from "./LayerSearchSource.js";
 import type LocatorSearchSource from "./LocatorSearchSource.js";
+import type { AbortOptions } from "../../core/promiseUtils.js";
+import type { MapViewOrSceneView } from "../../views/MapViewOrSceneView.js";
 
 /** The result object returned from a [Search#search()](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search.html#search). */
 export interface SearchResult {
@@ -112,4 +118,62 @@ export interface SourcesHandlerOptions {
   defaultSources: Collection<SupportedSearchSource>;
   /** The collection of sources currently configured in the Search widget. */
   sources: Collection<SupportedSearchSource>;
+}
+
+export type SearchGeometry = Extent | Multipoint | Point | Polygon | Polyline;
+
+export interface SearchFilter {
+  /**
+   * The filter geometry for suggests or search results.
+   * [Extent](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Extent.html) is the only supported geometry when working with [locator](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search-LocatorSearchSource.html) sources.
+   * See [Find Address Candidates](https://developers.arcgis.com/rest/services-reference/find-address-candidates.htm) for additional information.
+   */
+  geometry?: SearchGeometry;
+  /** The where clause specified for filtering suggests or search results. */
+  where?: string;
+}
+
+export interface GetParameters {
+  /** Indicates the index of the search source. */
+  sourceIndex?: number | null;
+  /** Indicates the spatial reference defined by the source. */
+  spatialReference?: SpatialReference;
+  /** Indicates the view provided using the source. */
+  view?: MapViewOrSceneView | null;
+}
+
+export interface GetResultsParameters extends GetParameters {
+  /** The key field used to find the result. */
+  exactMatch?: boolean | null;
+  /** The location value used by the Search. */
+  location?: Point | null;
+  /** Indicates the maximum number of search results to return. */
+  maxResults?: number | null;
+  /** Indicates the Suggest Result that triggered the search for a result. */
+  suggestResult: SuggestResult;
+}
+
+/**
+ * Function definition for the [SearchSource#getResults](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search-SearchSource.html#getResults) property.
+ *
+ * @param params - An object that is passed as a parameter to get search results.
+ * @param options - Additional options.
+ * @returns When resolved, returns an object containing an array of [search results](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search-types.html#SearchResult).
+ */
+export type GetResultsCallback = (params: GetResultsParameters, options?: AbortOptions) => Promise<SearchResult[] | null | undefined>;
+
+/**
+ * Function definition for the [SearchSource#getSuggestions](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search-SearchSource.html#getSuggestions) property.
+ *
+ * @param params - An object that is passed as a parameter to get search suggestions.
+ * @param options - Additional options.
+ * @returns When resolved, returns an object containing an array of [suggest results](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search-types.html#SuggestResult).
+ */
+export type GetSuggestionsCallback = (params: GetSuggestionsParameters, options?: AbortOptions) => Promise<SuggestResult[] | null | undefined>;
+
+export interface GetSuggestionsParameters extends GetParameters {
+  /** Indicates the maximum number of suggestions to return for the widget's input. */
+  maxSuggestions?: number | null;
+  /** Indicates search term used to find a suggestion. */
+  suggestTerm: string;
 }

package/widgets/Search.d.ts

@@ -492,7 +492,7 @@ export default class Search extends Widget {
    * The result selected from a search.
    *
    * @see [Event: select-result](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search.html#event-select-result)
-   * @see {@link widgets/Search#select}
+   * @see [SearchViewModel#select()](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search-SearchViewModel.html#select)
    */
   get selectedResult(): SearchResult | null | undefined;
   /**

package/widgets/ShadowCast/ShadowCastViewModel.d.ts

@@ -3,7 +3,7 @@ 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 { ScreenPoint } from "../../core/types.js";
 import type { ShadowVisualizationType } from "./ShadowVisualizationType.js";
 import type { ThresholdOptionsProperties } from "./ThresholdOptions.js";
 import type { DurationOptionsProperties } from "./DurationOptions.js";

package/widgets/ShadowCast/ShadowCastViewModel.js

@@ -2,4 +2,4 @@
 All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/5.0/esri/copyright.txt for details.
 */
-import{__decorate as t}from"tslib";import e from"../../Color.js";import i from"../../core/Accessor.js";import{isSome as r}from"../../core/arrayUtils.js";import{createTask as s}from"../../core/asyncUtils.js";import"../../core/has.js";import{deprecateUnnecessaryViewModel as o}from"../../core/deprecate.js";import n from"../../core/Logger.js";import{abortMaybe as a,destroyMaybe as l}from"../../core/maybe.js";import{after as u,throwIfAborted as d}from"../../core/promiseUtils.js";import{watch as p,syncAndInitial as h}from"../../core/reactiveUtils.js";import{createScreenPointArray as c,createRenderScreenPointArray as m}from"../../core/screenUtils.js";import{convertTime as f,offsetDateUTC as _}from"../../core/timeUtils.js";import{property as g,subclass as v}from"../../core/accessorSupport/decorators.js";import{create as y}from"../../core/libs/gl-matrix-2/factories/vec3f64.js";import{longitudeToTimezone as w}from"../../views/3d/support/earthUtils.js";import{computeDirectionsOverTime as D}from"../../views/3d/support/sunUtils.js";import T from"./DiscreteOptions.js";import O from"./DurationOptions.js";import{ShadowTooltipViewModel as P}from"./ShadowTooltipViewModel.js";import C from"./ThresholdOptions.js";import{breadthFirstBinaryPartitioning as b}from"../support/traversalUtils.js";const z=[],V=y(),U=[],j=255,x=f(1,"hours","milliseconds"),E=500;let A=class extends i{constructor(t){super(t),this.view=null,this.tooltip=new P({getDuration:t=>this.getDuration(t)}),this.startTimeOfDay=f(10,"hours","milliseconds"),this.endTimeOfDay=f(16,"hours","milliseconds"),this.visualizationType="threshold",this.thresholdOptions=new C({isDefaultViewModel:!0}),this.durationOptions=new O({isDefaultViewModel:!0}),this.discreteOptions=new T({isDefaultViewModel:!0}),this._running=!0,this._stopPreviewingTask=null,this._forcePreview=!1,this._autoRestoreForcePreviewEnabled=!0,this._utcOffset=null,t?.isDefaultViewModel||o(n.getLogger(this),"Shadow Cast","arcgis-shadow-cast",{version:"5.0"}),this.date=new Date}normalizeCtorArgs(t){const{isDefaultViewModel:e,...i}=t??{};return i}initialize(){this.addHandles([p(()=>({view:this.view,tooltipEnabled:this._tooltipEnabled}),({view:t,tooltipEnabled:e})=>{this.tooltip.view=t,this.tooltip.enabled=e},h),p(()=>this._forcePreviewDependencies,()=>{a(this._stopPreviewingTask),this._forcePreview=!0,this._autoRestoreForcePreviewEnabled&&(this._stopPreviewingTask=s(async t=>{await u(E,t),d(t),this._forcePreview=!1}))},h),p(()=>({renderer:this.renderer,parameters:this._visualizationParameters}),t=>S(t.renderer,t.parameters),h),p(()=>({renderer:this.renderer,lightDirections:this._lightDirections,lightDirectionsContext:this._lightDirectionsContext}),t=>S(t.renderer,{lightDirections:t.lightDirections,lightDirectionsContext:t.lightDirectionsContext}),h),p(()=>({renderer:this.renderer,parameters:{enabled:this._running}}),t=>S(t.renderer,t.parameters),h),p(()=>({renderer:this.renderer,parameters:{previewing:this._previewing}}),t=>S(t.renderer,t.parameters),h)])}destroy(){this.stop(),S(this.renderer,{enabled:!1}),l(this.tooltip)}get state(){return null!=this.view&&this.view.ready&&null!=this._referencePosition?"ready":"disabled"}set date(t){const e=new Date(t);e.setHours(0,0,0,0),this._set("date",e)}get utcOffset(){return this._utcOffset??this._utcOffsetAuto}set utcOffset(t){this._utcOffset=t}get testData(){}get _previewing(){const{view:t}=this;if(null==t?.allLayerViews)return!0;const{stationary:e,allLayerViews:i,graphicsView:r}=t;return this._forcePreview||!e||i.some(t=>M(t)&&t.updating)||!r?.suspended&&!!r?.updating}get _utcOffsetAuto(){const t=this._referencePosition;return null!=t?w(t[0],!1):0}get _dateUTCOffset(){let t=this.date;return t=_(t,-t.getTimezoneOffset(),"minutes"),t=_(t,-this.utcOffset,"hours"),t}get _startDateTimeUTC(){return _(this._dateUTCOffset,this.startTimeOfDay)}get _endDateTimeUTC(){return _(this._dateUTCOffset,this.endTimeOfDay)}get _referencePosition(){return this.view?.environmentManager?.referencePositionGeographic}get _durationInterval(){return this._duration>0?Math.floor(this._duration/(j-1)):j}get _interval(){const t=this._durationInterval;switch(this.visualizationType){case"threshold":case"duration":return t;case"discrete":return this.discreteOptions.interval||t}}get _intervalContext(){const{contextEnabled:t,contextOptions:{interval:e}}=this.thresholdOptions;return"threshold"===this.visualizationType&&t?e||this._durationInterval:-1}get _durationSampleCount(){return this._lightDirections.length}get _duration(){return this.endTimeOfDay-this.startTimeOfDay}get _lightDirections(){return this._calculateLightDirections(this._interval)}get _lightDirectionsContext(){return this._calculateLightDirections(this._intervalContext)}_calculateLightDirections(t){const{view:e}=this;if(null==e||t<=0)return z;const i="global"===e.viewingMode?V:this._referencePosition;if(null==i)return z;const r=D(this._startDateTimeUTC,this._endDateTimeUTC,t,i,e.state.viewingMode,j),s=r.length;U.length=0;const o=b(0,s,U),n=new Array(s);for(let a=0;a<s;++a)n[a]=r[o[a]];return n}get _tooltipEnabled(){return"ready"===this.state&&"discrete"!==this.visualizationType&&this._running&&!this._previewing}get _visualizationParameters(){if(!this._running)return null;switch(this.visualizationType){case"threshold":return this._thresholdVisualizationParameters;case"duration":return this._durationVisualizationParameters;case"discrete":return this._discreteVisualizationParameters}}get _thresholdVisualizationParameters(){const{value:t,color:i}=this.thresholdOptions,r=this._duration;return{visualization:2,thresholdColor:e.toUnitRGBA(i),threshold:r>0?t/this._duration:0,...this._thresholdDiscreteVisualizationParameters}}get _thresholdDiscreteVisualizationParameters(){const{contextOptions:{color:t},contextEnabled:i}=this.thresholdOptions;return i?{visualization:3,gradientColor:e.toUnitRGBA(t)}:{}}get _durationVisualizationParameters(){const{color:t,mode:i}=this.durationOptions,r=this._duration,s=r>0&&"hourly"===i?x/r:0,o=e.toUnitRGBA(t);return 0===s?{...this._discreteVisualizationParameters,gradientColor:o}:{bandedGradientColor:o,visualization:1,bandSize:s}}get _discreteVisualizationParameters(){return{gradientColor:e.toUnitRGBA(this.discreteOptions.color),visualization:0}}get _forcePreviewDependencies(){const{view:t}=this;if(null==t)return null;const e=t.slice.plane,i=t.allLayerViews.toArray().filter(M),s=i.map(t=>t.layer).filter(r),o=i.map(t=>t.suspended),n=s.map(t=>t.visible),a=s.map(t=>t.opacity),l=!!t.graphicsView?.suspended,u=s.filter(t=>"definitionExpression"in t).map(t=>t.definitionExpression),d=i.filter(t=>"filter"in t).map(t=>t.filter);return{slicePlane:e,startDateUTC:this._startDateTimeUTC,endDateUTC:this._endDateTimeUTC,layerViewSuspended:o,graphicsViewSuspended:l,layerVisibilities:n,layerOpacities:a,filters:d,definitionExpressions:u}}get renderer(){const{view:t}=this;if(null==t)return null;const e=t.stage;return null==e?null:e.renderer}start(){this.setRunning(!0)}stop(){this.setRunning(!1)}setRunning(t){this._running=t}async getDuration(t){const{view:e,renderer:i,_durationSampleCount:r}=this;if(null==e||null==i||0===r)return 0;const s=e.state.camera.screenToRender(c(t.x,t.y),m());return i.readAccumulatedShadow(s)*this._duration}};function S(t,e){null!=t&&null!=e&&t.setParameters({shadowCast:e})}function M(t){if(t.suspended)return!1;switch(t.type){case"building-scene-3d":case"csv-3d":case"elevation-3d":case"feature-3d":case"geojson-3d":case"graphics-3d":case"integrated-mesh-3d":case"integrated-mesh-3dtiles":case"ogc-feature-3d":case"route-3d":case"scene-layer-3d":case"scene-layer-graphics-3d":case"stream-3d":case"wms-3d":case"catalog-footprint-3d":return!0;default:return!1}}t([g()],A.prototype,"state",null),t([g()],A.prototype,"view",void 0),t([g()],A.prototype,"tooltip",void 0),t([g({type:Date,nonNullable:!0})],A.prototype,"date",null),t([g({type:Number,nonNullable:!0})],A.prototype,"utcOffset",null),t([g({type:Number,nonNullable:!0})],A.prototype,"startTimeOfDay",void 0),t([g({type:Number,nonNullable:!0})],A.prototype,"endTimeOfDay",void 0),t([g({type:["threshold","duration","discrete"],nonNullable:!0})],A.prototype,"visualizationType",void 0),t([g({type:C,nonNullable:!0})],A.prototype,"thresholdOptions",void 0),t([g({type:O,nonNullable:!0})],A.prototype,"durationOptions",void 0),t([g({type:T,nonNullable:!0})],A.prototype,"discreteOptions",void 0),t([g()],A.prototype,"_running",void 0),t([g()],A.prototype,"_stopPreviewingTask",void 0),t([g()],A.prototype,"_forcePreview",void 0),t([g()],A.prototype,"_autoRestoreForcePreviewEnabled",void 0),t([g()],A.prototype,"_previewing",null),t([g()],A.prototype,"_utcOffset",void 0),t([g()],A.prototype,"_utcOffsetAuto",null),t([g()],A.prototype,"_dateUTCOffset",null),t([g()],A.prototype,"_startDateTimeUTC",null),t([g()],A.prototype,"_endDateTimeUTC",null),t([g()],A.prototype,"_referencePosition",null),t([g()],A.prototype,"_interval",null),t([g()],A.prototype,"_intervalContext",null),t([g()],A.prototype,"_durationSampleCount",null),t([g()],A.prototype,"_duration",null),t([g()],A.prototype,"_lightDirections",null),t([g()],A.prototype,"_lightDirectionsContext",null),t([g()],A.prototype,"_tooltipEnabled",null),t([g()],A.prototype,"_visualizationParameters",null),t([g()],A.prototype,"_thresholdVisualizationParameters",null),t([g()],A.prototype,"_thresholdDiscreteVisualizationParameters",null),t([g()],A.prototype,"_durationVisualizationParameters",null),t([g()],A.prototype,"_discreteVisualizationParameters",null),t([g()],A.prototype,"_forcePreviewDependencies",null),t([g()],A.prototype,"renderer",null),A=t([v("esri.widgets.ShadowCast.ShadowCastViewModel")],A);const N=A;export{N as default};
+import{__decorate as t}from"tslib";import e from"../../core/Accessor.js";import{isSome as i}from"../../core/arrayUtils.js";import{createTask as r}from"../../core/asyncUtils.js";import"../../core/has.js";import{deprecateUnnecessaryViewModel as s}from"../../core/deprecate.js";import o from"../../core/Logger.js";import{abortMaybe as n,destroyMaybe as a}from"../../core/maybe.js";import{after as l,throwIfAborted as u}from"../../core/promiseUtils.js";import{watch as d,syncAndInitial as p}from"../../core/reactiveUtils.js";import{createScreenPointArray as h,createRenderScreenPointArray as c}from"../../core/screenUtils.js";import{convertTime as m,offsetDateUTC as f}from"../../core/timeUtils.js";import{property as _,subclass as g}from"../../core/accessorSupport/decorators.js";import{create as v}from"../../core/libs/gl-matrix-2/factories/vec3f64.js";import{longitudeToTimezone as y}from"../../views/3d/support/earthUtils.js";import{computeDirectionsOverTime as w}from"../../views/3d/support/sunUtils.js";import D from"./DiscreteOptions.js";import T from"./DurationOptions.js";import{ShadowTooltipViewModel as O}from"./ShadowTooltipViewModel.js";import P from"./ThresholdOptions.js";import{breadthFirstBinaryPartitioning as C}from"../support/traversalUtils.js";const b=[],z=v(),V=[],U=255,j=m(1,"hours","milliseconds"),x=500;let E=class extends e{constructor(t){super(t),this.view=null,this.tooltip=new O({getDuration:t=>this.getDuration(t)}),this.startTimeOfDay=m(10,"hours","milliseconds"),this.endTimeOfDay=m(16,"hours","milliseconds"),this.visualizationType="threshold",this.thresholdOptions=new P({isDefaultViewModel:!0}),this.durationOptions=new T({isDefaultViewModel:!0}),this.discreteOptions=new D({isDefaultViewModel:!0}),this._running=!0,this._stopPreviewingTask=null,this._forcePreview=!1,this._autoRestoreForcePreviewEnabled=!0,this._utcOffset=null,t?.isDefaultViewModel||s(o.getLogger(this),"Shadow Cast","arcgis-shadow-cast",{version:"5.0"}),this.date=new Date}normalizeCtorArgs(t){const{isDefaultViewModel:e,...i}=t??{};return i}initialize(){this.addHandles([d(()=>({view:this.view,tooltipEnabled:this._tooltipEnabled}),({view:t,tooltipEnabled:e})=>{this.tooltip.view=t,this.tooltip.enabled=e},p),d(()=>this._forcePreviewDependencies,()=>{n(this._stopPreviewingTask),this._forcePreview=!0,this._autoRestoreForcePreviewEnabled&&(this._stopPreviewingTask=r(async t=>{await l(x,t),u(t),this._forcePreview=!1}))},p),d(()=>({renderer:this.renderer,parameters:this._visualizationParameters}),t=>A(t.renderer,t.parameters),p),d(()=>({renderer:this.renderer,lightDirections:this._lightDirections,lightDirectionsContext:this._lightDirectionsContext}),t=>A(t.renderer,{lightDirections:t.lightDirections,lightDirectionsContext:t.lightDirectionsContext}),p),d(()=>({renderer:this.renderer,parameters:{enabled:this._running}}),t=>A(t.renderer,t.parameters),p),d(()=>({renderer:this.renderer,parameters:{previewing:this._previewing}}),t=>A(t.renderer,t.parameters),p)])}destroy(){this.stop(),A(this.renderer,{enabled:!1}),a(this.tooltip)}get state(){return null!=this.view&&this.view.ready&&null!=this._referencePosition?"ready":"disabled"}set date(t){const e=new Date(t);e.setHours(0,0,0,0),this._set("date",e)}get utcOffset(){return this._utcOffset??this._utcOffsetAuto}set utcOffset(t){this._utcOffset=t}get testData(){}get _previewing(){const{view:t}=this;if(null==t?.allLayerViews)return!0;const{stationary:e,allLayerViews:i,graphicsView:r}=t;return this._forcePreview||!e||i.some(t=>S(t)&&t.updating)||!r?.suspended&&!!r?.updating}get _utcOffsetAuto(){const t=this._referencePosition;return null!=t?y(t[0],!1):0}get _dateUTCOffset(){let t=this.date;return t=f(t,-t.getTimezoneOffset(),"minutes"),t=f(t,-this.utcOffset,"hours"),t}get _startDateTimeUTC(){return f(this._dateUTCOffset,this.startTimeOfDay)}get _endDateTimeUTC(){return f(this._dateUTCOffset,this.endTimeOfDay)}get _referencePosition(){return this.view?.environmentManager?.referencePositionGeographic}get _durationInterval(){return this._duration>0?Math.floor(this._duration/(U-1)):U}get _interval(){const t=this._durationInterval;switch(this.visualizationType){case"threshold":case"duration":return t;case"discrete":return this.discreteOptions.interval||t}}get _intervalContext(){const{contextEnabled:t,contextOptions:{interval:e}}=this.thresholdOptions;return"threshold"===this.visualizationType&&t?e||this._durationInterval:-1}get _durationSampleCount(){return this._lightDirections.length}get _duration(){return this.endTimeOfDay-this.startTimeOfDay}get _lightDirections(){return this._calculateLightDirections(this._interval)}get _lightDirectionsContext(){return this._calculateLightDirections(this._intervalContext)}_calculateLightDirections(t){const{view:e}=this;if(null==e||t<=0)return b;const i="global"===e.viewingMode?z:this._referencePosition;if(null==i)return b;const r=w(this._startDateTimeUTC,this._endDateTimeUTC,t,i,e.state.viewingMode,U),s=r.length;V.length=0;const o=C(0,s,V),n=new Array(s);for(let a=0;a<s;++a)n[a]=r[o[a]];return n}get _tooltipEnabled(){return"ready"===this.state&&"discrete"!==this.visualizationType&&this._running&&!this._previewing}get _visualizationParameters(){if(!this._running)return null;switch(this.visualizationType){case"threshold":return this._thresholdVisualizationParameters;case"duration":return this._durationVisualizationParameters;case"discrete":return this._discreteVisualizationParameters}}get _thresholdVisualizationParameters(){const{value:t,color:e}=this.thresholdOptions,i=this._duration;return{visualization:2,thresholdColor:e.toUnitRGBA(),threshold:i>0?t/this._duration:0,...this._thresholdDiscreteVisualizationParameters}}get _thresholdDiscreteVisualizationParameters(){const{contextOptions:{color:t},contextEnabled:e}=this.thresholdOptions;return e?{visualization:3,gradientColor:t.toUnitRGBA()}:{}}get _durationVisualizationParameters(){const{color:t,mode:e}=this.durationOptions,i=this._duration,r=i>0&&"hourly"===e?j/i:0,s=t.toUnitRGBA();return 0===r?{...this._discreteVisualizationParameters,gradientColor:s}:{bandedGradientColor:s,visualization:1,bandSize:r}}get _discreteVisualizationParameters(){return{gradientColor:this.discreteOptions.color.toUnitRGBA(),visualization:0}}get _forcePreviewDependencies(){const{view:t}=this;if(null==t)return null;const e=t.slice.plane,r=t.allLayerViews.toArray().filter(S),s=r.map(t=>t.layer).filter(i),o=r.map(t=>t.suspended),n=s.map(t=>t.visible),a=s.map(t=>t.opacity),l=!!t.graphicsView?.suspended,u=s.filter(t=>"definitionExpression"in t).map(t=>t.definitionExpression),d=r.filter(t=>"filter"in t).map(t=>t.filter);return{slicePlane:e,startDateUTC:this._startDateTimeUTC,endDateUTC:this._endDateTimeUTC,layerViewSuspended:o,graphicsViewSuspended:l,layerVisibilities:n,layerOpacities:a,filters:d,definitionExpressions:u}}get renderer(){const{view:t}=this;if(null==t)return null;const e=t.stage;return null==e?null:e.renderer}start(){this.setRunning(!0)}stop(){this.setRunning(!1)}setRunning(t){this._running=t}async getDuration(t){const{view:e,renderer:i,_durationSampleCount:r}=this;if(null==e||null==i||0===r)return 0;const s=e.state.camera.screenToRender(h(t.x,t.y),c());return i.readAccumulatedShadow(s)*this._duration}};function A(t,e){null!=t&&null!=e&&t.setParameters({shadowCast:e})}function S(t){if(t.suspended)return!1;switch(t.type){case"building-scene-3d":case"csv-3d":case"elevation-3d":case"feature-3d":case"geojson-3d":case"graphics-3d":case"integrated-mesh-3d":case"integrated-mesh-3dtiles":case"ogc-feature-3d":case"route-3d":case"scene-layer-3d":case"scene-layer-graphics-3d":case"stream-3d":case"wms-3d":case"catalog-footprint-3d":return!0;default:return!1}}t([_()],E.prototype,"state",null),t([_()],E.prototype,"view",void 0),t([_()],E.prototype,"tooltip",void 0),t([_({type:Date,nonNullable:!0})],E.prototype,"date",null),t([_({type:Number,nonNullable:!0})],E.prototype,"utcOffset",null),t([_({type:Number,nonNullable:!0})],E.prototype,"startTimeOfDay",void 0),t([_({type:Number,nonNullable:!0})],E.prototype,"endTimeOfDay",void 0),t([_({type:["threshold","duration","discrete"],nonNullable:!0})],E.prototype,"visualizationType",void 0),t([_({type:P,nonNullable:!0})],E.prototype,"thresholdOptions",void 0),t([_({type:T,nonNullable:!0})],E.prototype,"durationOptions",void 0),t([_({type:D,nonNullable:!0})],E.prototype,"discreteOptions",void 0),t([_()],E.prototype,"_running",void 0),t([_()],E.prototype,"_stopPreviewingTask",void 0),t([_()],E.prototype,"_forcePreview",void 0),t([_()],E.prototype,"_autoRestoreForcePreviewEnabled",void 0),t([_()],E.prototype,"_previewing",null),t([_()],E.prototype,"_utcOffset",void 0),t([_()],E.prototype,"_utcOffsetAuto",null),t([_()],E.prototype,"_dateUTCOffset",null),t([_()],E.prototype,"_startDateTimeUTC",null),t([_()],E.prototype,"_endDateTimeUTC",null),t([_()],E.prototype,"_referencePosition",null),t([_()],E.prototype,"_interval",null),t([_()],E.prototype,"_intervalContext",null),t([_()],E.prototype,"_durationSampleCount",null),t([_()],E.prototype,"_duration",null),t([_()],E.prototype,"_lightDirections",null),t([_()],E.prototype,"_lightDirectionsContext",null),t([_()],E.prototype,"_tooltipEnabled",null),t([_()],E.prototype,"_visualizationParameters",null),t([_()],E.prototype,"_thresholdVisualizationParameters",null),t([_()],E.prototype,"_thresholdDiscreteVisualizationParameters",null),t([_()],E.prototype,"_durationVisualizationParameters",null),t([_()],E.prototype,"_discreteVisualizationParameters",null),t([_()],E.prototype,"_forcePreviewDependencies",null),t([_()],E.prototype,"renderer",null),E=t([g("esri.widgets.ShadowCast.ShadowCastViewModel")],E);const M=E;export{M as default};

package/widgets/Sketch/SketchViewModel.d.ts

@@ -15,7 +15,7 @@ import type { EventedAccessor, EventedMixinProperties } from "../../core/Evented
 import type { TextSymbolProperties } from "../../symbols/TextSymbol.js";
 import type { MapViewOrSceneView } from "../../views/MapViewOrSceneView.js";
 import type { SnappingOptionsProperties } from "../../views/interactive/snapping/SnappingOptions.js";
-import type { CreateEvent, CreateOptions, CreateTool, CreationMode, DeleteEvent, RedoEvent, SketchPointSymbol, SketchPolygonSymbol, SketchPolylineSymbol, SketchTool, State, UpdateEvent, UpdateOptions, UndoEvent } from "./support/interfaces.js";
+import type { CreateEvent, CreateOptions, CreateTool, CreationMode, DeleteEvent, RedoEvent, SketchPointSymbol, SketchPolygonSymbol, SketchPolylineSymbol, SketchTool, State, UpdateEvent, UpdateOptions, UndoEvent } from "./types.js";
 import type { CIMSymbolProperties } from "../../symbols/CIMSymbol.js";
 import type { SimpleFillSymbolProperties } from "../../symbols/SimpleFillSymbol.js";
 import type { SketchLabelOptionsProperties } from "../../views/interactive/sketch/SketchLabelOptions.js";
@@ -328,8 +328,8 @@ export interface SketchViewModelEvents {
  * Gesture | Action | Example |
  * ---------|---------|---------|
  * Left-click | Adds a vertex at the pointer location. | <img alt="Left-click" src="https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/sketch/left-click-line.gif" width="400px"> |
- * Left-drag | Adds a vertex for each pointer move in {@link widgets/Sketch/SketchViewModel!defaultCreateOptions hybrid} or {@link widgets/Sketch/SketchViewModel!defaultCreateOptions freehand} mode. | <img alt="Left drag" src="https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/sketch/left-drag-line.gif" width="400px"> |
- * F | Adds a vertex to the `polyline` or `polygon` graphic. Completes the `rectangle` or `circle` polygon graphic in {@link widgets/Sketch/SketchViewModel!defaultCreateOptions click} mode. | <img alt="F vertex add" src="https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/sketch/f-key-line.gif" width="400px"> |
+ * Left-drag | Adds a vertex for each pointer move in [hybrid](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch-SketchViewModel.html#defaultCreateOptions) or [freehand](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch-SketchViewModel.html#defaultCreateOptions) mode. | <img alt="Left drag" src="https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/sketch/left-drag-line.gif" width="400px"> |
+ * F | Adds a vertex to the `polyline` or `polygon` graphic. Completes the `rectangle` or `circle` polygon graphic in [click](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch-SketchViewModel.html#defaultCreateOptions) mode. | <img alt="F vertex add" src="https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/sketch/f-key-line.gif" width="400px"> |
  * Enter | Completes the `polyline` or `polygon` graphic without the staged vertex. A `double-click` will complete the graphic at the current mouse cursor's position. | <img alt="Enter" src="https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/sketch/enter-line.gif" width="400px"> |
  * Spacebar+Left-drag | Pan the view while creating a polyline or polygon graphic. | <img alt="Space left drag" src="https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/sketch/space-left-drag.gif" width="400px"> |
  * Left-click on the first vertex | Completes the polygon graphic sketch. | <img alt="Left-click first vertex" src="https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/sketch/left-click-vertex.gif" width="400px"> |
@@ -450,8 +450,8 @@ export interface SketchViewModelEvents {
  * To be able to manipulate features on the z-axis using the height handle, the following configurations are relevant:
  * - [Elevation info mode](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-GraphicsLayer.html#elevationInfo) of the
  * [GraphicsLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-GraphicsLayer.html) needs to be set to `absolute-height`, `relative-to-scene`or `relative-to-ground`.
- * - To create a graphic with z-value the `hasZ` needs to be `true` in {@link widgets/Sketch/SketchViewModel!defaultCreateOptions} and/or in the [createOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch-SketchViewModel.html#create).
- * - To update the z-value of a graphic the `enableZ` needs to be `true` in {@link widgets/Sketch/SketchViewModel!defaultUpdateOptions} and/or in the [updateOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch-SketchViewModel.html#update).
+ * - To create a graphic with z-value the `hasZ` needs to be `true` in [defaultCreateOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch-SketchViewModel.html#defaultCreateOptions) and/or in the [createOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch-SketchViewModel.html#create).
+ * - To update the z-value of a graphic the `enableZ` needs to be `true` in [defaultUpdateOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch-SketchViewModel.html#defaultUpdateOptions) and/or in the [updateOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch-SketchViewModel.html#update).
  *
  * ```js
  * // define the GraphicsLayer

package/widgets/Sketch/{support/interfaces.d.ts → types.d.ts}

@@ -1,17 +1,17 @@
-import type Graphic from "../../../Graphic.js";
-import type CIMSymbol from "../../../symbols/CIMSymbol.js";
-import type LineSymbol3D from "../../../symbols/LineSymbol3D.js";
-import type PictureMarkerSymbol from "../../../symbols/PictureMarkerSymbol.js";
-import type PointSymbol3D from "../../../symbols/PointSymbol3D.js";
-import type PolygonSymbol3D from "../../../symbols/PolygonSymbol3D.js";
-import type SimpleFillSymbol from "../../../symbols/SimpleFillSymbol.js";
-import type SimpleLineSymbol from "../../../symbols/SimpleLineSymbol.js";
-import type SimpleMarkerSymbol from "../../../symbols/SimpleMarkerSymbol.js";
-import type TextSymbol from "../../../symbols/TextSymbol.js";
-import type WebStyleSymbol from "../../../symbols/WebStyleSymbol.js";
+import type Graphic from "../../Graphic.js";
+import type CIMSymbol from "../../symbols/CIMSymbol.js";
+import type LineSymbol3D from "../../symbols/LineSymbol3D.js";
+import type PictureMarkerSymbol from "../../symbols/PictureMarkerSymbol.js";
+import type PointSymbol3D from "../../symbols/PointSymbol3D.js";
+import type PolygonSymbol3D from "../../symbols/PolygonSymbol3D.js";
+import type SimpleFillSymbol from "../../symbols/SimpleFillSymbol.js";
+import type SimpleLineSymbol from "../../symbols/SimpleLineSymbol.js";
+import type SimpleMarkerSymbol from "../../symbols/SimpleMarkerSymbol.js";
+import type TextSymbol from "../../symbols/TextSymbol.js";
+import type WebStyleSymbol from "../../symbols/WebStyleSymbol.js";
 import type { Icon } from "@esri/calcite-components/components/calcite-icon";
-import type { SymbolUnion } from "../../../symbols/support/typeUtils.js";
-import type { DrawingMode } from "../../../views/draw/DrawingMode.js";
+import type { SymbolUnion } from "../../symbols/support/typeUtils.js";
+import type { DrawingMode } from "../../views/draw/DrawingMode.js";
 
 export type State = "disabled" | "ready" | "active";
 
@@ -81,8 +81,8 @@ export type CreateTool = "point" | "multipoint" | "polyline" | "polygon" | "circ
 
 /**
  * This information is returned as `toolEventInfo` parameter for the [Sketch#@create](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch.html#event-create) event when the graphic
- * is being created. It returns [VertexAddEventInfo](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch-support-interfaces.html#VertexAddEventInfo)
- * when the user clicks the view or [CursorUpdateEventInfo](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch-support-interfaces.html#CursorUpdateEventInfo) or when the user moves the cursor.
+ * is being created. It returns {@link widgets/Sketch/support/types!VertexAddEventInfo}
+ * when the user clicks the view or {@link widgets/Sketch/support/types!CursorUpdateEventInfo} or when the user moves the cursor.
  */
 export type CreateToolEventInfo = VertexAddEventInfo | VertexRemoveEventInfo | CursorUpdateEventInfo;
 
@@ -222,13 +222,13 @@ export interface UpdateOptions extends MoveOptions, TransformOptions {
    */
   toggleToolOnClick?: boolean;
   /**
-   * Name of the update tool. Specifies the update operation for the selected graphics. The provided tool will become the {@link widgets/Sketch/support/interfaces#activeTool}.
+   * Name of the update tool. Specifies the update operation for the selected graphics. The provided tool will become the [Sketch#activeTool](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch.html#activeTool).
    *
    * **Possible Values**
    *
    * Value | Description |
    * ----- | ----------- |
-   * transform | This is the *default* tool for graphics with a [Polygon](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Polygon.html) geometry, [Polyline](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Polyline.html) geometry or graphics that use a [3D object symbol layer](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-ObjectSymbol3DLayer.html) with a [Point](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Point.html) geometry. It allows one or multiple graphics to be scaled, rotated and moved by default. Its default behavior can be changed by setting the `enableRotation`, `enableScaling` or `preserveAspectRatio` arguments when calling the `update` method or setting them on the {@link widgets/Sketch/support/interfaces#defaultUpdateOptions} property when the Sketch widget initializes.
+   * transform | This is the *default* tool for graphics with a [Polygon](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Polygon.html) geometry, [Polyline](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Polyline.html) geometry or graphics that use a [3D object symbol layer](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-ObjectSymbol3DLayer.html) with a [Point](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Point.html) geometry. It allows one or multiple graphics to be scaled, rotated and moved by default. Its default behavior can be changed by setting the `enableRotation`, `enableScaling` or `preserveAspectRatio` arguments when calling the `update` method or setting them on the [Sketch#defaultUpdateOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch.html#defaultUpdateOptions) property when the Sketch widget initializes.
    * reshape | This tool allows the entire graphic or individual vertices of the graphic to be moved. Vertices can be added or removed. This tool can only be used with a single graphic that has a [Polygon](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Polygon.html) or [Polyline](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Polyline.html) geometry.
    * move | This is the *default* tool for graphics with a [Point](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Point.html) geometry that do not use a [3D object symbol layer](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-ObjectSymbol3DLayer.html). It should be used for specific cases where you just want to move selected `polygon` and `polyline` graphics without additional options. Additionally, the `move` tool does not support toggling to different modes, since the `move` operation is built into both the `transform` and `reshape` tools by default.
    */

package/widgets/Sketch.d.ts

@@ -18,8 +18,8 @@ import type { SketchValueOptionsProperties } from "../views/interactive/sketch/S
 import type { SnappingOptionsProperties } from "../views/interactive/snapping/SnappingOptions.js";
 import type { WidgetProperties } from "./Widget.js";
 import type { SketchViewModelEvents, SketchViewModelProperties } from "./Sketch/SketchViewModel.js";
+import type { CreateOptions, CreateTool, CreationMode, Layout, SelectionTool, SketchPointSymbol, SketchPolygonSymbol, SketchPolylineSymbol, SketchTool, State, ToolbarKind, UpdateOptions } from "./Sketch/types.js";
 import type { VisibleElements, VisibleElementsProperties } from "./Sketch/VisibleElements.js";
-import type { CreateOptions, CreateTool, CreationMode, Layout, SelectionTool, SketchPointSymbol, SketchPolygonSymbol, SketchPolylineSymbol, SketchTool, State, ToolbarKind, UpdateOptions } from "./Sketch/support/interfaces.js";
 import type { WebStyleSymbolProperties } from "../symbols/WebStyleSymbol.js";
 import type { CIMSymbolProperties } from "../symbols/CIMSymbol.js";
 import type { PointSymbol3DProperties } from "../symbols/PointSymbol3D.js";

package/widgets/Slice/SliceViewModel.d.ts

@@ -7,6 +7,7 @@ import type { SlicePlaneProperties } from "../../analysis/SlicePlane.js";
 import type { ReadonlyArrayOrCollection } from "../../core/Collection.js";
 import type { AnalysisViewModel } from "../support/AnalysisViewModel.js";
 
+/** @deprecated since 4.33. Use the [SliceAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-SliceAnalysis.html) or [Slice component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-slice/) 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 SliceViewModelProperties extends Partial<Pick<SliceViewModel, "excludeGroundSurface" | "tiltEnabled" | "view">> {
   /**
    * The slice analysis object being created or modified by the view model.

package/widgets/Slice.d.ts

@@ -8,6 +8,7 @@ import type { HeadingLevel } from "./support/Heading.js";
 import type { SliceAnalysisProperties } from "../analysis/SliceAnalysis.js";
 import type { SliceViewModelProperties } from "./Slice/SliceViewModel.js";
 
+/** @deprecated since 4.33. Use the [Slice component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-slice/) 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 SliceProperties extends WidgetProperties, Partial<Pick<Slice, "headingLevel" | "view">> {
   /**
    * The slice analysis object being created or modified by the widget. This property is an

package/widgets/Slider/SliderViewModel.d.ts

@@ -1,6 +1,6 @@
 import type Accessor from "../../core/Accessor.js";
-import type { Bounds, LabelInfos } from "./interfaces.js";
-import type { LabelFormatFunction, InputFormatFunction, InputParseFunction, SliderFormatType } from "../support/interfaces.js";
+import type { InputParseFunction, InputFormatFunction, LabelFormatFunction, SliderFormatType } from "../types.js";
+import type { Bounds, LabelInfos } from "./types.js";
 
 export interface SliderViewModelProperties extends Partial<Pick<SliderViewModel, "effectiveMax" | "effectiveMin" | "inputFormatFunction" | "inputParseFunction" | "labelFormatFunction" | "max" | "min" | "precision" | "thumbsConstrained" | "values">> {}
 
@@ -191,7 +191,7 @@ export default class SliderViewModel extends Accessor {
    * this property, the precision of that thumb value will be maintained until the thumb
    * is moved by the user. At that point, the value will be rounded according to the indicated precision.
    *
-   * If thumb labels aren't visible, they must be enabled with {@link widgets/Slider/SliderViewModel#labelInputsEnabled}.
+   * If thumb labels aren't visible, they must be enabled with [Slider#labelInputsEnabled](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Slider.html#labelInputsEnabled).
    *
    * Keep in mind this property rounds thumb [values](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Slider-SliderViewModel.html#values) and shouldn't be used exclusively
    * for formatting purposes. To format thumb `labels`, use the [labelFormatFunction](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Slider-SliderViewModel.html#labelFormatFunction)

package/widgets/Slider/{interfaces.d.ts → types.d.ts}

@@ -1,4 +1,4 @@
-import type { LabelFormatFunction } from "../support/interfaces.js";
+import type { LabelFormatFunction } from "../types.js";
 
 /** Represents the effective bounds of the slider. */
 export interface Bounds {
@@ -25,7 +25,7 @@ export type SliderTickMode = "count" | "percent" | "step" | "position";
 /**
  * Function that fires each time a tick is created. It provides you access to each tick
  * element so you can add custom CSS and attach event listeners to individual ticks. This function should be set to the
- * `tickCreatedFunction` property of the [TickConfig](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Slider-interfaces.html#TickConfig).
+ * `tickCreatedFunction` property of the [TickConfig](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Slider-types.html#TickConfig).
  *
  * @param value - The value of the slider where the tick is rendered.
  * @param tickElement - The HTMLElement representing the tick. You can add or modify the default style of individual

package/widgets/Slider.d.ts

@@ -2,9 +2,9 @@ import type Collection from "../core/Collection.js";
 import type Widget from "./Widget.js";
 import type SliderViewModel from "./Slider/SliderViewModel.js";
 import type { Icon } from "@esri/calcite-components/components/calcite-icon";
+import type { LabelFormatFunction, InputParseFunction, InputFormatFunction } from "./types.js";
 import type { WidgetProperties } from "./Widget.js";
-import type { InputCreatedFunction, LabelInfos, MaxClickEvent, MinClickEvent, SegmentClickEvent, SegmentDragEvent, ThumbChangeEvent, ThumbClickEvent, ThumbCreatedFunction, ThumbDragEvent, TrackClickEvent, TickConfig, MaxChangeEvent, MinChangeEvent, TickClickEvent } from "./Slider/interfaces.js";
-import type { InputParseFunction, InputFormatFunction, LabelFormatFunction } from "./support/interfaces.js";
+import type { InputCreatedFunction, LabelInfos, MaxClickEvent, MinClickEvent, SegmentClickEvent, SegmentDragEvent, ThumbChangeEvent, ThumbClickEvent, ThumbCreatedFunction, ThumbDragEvent, TrackClickEvent, TickConfig, MaxChangeEvent, MinChangeEvent, TickClickEvent } from "./Slider/types.js";
 import type { SliderViewModelProperties } from "./Slider/SliderViewModel.js";
 
 export interface SliderProperties extends WidgetProperties, Partial<Pick<Slider, "disabled" | "draggableSegmentsEnabled" | "effectiveMax" | "effectiveMin" | "inputCreatedFunction" | "inputFormatFunction" | "inputParseFunction" | "labelFormatFunction" | "labelInputsEnabled" | "layout" | "max" | "min" | "precision" | "rangeLabelInputsEnabled" | "snapOnClickEnabled" | "steps" | "syncedSegmentsEnabled" | "thumbCreatedFunction" | "thumbsConstrained" | "tickConfigs" | "values" | "visibleElements">> {
@@ -700,7 +700,7 @@ export default class Slider extends Widget<SliderProperties> {
    */
   accessor thumbsConstrained: boolean;
   /**
-   * When set, renders ticks along the slider track. See the [TickConfig](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Slider-interfaces.html#TickConfig) documentation
+   * When set, renders ticks along the slider track. See the [TickConfig](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Slider-types.html#TickConfig) documentation
    * for more information on how to configure tick placement, style, and behavior.
    *
    * @example
@@ -775,7 +775,7 @@ export default class Slider extends Widget<SliderProperties> {
    */
   accessor tickConfigs: TickConfig[];
   /**
-   * The HTML Element nodes representing slider ticks and their associated labels. These elements are created in [TickCreatedFunction](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Slider-interfaces.html#TickCreatedFunction) and configured in [tickConfigs](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Slider.html#tickConfigs).
+   * The HTML Element nodes representing slider ticks and their associated labels. These elements are created in [TickCreatedFunction](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Slider-types.html#TickCreatedFunction) and configured in [tickConfigs](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Slider.html#tickConfigs).
    *
    * @since 4.20
    * @example

package/widgets/Swipe/SwipeViewModel.d.ts

@@ -3,7 +3,7 @@ import type Collection from "../../core/Collection.js";
 import type Layer from "../../layers/Layer.js";
 import type MapView from "../../views/MapView.js";
 import type { ReadonlyArrayOrCollection } from "../../core/Collection.js";
-import type { Direction, State } from "./interfaces.js";
+import type { Direction, State } from "./types.js";
 
 export interface SwipeViewModelProperties extends Partial<Pick<SwipeViewModel, "direction" | "position" | "step" | "stepMultiplier" | "view">> {
   /**