@arcgis/map-components 4.34.0-next.5 → 4.34.0-next.50

package/dist/components/arcgis-building-explorer/customElement.d.ts

@@ -21,7 +21,9 @@ declare const useBuildingExplorerWidget: (component: LitElement & Pick<BuildingE
         childElem?: HTMLElement & {
             ownedBy?: HTMLElement;
         };
-        view?: __esri.LinkChartView | __esri.MapView | __esri.SceneView;
+        view
+        /** @copyDoc */
+        ?: __esri.LinkChartView | __esri.MapView | __esri.SceneView;
     };
     autoDestroyDisabled: boolean;
     destroy: () => Promise<void>;
@@ -29,6 +31,10 @@ declare const useBuildingExplorerWidget: (component: LitElement & Pick<BuildingE
 /**
  * The Building Explorer component is used to filter and explore the various components of [BuildingSceneLayers](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-BuildingSceneLayer.html). BuildingSceneLayers are complex digital models of buildings and interiors and can contain thousands of components grouped in sublayers. Using this component, buildings can be filtered by level, construction phase or by disciplines and categories.
  *
+ * **Known limitations**
+ *
+ * Building Explorer is only supported in a 3D [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/) component.
+ *
  * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-building-explorer/)
  */
 export declare class ArcgisBuildingExplorer extends LitElement {
@@ -43,7 +49,7 @@ export declare class ArcgisBuildingExplorer extends LitElement {
      */
     autoDestroyDisabled: boolean;
     /**
-     * Indicates the heading level to use for the headings in the widget.
+     * Indicates the heading level to use for the component title.
      *
      * @default 3
      */
@@ -55,23 +61,21 @@ export declare class ArcgisBuildingExplorer extends LitElement {
     /** @default false */
     hidePhases: boolean | undefined;
     /**
-     * Icon which represents the widget.
+     * Icon which represents the component. Typically used when the component is controlled by another component (e.g. by the Expand component).
+     *
+     * See also: [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
      *
-     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
      * @default "organization"
      */
     icon: string;
-    /**
-     * The widget's default label.
-     *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-BuildingExplorer.html#label)
-     */
+    /** The component's default label. */
     label: string;
     /**
-     * A [collection](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-Collection.html) of layers of type [BuildingSceneLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-BuildingSceneLayer.html)
-     * that are added to the widget for exploration.
+     * A [collection](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-Collection.html)
+     * of layers of type [BuildingSceneLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-BuildingSceneLayer.html)
+     * that are added to the componen for exploration.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-BuildingExplorer.html#layers)
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-BuildingExplorer.html#layers)
      */
     layers: __esri.Collection<__esri.BuildingSceneLayer>;
     /**
@@ -92,11 +96,19 @@ export declare class ArcgisBuildingExplorer extends LitElement {
     readonly phase: __esri.BuildingPhase;
     /** @default "bottom-left" */
     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;
     /**
-     * The current state of the view model that can be used for rendering the UI of the widget.
+     * The component's state. The values mean the following:
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-BuildingExplorer-BuildingExplorerViewModel.html#state)
+     * * `disabled` -  	component is being created
+     * * `loading` - layers and statistics are loading
+     * * `ready` - component is ready
+     * * `failed` - component failed to load data
      *
      * @default "disabled"
      */

package/dist/components/arcgis-building-explorer/customElement.js

@@ -3,10 +3,10 @@ import { usePropertyChange as i } from "@arcgis/lumina/controllers";
 import s from "@arcgis/core/widgets/BuildingExplorer.js";
 import { LitElement as t, createEvent as l, noShadowRoot as o } from "@arcgis/lumina";
 import { m as h } from "../../chunks/useWidget.js";
-import { css as r } from "@lit/reactive-element/css-tag.js";
+import { css as r } from "lit";
 /*! 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.5 */
+v4.34.0-next.50 */
 const a = r`@layer{arcgis-building-explorer{display:block}}`, d = h(s);
 class n extends t {
   constructor() {

package/dist/components/arcgis-catalog-layer-list/customElement.d.ts

@@ -124,6 +124,11 @@ export declare class ArcgisCatalogLayerList extends LitElement {
     minFilterItems: number;
     /** @default "bottom-left" */
     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;
     /**
      * A collection of selected [ListItems](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList-ListItem.html) representing [catalogItems](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-CatalogLayerList.html#catalogItems)

package/dist/components/arcgis-catalog-layer-list/customElement.js

@@ -4,11 +4,11 @@ import { reEmitEvent as i } from "@arcgis/lumina/controllers/accessor";
 import s from "@arcgis/core/widgets/CatalogLayerList.js";
 import { LitElement as o, createEvent as a, noShadowRoot as l } from "@arcgis/lumina";
 import { m as r } from "../../chunks/useWidget.js";
-import { css as h } from "@lit/reactive-element/css-tag.js";
+import { css as h } from "lit";
 import { c as d } from "../../chunks/createCloseEvent.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.5 */
+v4.34.0-next.50 */
 const c = h`@layer{arcgis-catalog-layer-list{display:block}}`, n = r(s);
 class g extends o {
   constructor() {

package/dist/components/arcgis-compass/customElement.d.ts

@@ -42,7 +42,11 @@ export declare class ArcgisCompass extends LitElement {
     set icon(value: string | undefined);
     /** The component's default label. */
     label?: string;
-    /** Replace localized message strings with your own strings. **Warning**: 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;
     /**
      * The z axis orientation.
@@ -52,6 +56,11 @@ export declare class ArcgisCompass extends LitElement {
     readonly orientation: __esri.Orientation;
     /** @default "top-left" */
     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;
     /**
      * The view model's state.

package/dist/components/arcgis-compass/customElement.js

@@ -1,29 +1,28 @@
 import { c } from "../../chunks/runtime.js";
-import { html as l } from "lit-html";
+import { css as l, html as d } from "lit";
 import { usePropertyChange as m } from "@arcgis/lumina/controllers";
-import { classes as d } from "@arcgis/components-utils";
-import h from "@arcgis/core/widgets/Compass/CompassViewModel.js";
-import { LitElement as p, createEvent as g, noShadowRoot as u, safeClassMap as s, nothing as o, safeStyleMap as f } from "@arcgis/lumina";
-import { u as v } from "../../chunks/useT9n.js";
-import { m as w } from "../../chunks/useViewModel.js";
+import { classes as h } from "@arcgis/components-utils";
+import p from "@arcgis/core/widgets/Compass/CompassViewModel.js";
+import { LitElement as g, createEvent as u, noShadowRoot as f, safeClassMap as s, nothing as o, safeStyleMap as v } from "@arcgis/lumina";
+import { u as w } from "../../chunks/useT9n.js";
+import { m as y } from "../../chunks/useViewModel.js";
 import { g as i } from "../../chunks/globalCss.js";
-import { css as y } from "@lit/reactive-element/css-tag.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.5 */
-const $ = y`@layer{arcgis-compass{display:block}}`, r = "esri-compass", a = {
-  base: r,
-  iconContainer: `${r}__icon-container`
-}, b = w(h);
-class M extends p {
+v4.34.0-next.50 */
+const $ = l`@layer{arcgis-compass{display:block}}`, a = "esri-compass", r = {
+  base: a,
+  iconContainer: `${a}__icon-container`
+}, b = y(p);
+class M extends g {
   constructor() {
-    super(...arguments), this.messages = v(), this.viewModel = b(this), this.autoDestroyDisabled = !1, this.goToOverride = this.viewModel.goToOverride, this.orientation = this.viewModel.orientation, this.position = "top-left", this.state = this.viewModel.state, this.arcgisPropertyChange = m()("state", "orientation"), this.arcgisReady = g();
+    super(...arguments), this.messages = w(), this.viewModel = b(this), this.autoDestroyDisabled = !1, this.goToOverride = this.viewModel.goToOverride, this.orientation = this.viewModel.orientation, this.position = "top-left", this.state = this.viewModel.state, this.arcgisPropertyChange = m()("state", "orientation"), this.arcgisReady = u();
   }
   static {
     this.properties = { autoDestroyDisabled: 5, goToOverride: 0, icon: 3, label: 1, messageOverrides: 0, orientation: 0, position: 3, referenceElement: 1, state: 3 };
   }
   static {
-    this.shadowRootOptions = u;
+    this.shadowRootOptions = f;
   }
   static {
     this.styles = $;
@@ -45,7 +44,7 @@ class M extends p {
   }
   render() {
     const { messages: t, icon: n } = this;
-    return l`<div class=${s(d(a.base, i.widget))}><calcite-button class=${s(i.widgetButton)} .disabled=${this.state === "disabled"} kind=neutral .label=${t.reset} @click=${this._reset} round scale=s title=${t.reset ?? o}><div aria-hidden=true class=${s(a.iconContainer)} title=${t.reset ?? o}><calcite-icon .icon=${n} style=${f(C(this.orientation))}></calcite-icon></div></calcite-button></div>`;
+    return d`<div class=${s(h(r.base, i.widget))}><calcite-button class=${s(i.widgetButton)} .disabled=${this.state === "disabled"} kind=neutral .label=${t.reset} @click=${this._reset} round scale=s title=${t.reset ?? o}><div aria-hidden=true class=${s(r.iconContainer)} title=${t.reset ?? o}><calcite-icon .icon=${n} style=${v(C(this.orientation))}></calcite-icon></div></calcite-button></div>`;
   }
 }
 const C = (e) => ({

package/dist/components/arcgis-coordinate-conversion/customElement.d.ts

@@ -81,7 +81,7 @@ export declare class ArcgisCoordinateConversion extends LitElement {
     /** @default false */
     hideCaptureButton: boolean | undefined;
     /** @default false */
-    hideEditButton: boolean | undefined;
+    hideInputButton: boolean | undefined;
     /** @default false */
     hideExpandButton: boolean | undefined;
     /** @default false */
@@ -126,6 +126,11 @@ export declare class ArcgisCoordinateConversion extends LitElement {
     orientation: "auto" | "expand-up" | "expand-down";
     /** @default "bottom-left" */
     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;
     /**
      * The view model's state.

package/dist/components/arcgis-coordinate-conversion/customElement.js

@@ -3,17 +3,17 @@ import { usePropertyChange as s } from "@arcgis/lumina/controllers";
 import o from "@arcgis/core/widgets/CoordinateConversion.js";
 import { LitElement as n, createEvent as r, noShadowRoot as a } from "@arcgis/lumina";
 import { m as d } from "../../chunks/useWidget.js";
-import { css as h } from "@lit/reactive-element/css-tag.js";
+import { css as h } from "lit";
 /*! 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.5 */
+v4.34.0-next.50 */
 const l = h`@layer{arcgis-coordinate-conversion{display:block}}`, g = d(o);
 class c extends n {
   constructor() {
-    super(...arguments), this.widget = g(this), this.viewModel = this.widget.viewModel, this.autoDestroyDisabled = !1, this.conversions = this.widget.conversions, this.currentLocation = this.widget.currentLocation, this.formats = this.widget.formats, this.goToOverride = this.widget.goToOverride, this.headingLevel = this.widget.headingLevel, this.hideCaptureButton = this.widget.visibleElements.captureButton, this.hideEditButton = this.widget.visibleElements.editButton, this.hideExpandButton = this.widget.visibleElements.expandButton, this.hideSettingsButton = this.widget.visibleElements.settingsButton, this.icon = this.widget.icon, this.label = this.widget.label, this.locationSymbol = this.widget.locationSymbol, this.mode = this.widget.mode, this.multipleConversionsDisabled = this.widget.multipleConversions, this.orientation = this.widget.orientation, this.position = "bottom-left", this.state = this.viewModel.state, this.storageDisabled = this.widget.storageEnabled, this.storageType = this.widget.storageType, this.arcgisPropertyChange = s()("currentLocation", "state"), this.arcgisReady = r();
+    super(...arguments), this.widget = g(this), this.viewModel = this.widget.viewModel, this.autoDestroyDisabled = !1, this.conversions = this.widget.conversions, this.currentLocation = this.widget.currentLocation, this.formats = this.widget.formats, this.goToOverride = this.widget.goToOverride, this.headingLevel = this.widget.headingLevel, this.hideCaptureButton = this.widget.visibleElements.captureButton, this.hideInputButton = this.widget.visibleElements.inputButton, this.hideExpandButton = this.widget.visibleElements.expandButton, this.hideSettingsButton = this.widget.visibleElements.settingsButton, this.icon = this.widget.icon, this.label = this.widget.label, this.locationSymbol = this.widget.locationSymbol, this.mode = this.widget.mode, this.multipleConversionsDisabled = this.widget.multipleConversions, this.orientation = this.widget.orientation, this.position = "bottom-left", this.state = this.viewModel.state, this.storageDisabled = this.widget.storageEnabled, this.storageType = this.widget.storageType, this.arcgisPropertyChange = s()("currentLocation", "state"), this.arcgisReady = r();
   }
   static {
-    this.properties = { autoDestroyDisabled: 5, conversions: 0, currentLocation: 0, formats: 0, goToOverride: 0, headingLevel: 9, hideCaptureButton: 5, hideEditButton: 5, hideExpandButton: 5, hideSettingsButton: 5, icon: 1, label: 1, locationSymbol: 0, mode: 1, multipleConversionsDisabled: 5, orientation: 1, position: 1, referenceElement: 1, state: 3, storageDisabled: 5, storageType: 1 };
+    this.properties = { autoDestroyDisabled: 5, conversions: 0, currentLocation: 0, formats: 0, goToOverride: 0, headingLevel: 9, hideCaptureButton: 5, hideInputButton: 5, hideExpandButton: 5, hideSettingsButton: 5, icon: 1, label: 1, locationSymbol: 0, mode: 1, multipleConversionsDisabled: 5, orientation: 1, position: 1, referenceElement: 1, state: 3, storageDisabled: 5, storageType: 1 };
   }
   static {
     this.shadowRootOptions = a;

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

@@ -27,7 +27,16 @@ declare const useDaylightWidget: (component: LitElement & Pick<Daylight, "icon"
     destroy: () => Promise<void>;
 }) => Daylight;
 /**
- * The Daylight component can be used to manipulate the lighting conditions of a [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html).
+ * The Daylight component can be used to manipulate the lighting conditions of a [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/).
+ *
+ * **Known limitations**
+ *
+ * Daylight is only supported in a 3D [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/) component.
+ *
+ * **See also**
+ *
+ * - [Environment](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#environment)
+ * - [Sample - Daylight component](https://developers.arcgis.com/javascript/latest/sample-code/daylight/)
  *
  * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-daylight/)
  */
@@ -49,7 +58,9 @@ export declare class ArcgisDaylight extends LitElement {
      */
     currentSeason: "spring" | "summer" | "fall" | "winter";
     /**
-     * Controls whether the widget displays a date or a season picker.
+     * Controls whether the component displays a date or a season picker.
+     *
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Daylight.html#dateOrSeason)
      *
      * @default "date"
      */
@@ -63,7 +74,7 @@ export declare class ArcgisDaylight extends LitElement {
      */
     dayPlaying: boolean;
     /**
-     * Indicates the heading level to use for the widget title.
+     * Indicates the heading level to use for the component title.
      *
      * @default 3
      */
@@ -81,17 +92,14 @@ export declare class ArcgisDaylight extends LitElement {
     /** @default false */
     hideTimezone: boolean | undefined;
     /**
-     * Icon which represents the widget.
+     * Icon which represents the component. Typically used when the component is controlled by another component (e.g. by the Expand component).
+     *
+     * See also: [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
      *
-     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
      * @default "brightness"
      */
     icon: string;
-    /**
-     * The widget's default label.
-     *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Daylight.html#label)
-     */
+    /** The component's default label. */
     label: string;
     /**
      * Controls the speed of the daytime and date animation.
@@ -101,10 +109,16 @@ export declare class ArcgisDaylight extends LitElement {
     playSpeedMultiplier: number;
     /** @default "bottom-left" */
     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;
     /**
-     * Sets steps, or intervals, on the time slider to restrict the times
-     * of the day that can be selected when dragging the thumb.
+     * Sets steps, or intervals, on the time slider to restrict the times of the day that can be selected when dragging the thumb.
+     *
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Daylight.html#timeSliderSteps)
      *
      * @default 5
      */
@@ -122,7 +136,7 @@ export declare class ArcgisDaylight extends LitElement {
     /** Emitted when the component associated with a map or scene view is is ready to be interacted with. */
     readonly arcgisReady: TargetedEvent<this, void>;
     /**
-     * Fires when the user changes the date or time in the widget by interacting with the slider, the date picker, the
+     * Fires when the user changes the date or time in the component by interacting with the slider, the date picker, the
      * season selector or the play buttons.
      *
      * @since 4.33

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

@@ -2,11 +2,11 @@ import { c as e } from "../../chunks/runtime.js";
 import i from "@arcgis/core/widgets/Daylight.js";
 import { LitElement as t, createEvent as s, noShadowRoot as a } from "@arcgis/lumina";
 import { m as h } from "../../chunks/useWidget.js";
-import { css as l } from "@lit/reactive-element/css-tag.js";
+import { css as l } from "lit";
 import { reEmitEvent as o } from "@arcgis/lumina/controllers/accessor";
 /*! 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.5 */
+v4.34.0-next.50 */
 const d = l`@layer{arcgis-daylight{display:block}}`, r = h(i);
 class n extends t {
   constructor() {

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

@@ -1,6 +1,5 @@
 /// <reference types="@arcgis/core/interfaces.d.ts" />
 /// <reference types="../../index.d.ts" />
-import { default as DirectLineMeasurementAnalysis } from '@arcgis/core/analysis/DirectLineMeasurementAnalysis';
 import { PublicLitElement as LitElement, JsxNode, TargetedEvent } from '@arcgis/lumina';
 import { Use } from '@arcgis/lumina/controllers';
 import { ArcgisReferenceElement } from '../../utils/component-utils';
@@ -8,14 +7,96 @@ 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/)
  */
 export declare class ArcgisDirectLineMeasurement3d extends LitElement {
-    get analysis(): DirectLineMeasurementAnalysis;
+    /**
+     * 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
      * disconnected from the document. This is useful when you want to move the
@@ -38,15 +119,37 @@ export declare class ArcgisDirectLineMeasurement3d extends LitElement {
     label?: string;
     /** @default "bottom-left" */
     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" | "measuring" | "measured";
+    /**
+     * 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, {
@@ -56,7 +159,7 @@ export declare class ArcgisDirectLineMeasurement3d extends LitElement {
     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,11 +1,10 @@
 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 { css as g, html as v } from "lit";
+import { LitElement as f, createEvent as w, noShadowRoot as D, nothing as b, safeClassMap as M } from "@arcgis/lumina";
+import { usePropertyChange as O } from "@arcgis/lumina/controllers";
+import { u as U } from "../../chunks/useT9n.js";
+import { m as $ } 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";
@@ -15,8 +14,8 @@ import { A as C } from "../../chunks/AnalysisViewModel.js";
 import { g as c, m } from "../../chunks/measurementUtils.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.5 */
-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}}`;
+v4.34.0-next.50 */
+const z = g`@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);
@@ -131,23 +130,20 @@ r([
 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 {
+const x = "arcgis-direct-line-measurement-3d", T = { base: x }, R = $(i);
+class h extends f {
   constructor() {
-    super(...arguments), this.viewModel = R(this), this.messages = O({ name: "directline-measurement-3d", blocking: !0 }), 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 = R(this), this.messages = U({ 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 = O()("analysis", "state"), this.arcgisReady = w();
   }
   static {
-    this.properties = { analysis: 32, autoDestroyDisabled: 5, icon: 3, label: 1, position: 1, referenceElement: 1, state: 1, unit: 1, unitOptions: 0 };
+    this.properties = { analysis: 0, autoDestroyDisabled: 5, icon: 3, label: 1, position: 1, referenceElement: 1, state: 35, unit: 1, unitOptions: 0 };
   }
   static {
-    this.shadowRootOptions = w;
+    this.shadowRootOptions = D;
   }
   static {
     this.styles = z;
   }
-  get analysis() {
-    return this.viewModel.analysis;
-  }
   async clear() {
     this.viewModel.clear();
   }
@@ -159,7 +155,7 @@ class h extends v {
   }
   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({
+    return v`<div aria-label=${t.componentLabel ?? b} class=${M({
       [T.base]: !0,
       [d.widget]: !0,
       [d.panel]: !0

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

@@ -54,10 +54,19 @@ export declare class ArcgisDirectionalPad extends LitElement {
     icon?: string;
     /** The component's default label. */
     label?: string;
-    /** Replace localized message strings with your own strings. **Warning**: 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;
+    /**
+     * 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