@arcgis/map-components 4.33.0-next.163 → 4.33.0-next.165

package/dist/components/arcgis-basemap-gallery-item/customElement.js

@@ -8,7 +8,7 @@ import { c as i } from "../../chunks/basemap-gallery-resources.js";
 import { g as A } from "../../chunks/component-utils.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.163 */
+v4.33.0-next.165 */
 function _(e) {
   return e.portalItem?.type === "Web Scene" || e.referenceLayers.some((t) => t.type === "scene");
 }

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

@@ -8,7 +8,7 @@ import { css as h } from "@lit/reactive-element/css-tag.js";
 import { c as d } from "../../chunks/createCloseEvent.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.163 */
+v4.33.0-next.165 */
 const n = h`@layer{arcgis-basemap-layer-list{display:block}}`, c = o(s);
 class g extends r {
   constructor() {

package/dist/components/arcgis-basemap-toggle/customElement.js

@@ -11,7 +11,7 @@ import { g as $ } from "../../chunks/globalCss.js";
 import { css as L } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.163 */
+v4.33.0-next.165 */
 const A = L`@layer{arcgis-basemap-toggle{display:block}.esri-basemap-toggle__title-wrap{text-wrap:wrap}}`, s = "esri-basemap-toggle", o = "esri-basemap-thumbnail", e = {
   base: s,
   secondaryBasemapImage: `${s}__image--secondary`,

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

@@ -8,7 +8,7 @@ import { css as r } from "@lit/reactive-element/css-tag.js";
 import { c as d } from "../../chunks/createCloseEvent.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.163 */
+v4.33.0-next.165 */
 const n = r`@layer{arcgis-bookmarks{display:block}}`, m = h(s);
 class g extends o {
   constructor() {

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

@@ -74,6 +74,8 @@ export declare class ArcgisBuildingExplorer extends LitElement {
      * 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)
      */
     layers: __esri.Collection<__esri.BuildingSceneLayer>;
     /**

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

@@ -6,7 +6,7 @@ import { m as h } from "../../chunks/useWidget.js";
 import { css as r } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.163 */
+v4.33.0-next.165 */
 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.js

@@ -8,7 +8,7 @@ import { css as h } from "@lit/reactive-element/css-tag.js";
 import { c as d } from "../../chunks/createCloseEvent.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.163 */
+v4.33.0-next.165 */
 const c = h`@layer{arcgis-catalog-layer-list{display:block}}`, n = r(s);
 class g extends o {
   constructor() {

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

@@ -10,7 +10,7 @@ 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.33/esri/copyright.txt for details.
-v4.33.0-next.163 */
+v4.33.0-next.165 */
 const $ = y`@layer{arcgis-compass{display:block}}`, r = "esri-compass", a = {
   base: r,
   iconContainer: `${r}__icon-container`

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

@@ -6,7 +6,7 @@ import { m as d } from "../../chunks/useWidget.js";
 import { css as h } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.163 */
+v4.33.0-next.165 */
 const l = h`@layer{arcgis-coordinate-conversion{display:block}}`, g = d(o);
 class c extends n {
   constructor() {

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

@@ -33,6 +33,11 @@ declare const useDaylightWidget: (component: LitElement & Pick<Daylight, "icon"
  *
  * 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/)
  */
 export declare class ArcgisDaylight extends LitElement {
@@ -55,6 +60,8 @@ export declare class ArcgisDaylight extends LitElement {
     /**
      * 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"
      */
     dateOrSeason: "date" | "season";
@@ -109,8 +116,9 @@ export declare class ArcgisDaylight extends LitElement {
      */
     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
      */

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

@@ -6,7 +6,7 @@ import { css as l } from "@lit/reactive-element/css-tag.js";
 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.33/esri/copyright.txt for details.
-v4.33.0-next.163 */
+v4.33.0-next.165 */
 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

@@ -7,9 +7,8 @@ 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.
- * 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.
+ * 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/)
  *
@@ -23,22 +22,21 @@ declare const useViewModel: (component: LitElement & Pick<DirectLineMeasurement3
  * 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).
  *
- * DirectLineMeasurement3D widget visualizes and labels the direct, horizontal, and vertical distances and displays the same values
+ * 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 widget is active, a horizontal "laser" line is drawn which indicates the height at the current mouse position.
+ * 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.
  *
- * The 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/).
- *
  * **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),
@@ -63,9 +61,13 @@ export declare class ArcgisDirectLineMeasurement3d extends LitElement {
      * The [DirectLineMeasurementAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-DirectLineMeasurementAnalysis.html)
      * created or modified by the component.
      *
-     * If no programmatically created analysis is provided, the component automatically creates an empty analysis on its own and adds it to the view.
-     * In this case, the analysis will also be automatically removed from the view when the component is destroyed.
+     * 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.
@@ -88,7 +90,7 @@ export declare class ArcgisDirectLineMeasurement3d extends LitElement {
      * await viewElement.viewOnReady();
      * const directLineMeasurement3d = document.querySelector("arcgis-direct-line-measurement-3d");
      * await directLineMeasurement3d.componentOnReady();
-     * // Add the analysis to the view component.
+     * // Add the analysis to the Scene component.
      * viewElement.analyses.add(directLineAnalysis);
      * // Connect the analysis to the measurement component:
      * directLineMeasurement3d.analysis = directLineAnalysis;
@@ -138,10 +140,9 @@ export declare class ArcgisDirectLineMeasurement3d extends LitElement {
      */
     unit: __esri.SystemOrLengthUnit;
     /**
-     * List of available units and unit systems (imperial, metric) for displaying the distance values.
-     * By default, the following units are included: `metric`, `imperial`, `square-inches`, `square-feet`, `square-us-feet`, `square-yards`, `square-miles`, `square-meters`, `square-kilometers`, `acres`, `ares`, `hectares`.
+     * 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.
-     * With this, it is possible to limit which options are shown in the component's dropdown.
      */
     unitOptions: __esri.SystemOrLengthUnit[];
     /** Clears the current measurement. */

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

@@ -15,7 +15,7 @@ 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.33/esri/copyright.txt for details.
-v4.33.0-next.163 */
+v4.33.0-next.165 */
 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--)

package/dist/components/arcgis-directional-pad/customElement.js

@@ -14,7 +14,7 @@ import { g as h } from "../../chunks/globalCss.js";
 import { css as M } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.163 */
+v4.33.0-next.165 */
 const u = [-45, 0, 45, -90, 90, -135, 180, 135], S = {
   0: { label: "north", iconName: "chevron-up" },
   45: { label: "northEast", iconName: "chevron-up-right" },

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

@@ -9,7 +9,7 @@ import { e as u } from "../../chunks/component-utils.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.33/esri/copyright.txt for details.
-v4.33.0-next.163 */
+v4.33.0-next.165 */
 const c = y`@layer{arcgis-directions{display:block}}`, g = m(d), i = "map-components:arcgis-directions";
 class p extends n {
   constructor() {

package/dist/components/arcgis-distance-measurement-2d/customElement.js

@@ -6,7 +6,7 @@ import { m as n } from "../../chunks/useWidget.js";
 import { css as r } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.163 */
+v4.33.0-next.165 */
 const c = r`@layer{arcgis-distance-measurement-2d{display:block}}`, h = n(e);
 class d extends i {
   constructor() {

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

@@ -6,7 +6,7 @@ import { m as n } from "../../chunks/useWidget.js";
 import { css as r } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.163 */
+v4.33.0-next.165 */
 const g = r`@layer{arcgis-editor{display:block}}`, d = n(s);
 class h extends o {
   constructor() {

package/dist/components/arcgis-elevation-profile/customElement.d.ts

@@ -29,6 +29,10 @@ declare const useElevationProfileWidget: (component: LitElement & Pick<Elevation
 /**
  * The Elevation Profile component 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).
  *
+ * **See also**
+ *
+ * - [Sample - Elevation Profile component](https://developers.arcgis.com/javascript/latest/sample-code/elevation-profile/)
+ *
  * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-elevation-profile/)
  */
 export declare class ArcgisElevationProfile extends LitElement {
@@ -84,7 +88,9 @@ export declare class ArcgisElevationProfile extends LitElement {
      */
     icon: string;
     /**
-     * The input line graphic along which elevation will be queried in order to generate an elevation profile.
+     * The input path along which elevation will be queried in order to generate an elevation profile.
+     *
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ElevationProfile.html#input)
      *
      * @default null
      */
@@ -93,7 +99,11 @@ export declare class ArcgisElevationProfile extends LitElement {
     label: string;
     /** @default "bottom-left" */
     position: __esri.UIPosition;
-    /** Collection of elevation profile lines which are to be generated and displayed in the component's chart. */
+    /**
+     * Collection of elevation profile lines which are to be generated and displayed in the component's chart.
+     *
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ElevationProfile.html#profiles)
+     */
     profiles: __esri.Collection<__esri.ElevationProfileLineGround | __esri.ElevationProfileLineInput | __esri.ElevationProfileLineQuery | __esri.ElevationProfileLineView>;
     /**
      * The progress, between 0 and 1 of generating all the configured elevation
@@ -143,7 +153,9 @@ export declare class ArcgisElevationProfile extends LitElement {
     unitOptions: __esri.SystemOrLengthUnit[];
     /** Permanently destroy the component. */
     destroy(): Promise<void>;
+    /** Switches to the "creating" state in which the user can draw a new line. */
     start(): Promise<void>;
+    /** Stops the creation operation. */
     stop(): Promise<void>;
     /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
     readonly arcgisPropertyChange: TargetedEvent<this, {

package/dist/components/arcgis-elevation-profile/customElement.js

@@ -6,7 +6,7 @@ import { m as n } from "../../chunks/useWidget.js";
 import { css as l } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.163 */
+v4.33.0-next.165 */
 const r = l`@layer{arcgis-elevation-profile{display:block}}`, a = n(e);
 class d extends s {
   constructor() {

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

@@ -5,7 +5,7 @@ import { m as a } from "../../chunks/useWidget.js";
 import { css as n } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.163 */
+v4.33.0-next.165 */
 const d = n`@layer{arcgis-expand{display:flex;pointer-events:auto}arcgis-expand>.esri-expand__content--expanded{background-color:var(--calcite-color-background)}}`, c = a(e);
 class l extends s {
   constructor() {

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

@@ -6,7 +6,7 @@ import { m as h } from "../../chunks/useWidget.js";
 import { css as l } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.163 */
+v4.33.0-next.165 */
 const r = l`@layer{arcgis-feature{display:block}}`, c = h(n);
 class m extends a {
   constructor() {

package/dist/components/arcgis-feature-form/customElement.js

@@ -7,7 +7,7 @@ import { m as h } from "../../chunks/useWidget.js";
 import { css as m } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.163 */
+v4.33.0-next.165 */
 const l = m`@layer{arcgis-feature-form{display:block}}`, g = h(s);
 class n extends r {
   constructor() {

package/dist/components/arcgis-feature-table/customElement.js

@@ -9,7 +9,7 @@ import { e as m, g as c } from "../../chunks/component-utils.js";
 import { css as u } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.163 */
+v4.33.0-next.165 */
 const w = u`@layer{arcgis-feature-table{display:block}.arcgis-feature-table{width:100%;height:100%}}`, p = g(a);
 class b extends d {
   constructor() {

package/dist/components/arcgis-feature-templates/customElement.js

@@ -7,7 +7,7 @@ import { m as a } from "../../chunks/useWidget.js";
 import { css as h } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.163 */
+v4.33.0-next.165 */
 const n = h`@layer{arcgis-feature-templates{display:block}}`, c = a(s);
 class d extends o {
   constructor() {

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

@@ -8,7 +8,7 @@ import { css as l } from "@lit/reactive-element/css-tag.js";
 import { c } from "../../chunks/createCloseEvent.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.163 */
+v4.33.0-next.165 */
 const g = l`@layer{arcgis-features{display:flex;flex-direction:column;overflow:hidden;.esri-features{flex:1 1 auto;overflow:hidden}}}`, u = d(o);
 class w extends r {
   constructor() {

package/dist/components/arcgis-floor-filter/customElement.js

@@ -5,7 +5,7 @@ import { m as a } from "../../chunks/useWidget.js";
 import { css as r } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.163 */
+v4.33.0-next.165 */
 const h = r`@layer{arcgis-floor-filter{display:block}}`, n = a(i);
 class c extends s {
   constructor() {

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

@@ -9,7 +9,7 @@ import { css as p } from "@lit/reactive-element/css-tag.js";
 import { u as h } from "../../chunks/useView.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.163 */
+v4.33.0-next.165 */
 const g = p`arcgis-fullscreen{display:block}`, E = {
   base: "esri-fullscreen"
 };

package/dist/components/arcgis-grid-controls/customElement.js

@@ -15,7 +15,7 @@ import { watch as D } from "@arcgis/core/core/reactiveUtils.js";
 import L from "@arcgis/core/widgets/support/GridControls/GridControlsViewModel.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.163 */
+v4.33.0-next.165 */
 function B(s) {
   if (s == null || Number.isNaN(s))
     return 0;

package/dist/components/arcgis-histogram-range-slider/customElement.js

@@ -6,7 +6,7 @@ import { m as n } from "../../chunks/useWidget.js";
 import { css as d } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.163 */
+v4.33.0-next.165 */
 const h = d`@layer{arcgis-histogram-range-slider{display:block}}`, l = n(s);
 class g extends a {
   constructor() {

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

@@ -11,7 +11,7 @@ import { g as a } from "../../chunks/globalCss.js";
 import { css as u } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.163 */
+v4.33.0-next.165 */
 const b = u`@layer{arcgis-home{display:block}}`, y = {
   base: "esri-home"
 }, M = f(d);

package/dist/components/arcgis-labeled-switch/customElement.js

@@ -6,7 +6,7 @@ import { LitElement as m, createEvent as b, safeClassMap as c } from "@arcgis/lu
 import { css as f } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.163 */
+v4.33.0-next.165 */
 const g = f`.label{--calcite-label-margin-bottom: 0}.label-content{display:flex;flex:1;gap:var(--calcite-spacing-sm);align-items:center;text-wrap:balance}.label-content>div{flex-grow:1}.icon{margin-top:-1px;&.info{color:var(--calcite-color-status-info)}&.warning{color:var(--calcite-color-status-warning)}}.tooltip{text-wrap:wrap}`, e = {
   label: "label",
   labelContent: "label-content",

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

@@ -8,7 +8,7 @@ import { s as n } from "../../chunks/layer-list.js";
 import { c as g } from "../../chunks/createCloseEvent.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.163 */
+v4.33.0-next.165 */
 const c = d(a);
 class m extends r {
   constructor() {

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

@@ -10,7 +10,7 @@ import { s as E } from "../../chunks/layer-list.js";
 import { u as x } from "../../chunks/useT9n.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.163 */
+v4.33.0-next.165 */
 const D = {
   hideChildren: "hide-children"
 };

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

@@ -6,7 +6,7 @@ import { m as o } from "../../chunks/useWidget.js";
 import { css as n } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.163 */
+v4.33.0-next.165 */
 const l = n`@layer{arcgis-legend{display:block}}`, d = o(i);
 class h extends s {
   constructor() {

package/dist/components/arcgis-line-of-sight/customElement.d.ts

@@ -9,30 +9,77 @@ declare const useViewModel: (component: LitElement & Pick<LineOfSightViewModel,
 /**
  * The Line Of Sight component is a 3D analysis tool that allows you to perform
  * [line of sight visibility analysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-LineOfSightAnalysis.html)
- * in a 3D view. Visibility between a given observer and multiple target points is calculated against the currently
- * displayed content in the view, including ground, integrated meshes, and 3D objects such as buildings or trees.
+ * in a [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/). Visibility between a given observer and multiple target points is calculated against the currently
+ * displayed content in the view, including the ground, integrated meshes, and 3D objects such as buildings or trees.
  *
- * The results from the analysis are displayed as lines, where the visible part, indicating what the observer can see,
- * is colored green. Visible targets are displayed with a green sphere and a fully green line of sight.
- * The spheres marking occluded targets are displayed red, as are the occluded parts of the lines of sight.
+ * ![line-of-sight](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/line-of-sight.png)
+ *
+ * The analysis results are displayed as colored lines, where areas visible to the observer are
+ * shown green and occluded parts are marked in red. Also, the color of the target points indicates their visibility.
  * When the line of sight cannot be calculated, it will be displayed with a gray color. This may happen if either
  * the target or the observer is not in the view.
  *
- * When creating a new line of sight analysis with the component, the first click in the scene creates the
+ * When creating a new line of sight analysis, the first click in the Scene creates the
  * [observer](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-LineOfSightAnalysisObserver.html)
- * and any further clicks place the [targets](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-LineOfSightAnalysisTarget.html).
- * Both, observer and target points, can be moved by dragging them. Additionally, the target points can be removed with a right click.
+ * and subsequent clicks place the [targets](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-LineOfSightAnalysisTarget.html).
+ * Both the observer and target points can be moved by dragging. Additionally, the target points can be removed with a right click.
  *
- * **Known limitations**
+ * **Known limitation**
  *
  * Line Of Sight is only supported in a 3D [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/) component.
  *
+ * **See also**
+ *
+ * - [LineOfSightAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-LineOfSightAnalysis.html)
+ * - [Sample - Line of sight component](https://developers.arcgis.com/javascript/latest/sample-code/line-of-sight/)
+ * - [Sample - Analysis objects](https://developers.arcgis.com/javascript/latest/sample-code/analysis-objects/)
+ *
  * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-line-of-sight/)
  */
 export declare class ArcgisLineOfSight extends LitElement {
     /**
-     * The [line of sight analysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-LineOfSightAnalysis.html)
-     * object being created by the component.
+     * The [LineOfSightAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-LineOfSightAnalysis.html)
+     * created or modified by the component.
+     *
+     * When connecting the Line Of Sight 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 lineOfSightAnalysis = new LineOfSightAnalysis({
+     *   observer: new LineOfSightAnalysisObserver({
+     *         position: new Point({
+     *         spatialReference: { latestWkid: 3857, wkid: 102100 },
+     *         x: -13624828.3377593,
+     *         y: 4550305.319405007,
+     *         z: 105.55410975124687
+     *         }),
+     *   }),
+     *   targets: [ new LineOfSightAnalysisTarget({
+     *         position: new Point({
+     *         spatialReference: { latestWkid: 3857, wkid: 102100 },
+     *         x: -13624944.17687458,
+     *         y: 4550420.577689567,
+     *         z: 0
+     *         }),
+     *   })
+     * ]
+     * });
+     * // Get the Scene and Line Of Sight component and wait until they are ready.
+     * const viewElement = document.querySelector("arcgis-scene");
+     * await viewElement.viewOnReady();
+     * const lineOfSight = document.querySelector("arcgis-line-of-sight");
+     * await lineOfSight.componentOnReady();
+     * // Add the analysis to the Scene component.
+     * viewElement.analyses.add(lineOfSightAnalysis);
+     * // Connect the analysis to the component:
+     * lineOfSight.analysis = lineOfSightAnalysis;
+     * ```
      */
     analysis: __esri.LineOfSightAnalysis;
     /**
@@ -87,8 +134,8 @@ export declare class ArcgisLineOfSight extends LitElement {
     /** Start a new line of sight analysis. */
     start(): Promise<void>;
     /**
-     * Stop the current line of sight analysis, keeping the results in the view.
-     * Users can still interact with existing targets and the observer but they cannot place new target points.
+     * Stop the current placing of line of sight analysis. Any lines added this far are kept  in the view.
+     * Users can still interact with existing targets and the observer, but they cannot place new target points.
      */
     stop(): Promise<void>;
     /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */

package/dist/components/arcgis-line-of-sight/customElement.js

@@ -11,7 +11,7 @@ import x from "@arcgis/core/analysis/LineOfSightAnalysis.js";
 import { property as O, subclass as A } from "@arcgis/core/core/accessorSupport/decorators.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.163 */
+v4.33.0-next.165 */
 const C = w`@layer{arcgis-line-of-sight{display:block}.arcgis-line-of-sight__container{display:flex;position:relative;flex-flow:column;gap:var(--calcite-spacing-md);padding:var(--esri-widget-padding);overflow-y:auto}.arcgis-line-of-sight__error{color:var(--calcite-color-status-danger)}.arcgis-line-of-sight__hint{display:flex;flex-direction:column;gap:var(--calcite-spacing-md)}.arcgis-line-of-sight__error,.arcgis-line-of-sight__hint{overflow:hidden;animation:arcgis-line-of-sight-fade-in .25s ease-in-out;p{margin:0;padding:0}}.arcgis-line-of-sight__actions{display:flex;flex-flow:column;gap:var(--calcite-spacing-xxs);justify-content:center}@keyframes arcgis-line-of-sight-fade-in{0%{opacity:0}25%{opacity:0}to{opacity:1}}}`, a = "arcgis-line-of-sight", r = {
   base: a,
   actions: `${a}__actions`,
@@ -40,7 +40,7 @@ let c = class extends M {
     this.analysis.observer = null, this.analysis.targets.removeAll();
   }
   async place(t) {
-    return await this.analysisView?.place(t);
+    await this.analysisView?.place(t);
   }
 };
 u([

package/dist/components/arcgis-link-chart/customElement.js

@@ -8,7 +8,7 @@ import { c as v, i as l } from "../../chunks/component-utils.js";
 import { css as m } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.163 */
+v4.33.0-next.165 */
 const g = m`@layer{arcgis-link-chart{display:block;height:100%;.esri-view{height:100%;width:100%}}}`, d = r(
   w,
   /**