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

package/widgets/ElevationProfile/ElevationProfileVisibleElements.d.ts

@@ -0,0 +1,60 @@
+import type Accessor from "../../core/Accessor.js";
+
+export interface ElevationProfileVisibleElementsProperties extends Partial<Pick<ElevationProfileVisibleElements, "chart" | "clearButton" | "legend" | "selectButton" | "settingsButton" | "sketchButton" | "uniformChartScalingToggle" | "unitSelector">> {}
+
+/**
+ * The visible elements that are displayed within the widget.
+ * This provides the ability to turn individual elements of the widget's display on/off.
+ * The visual elements in this widget are the legend, chart, settingsButton, sketchButton, and selectButton.
+ * These are all set to true by default.
+ */
+export default abstract class ElevationProfileVisibleElements extends Accessor {
+  /**
+   * When set to `false`, the chart is not displayed.
+   *
+   * @default true
+   */
+  accessor chart: boolean;
+  /**
+   * When set to `false` the button used to clear the current elevation profile is not displayed.
+   *
+   * @default true
+   */
+  accessor clearButton: boolean;
+  /**
+   * When set to `false`, the legend (which includes statistics) is not displayed.
+   *
+   * @default true
+   */
+  accessor legend: boolean;
+  /**
+   * When set to `false`, the button used to select a path is not displayed.
+   *
+   * @default true
+   */
+  accessor selectButton: boolean;
+  /**
+   * When set to `false`, the button used to open the settings popup is not displayed.
+   *
+   * @default true
+   */
+  accessor settingsButton: boolean;
+  /**
+   * When set to `false`, the button used to start drawing/sketching is not displayed.
+   *
+   * @default true
+   */
+  accessor sketchButton: boolean;
+  /**
+   * When set to `false`, the element used to toggle uniform chart scaling on or off is not displayed.
+   *
+   * @default true
+   */
+  accessor uniformChartScalingToggle: boolean;
+  /**
+   * When set to `false`, the dropdown used to select the units is not displayed.
+   *
+   * @default true
+   */
+  accessor unitSelector: boolean;
+}

package/widgets/ElevationProfile/elevationProfileLineTypes.d.ts

@@ -0,0 +1,6 @@
+import type ElevationProfileLineGround from "./ElevationProfileLineGround.js";
+import type ElevationProfileLineInput from "./ElevationProfileLineInput.js";
+import type ElevationProfileLineQuery from "./ElevationProfileLineQuery.js";
+import type ElevationProfileLineView from "./ElevationProfileLineView.js";
+
+export type ElevationProfileLine = ElevationProfileLineGround | ElevationProfileLineInput | ElevationProfileLineQuery | ElevationProfileLineView;

package/widgets/ElevationProfile/interfaces.d.ts

@@ -0,0 +1,103 @@
+import type { LengthUnit } from "../../core/units.js";
+import type { QueryGeometry, ElevationQueryResult } from "../../layers/support/ElevationQuery.js";
+import type { QueryOptions } from "../../layers/support/ElevationQueryContext.js";
+
+export interface ElevationQuerySource {
+  /**
+   * Function used to query elevation values for a geometry ([Point](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Point.html),
+   * [Multipoint](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Multipoint.html) or [Polyline](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Polyline.html)).
+   * It returns a promise that resolves with an [ElevationQueryResult](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-ElevationQuery.html#ElevationQueryResult).
+   *
+   * @param geometry - The geometry to use for sampling elevation data.
+   * @param options - Additional query options. See the table below.
+   * @returns Resolves to an object with the sampled geometry, resolution information, and no data value.
+   */
+  queryElevation(geometry: QueryGeometry, options?: QueryOptions): Promise<ElevationQueryResult<QueryGeometry>>;
+}
+
+/**
+ * A sample/point in a generated elevation profile. The x, y and z properties
+ * are in the spatial reference of the view and distance and elevation are in
+ * the units specified in the view model.
+ */
+export interface ElevationProfileSample {
+  /**
+   * Horizontal (2D) distance from the beginning of the path, in the
+   *    effective unit selected by the user. In geographic coordinate systems (GCS) and in WebMercator,
+   *    the distance is the geodesic distance. In projected coordinate systems (PCS), apart from
+   *    WebMercator, the distance is computed in a Euclidean manner (in the respective PCS).
+   */
+  readonly distance: number;
+  /** The elevation of the sample, in the effective units selected by the user. */
+  readonly elevation?: number | null;
+  /** The x coordinate of the sample, in the spatial reference of the view. */
+  readonly x: number;
+  /** The y coordinate of the sample, in the spatial reference of the view. */
+  readonly y: number;
+  /** The z coordinate of the sample, in the spatial reference of the view. */
+  readonly z?: number | null;
+}
+
+/** Statistics about a generated elevation profile. */
+export interface ElevationProfileStatistics {
+  /** The average elevation along the path. */
+  readonly avgElevation?: number | null;
+  /**
+   * The average negative slope along the path. Profiles are sampled at a
+   *   minimum distance of 10 meters (32.8 feet). Higher resolution profiles are downsampled to that minimum sampling
+   *   distance before calculating the slope.
+   */
+  readonly avgNegativeSlope?: number | null;
+  /**
+   * The average positive slope along the path. Profiles are sampled at a
+   *   minimum distance of 10 meters (32.8 feet). Higher resolution profiles are downsampled to that minimum sampling
+   *   distance before calculating the slope.
+   */
+  readonly avgPositiveSlope?: number | null;
+  /**
+   * The cumulative elevation gain along the path.
+   * See https://en.wikipedia.org/wiki/Cumulative_elevation_gain
+   */
+  readonly elevationGain?: number | null;
+  /**
+   * The cumulative elevation loss along the path.
+   * See https://en.wikipedia.org/wiki/Cumulative_elevation_gain
+   */
+  readonly elevationLoss?: number | null;
+  /**
+   * The maximum horizontal (2D) distance of the path. In geographic
+   * coordinate systems (GCS) and in WebMercator, the distance is the geodesic distance. In projected
+   * coordinate systems (PCS), apart from WebMercator, the distance is computed in a Euclidean manner
+   * (in the respective PCS).
+   */
+  readonly maxDistance?: number | null;
+  /** The maximum elevation along the path. */
+  readonly maxElevation?: number | null;
+  /**
+   * The maximum negative slope along the path. Profiles are sampled at a
+   *   minimum distance of 10 meters (32.8 feet). Higher resolution profiles are downsampled to that minimum sampling
+   *   distance before calculating the slope.
+   */
+  readonly maxNegativeSlope?: number | null;
+  /**
+   * The maximum positive slope along the path. Profiles are sampled at a
+   *   minimum distance of 10 meters (32.8 feet). Higher resolution profiles are downsampled to that minimum sampling
+   *   distance before calculating the slope.
+   */
+  readonly maxPositiveSlope?: number | null;
+  /** The minimum elevation along the path. */
+  readonly minElevation?: number | null;
+}
+
+/**
+ * The units which have been selected according to the magnitude of the elevations and distances
+ * that are to be displayed in the widget, according to the selected unit or unit system.
+ */
+export interface EffectiveUnits {
+  /** Units used for displaying distance or length values. */
+  readonly distance: LengthUnit;
+  /** Units used for displaying elevation values. */
+  readonly elevation: LengthUnit;
+}
+
+export type ElevationProfileLineType = "ground" | "input" | "query" | "view";

package/widgets/ElevationProfile/support/constants.d.ts

@@ -0,0 +1,14 @@
+
+/**
+ * The public state (mostly related to interaction) the elevation profile can be in.
+ *
+ * Value | Description
+ * ------------|-------------
+ * disabled | widget is being created
+ * ready | widget is ready. No path configured and no interactive operation ongoing.
+ * creating | user is creating a new input path.
+ * created | input path is configured but no interactive operation is ongoing.
+ * selecting | user is selecting an existing input path.
+ * selected | user selected an existing input path.
+ */
+export type ElevationProfileState = "disabled" | "ready" | "creating" | "created" | "selecting" | "selected";

package/widgets/ElevationProfile.d.ts

@@ -1,4 +1,330 @@
-import "../interfaces";
+import type Graphic from "../Graphic.js";
+import type Collection from "../core/Collection.js";
+import type Widget from "./Widget.js";
+import type ElevationProfileViewModel from "./ElevationProfile/ElevationProfileViewModel.js";
+import type ElevationProfileVisibleElements from "./ElevationProfile/ElevationProfileVisibleElements.js";
+import type { Icon } from "@esri/calcite-components/components/calcite-icon";
+import type { ReadonlyArrayOrCollection } from "../core/Collection.js";
+import type { SystemOrLengthUnit } from "../core/units.js";
+import type { MapViewOrSceneView } from "../views/MapViewOrSceneView.js";
+import type { WidgetProperties } from "./Widget.js";
+import type { ElevationProfileLine } from "./ElevationProfile/elevationProfileLineTypes.js";
+import type { ElevationProfileViewModelProperties } from "./ElevationProfile/ElevationProfileViewModel.js";
+import type { GraphicProperties } from "../Graphic.js";
+import type { ElevationProfileLineViewProperties } from "./ElevationProfile/ElevationProfileLineView.js";
+import type { ElevationProfileLineQueryProperties } from "./ElevationProfile/ElevationProfileLineQuery.js";
+import type { ElevationProfileLineInputProperties } from "./ElevationProfile/ElevationProfileLineInput.js";
+import type { ElevationProfileLineGroundProperties } from "./ElevationProfile/ElevationProfileLineGround.js";
+import type { ElevationProfileVisibleElementsProperties } from "./ElevationProfile/ElevationProfileVisibleElements.js";
 
-import ElevationProfile = __esri.ElevationProfile;
-export default ElevationProfile;
+export interface ElevationProfileProperties extends WidgetProperties, Partial<Pick<ElevationProfile, "unit" | "unitOptions" | "view">> {
+  /**
+   * Icon which represents the widget. It is typically used when the widget is controlled by another
+   * one (e.g. in the Expand widget).
+   *
+   * @default "altitude"
+   * @since 4.27
+   * @see [Calcite Icon Search](https://developers.arcgis.com/calcite-design-system/icons/)
+   * @see [Calcite Icon Search](https://developers.arcgis.com/calcite-design-system/icons/)
+   */
+  icon?: Icon["icon"] | null;
+  /**
+   * The input line graphic along which elevation will be queried in order to generate an elevation profile.
+   *
+   * Typically not set when creating the widget. In this case the widget starts empty,
+   * and waits for the user to either draw a new profile or generate a profile from selecting a line feature.
+   * The result of this action populates `input`.
+   * `input` can be set when constructing the widget, or set or changed at runtime.
+   * The input graphic must contain a geometry of type [Polyline](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Polyline.html),
+   * symbol and attributes of the input graphic are ignored.
+   */
+  input?: GraphicProperties | null;
+  /**
+   * The widget's default label.
+   *
+   * @since 4.11
+   */
+  label?: string | null;
+  /**
+   * Collection of elevation profile lines which are to be generated and displayed in the widget's
+   * chart. See the different profile line types for details on usage and behavior.
+   *
+   * Once an elevation profile is generated, each line will contain the raw data used to
+   * generate the chart and [profile statistics](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ElevationProfile-interfaces.html#ElevationProfileStatistics).
+   * The order of the profiles within the collection determines the drawing order on the chart.
+   *
+   * In a [MapView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html) [ElevationProfileLineView](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ElevationProfile-ElevationProfileLineView.html)
+   * is not supported.
+   *
+   * @example
+   * const elevationProfile = new ElevationProfile({
+   *   view: view,
+   *   profiles: [{
+   *     // displays elevation values from Map.ground
+   *     type: "ground", //autocasts as new ElevationProfileLineGround()
+   *   }, {
+   *     // displays elevation values from the input line graphic
+   *     type: "input", //autocasts as new ElevationProfileLineInput()
+   *   }, {
+   *     // displays elevation values from an elevation source
+   *     type: "query", //autocasts as new ElevationProfileLineQuery()
+   *     source: elevationLayer
+   *   }, {
+   *     // displays elevation values from a SceneView
+   *     type: "view" //autocasts as new ElevationProfileLineView()
+   *   }]
+   * });
+   */
+  profiles?: ReadonlyArrayOrCollection<((ElevationProfileLineGroundProperties & { type: "ground" }) | (ElevationProfileLineInputProperties & { type: "input" }) | (ElevationProfileLineQueryProperties & { type: "query" }) | (ElevationProfileLineViewProperties & { type: "view" }))> | null;
+  /**
+   * The view model for this widget. This is a class that contains all the logic (properties and methods)
+   * that controls this widget's behavior. See the [ElevationProfileViewModel](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ElevationProfile-ElevationProfileViewModel.html)
+   * class to access all properties and methods on the widget.
+   */
+  viewModel?: ElevationProfileViewModelProperties;
+  /**
+   * This property provides the ability to display or hide the individual elements of the widget.
+   *
+   * @example
+   * elevationProfile.visibleElements = {
+   *    legend: true,
+   *    chart: true,
+   *    clearButton: true,
+   *    settingsButton: true,
+   *    sketchButton: true,
+   *    selectButton: true,
+   *    uniformChartScalingToggle: true
+   * }
+   */
+  visibleElements?: ElevationProfileVisibleElementsProperties;
+}
+
+/**
+ * The ElevationProfile widget is used to generate and display an elevation profile from an [input line graphic](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ElevationProfile.html#input).
+ * The input graphic can be set interactively by drawing a single or multi-segment line or by selecting a line feature in the view.
+ * Alternatively, the widget allows setting an input graphic programmatically at creation or runtime by setting the
+ * [input](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ElevationProfile.html#input) property.
+ *
+ * [![elevation-profile](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/elevation-profile/elevation-profile-city.png)](https://developers.arcgis.com/javascript/latest/sample-code/widgets-elevation-profile/)
+ * _ElevationProfile widget used in a city scene, displaying ground and building profiles. See [Sample - ElevationProfile widget](https://developers.arcgis.com/javascript/latest/sample-code/widgets-elevation-profile/)_
+ *
+ * The widget can visualize multiple profile lines, depending on the environment (2D versus 3D) and elevation source data:
+ *
+ * * [ElevationProfileLineGround](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ElevationProfile-ElevationProfileLineGround.html) can be used in both [MapView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html)
+ * and [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html). In this case, the elevation is sampled directly from
+ * [Map#ground](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html#ground). Whether your map is displayed in 2D or 3D, the ground property needs to be set on the map.
+ *
+ * * [ElevationProfileLineInput](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ElevationProfile-ElevationProfileLineInput.html) samples elevation data from the geometry of
+ * the input graphic. It is typically used with input line data that has z values. If the input line data doesn't have z values, a profile line
+ * is computed if the line is displayed with a non-draped elevation mode. An elevation offset can also be applied.
+ * Currently, in 2D, z values are not fetched from feature-based layers, so in a [MapView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html),
+ * this profile line can only be used with client-side graphics that have z values.
+ *
+ * * [ElevationProfileLineQuery](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ElevationProfile-ElevationProfileLineQuery.html) samples elevation data from the elevation source set in the
+ * [ElevationProfileLineQuery#source](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ElevationProfile-ElevationProfileLineQuery.html#source) property. The elevation source can be an
+ * [ElevationLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-ElevationLayer.html) or any object with a method called `queryElevation` that has the same signature as
+ * [ElevationLayer#queryElevation()](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-ElevationLayer.html#queryElevation).
+ *
+ * * [ElevationProfileLineView](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ElevationProfile-ElevationProfileLineView.html) is available only in a
+ * [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html) and it displays the elevation sampled directly from the view along the input graphic.
+ * All volumetric objects in a [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html) contribute to the resulting profile.
+ *
+ * You can choose to display one or several profile lines in the chart, by setting them in the [profiles](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ElevationProfile.html#profiles) property.
+ *
+ * Once all profiles are refined to their maximum resolution, the corresponding 3D profile lines appear in the
+ * [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html) (currently no lines are displayed in a [MapView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html)),
+ * and [profile statistics](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ElevationProfile-interfaces.html#ElevationProfileStatistics) display in the legend for each profile line.
+ * Hovering over the chart shows an overlaid tooltip with elevation values of all profiles,
+ * and displays colored dot markers in the 3D view at the matching positions.
+ *
+ * Checkboxes in the legend allow hiding individual profiles.
+ * Chart units can be set via the settings menu to metric, imperial or a specific unit.
+ *
+ * Scrolling the chart zooms in to a specific part of the profile chart. When zoomed in, click the minus button to reset the zoom.
+ * On touch devices, pinch to zoom in and out.
+ *
+ * ![elevation-profile-draw](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/elevation-profile/elevation-profile-draw.gif)
+ * _Drawing a path to get a ground profile._
+ *
+ * ![elevation-profile-zline](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/elevation-profile/elevation-profile-zline.png)
+ * _Profile generated from a line feature with z-values shows a paraglide track above ground._
+ *
+ * How distance values are computed depends on the map's spatial reference:
+ * * 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).
+ *
+ * > [!WARNING]
+ * >
+ * > **Known Limitations**
+ * >
+ * > In 3D, [ElevationProfileLineInput](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ElevationProfile-ElevationProfileLineInput.html) does not take into consideration
+ * > the `featureExpression` set on the [elevation mode](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-GraphicsLayer.html#elevationInfo) of the layer.
+ * > In 2D, z values are not fetched from feature based layers. Therefore,
+ * > [ElevationProfileLineInput](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ElevationProfile-ElevationProfileLineInput.html) can only be used with client-side graphics that have z values
+ * > in a [MapView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html).
+ *
+ * @deprecated since 5.0. Use the [Elevation Profile component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-elevation-profile/) 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.18
+ * @see [Sample - ElevationProfile widget](https://developers.arcgis.com/javascript/latest/sample-code/widgets-elevation-profile/)
+ * @see [ElevationProfileViewModel](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ElevationProfile-ElevationProfileViewModel.html) - Deprecated since 5.0. Use the [ElevationProfileAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ElevationProfileAnalysis.html) or [Elevation Profile component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-elevation-profile/) instead.
+ * @see [ElevationProfileLineGround](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ElevationProfile-ElevationProfileLineGround.html) - Deprecated since 5.0. Use [ElevationProfileLineGround](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ElevationProfile-ElevationProfileLineGround.html) from [ElevationProfileAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ElevationProfileAnalysis.html) instead.
+ * @see [ElevationProfileLineInput](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ElevationProfile-ElevationProfileLineInput.html) - Deprecated since 5.0. Use [ElevationProfileLineInput](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ElevationProfile-ElevationProfileLineInput.html) from [ElevationProfileAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ElevationProfileAnalysis.html) instead.
+ * @see [ElevationProfileLineQuery](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ElevationProfile-ElevationProfileLineQuery.html) - Deprecated since 5.0. Use [ElevationProfileLineQuery](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ElevationProfile-ElevationProfileLineQuery.html) from [ElevationProfileAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ElevationProfileAnalysis.html) instead.
+ * @see [ElevationProfileLineView](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ElevationProfile-ElevationProfileLineView.html) - Deprecated since 5.0. Use [ElevationProfileLineScene](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ElevationProfile-ElevationProfileLineScene.html) from [ElevationProfileAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ElevationProfileAnalysis.html) instead.
+ * @example
+ * const elevationProfile = new ElevationProfile({ view });
+ * // adds the ElevationProfile to the top right corner of the view
+ * view.ui.add(elevationProfile, "top-right");
+ * @example
+ * // elevation profile with all the line profiles
+ * const elevationProfile = new ElevationProfile({
+ *   view,
+ *   profiles: [{
+ *     // displays elevation values from Map.ground
+ *     type: "ground", //autocasts as new ElevationProfileLineGround()
+ *     color: "#61d4a4",
+ *     title: "Ground elevation"
+ *   }, {
+ *     // displays elevation values from the input line graphic
+ *     type: "input", //autocasts as new ElevationProfileLineInput()
+ *     color: "#f57e42",
+ *     title: "Line elevation"
+ *   }, {
+ *     // displays elevation values from a SceneView
+ *     type: "view", //autocasts as new ElevationProfileLineView()
+ *     color: "#8f61d4",
+ *     title: "View elevation"
+ *     // by default ground and all layers are used to compute elevation, but
+ *     // you can define which elements should be included/excluded from the computation
+ *     exclude: [map.ground]
+ *   }, {
+ *     // displays elevation values from a custom source
+ *     type: "query",
+ *     source: new ElevationLayer({
+ *       url: "https://elevation3d.arcgis.com/arcgis/rest/../Terrain3D/ImageServer"
+ *     }),
+ *     color: "#d46189",
+ *     title: "Custom elevation"
+ *   }]
+ * });
+ * view.ui.add(elevationProfile, "bottom-right");
+ * @example
+ * // Line whose elevation profile is to be generated.
+ * const inputLine = new Graphic({
+ *   geometry: new Polyline({
+ *     spatialReference: SpatialReference.WebMercator,
+ *     paths: [
+ *       [
+ *         [950857, 6003812], // Zurich, Switzerland
+ *         [924987, 5950271], // Lucerne, Switzerland
+ *       ]
+ *     ],
+ *   }),
+ * });
+ *
+ * // Elevation profile for the existing line.
+ * const elevationProfile = new ElevationProfile({
+ *   view,
+ *   input: inputLine,
+ *   // Don't let the user draw or select a new line because we provide one programmatically.
+ *   visibleElements: {
+ *     sketchButton: false,
+ *     selectButton: false
+ *   }
+ * });
+ * view.ui.add(elevationProfile, "bottom-right");
+ */
+export default class ElevationProfile extends Widget {
+  constructor(properties?: ElevationProfileProperties);
+  /**
+   * Icon which represents the widget. It is typically used when the widget is controlled by another
+   * one (e.g. in the Expand widget).
+   *
+   * @default "altitude"
+   * @since 4.27
+   * @see [Calcite Icon Search](https://developers.arcgis.com/calcite-design-system/icons/)
+   * @see [Calcite Icon Search](https://developers.arcgis.com/calcite-design-system/icons/)
+   */
+  get icon(): Icon["icon"];
+  set icon(value: Icon["icon"] | null | undefined);
+  /**
+   * The input line graphic along which elevation will be queried in order to generate an elevation profile.
+   *
+   * Typically not set when creating the widget. In this case the widget starts empty,
+   * and waits for the user to either draw a new profile or generate a profile from selecting a line feature.
+   * The result of this action populates `input`.
+   * `input` can be set when constructing the widget, or set or changed at runtime.
+   * The input graphic must contain a geometry of type [Polyline](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Polyline.html),
+   * symbol and attributes of the input graphic are ignored.
+   */
+  get input(): Graphic | null | undefined;
+  set input(value: GraphicProperties | null | undefined);
+  /**
+   * The widget's default label.
+   *
+   * @since 4.11
+   */
+  get label(): string;
+  set label(value: string | null | undefined);
+  /**
+   * Collection of elevation profile lines which are to be generated and displayed in the widget's
+   * chart. See the different profile line types for details on usage and behavior.
+   *
+   * Once an elevation profile is generated, each line will contain the raw data used to
+   * generate the chart and [profile statistics](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ElevationProfile-interfaces.html#ElevationProfileStatistics).
+   * The order of the profiles within the collection determines the drawing order on the chart.
+   *
+   * In a [MapView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html) [ElevationProfileLineView](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ElevationProfile-ElevationProfileLineView.html)
+   * is not supported.
+   *
+   * @example
+   * const elevationProfile = new ElevationProfile({
+   *   view: view,
+   *   profiles: [{
+   *     // displays elevation values from Map.ground
+   *     type: "ground", //autocasts as new ElevationProfileLineGround()
+   *   }, {
+   *     // displays elevation values from the input line graphic
+   *     type: "input", //autocasts as new ElevationProfileLineInput()
+   *   }, {
+   *     // displays elevation values from an elevation source
+   *     type: "query", //autocasts as new ElevationProfileLineQuery()
+   *     source: elevationLayer
+   *   }, {
+   *     // displays elevation values from a SceneView
+   *     type: "view" //autocasts as new ElevationProfileLineView()
+   *   }]
+   * });
+   */
+  get profiles(): Collection<ElevationProfileLine>;
+  set profiles(value: ReadonlyArrayOrCollection<((ElevationProfileLineGroundProperties & { type: "ground" }) | (ElevationProfileLineInputProperties & { type: "input" }) | (ElevationProfileLineQueryProperties & { type: "query" }) | (ElevationProfileLineViewProperties & { type: "view" }))> | null);
+  /** Unit system (imperial, metric) or specific unit used for displaying the elevation and distance values. */
+  accessor unit: SystemOrLengthUnit;
+  /** List of available units and unit systems (imperial, metric) for displaying the elevation and distance values. */
+  accessor unitOptions: SystemOrLengthUnit[];
+  /** A reference to the [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html) or the [MapView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html). */
+  accessor view: MapViewOrSceneView | null | undefined;
+  /**
+   * The view model for this widget. This is a class that contains all the logic (properties and methods)
+   * that controls this widget's behavior. See the [ElevationProfileViewModel](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ElevationProfile-ElevationProfileViewModel.html)
+   * class to access all properties and methods on the widget.
+   */
+  get viewModel(): ElevationProfileViewModel;
+  set viewModel(value: ElevationProfileViewModelProperties);
+  /**
+   * This property provides the ability to display or hide the individual elements of the widget.
+   *
+   * @example
+   * elevationProfile.visibleElements = {
+   *    legend: true,
+   *    chart: true,
+   *    clearButton: true,
+   *    settingsButton: true,
+   *    sketchButton: true,
+   *    selectButton: true,
+   *    uniformChartScalingToggle: true
+   * }
+   */
+  get visibleElements(): ElevationProfileVisibleElements;
+  set visibleElements(value: ElevationProfileVisibleElementsProperties);
+}

package/widgets/Expand/ExpandViewModel.d.ts

@@ -1,4 +1,53 @@
-import "../../interfaces";
+import type Accessor from "../../core/Accessor.js";
+import type { MapViewOrSceneView } from "../../views/MapViewOrSceneView.js";
 
-import ExpandViewModel = __esri.ExpandViewModel;
-export default ExpandViewModel;
+export interface ExpandViewModelProperties extends Partial<Pick<ExpandViewModel, "autoCollapse" | "expanded" | "group" | "view">> {}
+
+export type ExpandViewModelState = "ready" | "disabled";
+
+/**
+ * Provides the logic for the [Expand](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Expand.html) widget and [component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-expand/).
+ *
+ * @since 4.3
+ * @see [Expand](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Expand.html) widget - _Deprecated since 4.34. Use the [Expand component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-expand/) instead._
+ * @see [Expand component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-expand/)
+ * @see [Programming patterns: Widget viewModel pattern](https://developers.arcgis.com/javascript/latest/programming-patterns/#widget-viewmodel-pattern)
+ */
+export default class ExpandViewModel extends Accessor {
+  constructor(properties?: ExpandViewModelProperties);
+  /**
+   * Automatically collapses the Expand instance when the view's
+   * {@link views/View#viewpoint} updates.
+   *
+   * @default false
+   */
+  accessor autoCollapse: boolean;
+  /**
+   * Whether the element is currently expanded or not.
+   *
+   * @default false
+   */
+  accessor expanded: boolean;
+  /**
+   * This value associates two or more Expand instances with each other, allowing one
+   * instance to auto collapse when another instance in the same group is expanded. For auto collapsing
+   * to take effect, all instances of the group must be included in the view's `ui` property.
+   *
+   * For example, if you place multiple Expand instances in the top-left of the view's ui, you can assign them to a
+   * group called `top-left`. If one Expand instance is expanded and the user clicks on a different instance in the
+   * `top-left` group, then the first instance is collapsed, allowing the content of the second instance to be
+   * fully visible.
+   *
+   * @since 4.6
+   * @see [Expand#group](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Expand.html#group)
+   */
+  accessor group: string | null | undefined;
+  /**
+   * The view model's state.
+   *
+   * @default "disabled"
+   */
+  get state(): ExpandViewModelState;
+  /** The view in which the Expand is used. */
+  accessor view: MapViewOrSceneView | null | undefined;
+}