@arcgis/map-components 4.34.0-next.4 → 4.34.0-next.40

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.34/esri/copyright.txt for details.
-v4.34.0-next.4 */
+v4.34.0-next.40 */
 const h = r`@layer{arcgis-floor-filter{display:block}}`, n = a(i);
 class c extends s {
   constructor() {

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

@@ -10,18 +10,34 @@ import { default as LinkChartView } from '@arcgis/core/views/LinkChartView.js';
 
 /**
  * The Fullscreen component allows users to toggle the map or scene to fullscreen mode.
+ * Use the escape key (`esc`) to exit fullscreen mode.
+ *
+ * **Known limitations**
+ *
+ * * The Fullscreen widget only works with browsers that implement the [Fullscreen](https://developer.mozilla.org/en-US/docs/Web/API/Fullscreen_API) API.
+ *   Thus, iOS Safari is not supported.
  *
  * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-fullscreen/)
  */
 export declare class ArcgisFullscreen extends LitElement {
     /** The [HTMLElement](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement) to present in fullscreen mode. */
-    element?: HTMLElement;
+    get element(): Element | undefined;
+    set element(value: Element | 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;
     /** @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;
     get state(): "active" | "disabled" | "ready" | "unsupported";
     /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
@@ -39,4 +55,7 @@ export declare class ArcgisFullscreen extends LitElement {
         enter: string;
         exit: string;
     }>;
+    readonly _setterTypes: {
+        element?: Element | string | undefined;
+    };
 }

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

@@ -1,32 +1,46 @@
-import { c } from "../../chunks/runtime.js";
-import { html as s } from "lit-html";
-import { usePropertyChange as o } from "@arcgis/lumina/controllers";
-import { classes as a } from "@arcgis/components-utils";
-import { LitElement as u, createEvent as m, safeClassMap as l, nothing as d } from "@arcgis/lumina";
-import { u as f } from "../../chunks/useT9n.js";
-import { g as n } from "../../chunks/globalCss.js";
-import { css as p } from "@lit/reactive-element/css-tag.js";
-import { u as h } from "../../chunks/useView.js";
+import { c as o } from "../../chunks/runtime.js";
+import { html as l } from "lit-html";
+import { usePropertyChange as a } from "@arcgis/lumina/controllers";
+import { closestElement as m, classes as u } from "@arcgis/components-utils";
+import { LitElement as d, createEvent as f, safeClassMap as i, nothing as h } from "@arcgis/lumina";
+import { u as p } from "../../chunks/useT9n.js";
+import { g as r } from "../../chunks/globalCss.js";
+import { css as g } from "@lit/reactive-element/css-tag.js";
+import { u as E } from "../../chunks/useView.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.4 */
-const g = p`arcgis-fullscreen{display:block}`, E = {
+v4.34.0-next.40 */
+const b = g`arcgis-fullscreen{display:block}`, y = {
   base: "esri-fullscreen"
 };
-class b extends u {
+function $(s) {
+  return s.includes("#") || s.includes(".") || s.includes("[") ? s : `#${s}`;
+}
+class v extends d {
   constructor() {
-    super(), this.messages = f(), this.view = h(this), this.position = "top-left", this.arcgisPropertyChange = o()("state"), this.arcgisReady = m(), this.listenOn(document, "fullscreenchange", () => this.fullscreenElement = document.fullscreenElement);
+    super(), this.messages = p(), this.view = E(this), this.position = "top-left", this.arcgisPropertyChange = a()("state"), this.arcgisReady = f(), this.listenOn(document, "fullscreenchange", () => this.fullscreenElement = document.fullscreenElement);
   }
   static {
-    this.properties = { fullscreenElement: 16, element: 0, label: 1, messageOverrides: 0, position: 3, referenceElement: 1, state: 35 };
+    this.properties = { fullscreenElement: 16, element: 1, label: 1, messageOverrides: 0, position: 3, referenceElement: 1, state: 35 };
   }
   static {
-    this.styles = g;
+    this.styles = b;
   }
   get fullscreenTitle() {
     const e = this.state;
     return e === "active" ? this.messages.exit : e === "ready" ? this.messages.enter : "";
   }
+  #e;
+  get element() {
+    return this.#e;
+  }
+  set element(e) {
+    if (typeof e == "string") {
+      const t = $(e), n = m(this.el, t);
+      this.#e = n || void 0;
+    } else
+      this.#e = e;
+  }
   get state() {
     if (!document.fullscreenEnabled)
       return "unsupported";
@@ -43,11 +57,11 @@ class b extends u {
     document.fullscreenElement ? document.exitFullscreen() : this._getElement()?.requestFullscreen();
   }
   render() {
-    const { fullscreenTitle: e, state: t } = this, r = t === "unsupported", i = t === "ready" || t === "disabled" || t === "unsupported" ? "zoom-out-fixed" : "zoom-in-fixed";
-    return s`<div class=${l(a(E.base, n.widget))}>${!r && s`<calcite-button class=${l(n.widgetButton)} .disabled=${t === "disabled"} .iconStart=${i} kind=neutral .label=${e} @click=${this._toggle} title=${e ?? d}></calcite-button>` || ""}</div>`;
+    const { fullscreenTitle: e, state: t } = this, n = t === "unsupported", c = t === "ready" || t === "disabled" || t === "unsupported" ? "zoom-out-fixed" : "zoom-in-fixed";
+    return l`<div class=${i(u(y.base, r.widget))}>${!n && l`<calcite-button class=${i(r.widgetButton)} .disabled=${t === "disabled"} .iconStart=${c} kind=neutral .label=${e} @click=${this._toggle} title=${e ?? h}></calcite-button>` || ""}</div>`;
   }
 }
-c("arcgis-fullscreen", b);
+o("arcgis-fullscreen", v);
 export {
-  b as ArcgisFullscreen
+  v as ArcgisFullscreen
 };

package/dist/components/arcgis-grid-controls/customElement.d.ts

@@ -24,6 +24,11 @@ declare const useGridControlsViewModel: (component: LitElement & Pick<GridContro
  * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-grid-controls/)
  */
 export declare class ArcgisGridControls extends LitElement {
+    /**
+     * 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;
     /** @default "bottom-right" */
     position: __esri.UIPosition;
@@ -211,7 +216,11 @@ export declare class ArcgisGridControls extends LitElement {
      * @default false
      */
     autoDestroyDisabled: boolean;
-    /** 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 component's default label. */
     label?: string;

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.34/esri/copyright.txt for details.
-v4.34.0-next.4 */
+v4.34.0-next.40 */
 function B(s) {
   if (s == null || Number.isNaN(s))
     return 0;

package/dist/components/arcgis-histogram-range-slider/customElement.d.ts

@@ -138,6 +138,11 @@ export declare class ArcgisHistogramRangeSlider extends LitElement {
      * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-HistogramRangeSlider.html#rangeType)
      */
     rangeType: "equal" | "not-equal" | "less-than" | "greater-than" | "at-most" | "at-least" | "between" | "not-between";
+    /**
+     * 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;
     /**
      * Indicates the standard deviation of the dataset.

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.34/esri/copyright.txt for details.
-v4.34.0-next.4 */
+v4.34.0-next.40 */
 const h = d`@layer{arcgis-histogram-range-slider{display:block}}`, l = n(s);
 class g extends a {
   constructor() {

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

@@ -7,11 +7,23 @@ import { ArcgisReferenceElement } from '../../utils/component-utils';
 
 declare const useHomeViewModel: (component: LitElement & Pick<HomeViewModel, never> & import('../../controllers/useViewModel').ViewModelControllerUses<HomeViewModel>) => HomeViewModel;
 /**
- * The Home component is a button that switches the view to its
+ * The Home component is a button that navigates back to the
  * initial [Viewpoint](https://developers.arcgis.com/javascript/latest/api-reference/esri-Viewpoint.html)
  * or a previously defined `viewpoint`.
  *
  * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-home/)
+ *
+ * @example
+ *  ```js
+ * // Create viewpoint centered on extent of a polygon geometry
+ *
+ * let vp = new Viewpoint({
+ *   targetGeometry: geom.extent
+ * });
+ *
+ * // Sets the Home's viewpoint to that Viewpoint
+ * home.viewpoint = vp;
+ * ```
  */
 export declare class ArcgisHome extends LitElement {
     /**
@@ -42,10 +54,19 @@ export declare class ArcgisHome 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 "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 current state of the widget.
@@ -56,46 +77,48 @@ export declare class ArcgisHome extends LitElement {
      */
     readonly state: "ready" | "disabled" | "going-home";
     /**
-     * The esri/Viewpoint, or point of view, to zoom to when
-     * going home. The initial value is determined a few different ways:
+     * The [Viewpoint](https://developers.arcgis.com/javascript/latest/api-reference/esri-Viewpoint.html)
+     * to go to when going "home".
+     * The initial value is determined in a few different ways:
      *
-     * If no esri/views/View is provided, the value is `null`.
-     * If the esri/views/View is ready, but the esri/Viewpoint is not defined, the initial
-     * value of the esri/Viewpoint is determined when the esri/views/View became ready.
-     * If the esri/views/View is ready and the esri/Viewpoint is defined by the user, the initial viewpoint value is the user-defined esri/Viewpoint.
+     * If no referenceElement is provided, the value is `null`.
+     * Once the referenceElement is ready, the initial viewpoint value is the user-defined [Viewpoint](https://developers.arcgis.com/javascript/latest/api-reference/esri-Viewpoint.html).
      *
      * @example
-     * // Creates a viewpoint centered on the extent of a polygon geometry
+     *  ```js
+     * // Create viewpoint centered on extent of a polygon geometry
+     *
      * let vp = new Viewpoint({
      *   targetGeometry: geom.extent
      * });
      *
-     * // Sets the model's viewpoint to the Viewpoint based on a polygon geometry
+     * // Sets the Home's viewpoint to that Viewpoint
      * home.viewpoint = vp;
+     * ```
      * @default null
      */
     viewpoint: nullish | __esri.Viewpoint;
     /**
      * This function provides the ability to interrupt and cancel the process
-     * of navigating the view back to the view's initial extent.
-     *
-     * @since 4.9
+     * of navigating back to the initial extent.
      */
     cancelGo(): Promise<void>;
     /** Permanently destroy the component. */
     destroy(): Promise<void>;
     /**
-     * Animates the view to the initial Viewpoint of the view or the
-     * value of `viewpoint`
+     * Animates the map or scene to its initial Viewpoint or the
+     * value of `viewpoint`.
      */
     go(): Promise<void>;
     /**
      * Fires when the go() method is called.
      *
      * @example
-     * home.addEventListener("go", (event) => {
+     * ```js
+     * home.addEventListener("arcgisGo", (event) => {
      *   console.log("updating viewpoint");
      * });
+     * ```
      */
     readonly arcgisGo: TargetedEvent<this, __esri.HomeViewModelGoEvent>;
     /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */

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.34/esri/copyright.txt for details.
-v4.34.0-next.4 */
+v4.34.0-next.40 */
 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.34/esri/copyright.txt for details.
-v4.34.0-next.4 */
+v4.34.0-next.40 */
 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.d.ts

@@ -155,6 +155,11 @@ export declare class ArcgisLayerList extends LitElement {
     get operationalItems(): __esri.Collection<__esri.ListItem>;
     /** @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 [ListItem](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList-ListItem.html)s representing operational layers

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.34/esri/copyright.txt for details.
-v4.34.0-next.4 */
+v4.34.0-next.40 */
 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.34/esri/copyright.txt for details.
-v4.34.0-next.4 */
+v4.34.0-next.40 */
 const D = {
   hideChildren: "hide-children"
 };

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

@@ -97,6 +97,11 @@ export declare class ArcgisLegend extends LitElement {
     legendStyle: string | __esri.LegendStyle;
     /** @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;
     /**
      * If a layer uses a unique value render, only features that satisfy the layer's

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.34/esri/copyright.txt for details.
-v4.34.0-next.4 */
+v4.34.0-next.40 */
 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

@@ -1,7 +1,6 @@
 /// <reference types="@arcgis/core/interfaces.d.ts" />
 /// <reference types="../../index.d.ts" />
 import { Use } from '@arcgis/lumina/controllers';
-import { default as LineOfSightAnalysis } from '@arcgis/core/analysis/LineOfSightAnalysis.js';
 import { PublicLitElement as LitElement, JsxNode, TargetedEvent } from '@arcgis/lumina';
 import { ArcgisReferenceElement } from '../../utils/component-utils';
 import { default as LineOfSightViewModel } from './LineOfSightViewModel';
@@ -10,28 +9,79 @@ 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 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;
+     * ```
      */
-    get analysis(): LineOfSightAnalysis;
+    analysis: __esri.LineOfSightAnalysis;
     /**
      * 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
@@ -52,10 +102,19 @@ export declare class ArcgisLineOfSight extends LitElement {
     icon?: HTMLCalciteIconElement["icon"];
     /** 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;
     /**
      * The component's state. The values mean the following:
@@ -68,18 +127,15 @@ export declare class ArcgisLineOfSight extends LitElement {
     get state(): "created" | "creating" | "disabled" | "ready";
     /** Clear the current analysis results. After calling this method, the user can set a new observer and targets. */
     clear(): Promise<void>;
-    /**
-     * After [stop()](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-line-of-sight/#stop)
-     * was called, this method allows to continue the line of sight analysis and add more targets.
-     */
+    /** After [stop()](#stop) was called, this method allows to continue the line of sight analysis and add more targets. */
     continue(): Promise<void>;
     /** Permanently destroy the component. */
     destroy(): Promise<void>;
     /** 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.34/esri/copyright.txt for details.
-v4.34.0-next.4 */
+v4.34.0-next.40 */
 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`,
@@ -22,8 +22,8 @@ const C = w`@layer{arcgis-line-of-sight{display:block}.arcgis-line-of-sight__con
   newAnalysisButton: `${a}__new-analysis-button`
 };
 var S = Object.defineProperty, D = Object.getOwnPropertyDescriptor, u = (t, e, i, o) => {
-  for (var s = o > 1 ? void 0 : o ? D(e, i) : e, d = t.length - 1, p; d >= 0; d--)
-    (p = t[d]) && (s = (o ? p(e, i, s) : p(s)) || s);
+  for (var s = o > 1 ? void 0 : o ? D(e, i) : e, d = t.length - 1, h; d >= 0; d--)
+    (h = t[d]) && (s = (o ? h(e, i, s) : h(s)) || s);
   return o && s && S(e, i, s), s;
 };
 let c = class extends M {
@@ -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([
@@ -52,10 +52,10 @@ c = u([
 const L = b(c);
 class V extends y {
   constructor() {
-    super(...arguments), this.viewModel = L(this), this._messages = $({ blocking: !0 }), this.view = this.viewModel.view, this.autoDestroyDisabled = !1, this.icon = "line-of-sight", this.position = "bottom-left", this.arcgisPropertyChange = m()("analysis", "state"), this.arcgisReady = v();
+    super(...arguments), this.viewModel = L(this), this._messages = $({ blocking: !0 }), this.view = this.viewModel.view, this.analysis = this.viewModel.analysis, this.autoDestroyDisabled = !1, this.icon = "line-of-sight", this.position = "bottom-left", this.arcgisPropertyChange = m()("analysis", "state"), this.arcgisReady = v();
   }
   static {
-    this.properties = { analysis: 32, autoDestroyDisabled: 5, icon: 3, label: 1, messageOverrides: 0, position: 1, referenceElement: 1, state: 32, _supported: 16 };
+    this.properties = { analysis: 0, autoDestroyDisabled: 5, icon: 3, label: 1, messageOverrides: 0, position: 1, referenceElement: 1, state: 35, _supported: 16 };
   }
   static {
     this.shadowRootOptions = _;
@@ -63,9 +63,6 @@ class V extends y {
   static {
     this.styles = C;
   }
-  get analysis() {
-    return this.viewModel.analysis;
-  }
   get state() {
     return this.viewModel.state;
   }
@@ -98,16 +95,16 @@ class V extends y {
     if (!this._supported)
       return l`<div class=${n(r.error)}><p>${this._messages.unsupported}</p></div>`;
     const e = this.viewModel.state, i = e === "creating";
-    return l`<div class=${n(r.container)}>${i ? l`<div class=${n(r.hint)}><p class=${n(r.hintText)}>${this._messages.hint}</p></div>` : null}<div class=${n(r.actions)}>${e === "creating" ? h({ onClick: () => {
+    return l`<div class=${n(r.container)}>${i ? l`<div class=${n(r.hint)}><p class=${n(r.hintText)}>${this._messages.hint}</p></div>` : null}<div class=${n(r.actions)}>${e === "creating" ? p({ onClick: () => {
       this.stop();
-    }, children: this._messages.done }) : null}${e === "created" ? h({ onClick: () => {
+    }, children: this._messages.done }) : null}${e === "created" ? p({ onClick: () => {
       this.continue();
-    }, children: this._messages.continueAnalysis }) : null}${h({ className: r.newAnalysisButton, onClick: () => {
+    }, children: this._messages.continueAnalysis }) : null}${p({ className: r.newAnalysisButton, onClick: () => {
       this.start();
     }, primary: !0, disabled: e === "disabled", children: this._messages.newAnalysis })}</div></div>`;
   }
 }
-function h({ className: t, onClick: e, primary: i, disabled: o, children: s }) {
+function p({ className: t, onClick: e, primary: i, disabled: o, children: s }) {
   return l`<calcite-button .appearance=${i ? "solid" : "outline-fill"} class=${n(t)} .disabled=${o} @click=${e}>${s}</calcite-button>`;
 }
 f("arcgis-line-of-sight", V);