@arcgis/map-components 4.34.0-next.9 → 4.34.0-next.91

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

@@ -1,20 +1,20 @@
 import { c as T } from "../../chunks/runtime.js";
-import { html as r } from "lit-html";
-import { classes as y } from "@arcgis/components-utils";
+import { html as r } from "lit";
+import { classes as y } from "@arcgis/toolkit/dom";
 import { isLayerFromCatalog as S } from "@arcgis/core/layers/catalog/catalogUtils.js";
-import { LitElement as A, noShadowRoot as M, safeClassMap as h, nothing as o, safeStyleMap as w } from "@arcgis/lumina";
+import { LitElement as A, safeClassMap as h, nothing as o, safeStyleMap as M } from "@arcgis/lumina";
 import { createRef as _, ref as v } from "lit-html/directives/ref.js";
 import "lit/static-html.js";
-import { s as L } from "../../chunks/component-utils.js";
-import { s as E } from "../../chunks/layer-list.js";
-import { u as x } from "../../chunks/useT9n.js";
+import { s as w } from "../../chunks/component-utils.js";
+import { s as L } from "../../chunks/layer-list.js";
+import { u as E } 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.9 */
-const D = {
+v4.34.0-next.91 */
+const x = {
   hideChildren: "hide-children"
 };
-function O({
+function D({
   exclusive: n,
   visible: e,
   visibilityAppearance: t
@@ -22,37 +22,37 @@ function O({
   const i = t === "checkbox";
   return e ? n ? "circle-f" : i ? "check-square-f" : "view-visible" : n ? "circle" : i ? "square" : "view-hide";
 }
-function R({
+function O({
   connectionStatus: n,
   publishing: e
 }) {
   return n ? n === "connected" ? "beacon" : "offline" : e ? "square" : "bullet-point";
 }
+function R(n) {
+  return n?.listMode === x.hideChildren;
+}
 function P(n) {
-  return n?.listMode === D.hideChildren;
+  const e = (n?.layer && F(n.layer) ? n.layer.layer : void 0) ?? n?.layer;
+  return e ? e.type === "catalog" ? !1 : k(e) ?? !0 : !1;
 }
 function F(n) {
-  const e = (n?.layer && k(n.layer) ? n.layer.layer : void 0) ?? n?.layer;
-  return e ? e.type === "catalog" ? !1 : U(e) ?? !0 : !1;
-}
-function k(n) {
   return n != null && "layer" in n && n.layer != null;
 }
-function U(n) {
-  const e = V(n);
+function k(n) {
+  const e = U(n);
   return e != null && "supportsDynamicLayers" in e ? e.supportsDynamicLayers : void 0;
 }
-function V(n) {
+function U(n) {
   return n && "capabilities" in n && n.capabilities != null && "exportMap" in n.capabilities ? n.capabilities.exportMap : void 0;
 }
-function B(n) {
+function V(n) {
   return n?.getAttribute("data-item");
 }
-function G(n) {
+function B(n) {
   const { children: e, error: t } = n, i = "incompatible" in n ? n.incompatible : !1;
   return !!e?.filter((s) => !s.hidden).length && !t && !i;
 }
-function N(n) {
+function G(n) {
   for (const e of n)
     for (const t of e)
       if (t.type === "button" || t.type === "toggle")
@@ -74,26 +74,23 @@ function C(n) {
   if (!("image" in n && n.image) && !n.className)
     return "question";
 }
-function H(n) {
+function N(n) {
   return n ? {
     backgroundImage: `url(${n})`
   } : {};
 }
-class J extends A {
+class H extends A {
   constructor() {
-    super(...arguments), this._itemRef = _(), this._noticeRef = _(), this._messages = x({ name: "layer-list" }), this.hideCatalogLayerList = !1, this.showCloseButton = !1, this.showCollapseButton = !1, this.showErrors = !1, this.showFilter = !1, this.hideFlow = !1, this.showHeading = !1, this.hideStatusIndicators = !1, this.showTemporaryLayerIndicators = !1, this.showTemporaryTableIndicators = !1, this.dragEnabled = !1, this.listModeDisabled = !1, this.autoDestroyDisabled = !1;
+    super(...arguments), this._itemRef = _(), this._noticeRef = _(), this.messages = E(), this.hideCatalogLayerList = !1, this.showCloseButton = !1, this.showCollapseButton = !1, this.showErrors = !1, this.showFilter = !1, this.hideFlow = !1, this.showHeading = !1, this.hideStatusIndicators = !1, this.showTemporaryLayerIndicators = !1, this.showTemporaryTableIndicators = !1, this.dragEnabled = !1, this.listModeDisabled = !1, this.autoDestroyDisabled = !1;
   }
   static {
     this.properties = { _title: 16, _renderedItemStatus: 16, _renderedItemTemporaryIcon: 16, _renderedItemToggle: 16, _renderedPanel: 16, _renderedPanelAction: 16, _renderedActions: 16, _renderedActionMenu: 16, _renderedActionMenuContent: 16, _renderedCatalogFootprintIcon: 16, _renderedCatalogDynamicIcon: 16, _renderedCatalogSelectNode: 16, _renderedChildList: 16, _hasTables: 16, _renderedTablesItem: 16, _renderedItemMessage: 16, _singleAction: 16, _filteredSections: 16, _actionsCount: 16, activeItem: 0, canMove: 0, css: 0, displayMode: 1, hideCatalogLayerList: 5, showCloseButton: 5, showCollapseButton: 5, showErrors: 5, showFilter: 5, hideFlow: 5, showHeading: 5, hideStatusIndicators: 5, showTemporaryLayerIndicators: 5, showTemporaryTableIndicators: 5, dragEnabled: 5, item: 0, layerTablesEnabled: 0, listModeDisabled: 5, handleAction: 0, handlePanelOpen: 0, handleCatalogOpen: 0, handleTablesOpen: 0, handleSelectedDragItemLayerUidChange: 0, handleTooltipReferenceChange: 0, parent: 0, parentTitles: 0, rootGroupUid: 1, selectionMode: 1, selectedItems: 0, selectedDragItemLayerUid: 1, visibilityAppearance: 1, autoDestroyDisabled: 5 };
   }
   static {
-    this.styles = E;
-  }
-  static {
-    this.shadowRootOptions = M;
+    this.styles = L;
   }
   get _title() {
-    const { _messages: e } = this;
+    const { messages: e } = this;
     return this.item.title || ("untitledTable" in e ? e.untitledTable : e.untitledLayer);
   }
   get _renderedItemStatus() {
@@ -109,20 +106,20 @@ class J extends A {
       [s.connectionStatus]: u
     }, "connectionStatusConnected" in s && {
       [s.connectionStatusConnected]: u && l === "connected"
-    }))} .icon=${R({ connectionStatus: l, publishing: a })} scale=s slot=content-end></calcite-icon>`;
+    }))} .icon=${O({ connectionStatus: l, publishing: a })} scale=s slot=content-end></calcite-icon>`;
   }
   get _renderedItemTemporaryIcon() {
     const { item: e, showTemporaryLayerIndicators: t, showTemporaryTableIndicators: i, css: s } = this, { layer: a } = e, c = a && "persistenceEnabled" in a && (S(a) || !a.persistenceEnabled);
-    return (t || i) && c ? r`<calcite-icon class=${h(s.itemTemporaryIcon)} icon=temporary scale=s slot=content-start title=${this._messages.temporary ?? o}></calcite-icon>` : null;
+    return (t || i) && c ? r`<calcite-icon class=${h(s.itemTemporaryIcon)} icon=temporary scale=s slot=content-start title=${this.messages.temporary ?? o}></calcite-icon>` : null;
   }
   get _renderedItemToggle() {
-    const { item: e, parent: t, _messages: i, visibilityAppearance: s, css: a } = this;
+    const { item: e, parent: t, messages: i, visibilityAppearance: s, css: a } = this;
     if (!("visible" in e) || !("layerVisibility" in i) || !("visibleToggle" in a) || !s)
       return null;
     const { visible: c } = e, l = this._getParentVisibilityMode(t);
     if (l === "inherited")
       return null;
-    const u = O({
+    const u = D({
       visible: c,
       exclusive: l === "exclusive",
       visibilityAppearance: s
@@ -158,7 +155,7 @@ class J extends A {
     }
   }
   get _renderedActionMenu() {
-    const { item: e, _messages: t } = this, i = t.options;
+    const { item: e, messages: t } = this, i = t.options;
     return r`<calcite-action-menu appearance=transparent .label=${t.menu ?? ""} .open=${e.actionsOpen} overlay-positioning=fixed placement=bottom-end scale=s slot=actions-end @calciteActionMenuOpen=${this._onActionMenuOpen}><calcite-action appearance=transparent icon=ellipsis scale=s slot=trigger .text=${i ?? ""} title=${i ?? o}></calcite-action>${this._renderedActionMenuContent}</calcite-action-menu>`;
   }
   get _renderedActionMenuContent() {
@@ -186,7 +183,7 @@ class J extends A {
     const { dragEnabled: e, item: t, rootGroupUid: i, listModeDisabled: s, selectionMode: a, displayMode: c } = this;
     if (!("children" in t))
       return;
-    const l = [...this.parentTitles ?? [], t.title], { children: u, layer: d } = t, g = d?.type !== "catalog-dynamic-group" && G(t), f = s ? !1 : P(d), m = d?.type === "group", $ = !f && !g && e && m, b = e ? "childrenSortable" in t && t.childrenSortable && F(t) : !1;
+    const l = [...this.parentTitles ?? [], t.title], { children: u, layer: d } = t, g = d?.type !== "catalog-dynamic-group" && B(t), f = s ? !1 : R(d), m = d?.type === "group", $ = !f && !g && e && m, b = e ? "childrenSortable" in t && t.childrenSortable && P(t) : !1;
     return g || $ ? r`<calcite-list .canPull=${(p) => this.canMove ? this.canMove(p, "pull") : !1} .canPut=${(p) => this.canMove ? this.canMove(p, "put") : !1} data-item=${t ?? o} data-layer-type=${i ?? o} .displayMode=${c} .dragEnabled=${b} .group=${m ? i : `${i}-${d?.uid}`} .label=${t.title} selection-appearance=border .selectionMode=${a}>${u?.filter((p) => !p.hidden && (this.showErrors || !p.error)).toArray().map((p) => this._renderItem(p, t, l))}${this._renderedTablesItem}</calcite-list>` : null;
   }
   get _hasTables() {
@@ -204,16 +201,16 @@ class J extends A {
     }
   }
   get _renderedTablesItem() {
-    const { item: e, _messages: t, css: i } = this, { layer: s } = e;
+    const { item: e, messages: t, css: i } = this, { layer: s } = e;
     return "itemTableIcon" in i && "visible" in e && "tables" in t && this._hasTables ? r`<calcite-list-item class=${h(i.item)} data-layer-id=${s?.id ?? o} drag-disabled .label=${t.tables} title=${t.tables ?? o} @calciteListItemSelect=${() => this._triggerOnTablesOpen(e)}><calcite-icon class=${h(i.itemTableIcon)} icon=table scale=s slot=content-start></calcite-icon><calcite-icon flip-rtl icon=chevron-right scale=s slot=content-end></calcite-icon></calcite-list-item>` : null;
   }
   get _renderedItemMessage() {
-    const { item: e, _messages: t, css: i } = this;
+    const { item: e, messages: t, css: i } = this;
     return e.error ? r`<div class=${h(i.itemMessage)} slot=content-bottom><calcite-notice icon=exclamation-mark-triangle kind=warning open scale=s width=full><div slot=message>${"tableError" in t ? t.tableError : t.layerError}</div></calcite-notice></div>` : "incompatible" in e && e.incompatible && "layerIncompatible" in t ? r`<div class=${h(i.itemMessage)} slot=content-bottom><calcite-notice icon=exclamation-mark-triangle kind=warning open scale=s tabindex=0 width=full ${v(this._noticeRef)}><div slot=message>${t.layerIncompatible}</div></calcite-notice></div>` : null;
   }
   get _singleAction() {
     return this._renderAction({
-      action: N(this._filteredSections),
+      action: G(this._filteredSections),
       textEnabled: !1
     });
   }
@@ -251,7 +248,7 @@ class J extends A {
     e && this.handleCatalogOpen?.(e);
   }
   _focusSelectedDragEl(e, t) {
-    this.selectedDragItemLayerUid === t.layer?.uid && (L(e), this.handleSelectedDragItemLayerUidChange?.(null));
+    this.selectedDragItemLayerUid === t.layer?.uid && (w(e), this.handleSelectedDragItemLayerUidChange?.(null));
   }
   _handleCalciteListItemToggle(e, t) {
     e.stopPropagation(), t.open = e.target.expanded;
@@ -260,7 +257,7 @@ class J extends A {
     return e && "visibilityMode" in e ? e.visibilityMode : null;
   }
   _handleCalciteListItemSelect(e, t, i) {
-    if (B(e.target) !== t)
+    if (V(e.target) !== t)
       return;
     const s = this._getParentVisibilityMode(i);
     this.selectionMode !== "none" || s === "inherited" || this._toggleVisibility(t, i);
@@ -274,7 +271,7 @@ class J extends A {
     this._getParentVisibilityMode(t) === "exclusive" && e.visible || (e.visible = !e.visible);
   }
   render() {
-    const e = this.parentTitles ?? [], { _title: t, item: i, activeItem: s, selectionMode: a, selectedItems: c, _messages: l, parent: u, css: d } = this, g = "visibleAtCurrentTimeExtent" in i && "layerInvisibleAtTime" in l && !i.visibleAtCurrentTimeExtent ? `${t} (${l.layerInvisibleAtTime})` : "visibleAtCurrentScale" in i && "layerInvisibleAtScale" in l && !i.visibleAtCurrentScale ? `${t} (${l.layerInvisibleAtScale})` : t, f = "parent" in i && i.parent?.layer?.type === "catalog", { layer: m } = i, $ = "visibleAtCurrentScale" in i && !i.visibleAtCurrentScale || "visibleAtCurrentTimeExtent" in i && !i.visibleAtCurrentTimeExtent;
+    const e = this.parentTitles ?? [], { _title: t, item: i, activeItem: s, selectionMode: a, selectedItems: c, messages: l, parent: u, css: d } = this, g = "visibleAtCurrentTimeExtent" in i && "layerInvisibleAtTime" in l && !i.visibleAtCurrentTimeExtent ? `${t} (${l.layerInvisibleAtTime})` : "visibleAtCurrentScale" in i && "layerInvisibleAtScale" in l && !i.visibleAtCurrentScale ? `${t} (${l.layerInvisibleAtScale})` : t, f = "parent" in i && i.parent?.layer?.type === "catalog", { layer: m } = i, $ = "visibleAtCurrentScale" in i && !i.visibleAtCurrentScale || "visibleAtCurrentTimeExtent" in i && !i.visibleAtCurrentTimeExtent;
     return r`<calcite-list-item class=${h(y(d.item, "itemActive" in d && { [d.itemActive]: s === i }))} data-item=${i ?? o} data-layer-id=${m?.id ?? o} .dragDisabled=${!("sortable" in i && i.sortable) || f} id=${m?.uid ?? o} .label=${t} .metadata=${{ parentTitles: e, _title: t }} .expanded=${"open" in i && i.open} .selected=${a !== "none" ? c.includes(i) : !1} title=${g ?? o} .unavailable=${$} .value=${m?.uid} @calciteListItemSelect=${(b) => "visible" in i && this._handleCalciteListItemSelect(b, i, u)} @calciteListItemToggle=${(b) => "open" in i && this._handleCalciteListItemToggle(b, i)} ${v(this._itemRef)}>${this._renderedCatalogFootprintIcon}${this._renderedCatalogDynamicIcon}${this._renderedItemStatus}${this._renderedItemToggle}${this._renderedCatalogSelectNode}${this._renderedItemTemporaryIcon}${this._renderedChildList}${this._renderedItemMessage}${this._renderedPanel}${this._renderedPanelAction}${this._renderedActions}</calcite-list-item>`;
   }
   _renderAction(e) {
@@ -291,13 +288,13 @@ class J extends A {
     const s = "image" in e ? e.image : void 0, a = {
       [t.itemActionImage]: !!s
     };
-    return s ? r`<span aria-hidden=true class=${h(y(t.itemActionIcon, a))} style=${w(H(s))}></span>` : null;
+    return s ? r`<span aria-hidden=true class=${h(y(t.itemActionIcon, a))} style=${M(N(s))}></span>` : null;
   }
   _renderItem(e, t, i = []) {
     return r`<arcgis-layer-list-item .activeItem=${this.activeItem} .canMove=${this.canMove} .css=${this.css} .displayMode=${this.displayMode} .dragEnabled=${this.dragEnabled} .item=${e} .layerTablesEnabled=${this.layerTablesEnabled} .listModeDisabled=${this.listModeDisabled} .parent=${t} .parentTitles=${i} .rootGroupUid=${this.rootGroupUid} .selectedDragItemLayerUid=${this.selectedDragItemLayerUid} .selectedItems=${this.selectedItems} .selectionMode=${this.selectionMode} .visibilityAppearance=${this.visibilityAppearance} .handleAction=${this.handleAction} .handleCatalogOpen=${this.handleCatalogOpen} .handlePanelOpen=${this.handlePanelOpen} .handleSelectedDragItemLayerUidChange=${this.handleSelectedDragItemLayerUidChange} .handleTablesOpen=${this.handleTablesOpen} .handleTooltipReferenceChange=${this.handleTooltipReferenceChange} .hideCatalogLayerList=${this.hideCatalogLayerList} .showCloseButton=${this.showCloseButton} .showCollapseButton=${this.showCollapseButton} .showErrors=${this.showErrors} .showFilter=${this.showFilter} .hideFlow=${this.hideFlow} .showHeading=${this.showHeading} .hideStatusIndicators=${this.hideStatusIndicators} .showTemporaryLayerIndicators=${this.showTemporaryLayerIndicators} .showTemporaryTableIndicators=${this.showTemporaryTableIndicators}></arcgis-layer-list-item>`;
   }
 }
-T("arcgis-layer-list-item", J);
+T("arcgis-layer-list-item", H);
 export {
-  J as ArcgisLayerListItem
+  H as ArcgisLayerListItem
 };

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

@@ -1,5 +1,5 @@
 /// <reference types="@arcgis/core/interfaces.d.ts" />
-/// <reference types="../../index.d.ts" />
+/// <reference path="../../index.d.ts" />
 import { Use } from '@arcgis/lumina/controllers';
 import { default as Legend } from '@arcgis/core/widgets/Legend.js';
 import { PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
@@ -9,8 +9,8 @@ declare const useLegendWidget: (component: LitElement & Pick<Legend, "icon" | "l
     state?: unknown;
     viewModel?: __esri.LegendViewModel | undefined;
     closed?: boolean;
-    icon: import('@arcgis/components-utils').Nil | string;
-    label: import('@arcgis/components-utils').Nil | string;
+    icon: import('@arcgis/toolkit/type').nil | string;
+    label: import('@arcgis/toolkit/type').nil | string;
     referenceElement?: ArcgisReferenceElement | string;
     position: __esri.UIPosition;
     arcgisReady: import('@arcgis/lumina').EventEmitter;
@@ -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
@@ -129,7 +134,7 @@ export declare class ArcgisLegend extends LitElement {
     readonly arcgisPropertyChange: TargetedEvent<this, {
         name: "state";
     }>;
-    /** Emitted when the component associated with a map or scene view is is ready to be interacted with. */
+    /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
     readonly arcgisReady: TargetedEvent<this, void>;
 }
 export {};

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

@@ -1,31 +1,28 @@
 import { c as e } from "../../chunks/runtime.js";
-import { usePropertyChange as t } from "@arcgis/lumina/controllers";
-import i from "@arcgis/core/widgets/Legend.js";
-import { LitElement as s, createEvent as r, noShadowRoot as a } from "@arcgis/lumina";
-import { m as o } from "../../chunks/useWidget.js";
-import { css as n } from "@lit/reactive-element/css-tag.js";
+import { usePropertyChange as i } from "@arcgis/lumina/controllers";
+import r from "@arcgis/core/widgets/Legend.js";
+import { LitElement as t, createEvent as a } from "@arcgis/lumina";
+import { m as l } from "../../chunks/useWidget.js";
+import { css as o } 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.9 */
-const l = n`@layer{arcgis-legend{display:block}}`, d = o(i);
-class h extends s {
+v4.34.0-next.91 */
+const d = o`.esri-widget__heading{color:var(--calcite-color-text-2);margin:0 0 .5rem;font-weight:var(--calcite-font-weight-semibold)}h1.esri-widget__heading{font-size:var(--calcite-font-size-xl)}h2.esri-widget__heading{font-size:var(--calcite-font-size-md)}h3.esri-widget__heading,h4.esri-widget__heading,h5.esri-widget__heading,h6.esri-widget__heading{font-size:var(--calcite-font-size)}.esri-widget{--esri-widget-padding-x: 15px;--esri-widget-padding-y: var(--calcite-spacing-md);--esri-widget-padding: var(--esri-widget-padding-y) var(--esri-widget-padding-x);box-sizing:border-box;color:var(--calcite-color-text-2);background-color:var(--calcite-color-foreground-1);font-family:Avenir Next,Helvetica Neue,helvetica,arial,sans-serif;font-size:var(--calcite-font-size);line-height:1.3em}.esri-widget *,.esri-widget :before,.esri-widget :after{box-sizing:inherit}.esri-widget.esri-widget--disabled>*{opacity:.4;pointer-events:none}.esri-widget.esri-widget--compact{--esri-widget-padding-y: 0;--esri-widget-padding-x: 0}.esri-widget__anchor{color:var(--calcite-color-text-2)}.esri-widget__anchor:hover{color:var(--calcite-color-text-3)}.esri-widget__anchor:hover,.esri-widget__anchor:focus{text-decoration:underline}.esri-widget__anchor--disabled{opacity:.4;pointer-events:none}.esri-widget__header{background-color:var(--calcite-color-foreground-1);flex:1 0 100%;justify-content:space-between;align-items:center;width:100%;min-height:48px;padding:12px 0 12px 15px;display:flex}.esri-widget__header .esri-widget__heading{width:calc(100% - 48px);text-align:initial;color:var(--calcite-color-text-1);align-items:center;margin:0;padding:0;display:flex}.esri-widget__header-button{appearance:none;cursor:pointer;color:var(--calcite-color-text-2);background-color:var(--calcite-color-foreground-1);border:none;flex:0 0 48px;justify-content:center;align-self:stretch;align-items:center;width:48px;padding:0;display:flex}.esri-widget__footer{background-color:var(--calcite-color-foreground-1);justify-content:center;align-items:center;width:100%;min-height:48px;display:flex}.esri-widget__footer-pagination{color:var(--calcite-color-text-2);justify-content:space-between;align-items:center;display:flex}.esri-widget__footer-pagination-previous-button,.esri-widget__footer-pagination-next-button{cursor:pointer;background-color:var(--calcite-color-foreground-1);border:0;margin:0 7px;padding:12px 15px;transition:background-color .125s ease-in-out}.esri-widget__footer-pagination-previous-button:hover,.esri-widget__footer-pagination-previous-button:focus,.esri-widget__footer-pagination-next-button:hover,.esri-widget__footer-pagination-next-button:focus{color:var(--calcite-color-text-1);background-color:var(--calcite-color-foreground-1)}.esri-menu{visibility:hidden;z-index:1;background-clip:padding;background-color:var(--calcite-color-foreground-1);background-clip:padding-box;width:100%;max-height:0;margin:2px 0 0;padding:0;font-size:var(--calcite-font-size);line-height:var(--calcite-spacing-xl);position:absolute;top:100%;left:0;overflow:hidden;box-shadow:0 1px 2px #0000004d}.esri-menu .esri-menu__header{color:var(--calcite-color-text-inverse);background-color:var(--calcite-color-inverse);padding:6px 12px}.esri-menu__list{margin:0;padding:0;list-style:none}.esri-menu__list-item{cursor:pointer;border-top:1px solid #adadad4d;border-left:3px solid #0000;padding:.8em 1em}.esri-menu__list-item [class^=esri-icon-],.esri-menu__list-item [class*=" esri-icon-"]{padding-right:2.8px}.esri-menu__list-item:first-child{border-top:none}.esri-menu__list-item--focus,.esri-menu__list-item:hover,.esri-menu__list-item:focus{background-color:#303030}.esri-menu__list-item:active{background-color:#000}.esri-menu__list-item--active,.esri-menu__list-item--active:hover,.esri-menu__list-item--active:focus{background-color:var(--calcite-color-foreground-1);border-left-color:#2493f2}.esri-widget__table{border-collapse:collapse;color:var(--calcite-color-text-1);border:none;width:100%;line-height:1.3em}.esri-widget__table tr:nth-child(odd){background-color:var(--calcite-color-transparent)}.esri-widget__table tr:nth-child(2n){background-color:var(--calcite-color-transparent-press)}.esri-widget__table tr a{color:var(--calcite-color-text-2)}.esri-widget__table tr a:hover,.esri-widget__table tr a:focus{color:var(--calcite-color-text-1)}.esri-widget__table tr td,.esri-widget__table tr th{vertical-align:top;word-break:break-word;padding:.5em .7em;font-size:var(--calcite-font-size-sm);font-weight:var(--calcite-font-weight-regular)}.esri-widget__table tr th{text-align:left;border-right:3px solid #0000000d;width:50%}.esri-widget__table tr td{width:50%}.esri-input{color:var(--calcite-color-text-1);background-color:var(--calcite-color-foreground-1);border:1px solid #959595;font-size:var(--calcite-font-size)}.esri-input::-ms-clear{display:none}.esri-input::placeholder{opacity:1;color:var(--calcite-color-text-2)}.esri-input:placeholder-shown{text-overflow:ellipsis}.esri-input[type=text],.esri-input[type=password],.esri-input[type=number]{height:32px;padding:0 .5em}calcite-combobox.esri-input{border:none}.esri-widget__content--empty{text-align:center;color:var(--calcite-color-border-input);flex-flow:column wrap;align-items:center;padding:18px 22px;display:flex}.esri-widget__content--empty h1.esri-widget__heading,.esri-widget__content--empty h2.esri-widget__heading,.esri-widget__content--empty h3.esri-widget__heading,.esri-widget__content--empty h4.esri-widget__heading,.esri-widget__content--empty h5.esri-widget__heading{font-weight:var(--calcite-font-weight-regular)}.esri-widget__content-illustration--empty{width:128px;padding:1rem 0}.esri-widget__content-icon--empty{width:32px;padding:.5rem 0}.esri-select{appearance:none;cursor:pointer;color:var(--calcite-color-text-2);background:var(--calcite-color-foreground-1) url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='-8 -8 32 32' width='32' height='32'%3E%3Cpath d='M8 11.207l-4-4V5.793l4 4 4-4v1.414z' fill='%23adadad' fillrule='nonzero'/%3E%3C/svg%3E") 100% no-repeat;border:1px solid #959595;border-radius:0;width:100%;height:32px;margin:0;padding:0 .5em;font-family:inherit;font-size:.85em;display:block}.esri-select[disabled]{cursor:auto}.esri-select::-ms-expand{display:none}.esri-disabled a,.esri-disabled [role=menu],.esri-disabled [role=checkbox],.esri-disabled [class^=esri-icon-],.esri-disabled [class*=" esri-icon-"]{color:var(--calcite-color-text-3)}.keynav-mode .esri-widget:focus,.keynav-mode .esri-widget :focus{z-index:1;outline-offset:2px;outline:2px solid #adadad}.esri-widget__loader-animation{border:.15em solid #adadad4d;border-top-color:var(--calcite-color-border-input);border-radius:100%;width:1em;height:1em;font-size:var(--calcite-font-size-md);animation:1.25s linear infinite esri-rotate;display:block;transform:translateZ(0)}:dir(rtl) .esri-widget__table th{text-align:right;border-left:3px solid #0000000d;border-right:none}:dir(rtl) .esri-select{background-position:0}:dir(rtl) .esri-menu__list-item{border-left:none;border-right:3px solid #0000}:dir(rtl) .esri-menu__list-item [class^=esri-icon-],:dir(rtl) .esri-menu__list-item [class*=" esri-icon-"]{padding-left:2px;padding-right:0}:dir(rtl) .esri-menu__list-item--active{border-right-color:var(--calcite-color-brand)}.esri-icon-font-fallback-text{clip:rect(0 0 0 0);width:1px;height:1px;position:absolute;overflow:hidden}.esri-rotating{animation:1.25s linear infinite esri-rotate;transform:translateZ(0)}.esri-clearfix:before,.esri-clearfix:after{content:" ";display:table}.esri-clearfix:after{clear:both}.esri-interactive{cursor:pointer}.esri-hidden{display:none!important}.esri-invisible{visibility:hidden!important}.esri-offscreen{position:absolute;top:-999em;left:-999em}.esri-match-height{flex-direction:column;flex:auto;display:flex;overflow:hidden}:host{display:flex}.esri-legend{width:100%;overflow:hidden auto}.esri-legend__message{padding:.5em 1em}.esri-legend__service{padding:var(--esri-widget-padding);word-wrap:break-word;border-bottom:var(--calcite-border-width-sm) solid var(--calcite-color-border-2)}.esri-legend__service:last-child{border-bottom:none}.esri-legend__layer{margin-left:var(--calcite-spacing-sm);overflow:auto}.esri-legend__group-layer-child{margin-left:var(--calcite-spacing-sm);padding-left:0;padding-right:0}.esri-legend__layer-table{flex-flow:column;width:100%;margin-bottom:var(--calcite-spacing-md);display:flex}.esri-legend__layer-child-table{border-collapse:collapse;width:100%;margin-bottom:var(--calcite-spacing-md);display:table}.esri-legend__layer-body{margin-left:var(--calcite-spacing-sm)}.esri-legend__layer-row{display:flex}.esri-legend__layer-cell{vertical-align:middle;word-break:break-word;min-width:100px;padding:var(--calcite-spacing-xxs) 0}.esri-legend__layer-cell--symbols{text-align:center;min-width:10px}.esri-legend--card__color-ramp-container{justify-content:center}.esri-legend__layer-table--size-ramp{display:table}.esri-legend__layer-table--size-ramp .esri-legend__layer-row{display:table-row}.esri-legend__layer-table--size-ramp .esri-legend__layer-cell{display:table-cell}.esri-legend__size-ramp~.esri-legend__layer-cell--info{width:80%;max-width:80%}.esri-legend__layer-cell--info{word-break:normal;word-wrap:normal;max-width:250px;padding-left:var(--calcite-spacing-sm);padding-right:var(--calcite-spacing-sm);font-size:var(--calcite-spacing-md)}.esri-legend__imagery-layer-image--stretched{margin-bottom:-2px;display:block}.esri-legend__imagery-layer-cell--stretched{vertical-align:top;padding:0;line-height:1}.esri-legend__imagery-layer-info--stretched{vertical-align:top;padding:0 2px}.esri-legend__symbol{justify-content:center;display:flex}.esri-legend__layer-caption{word-break:break-word;padding:6px 0;display:table-caption}.esri-legend__ramp-labels{flex-flow:column;justify-content:space-between;display:flex}.esri-legend__ramps{margin-left:3px}.esri-legend__color-ramp{width:2var (--calcite-spacing-xxs)}.esri-legend__opacity-ramp{background-image:url(data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAgAAAAICAIAAABLbSncAAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAA2hpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0i77u/IiBpZD0iVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkIj8+IDx4OnhtcG1ldGEgeG1sbnM6eD0iYWRvYmU6bnM6bWV0YS8iIHg6eG1wdGs9IkFkb2JlIFhNUCBDb3JlIDUuMC1jMDYxIDY0LjE0MDk0OSwgMjAxMC8xMi8wNy0xMDo1NzowMSAgICAgICAgIj4gPHJkZjpSREYgeG1sbnM6cmRmPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5LzAyLzIyLXJkZi1zeW50YXgtbnMjIj4gPHJkZjpEZXNjcmlwdGlvbiByZGY6YWJvdXQ9IiIgeG1sbnM6eG1wTU09Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC9tbS8iIHhtbG5zOnN0UmVmPSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvc1R5cGUvUmVzb3VyY2VSZWYjIiB4bWxuczp4bXA9Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC8iIHhtcE1NOk9yaWdpbmFsRG9jdW1lbnRJRD0ieG1wLmRpZDowMTgwMTE3NDA3MjA2ODExODcxRkM3N0RBQzA4QkVDRSIgeG1wTU06RG9jdW1lbnRJRD0ieG1wLmRpZDpEOTY4RkNFNjM1MzYxMUU0ODlDMUFFQ0M2REU5QzFCNCIgeG1wTU06SW5zdGFuY2VJRD0ieG1wLmlpZDpEOTY4RkNFNTM1MzYxMUU0ODlDMUFFQ0M2REU5QzFCNCIgeG1wOkNyZWF0b3JUb29sPSJBZG9iZSBQaG90b3Nob3AgQ1M1LjEgTWFjaW50b3NoIj4gPHhtcE1NOkRlcml2ZWRGcm9tIHN0UmVmOmluc3RhbmNlSUQ9InhtcC5paWQ6MDE4MDExNzQwNzIwNjgxMTg3MUZDNzdEQUMwOEJFQ0UiIHN0UmVmOmRvY3VtZW50SUQ9InhtcC5kaWQ6MDE4MDExNzQwNzIwNjgxMTg3MUZDNzdEQUMwOEJFQ0UiLz4gPC9yZGY6RGVzY3JpcHRpb24+IDwvcmRmOlJERj4gPC94OnhtcG1ldGE+IDw/eHBhY2tldCBlbmQ9InIiPz6SLS5VAAAAKElEQVR42mI8c+YMAwwYGxvD2UwMOADpEoz///+Hc86ePUsLOwACDABC1ghwV8TLOQAAAABJRU5ErkJggg==)}.esri-legend__ramp-tick{border-top:var(--calcite-border-width-sm) solid var(--calcite-color-border-2);width:var(--calcite-spacing-xxs);line-height:0;position:absolute;left:auto;right:var(--calcite-border-width-sm)}.esri-legend__ramp-label{white-space:nowrap;padding:0 var(--calcite-spacing-sm);font-size:var(--calcite-spacing-md);line-height:1em;position:relative}.esri-legend__ramp-label:before{content:"";border:3px solid var(--calcite-color-transparent);border-left-width:0;border-right:4px solid var(--calcite-color-inverse);width:0;height:0;display:block;position:absolute;top:.25em;right:100%}.esri-legend__ramp-label:first-child{margin-top:-var(--calcite-spacing-xxs)}.esri-legend__ramp-label:last-child{bottom:-3px}.esri-legend-layer-caption{padding:6px 0;display:table-caption}:dir(rtl) .esri-legend__ramp-label:before{border-width:3px 0 3px var(--calcite-spacing-xxs);border-color:var(--calcite-color-border-2) var(--calcite-color-border-2) var(--calcite-color-border-2) var(--calcite-color-border-2);left:100%;right:auto}:dir(rtl) .esri-legend__layer,:dir(rtl) .esri-legend__group-layer-child,:dir(rtl) .esri-legend__layer-body{margin-left:0;margin-right:var(--calcite-spacing-sm);overflow:auto}:dir(rtl) .esri-legend__ramps{margin-left:auto;margin-right:3px}.esri-legend--card{background:var(--calcite-color-foreground-1);transition:max-width .25s ease-in-out;display:flex;position:relative;overflow-x:auto}.esri-legend--card__section{white-space:pre-wrap;word-break:break-word;word-wrap:break-word;border-left:var(--calcite-border-width-sm) solid var(--calcite-color-border-2);min-width:300px;padding:var(--calcite-spacing-md) 15px;font-size:var(--calcite-spacing-md);overflow:auto}.esri-legend--card__section:first-child{border-left:none}.esri-legend--card__message{padding:.5em 1em}.esri-legend--card__service-caption-container{border-bottom:var(--calcite-border-width-sm) solid var(--calcite-color-border-2);height:45px;padding:var(--calcite-spacing-md) 15px;font-weight:600}.esri-legend--card__service-caption-text{margin:0;padding-bottom:20px;overflow:auto}.esri-legend--card__layer-caption{margin-bottom:var(--calcite-spacing-md);padding:6px 0;font-weight:400}.esri-legend--card__service-content{height:calc(100% - 45px);display:flex}.esri-legend--card__label-container{flex-wrap:wrap;display:flex}.esri-legend--card__relationship-label-container{flex-direction:column;display:flex}.esri-legend--card__relationship-label-container .esri-legend--card__layer-row{padding-bottom:.5em}.esri-legend--card__relationship-label-container .esri-legend--card__layer-row:last-child{padding-bottom:0}.esri-legend--card__relationship-section{border:none}.esri-legend--card__label-element{text-align:center;min-width:4em;min-height:2.7em;margin:.1em;padding:.5em 1em}.esri-legend--card__image-label{padding-left:var(--calcite-spacing-sm);padding-right:var(--calcite-spacing-sm)}.esri-legend--card__layer-row,.esri-legend--card__size-ramp-container{align-items:center;display:flex}.esri-legend--card__size-ramp-preview{display:flex}.esri-legend--card__ramp-label{white-space:nowrap;margin:0 .5em}.esri-legend--card__pie-chart-ramp-preview{justify-content:center;display:flex}.esri-legend--card__interval-separator{text-align:center;font-size:.5em}.esri-legend--card__imagery-layer-image--stretched{margin-bottom:-2px;display:block}.esri-legend--card__symbol-container{position:relative}.esri-legend--card__interval-separators-container{position:absolute;top:50px;left:50%;transform:translate(-50%,-50%)}.esri-legend--card__carousel-title{margin:0}.esri-legend--card__service{border-left:var(--calcite-border-width-sm) solid var(--calcite-color-border-2);min-width:fit-content}.esri-legend--card__symbol{margin:auto;display:block}.esri-legend--stacked{flex-direction:column;min-width:300px;display:flex}.esri-legend--stacked .esri-legend--card__carousel{width:300px;max-height:420px}.esri-legend--stacked .esri-legend--card__carousel-item{max-height:388px}.esri-legend--stacked calcite-carousel-item[selected]{flex:1}.esri-legend--stacked .esri-legend--card__section{box-sizing:border-box;width:100%;min-width:unset;border:none;height:auto;overflow:auto}.esri-legend--stacked .esri-legend--card__size-ramp-row{flex-direction:column}.esri-legend--stacked .esri-legend--card__symbol-row{width:100%;margin:5px 0;display:table-row}.esri-legend--stacked .esri-legend--card__label-cell{vertical-align:middle;display:table-cell}.esri-legend--stacked .esri-legend--card__symbol-cell{vertical-align:middle;text-align:center;display:table-cell}.esri-legend--stacked .esri-legend--card__carousel-indicator-container{justify-content:center;width:300px;height:32px;display:flex;overflow:auto;box-shadow:0 -var(--calcite-border-width-sm) var(--calcite-color-border-2)}.esri-legend--stacked .esri-legend--card__carousel-indicator{cursor:pointer;justify-content:center;align-items:center;width:16px;height:auto;display:flex}.esri-legend--stacked .esri-legend--card__carousel-indicator:before{content:"";background-color:var(--calcite-color-border-2);border-radius:50%;width:10px;height:10px;transition:background-color .125s ease-in-out;display:block;box-shadow:0 0 0 var(--calcite-border-width-sm) var(--calcite-color-border-2)}.esri-legend--stacked .esri-legend--card__carousel-indicator:hover:before,.esri-legend--stacked .esri-legend--card__carousel-indicator--activated:before,.esri-legend--stacked .esri-legend--card__carousel-indicator--activated:hover:before{background-color:var(--calcite-color-border-2)}.esri-ui-corner .esri-legend--card{max-height:420px}:dir(rtl) .esri-view-width-greater-than-small .esri-legend--card__section{border-left:0;border-right:var(--calcite-border-width-sm) solid var(--calcite-color-border-2)}:dir(rtl) .esri-view-width-greater-than-small .esri-legend--card__section:first-child{border-right:none}.esri-relationship-ramp--diamond__container{font-size:var(--calcite-spacing-md);display:flex}.esri-relationship-ramp--diamond__left-column{text-align:right;align-self:center;max-width:85px;padding-right:5px}.esri-relationship-ramp--diamond__right-column{text-align:left;align-self:center;max-width:85px;padding-left:5px}.esri-relationship-ramp--diamond__middle-column{text-align:center;flex-direction:column;display:flex}.esri-relationship-ramp--diamond__middle-column--label{align-self:center;max-width:85px}.esri-relationship-ramp--diamond__middle-column--ramp{width:85px;height:85px}.esri-relationship-ramp--square__table{font-size:var(--calcite-spacing-md);display:table}.esri-relationship-ramp--square__table-row{display:table-row}.esri-relationship-ramp--square__table-cell{display:table-cell}.esri-relationship-ramp--square__table-label{max-width:95px}.esri-relationship-ramp--square__table-label--left-bottom{vertical-align:bottom;text-align:left}.esri-relationship-ramp--square__table-label--right-bottom{vertical-align:bottom;text-align:right}.esri-relationship-ramp--square__table-label--left-top{vertical-align:top;text-align:left}.esri-relationship-ramp--square__table-label--right-top{vertical-align:top;text-align:right}.esri-univariate-above-and-below-ramp__symbol{justify-content:center;align-items:center;display:flex}.esri-univariate-above-and-below-ramp__label{white-space:nowrap;margin-left:var(--calcite-spacing-sm);font-size:var(--calcite-spacing-md);line-height:1em;position:relative}.esri-univariate-above-and-below-ramp__label:before{content:"";border-style:solid;border-width:var(--calcite-border-width-sm) 0 0;width:1var (--calcite-spacing-xxs);height:0;display:block;position:absolute;top:.45em;left:-19px}.esri-univariate-above-and-below-ramp__label:first-child{top:-6px}.esri-univariate-above-and-below-ramp__label:last-child{bottom:-6px}.esri-univariate-above-and-below-ramp__color--card{position:relative}.esri-univariate-above-and-below-ramp__color--card:before{content:"";border-left:var(--calcite-border-width-sm) solid var(--calcite-color-background);border-right:var(--calcite-border-width-sm) solid var(--calcite-color-background);width:100%;height:15px;display:block;position:absolute;top:var(--calcite-border-width-sm)}:dir(rtl) .esri-univariate-above-and-below-ramp__label{margin-left:auto;margin-right:var(--calcite-spacing-sm)}:dir(rtl) .esri-univariate-above-and-below-ramp__label:before{left:auto;right:-19px}`, n = l(r);
+class s extends t {
   constructor() {
-    super(...arguments), this.widget = d(this), this.viewModel = this.widget.viewModel, this.activeLayerInfos = this.widget.activeLayerInfos, this.autoDestroyDisabled = !1, this.basemapLegendVisible = this.widget.basemapLegendVisible, this.headingLevel = this.widget.headingLevel, this.hideLayersNotInCurrentView = this.widget.hideLayersNotInCurrentView, this.icon = this.widget.icon, this.label = this.widget.label, this.layerInfos = this.widget.layerInfos, this.legendStyle = this.widget.style, this.position = "bottom-left", this.respectLayerDefinitionExpression = this.widget.respectLayerDefinitionExpression, this.respectLayerVisibilityDisabled = this.widget.respectLayerVisibility, this.state = this.viewModel.state, this.arcgisPropertyChange = t()("state"), this.arcgisReady = r();
+    super(...arguments), this.widget = n(this), this.viewModel = this.widget.viewModel, this.activeLayerInfos = this.widget.activeLayerInfos, this.autoDestroyDisabled = !1, this.basemapLegendVisible = this.widget.basemapLegendVisible, this.headingLevel = this.widget.headingLevel, this.hideLayersNotInCurrentView = this.widget.hideLayersNotInCurrentView, this.icon = this.widget.icon, this.label = this.widget.label, this.layerInfos = this.widget.layerInfos, this.legendStyle = this.widget.style, this.position = "bottom-left", this.respectLayerDefinitionExpression = this.widget.respectLayerDefinitionExpression, this.respectLayerVisibilityDisabled = this.widget.respectLayerVisibility, this.state = this.viewModel.state, this.arcgisPropertyChange = i()("state"), this.arcgisReady = a();
   }
   static {
     this.properties = { activeLayerInfos: 0, autoDestroyDisabled: 5, basemapLegendVisible: 5, headingLevel: 9, hideLayersNotInCurrentView: 5, icon: 1, label: 1, layerInfos: 0, legendStyle: 1, position: 1, referenceElement: 1, respectLayerDefinitionExpression: 5, respectLayerVisibilityDisabled: 5, state: 3 };
   }
   static {
-    this.shadowRootOptions = a;
-  }
-  static {
-    this.styles = l;
+    this.styles = d;
   }
   async destroy() {
     await this.manager.destroy();
   }
 }
-e("arcgis-legend", h);
+e("arcgis-legend", s);
 export {
-  h as ArcgisLegend
+  s as ArcgisLegend
 };

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" />
+/// <reference path="../../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,25 +127,22 @@ 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. */
     readonly arcgisPropertyChange: TargetedEvent<this, {
         name: "state" | "analysis";
     }>;
-    /** Emitted when the component associated with a map or scene view is is ready to be interacted with. */
+    /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
     readonly arcgisReady: TargetedEvent<this, void>;
     private _messages;
 }