@arcgis/map-components 4.34.0-next.16 → 4.34.0-next.160

package/dist/components/arcgis-daylight/daylight-time-slider.d.ts

@@ -0,0 +1,10 @@
+import { JsxNode } from '@arcgis/lumina';
+import { Ref } from 'lit/directives/ref.js';
+export declare function TimeSlider(props: {
+    disabled?: boolean;
+    value: number | null;
+    onTimeChanged: (time: number) => void;
+    scale?: HTMLCalciteSliderElement["scale"];
+    steps?: number;
+    ref: Ref<HTMLCalciteSliderElement>;
+}): JsxNode;

package/dist/components/arcgis-daylight/daylight-utils.d.ts

@@ -0,0 +1,32 @@
+import { default as VirtualLighting } from '@arcgis/core/views/3d/environment/VirtualLighting.js';
+import { default as SunLighting } from '@arcgis/core/views/3d/environment/SunLighting.js';
+export type DateOrSeason = "date" | "season";
+export interface SeasonConfig {
+    dayOfMonth: number;
+    month: number;
+}
+export type Hemisphere = "northern" | "southern";
+export declare const orderedSeasons: readonly ["spring", "summer", "fall", "winter"];
+export type Season = (typeof orderedSeasons)[number];
+/**
+ * Returns a date object which has the same year and time as the reference, but whose day of the month
+ * and month are set according to the specified season.
+ */
+export declare function getSeasonDate(reference: Date, season: Season, hemisphere: Hemisphere): Date;
+/**
+ * Gets the astronomical season for the specified date.
+ */
+export declare function getSeasonFromDate(date: Date, hemisphere: Hemisphere): Season;
+/**
+ * Converts a season in the specified hemisphere to a northern hemisphere season.
+ */
+export declare function getNorthernHemisphereSeason(season: Season, hemisphere: Hemisphere): Season;
+export declare function getHemisphere(latitude: number): Hemisphere;
+export declare const dayInMinutes = 1440;
+export declare const dayInMilliseconds = 86400000;
+export declare function getSunriseAndSunsetTimes(currentDate: Date, latitude: number, longitude: number, UTCDisplayOffset: number): {
+    sunrise: Date;
+    sunset: Date;
+};
+export type LightingUnion = SunLighting | VirtualLighting;
+export declare function isSunlighting(lighting: LightingUnion | nullish): lighting is SunLighting;

package/dist/components/arcgis-daylight/index.d.ts

@@ -1 +1,9 @@
+import "@esri/calcite-components/components/calcite-slider";
+import "@esri/calcite-components/components/calcite-label";
+import "@esri/calcite-components/components/calcite-input-time-zone";
+import "@esri/calcite-components/components/calcite-button";
+import "@esri/calcite-components/components/calcite-input-date-picker";
+import "@esri/calcite-components/components/calcite-select";
+import "@esri/calcite-components/components/calcite-option";
+import "@esri/calcite-components/components/calcite-checkbox";
 export * from "./customElement.js";

package/dist/components/arcgis-daylight/index.js

@@ -1 +1,9 @@
+import "@esri/calcite-components/components/calcite-slider";
+import "@esri/calcite-components/components/calcite-label";
+import "@esri/calcite-components/components/calcite-input-time-zone";
+import "@esri/calcite-components/components/calcite-button";
+import "@esri/calcite-components/components/calcite-input-date-picker";
+import "@esri/calcite-components/components/calcite-select";
+import "@esri/calcite-components/components/calcite-option";
+import "@esri/calcite-components/components/calcite-checkbox";
 export * from "./customElement.js";

package/dist/components/arcgis-direct-line-measurement-3d/DirectLineMeasurement3dViewModel.d.ts

@@ -1,13 +1,12 @@
-/// <reference types="@arcgis/core/interfaces.d.ts" />
 import { default as DirectLineMeasurementAnalysis } from '@arcgis/core/analysis/DirectLineMeasurementAnalysis.js';
 import { default as SceneView } from '@arcgis/core/views/SceneView';
 import { AnalysisViewModel } from '../../support/AnalysisViewModel';
-import { MeasurementModeString, MeasurementState, MeasurementValue } from '../../support/measurementUtils';
+import { Length, MeasurementModeString, MeasurementState, MeasurementValue, SystemOrLengthUnit } from '../../support/measurementUtils';
 export interface Measurement {
     readonly mode: MeasurementModeString;
-    readonly directDistance: MeasurementValue<__esri.Length>;
-    readonly horizontalDistance: MeasurementValue<__esri.Length>;
-    readonly verticalDistance: MeasurementValue<__esri.Length>;
+    readonly directDistance: MeasurementValue<Length>;
+    readonly horizontalDistance: MeasurementValue<Length>;
+    readonly verticalDistance: MeasurementValue<Length>;
 }
 export type State = "disabled" | "measured" | "measuring" | "ready";
 export default class DirectLineMeasurement3DViewModel extends AnalysisViewModel<SceneView, DirectLineMeasurementAnalysis> {
@@ -21,16 +20,16 @@ export default class DirectLineMeasurement3DViewModel extends AnalysisViewModel<
     /**
      * List of unit systems (imperial, metric) and specific units for displaying the distance values.
      */
-    get unitOptions(): __esri.SystemOrLengthUnit[];
-    set unitOptions(units: __esri.SystemOrLengthUnit[] | undefined);
+    get unitOptions(): SystemOrLengthUnit[];
+    set unitOptions(units: SystemOrLengthUnit[] | undefined);
     private _userUnitOptions?;
     /**
      * Unit system (imperial, metric) or specific unit used for displaying the distance values.
      */
-    get unit(): __esri.SystemOrLengthUnit;
-    set unit(unit: __esri.SystemOrLengthUnit | undefined);
+    get unit(): SystemOrLengthUnit;
+    set unit(unit: SystemOrLengthUnit | undefined);
     private _userUnit?;
-    get defaultUnit(): __esri.MeasurementSystem | undefined;
+    private get _defaultUnit();
     place(options?: {
         signal?: AbortSignal;
     }): Promise<void>;

package/dist/components/arcgis-direct-line-measurement-3d/customElement.d.ts

@@ -1,5 +1,5 @@
 /// <reference types="@arcgis/core/interfaces.d.ts" />
-/// <reference types="../../index.d.ts" />
+/// <reference path="../../index.d.ts" />
 import { PublicLitElement as LitElement, JsxNode, TargetedEvent } from '@arcgis/lumina';
 import { Use } from '@arcgis/lumina/controllers';
 import { ArcgisReferenceElement } from '../../utils/component-utils';
@@ -7,14 +7,102 @@ import { default as DirectLineMeasurement3DViewModel } from './DirectLineMeasure
 
 declare const useViewModel: (component: LitElement & Pick<DirectLineMeasurement3DViewModel, never> & import('../../controllers/useViewModel').ViewModelControllerUses<DirectLineMeasurement3DViewModel>) => DirectLineMeasurement3DViewModel;
 /**
- * The Direct Line Measurement 3D component calculates and displays the 3D distance between two points. This component
- * can be used in a [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html)
- * to measure the vertical, horizontal, and direct distance between two points.
+ * The Direct Line Measurement 3D component can be added to a [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/)
+ * component to calculate and display vertical, horizontal, and direct distances between two points.
+ *
+ * [![measurement-line-3d](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/3D_DirectLineMeasurement_widget.png)](https://developers.arcgis.com/javascript/latest/sample-code/measurement-3d/)
+ *
+ * How distances are computed depends on the scene's spatial reference.
+ *
+ * In **geographic coordinate systems** (GCS) and in **Web Mercator**:
+ * - Direct distance is computed in a Euclidean manner, in an [ECEF](https://en.wikipedia.org/wiki/ECEF) coordinate system (or equivalent on other planets);
+ * - Horizontal distance is computed geodetically, taking into consideration the curvature of the planet;
+ * - Vertical distance is computed as an elevation difference.
+ *
+ * In **projected coordinate systems** (PCS), apart from Web Mercator, all three distances (direct, horizontal, and vertical)
+ *  are computed in a Euclidean manner (in their respective PCS).
+ *
+ * Direct Line Measurement 3D component visualizes and labels the direct, horizontal, and vertical distances and displays the same values
+ * in the UI panel. When the distance between the points is greater than 100 kilometers,
+ * the measurement visualization is simplified, and only the horizontal and vertical distances are calculated.
+ * The direct distance option becomes unavailable.
+ *
+ * ![measurement-line-3d](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/direct-line-measurement-3d.png)
+ *
+ * When the component is active, a horizontal "laser" line is drawn which indicates the height at the current mouse position.
+ * This line can help in analyzing the heights of objects relative to each other and the terrain.
+ * A second laser line shows the intersection of the scene with the vertical plane that passes through the checkered line.
+ *
+ * **Things to consider**
+ *
+ * * Direct Line Measurement 3D is designed to work in the Scene component. For measurements in the [Map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/)
+ * component, use [Distance Measurement 2D](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-distance-measurement-2d/).
+ * * Snapping is enabled by default. This can be temporarily disabled by holding the `CTRL` key.
+ * * Layer types currently supported for snapping are:
+ * [FeatureLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html),
+ * [GraphicsLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-GraphicsLayer.html) (except Mesh geometries),
+ * [GeoJSONLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-GeoJSONLayer.html),
+ * [WFSLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-WFSLayer.html),
+ * [CSVLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-CSVLayer.html),
+ * [3D Object SceneLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-SceneLayer.html),
+ * and [BuildingSceneLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-BuildingSceneLayer.html).
+ *
+ * **See also**
+ *
+ * - [DirectLineMeasurementAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-DirectLineMeasurementAnalysis.html)
+ * - [Sample - Measurement in 3D](https://developers.arcgis.com/javascript/latest/sample-code/measurement-3d/)
+ * - [Sample - Analysis objects](https://developers.arcgis.com/javascript/latest/sample-code/analysis-objects/)
+ * - [Sample - Color theming for interactive tools](https://developers.arcgis.com/javascript/latest/sample-code/view-theme/)
  *
  * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-direct-line-measurement-3d/)
+ *
+ * @since 4.33
  */
 export declare class ArcgisDirectLineMeasurement3d extends LitElement {
-    /** Analysis data object. */
+    /**
+     * The view associated with the component.
+     *   > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the ArcgisDirectLineMeasurement3d component will be associated with a map or scene component rather than using the `view` property.
+     */
+    view?: __esri.SceneView | undefined;
+    /**
+     * The [DirectLineMeasurementAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-DirectLineMeasurementAnalysis.html)
+     * created or modified by the component.
+     *
+     * When connecting the Direct Line Measurement 3D component to the [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/)
+     * component, it automatically creates an empty analysis and adds it to the Scene's
+     * [analyses](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#analyses) collection.
+     * Whenever the component is destroyed, the analysis is automatically removed from the collection.
+     *
+     * Alternatively, a programmatically created analysis can be provided to the component.
+     * Then, the application itself needs to add it to and later remove it from the Scene's analyses collection.
+     *
+     * ```js
+     * // Create the analysis.
+     * const directLineAnalysis = new DirectLineMeasurementAnalysis({
+     *    startPoint: new Point({
+     *      spatialReference: { latestWkid: 3857, wkid: 102100 },
+     *      x: -13624995.61798748,
+     *      y: 4550334.030096778,
+     *      z: 63.378210234455764
+     *    }),
+     *    endPoint: new Point({
+     *      spatialReference: { latestWkid: 3857, wkid: 102100 },
+     *      x: -13624921.53589075,
+     *      y: 4550407.42357004,
+     *      z: 63.3783810287714
+     *    }),
+     * });
+     * // Get the Scene and measurement component and wait until they are ready.
+     * const viewElement = document.querySelector("arcgis-scene");
+     * await viewElement.viewOnReady();
+     * const directLineMeasurement3d = document.querySelector("arcgis-direct-line-measurement-3d");
+     * await directLineMeasurement3d.componentOnReady();
+     * // Add the analysis to the Scene component.
+     * viewElement.analyses.add(directLineAnalysis);
+     * // Connect the analysis to the measurement component:
+     * directLineMeasurement3d.analysis = directLineAnalysis;
+     * ```
+     */
     analysis: __esri.DirectLineMeasurementAnalysis;
     /**
      * If true, the component will not be destroyed automatically when it is
@@ -36,27 +124,49 @@ export declare class ArcgisDirectLineMeasurement3d extends LitElement {
     icon?: HTMLCalciteIconElement["icon"];
     /** The component's default label. */
     label?: string;
-    /** @default "bottom-left" */
-    position: __esri.UIPosition;
+    /** @deprecated since 4.34, use [`slot`](https://developers.arcgis.com/javascript/latest/building-your-ui/#slots) instead. */
+    position?: __esri.UIPosition;
+    /**
+     * By assigning the `id` attribute of the Map or Scene component to this property, you can position a child component anywhere in the DOM while still maintaining a connection to the Map or Scene.
+     *
+     * @see [Associate components with a Map or Scene component](https://developers.arcgis.com/javascript/latest/programming-patterns/#associate-components-with-a-map-or-scene-component)
+     */
     referenceElement?: ArcgisReferenceElement | string;
-    state: "ready" | "disabled" | "measuring" | "measured";
-    /** Unit system (imperial, metric) or specific unit used for displaying the distance values. */
+    /**
+     * The component's state. The values mean the following:
+     *
+     * * `disabled` -  not ready yet
+     * * `ready` - ready for measuring
+     * * `measuring` - currently measuring
+     * * `measured` - measuring has finished
+     */
+    readonly state: "ready" | "disabled" | "measured" | "measuring";
+    /**
+     * Unit system (imperial, metric) or specific unit used for displaying the distance values. Possible values are listed in
+     * [unitOptions](#unitOptions).
+     */
     unit: __esri.SystemOrLengthUnit;
-    /** List of unit systems (imperial, metric) and specific units for displaying the distance values. */
+    /**
+     * List of available units and unit systems (imperial, metric) that are shown in the component's dropdown.
+     * By default, the following units are included: `metric`, `imperial`, `inches`, `feet`, `us-feet`, `yards`, `miles`, `nautical-miles`, `meters`, `kilometers`.
+     * Possible [unit](#unit) values can only be a subset of this list.
+     */
     unitOptions: __esri.SystemOrLengthUnit[];
+    /** Clears the current measurement. */
     clear(): Promise<void>;
     /** Permanently destroy the component. */
     destroy(): Promise<void>;
+    /** Starts a new measurement. */
     start(): Promise<void>;
     /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
     readonly arcgisPropertyChange: TargetedEvent<this, {
         name: "state" | "analysis";
     }>;
-    /** Emitted when the component associated with a map or scene view is is ready to be interacted with. */
+    /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
     readonly arcgisReady: TargetedEvent<this, void>;
 }
 /**
- * The Direct Line Measurement 3D component calculates and displays the 3D distance between two points. This component can be used in a [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html) to measure the vertical, horizontal, and direct distance between two points.
+ * The Directline Measurement 3D component calculates and displays the 3D distance between two points. It can be used in a [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/) component to measure the vertical, horizontal, and direct distance between two points.
  *
  * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-directline-measurement-3d/)
  *

package/dist/components/arcgis-direct-line-measurement-3d/customElement.js

@@ -1,35 +1,35 @@
 import { c as p } from "../../chunks/runtime.js";
-import { html as g } from "lit-html";
-import { LitElement as v, createEvent as f, noShadowRoot as w, nothing as D, safeClassMap as b } from "@arcgis/lumina";
-import { usePropertyChange as M } from "@arcgis/lumina/controllers";
-import { u as O } from "../../chunks/useT9n.js";
-import { m as U } from "../../chunks/useViewModel.js";
-import { g as d } from "../../chunks/globalCss.js";
-import { css as $ } from "@lit/reactive-element/css-tag.js";
-import L from "@arcgis/core/analysis/DirectLineMeasurementAnalysis.js";
-import { isAboveGeodesicDistanceThreshold as _ } from "@arcgis/core/applications/Components/analysisUtils.js";
-import { getDefaultUnitForView as V } from "@arcgis/core/applications/Components/getDefaultUnits.js";
-import { property as o, subclass as P } from "@arcgis/core/core/accessorSupport/decorators.js";
-import { watch as A } from "@arcgis/core/core/reactiveUtils.js";
-import { A as C } from "../../chunks/AnalysisViewModel.js";
-import { g as c, m } from "../../chunks/measurementUtils.js";
+import { css as _, html as w } from "lit";
+import { LitElement as f, createEvent as v, nothing as b, safeClassMap as x } from "@arcgis/lumina";
+import { usePropertyChange as y } from "@arcgis/lumina/controllers";
+import { u as D } from "../../chunks/useT9n.js";
+import { m as z } from "../../chunks/useViewModel.js";
+import { g } from "../../chunks/globalCss.js";
+import k from "@arcgis/core/analysis/DirectLineMeasurementAnalysis.js";
+import { isAboveGeodesicDistanceThreshold as M } from "@arcgis/core/applications/Components/analysisUtils.js";
+import { getDefaultUnitForView as O } from "@arcgis/core/applications/Components/getDefaultUnits.js";
+import { property as a, subclass as U } from "@arcgis/core/core/accessorSupport/decorators.js";
+import { watch as $ } from "@arcgis/core/core/reactiveUtils.js";
+import { A as L } from "../../chunks/AnalysisViewModel.js";
+import { g as c, m as u } from "../../chunks/measurementUtils.js";
+import { b as V } from "../../chunks/async-utils.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.16 */
-const z = $`@layer{arcgis-directline-measurement-3d,arcgis-direct-line-measurement-3d{display:block}.arcgis-direct-line-measurement-3d{position:relative;padding:var(--esri-widget-padding);overflow-y:auto}}`;
-var S = Object.defineProperty, E = Object.getOwnPropertyDescriptor, r = (e, t, s, a) => {
-  for (var n = a > 1 ? void 0 : a ? E(t, s) : t, l = e.length - 1, u; l >= 0; l--)
-    (u = e[l]) && (n = (a ? u(t, s, n) : u(n)) || n);
-  return a && n && S(t, s, n), n;
+v4.34.0-next.160 */
+const C = _`.esri-widget__heading{color:var(--calcite-color-text-2);margin:0 0 .5rem;font-weight:var(--calcite-font-weight-semibold)}h1.esri-widget__heading{font-size:var(--calcite-font-size-xl)}h2.esri-widget__heading{font-size:var(--calcite-font-size-md)}h3.esri-widget__heading,h4.esri-widget__heading,h5.esri-widget__heading,h6.esri-widget__heading{font-size:var(--calcite-font-size)}.esri-widget{--esri-widget-padding-x: 15px;--esri-widget-padding-y: var(--calcite-spacing-md);--esri-widget-padding: var(--esri-widget-padding-y) var(--esri-widget-padding-x);box-sizing:border-box;color:var(--calcite-color-text-2);background-color:var(--calcite-color-foreground-1);font-size:var(--calcite-font-size);line-height:var(--calcite-font-line-height-relative-tight)}.esri-widget *,.esri-widget :before,.esri-widget :after{box-sizing:inherit}.esri-widget.esri-widget--disabled>*{opacity:.4;pointer-events:none}.esri-widget.esri-widget--compact{--esri-widget-padding-y: 0;--esri-widget-padding-x: 0}.esri-widget__anchor{color:var(--calcite-color-text-2)}.esri-widget__anchor:hover{color:var(--calcite-color-text-3)}.esri-widget__anchor:hover,.esri-widget__anchor:focus{text-decoration:underline}.esri-widget__anchor--disabled{opacity:.4;pointer-events:none}.esri-widget__header{background-color:var(--calcite-color-foreground-1);flex:1 0 100%;justify-content:space-between;align-items:center;width:100%;min-height:48px;padding:12px 0 12px 15px;display:flex}.esri-widget__header .esri-widget__heading{width:calc(100% - 48px);text-align:initial;color:var(--calcite-color-text-1);align-items:center;margin:0;padding:0;display:flex}.esri-widget__header-button{appearance:none;cursor:pointer;color:var(--calcite-color-text-2);background-color:var(--calcite-color-foreground-1);border:none;flex:0 0 48px;justify-content:center;align-self:stretch;align-items:center;width:48px;padding:0;display:flex}.esri-widget__footer{background-color:var(--calcite-color-foreground-1);justify-content:center;align-items:center;width:100%;min-height:48px;display:flex}.esri-widget__footer-pagination{color:var(--calcite-color-text-2);justify-content:space-between;align-items:center;display:flex}.esri-widget__footer-pagination-previous-button,.esri-widget__footer-pagination-next-button{cursor:pointer;background-color:var(--calcite-color-foreground-1);border:0;margin:0 7px;padding:12px 15px;transition:background-color .125s ease-in-out}.esri-widget__footer-pagination-previous-button:hover,.esri-widget__footer-pagination-previous-button:focus,.esri-widget__footer-pagination-next-button:hover,.esri-widget__footer-pagination-next-button:focus{color:var(--calcite-color-text-1);background-color:var(--calcite-color-foreground-1)}.esri-menu{visibility:hidden;z-index:1;background-clip:padding;background-color:var(--calcite-color-foreground-1);background-clip:padding-box;width:100%;max-height:0;margin:2px 0 0;padding:0;font-size:var(--calcite-font-size);line-height:var(--calcite-spacing-xl);position:absolute;top:100%;left:0;overflow:hidden;box-shadow:0 1px 2px #0000004d}.esri-menu .esri-menu__header{color:var(--calcite-color-text-inverse);background-color:var(--calcite-color-inverse);padding:6px 12px}.esri-menu__list{margin:0;padding:0;list-style:none}.esri-menu__list-item{cursor:pointer;border-top:1px solid #adadad4d;border-left:3px solid #0000;padding:.8em 1em}.esri-menu__list-item [class^=esri-icon-],.esri-menu__list-item [class*=" esri-icon-"]{padding-right:2.8px}.esri-menu__list-item:first-child{border-top:none}.esri-menu__list-item--focus,.esri-menu__list-item:hover,.esri-menu__list-item:focus{background-color:var(--calcite-color-foreground-1)}.esri-menu__list-item:active{background-color:var(--calcite-color-foreground-current)}.esri-menu__list-item--active,.esri-menu__list-item--active:hover,.esri-menu__list-item--active:focus{background-color:var(--calcite-color-foreground-1);border-left-color:var(--calcite-color-brand)}.esri-widget__table{border-collapse:collapse;color:var(--calcite-color-text-1);border:none;width:100%;line-height:var(--calcite-font-line-height-relative-tight)}.esri-widget__table tr:nth-child(odd){background-color:var(--calcite-color-transparent)}.esri-widget__table tr:nth-child(2n){background-color:var(--calcite-color-transparent-press)}.esri-widget__table tr a{color:var(--calcite-color-text-2)}.esri-widget__table tr a:hover,.esri-widget__table tr a:focus{color:var(--calcite-color-text-1)}.esri-widget__table tr td,.esri-widget__table tr th{vertical-align:top;word-break:break-word;padding:.5em .7em;font-size:var(--calcite-font-size-sm);font-weight:var(--calcite-font-weight-regular)}.esri-widget__table tr th{text-align:left;border-right:3px solid #0000000d;width:50%}.esri-widget__table tr td{width:50%}.esri-input{color:var(--calcite-color-text-1);background-color:var(--calcite-color-foreground-1);border:1px solid #959595;font-size:var(--calcite-font-size)}.esri-input::-ms-clear{display:none}.esri-input::placeholder{opacity:1;color:var(--calcite-color-text-2)}.esri-input:placeholder-shown{text-overflow:ellipsis}.esri-input[type=text],.esri-input[type=password],.esri-input[type=number]{height:32px;padding:0 .5em}calcite-combobox.esri-input{border:none}.esri-widget__content--empty{text-align:center;color:var(--calcite-color-border-input);flex-flow:column wrap;align-items:center;padding:18px 22px;display:flex}.esri-widget__content--empty h1.esri-widget__heading,.esri-widget__content--empty h2.esri-widget__heading,.esri-widget__content--empty h3.esri-widget__heading,.esri-widget__content--empty h4.esri-widget__heading,.esri-widget__content--empty h5.esri-widget__heading{font-weight:var(--calcite-font-weight-regular)}.esri-widget__content-illustration--empty{width:128px;padding:1rem 0}.esri-widget__content-icon--empty{width:32px;padding:.5rem 0}.esri-select{appearance:none;cursor:pointer;color:var(--calcite-color-text-2);background:var(--calcite-color-foreground-1) url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='-8 -8 32 32' width='32' height='32'%3E%3Cpath d='M8 11.207l-4-4V5.793l4 4 4-4v1.414z' fill='%23adadad' fillrule='nonzero'/%3E%3C/svg%3E") 100% no-repeat;border:1px solid #959595;border-radius:0;width:100%;height:32px;margin:0;padding:0 .5em;font-family:inherit;font-size:.85em;display:block}.esri-select[disabled]{cursor:auto}.esri-select::-ms-expand{display:none}.esri-disabled a,.esri-disabled [role=menu],.esri-disabled [role=checkbox],.esri-disabled [class^=esri-icon-],.esri-disabled [class*=" esri-icon-"]{color:var(--calcite-color-text-3)}.keynav-mode .esri-widget:focus,.keynav-mode .esri-widget :focus{z-index:1;outline-offset:2px;outline:2px solid #adadad}.esri-widget__loader-animation{border:.15em solid #adadad4d;border-top-color:var(--calcite-color-border-input);border-radius:100%;width:1em;height:1em;font-size:var(--calcite-font-size-md);animation:1.25s linear infinite esri-rotate;display:block;transform:translateZ(0)}:dir(rtl) .esri-widget__table th{text-align:right;border-left:3px solid #0000000d;border-right:none}:dir(rtl) .esri-select{background-position:0}:dir(rtl) .esri-menu__list-item{border-left:none;border-right:3px solid #0000}:dir(rtl) .esri-menu__list-item [class^=esri-icon-],:dir(rtl) .esri-menu__list-item [class*=" esri-icon-"]{padding-left:2px;padding-right:0}:dir(rtl) .esri-menu__list-item--active{border-right-color:var(--calcite-color-brand)}.esri-icon-font-fallback-text{clip:rect(0 0 0 0);width:1px;height:1px;position:absolute;overflow:hidden}.esri-rotating{animation:1.25s linear infinite esri-rotate;transform:translateZ(0)}.esri-clearfix:before,.esri-clearfix:after{content:" ";display:table}.esri-clearfix:after{clear:both}.esri-interactive{cursor:pointer}.esri-hidden{display:none!important}.esri-invisible{visibility:hidden!important}.esri-offscreen{position:absolute;top:-999em;left:-999em}.esri-match-height{flex-direction:column;flex:auto;display:flex;overflow:hidden}.esri-widget--panel{min-width:300px;min-height:32px;padding:var(--esri-widget-padding);transition:max-height .25s ease-in-out;overflow-y:auto}.esri-unit-select{width:100%}.esri-unit-select__label{--calcite-label-margin-bottom: 0;width:100%}:host{display:block}.esri-measurement-widget-content{padding:var(--esri-widget-padding);flex-direction:column;gap:var(--calcite-spacing-xxl);display:flex;position:relative;overflow-y:auto}.esri-measurement-widget-content__error{color:var(--calcite-color-status-danger)}.esri-measurement-widget-content__error,.esri-measurement-widget-content__hint{overflow:hidden}.esri-measurement-widget-content__error p,.esri-measurement-widget-content__hint p{margin:0;padding:0}.esri-measurement-widget-content__hint,.esri-measurement-widget-content__error,.esri-measurement-widget-content__measurement,.esri-measurement-widget-content__measurement-item{flex-direction:column;gap:var(--calcite-spacing-md);animation:.25s ease-in-out esri-fade-in;display:flex}.esri-measurement-widget-content__measurement-item--disabled{color:var(--calcite-color-border-ghost)}.esri-measurement-widget-content__measurement-item__value{font-weight:var(--calcite-font-weight-semibold)}.esri-measurement-widget-content__actions{flex-direction:column;justify-content:center;gap:var(--calcite-spacing-xs);display:flex}:host{.esri-widget--panel{min-width:0}}`;
+var A = Object.defineProperty, E = Object.getOwnPropertyDescriptor, s = (e, t, i, o) => {
+  for (var n = o > 1 ? void 0 : o ? E(t, i) : t, l = e.length - 1, d; l >= 0; l--)
+    (d = e[l]) && (n = (o ? d(t, i, n) : d(n)) || n);
+  return o && n && A(t, i, n), n;
 };
-let i = class extends C {
+let r = class extends L {
   constructor() {
     super(...arguments), this.supportedViewType = "3d", this.unsupportedErrorMessage = "The Direct Line Measurement 3D component is only supported in 3D views.";
   }
   initialize() {
     this.addHandles(
       // Make sure the analysis and view model units are in sync.
-      A(
+      $(
         () => ({
           analysis: this.analysis,
           unit: this.unit
@@ -66,33 +66,33 @@ let i = class extends C {
         horizontalDistance: c(void 0),
         verticalDistance: c(void 0)
       };
-    const s = e?.directDistance, a = s != null && _(s);
+    const i = e?.directDistance, o = i != null && M(i);
     return {
       mode: t ?? "euclidean",
-      directDistance: c(a ? void 0 : s),
+      directDistance: c(o ? void 0 : i),
       horizontalDistance: c(e?.horizontalDistance),
       verticalDistance: c(e?.verticalDistance)
     };
   }
   get unitOptions() {
-    const e = this._userUnitOptions?.filter((t) => m.includes(t));
-    return e && e.length > 0 ? e : m.slice();
+    const e = this._userUnitOptions?.filter((t) => u.includes(t));
+    return e && e.length > 0 ? e : u.slice();
   }
   set unitOptions(e) {
     this._userUnitOptions = e;
   }
   get unit() {
-    const e = this._userUnit, t = this.unitOptions;
+    const e = this._userUnit ?? this.analysis.unit, t = this.unitOptions;
     if (e && t.includes(e))
       return e;
-    const s = this.defaultUnit;
-    return s && t.includes(s) ? s : t[0];
+    const i = this._defaultUnit;
+    return i && t.includes(i) ? i : t[0];
   }
   set unit(e) {
     this._userUnit = e;
   }
-  get defaultUnit() {
-    return this.view ? V(this.view) : void 0;
+  get _defaultUnit() {
+    return this.view ? O(this.view) : void 0;
   }
   async place(e) {
     await this.analysisView?.place(e);
@@ -101,49 +101,46 @@ let i = class extends C {
     this.analysis.startPoint = null, this.analysis.endPoint = null;
   }
   constructAnalysis() {
-    return new L();
+    return new k();
   }
 };
-r([
-  o({ readOnly: !0 })
-], i.prototype, "state", 1);
-r([
-  o({ readOnly: !0 })
-], i.prototype, "displayState", 1);
-r([
-  o({ readOnly: !0 })
-], i.prototype, "measurement", 1);
-r([
-  o()
-], i.prototype, "unitOptions", 1);
-r([
-  o()
-], i.prototype, "_userUnitOptions", 2);
-r([
-  o()
-], i.prototype, "unit", 1);
-r([
-  o()
-], i.prototype, "_userUnit", 2);
-r([
-  o({ readOnly: !0 })
-], i.prototype, "defaultUnit", 1);
-i = r([
-  P("components.direct-line-measurement-3d.DirectLineMeasurement3dViewModel")
-], i);
-const x = "arcgis-direct-line-measurement-3d", T = { base: x }, R = U(i);
-class h extends v {
+s([
+  a({ readOnly: !0 })
+], r.prototype, "state", 1);
+s([
+  a({ readOnly: !0 })
+], r.prototype, "displayState", 1);
+s([
+  a({ readOnly: !0 })
+], r.prototype, "measurement", 1);
+s([
+  a()
+], r.prototype, "unitOptions", 1);
+s([
+  a()
+], r.prototype, "_userUnitOptions", 2);
+s([
+  a()
+], r.prototype, "unit", 1);
+s([
+  a()
+], r.prototype, "_userUnit", 2);
+s([
+  a({ readOnly: !0 })
+], r.prototype, "_defaultUnit", 1);
+r = s([
+  U("components.direct-line-measurement-3d.DirectLineMeasurement3dViewModel")
+], r);
+const P = "arcgis-direct-line-measurement-3d", j = { base: P }, S = z(r);
+class m extends f {
   constructor() {
-    super(...arguments), this.viewModel = R(this), this.messages = O({ name: "directline-measurement-3d", blocking: !0 }), this.analysis = this.viewModel.analysis, this.autoDestroyDisabled = !1, this.icon = "measure-line", this.position = "bottom-left", this.state = this.viewModel.state, this.unit = this.viewModel.unit, this.unitOptions = this.viewModel.unitOptions, this.arcgisPropertyChange = M()("analysis", "state"), this.arcgisReady = f();
+    super(...arguments), this.viewModel = S(this), this.messages = D({ name: "directline-measurement-3d", blocking: !0 }), this.view = this.viewModel.view, this.analysis = this.viewModel.analysis, this.autoDestroyDisabled = !1, this.icon = "measure-line", this.state = this.viewModel.state, this.unit = this.viewModel.unit, this.unitOptions = this.viewModel.unitOptions, this.arcgisPropertyChange = y()("analysis", "state"), this.arcgisReady = v();
   }
   static {
-    this.properties = { analysis: 0, autoDestroyDisabled: 5, icon: 3, label: 1, position: 1, referenceElement: 1, state: 1, unit: 1, unitOptions: 0 };
+    this.properties = { view: 0, analysis: 0, autoDestroyDisabled: 5, icon: 3, label: 1, position: 1, referenceElement: 1, state: 35, unit: 1, unitOptions: 0 };
   }
   static {
-    this.shadowRootOptions = w;
-  }
-  static {
-    this.styles = z;
+    this.styles = C;
   }
   async clear() {
     this.viewModel.clear();
@@ -152,14 +149,14 @@ class h extends v {
     await this.manager.destroy();
   }
   async start() {
-    await this.viewModel.start();
+    V(this.viewModel.start());
   }
   render() {
-    const { messages: t, unit: s, unitOptions: a, viewModel: n } = this, { measurement: l, state: u } = n;
-    return g`<div aria-label=${t.componentLabel ?? D} class=${b({
-      [T.base]: !0,
-      [d.widget]: !0,
-      [d.panel]: !0
+    const { messages: t, unit: i, unitOptions: o, viewModel: n } = this, { measurement: l, state: d } = n;
+    return w`<div aria-label=${t.componentLabel ?? b} class=${x({
+      [j.base]: !0,
+      [g.widget]: !0,
+      [g.panel]: !0
     })} role=presentation><arcgis-measurement-content .state=${n.displayState} .hintLabel=${t.hint} .unsupportedLabel=${t.unsupported} .items=${[
       {
         title: t.direct,
@@ -173,21 +170,19 @@ class h extends v {
         title: t.vertical,
         measurement: l.verticalDistance
       }
-    ]}><arcgis-unit-select slot=settings .options=${a} .selectLabel=${t.unit} .value=${s} @arcgisUnitSelectChange=${(y) => {
-      this.unit = y.detail;
-    }}></arcgis-unit-select><calcite-button slot=actions .disabled=${u === "disabled"} @click=${() => {
-      this.viewModel.clear(), this.viewModel.start();
-    }}>${t.newMeasurement}</calcite-button></arcgis-measurement-content></div>`;
+    ]}><arcgis-unit-select slot=settings .options=${o} .selectLabel=${t.unit} .value=${i} @arcgisUnitSelectChange=${(h) => {
+      this.unit = h.detail;
+    }}></arcgis-unit-select><calcite-button slot=actions .disabled=${d === "disabled"} @click=${this.start}>${t.newMeasurement}</calcite-button></arcgis-measurement-content></div>`;
   }
 }
-class j extends h {
+class T extends m {
   constructor() {
     super(), console.warn('arcgis-directline-measurement-3d - this component is deprecated. Use the "arcgis-direct-line-measurement-3d" component instead.');
   }
 }
-p("arcgis-direct-line-measurement-3d", h);
-p("arcgis-directline-measurement-3d", j);
+p("arcgis-direct-line-measurement-3d", m);
+p("arcgis-directline-measurement-3d", T);
 export {
-  h as ArcgisDirectLineMeasurement3d,
-  j as DeprecatedArcgisDirectLineMeasurement3d
+  m as ArcgisDirectLineMeasurement3d,
+  T as DeprecatedArcgisDirectLineMeasurement3d
 };

package/dist/components/arcgis-directional-pad/customElement.d.ts

@@ -1,5 +1,5 @@
 /// <reference types="@arcgis/core/interfaces.d.ts" />
-/// <reference types="../../index.d.ts" />
+/// <reference path="../../index.d.ts" />
 import { Use } from '@arcgis/lumina/controllers';
 import { default as DirectionalPadViewModel } from '@arcgis/core/widgets/DirectionalPad/DirectionalPadViewModel.js';
 import { JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
@@ -18,8 +18,15 @@ declare const useDirectionalPadViewModel: (component: LitElement & Pick<Directio
  * The Directional Pad component is not supported in 3D.
  *
  * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-directional-pad/)
+ *
+ * @since 4.29
  */
 export declare class ArcgisDirectionalPad extends LitElement {
+    /**
+     * The view associated with the component.
+     *   > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the ArcgisDirectionalPad component will be associated with a map or scene component rather than using the `view` property.
+     */
+    view?: __esri.MapView | nullish;
     /**
      * If true, the component will not be destroyed automatically when it is
      * disconnected from the document. This is useful when you want to move the
@@ -54,10 +61,19 @@ export declare class ArcgisDirectionalPad extends LitElement {
     icon?: string;
     /** The component's default label. */
     label?: string;
-    /** Replace localized message strings with your own strings. <br>_**Note**: Individual message keys may change between releases._ */
+    /**
+     * Replace localized message strings with your own strings.
+     *
+     * _**Note**: Individual message keys may change between releases._
+     */
     messageOverrides?: typeof this.messages._overrides;
-    /** @default "bottom-left" */
-    position: __esri.UIPosition;
+    /** @deprecated since 4.34, use [`slot`](https://developers.arcgis.com/javascript/latest/building-your-ui/#slots) instead. */
+    position?: __esri.UIPosition;
+    /**
+     * By assigning the `id` attribute of the Map or Scene component to this property, you can position a child component anywhere in the DOM while still maintaining a connection to the Map or Scene.
+     *
+     * @see [Associate components with a Map or Scene component](https://developers.arcgis.com/javascript/latest/programming-patterns/#associate-components-with-a-map-or-scene-component)
+     */
     referenceElement?: ArcgisReferenceElement | string;
     /**
      * Whether to display the button to reset the rotation angle. This only takes
@@ -72,11 +88,7 @@ export declare class ArcgisDirectionalPad extends LitElement {
      * @default false
      */
     showRotationSlider: boolean;
-    /**
-     * The state of the view model.
-     *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-DirectionalPad-DirectionalPadViewModel.html#state)
-     */
+    /** The current state of the component. */
     readonly state: "ready" | "disabled" | "moving";
     /**
      * Determines the size of directional pad buttons and the slider.
@@ -93,7 +105,7 @@ export declare class ArcgisDirectionalPad extends LitElement {
     readonly arcgisPropertyChange: TargetedEvent<this, {
         name: "state";
     }>;
-    /** Emitted when the component associated with a map or scene view is is ready to be interacted with. */
+    /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
     readonly arcgisReady: TargetedEvent<this, void>;
     private messages: Partial<{
         componentLabel: string;