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

package/dist/components/arcgis-floor-filter/customElement.d.ts

@@ -83,6 +83,11 @@ export declare class ArcgisFloorFilter extends LitElement {
     longNames: boolean;
     /** @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 currently selected site.

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

@@ -2,10 +2,10 @@ import { c as e } from "../../chunks/runtime.js";
 import i from "@arcgis/core/widgets/FloorFilter.js";
 import { LitElement as s, createEvent as o, noShadowRoot as l } from "@arcgis/lumina";
 import { m as a } from "../../chunks/useWidget.js";
-import { css as r } from "@lit/reactive-element/css-tag.js";
+import { css as r } from "lit";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.5 */
+v4.34.0-next.50 */
 const 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,45 @@
-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 { css as a, html as l } from "lit";
+import { usePropertyChange as m } from "@arcgis/lumina/controllers";
+import { closestElement as u, classes as d } from "@arcgis/components-utils";
+import { LitElement as f, createEvent as h, safeClassMap as i, nothing as p } from "@arcgis/lumina";
+import { u as g } from "../../chunks/useT9n.js";
+import { g as r } from "../../chunks/globalCss.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.5 */
-const g = p`arcgis-fullscreen{display:block}`, E = {
+v4.34.0-next.50 */
+const b = a`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 f {
   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 = g(), this.view = E(this), this.position = "top-left", this.arcgisPropertyChange = m()("state"), this.arcgisReady = h(), 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 = u(this.el, t);
+      this.#e = n || void 0;
+    } else
+      this.#e = e;
+  }
   get state() {
     if (!document.fullscreenEnabled)
       return "unsupported";
@@ -43,11 +56,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(d(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 ?? p}></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

@@ -1,21 +1,20 @@
 import { c as S } from "../../chunks/runtime.js";
-import { html as n } from "lit-html";
-import { ref as f } from "lit-html/directives/ref.js";
+import { css as C, html as n } from "lit";
+import { ref as f } from "lit/directives/ref.js";
 import { g as _ } from "../../chunks/globalCss.js";
-import C from "@arcgis/core/views/Theme.js";
-import { u as I } from "../../chunks/useT9n.js";
-import { generateGuid as M, classes as h } from "@arcgis/components-utils";
-import { usePropertyChange as T } from "@arcgis/lumina/controllers";
-import { m as E } from "../../chunks/useViewModel.js";
+import I from "@arcgis/core/views/Theme.js";
+import { u as M } from "../../chunks/useT9n.js";
+import { generateGuid as T, classes as h } from "@arcgis/components-utils";
+import { usePropertyChange as E } from "@arcgis/lumina/controllers";
+import { m as x } from "../../chunks/useViewModel.js";
 import g from "@arcgis/core/Color.js";
-import { LitElement as x, createEvent as P, noShadowRoot as k, safeClassMap as d, nothing as u } from "@arcgis/lumina";
-import { css as R } from "@lit/reactive-element/css-tag.js";
+import { LitElement as P, createEvent as k, noShadowRoot as R, safeClassMap as d, nothing as u } from "@arcgis/lumina";
 import { substitute as O } from "@arcgis/core/intl.js";
 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.5 */
+v4.34.0-next.50 */
 function B(s) {
   if (s == null || Number.isNaN(s))
     return 0;
@@ -32,7 +31,7 @@ function y(s, e) {
 const $ = {
   fromAttribute: (s) => g.fromHex(s),
   toAttribute: (s) => typeof s == "string" ? s : s?.toHex() ?? ""
-}, W = R`@layer{calcite-block>.arcgis-grid-controls{background:none;padding:0}.arcgis-ui-corner .arcgis-expand .arcgis-widget--panel .arcgis-widget--panel.arcgis-grid-controls{overflow-y:visible}.arcgis-grid-controls{user-select:none;display:flex;flex-flow:column wrap;padding:var(--calcite-spacing-sm);.container{display:flex;flex:1 1 auto;flex-direction:column;gap:var(--calcite-spacing-sm)}.numeric-inputs-container{display:grid;grid-auto-columns:1fr;grid-auto-flow:column;gap:var(--calcite-spacing-sm)}arcgis-labeled-switch{margin-block-end:var(--calcite-spacing-sm)}.switch--bordered{border-width:0 0 var(--calcite-spacing-px) 0;border-style:solid;border-color:var(--calcite-color-border-1);padding-block-end:var(--calcite-spacing-sm)}.tile-group{display:flex;column-gap:var(--calcite-spacing-md);align-items:start;margin-bottom:calc(0px - var(--calcite-spacing-sm))}.tile{position:relative;.content{display:flex;flex-direction:column;row-gap:var(--calcite-spacing-md);align-items:center;padding:var(--calcite-spacing-md);color:var(--calcite-color-text-2)}&.disabled{opacity:var(--calcite-opacity-disabled)}&:focus-within{outline:var(--calcite-spacing-base) solid var(--calcite-color-brand);outline-offset:var(--calcite-spacing-base)}input[type=radio]{appearance:none;position:absolute;inset:0;opacity:.001;border:var(--calcite-spacing-px) solid transparent;cursor:pointer;&:checked+.content{border:var(--calcite-spacing-px) solid var(--calcite-color-brand)}+.content{border:var(--calcite-spacing-px) solid transparent;calcite-label{margin-bottom:calc(0px - var(--calcite-label-margin-bottom, .75rem));font-weight:var(--calcite-font-weight-medium)}}}}.inline-icon{margin-left:var(--calcite-spacing-xs);vertical-align:top;color:var(--calcite-color-status-warning)}}}`, G = "arcgis-grid-controls", r = {
+}, W = C`@layer{calcite-block>.arcgis-grid-controls{background:none;padding:0}.arcgis-ui-corner .arcgis-expand .arcgis-widget--panel .arcgis-widget--panel.arcgis-grid-controls{overflow-y:visible}.arcgis-grid-controls{user-select:none;display:flex;flex-flow:column wrap;padding:var(--calcite-spacing-sm);.container{display:flex;flex:1 1 auto;flex-direction:column;gap:var(--calcite-spacing-sm)}.numeric-inputs-container{display:grid;grid-auto-columns:1fr;grid-auto-flow:column;gap:var(--calcite-spacing-sm)}arcgis-labeled-switch{margin-block-end:var(--calcite-spacing-sm)}.switch--bordered{border-width:0 0 var(--calcite-spacing-px) 0;border-style:solid;border-color:var(--calcite-color-border-1);padding-block-end:var(--calcite-spacing-sm)}.tile-group{display:flex;column-gap:var(--calcite-spacing-md);align-items:start;margin-bottom:calc(0px - var(--calcite-spacing-sm))}.tile{position:relative;.content{display:flex;flex-direction:column;row-gap:var(--calcite-spacing-md);align-items:center;padding:var(--calcite-spacing-md);color:var(--calcite-color-text-2)}&.disabled{opacity:var(--calcite-opacity-disabled)}&:focus-within{outline:var(--calcite-spacing-base) solid var(--calcite-color-brand);outline-offset:var(--calcite-spacing-base)}input[type=radio]{appearance:none;position:absolute;inset:0;opacity:.001;border:var(--calcite-spacing-px) solid transparent;cursor:pointer;&:checked+.content{border:var(--calcite-spacing-px) solid var(--calcite-color-brand)}+.content{border:var(--calcite-spacing-px) solid transparent;calcite-label{margin-bottom:calc(0px - var(--calcite-label-margin-bottom, .75rem));font-weight:var(--calcite-font-weight-medium)}}}}.inline-icon{margin-left:var(--calcite-spacing-xs);vertical-align:top;color:var(--calcite-color-status-warning)}}}`, G = "arcgis-grid-controls", r = {
   base: G,
   borderedSwitch: "switch--bordered",
   container: "container",
@@ -47,10 +46,10 @@ const $ = {
   gridTheme: { light: "circle", dark: "circle-area", custom: "palette" },
   placementState: { interactive: "maximum-territory-distance", place: "move", rotate: "rotate" },
   warning: "exclamation-mark-triangle"
-}, b = g.fromArray([115, 115, 115]), v = g.fromArray([200, 200, 200]), A = ["interactive", "place", "rotate"], j = E(L);
-class V extends x {
+}, b = g.fromArray([115, 115, 115]), v = g.fromArray([200, 200, 200]), A = ["interactive", "place", "rotate"], j = x(L);
+class V extends P {
   constructor() {
-    super(...arguments), this._labelUid = M(), this._messages = I({}), this._viewModel = j(this), this._placementModeButtonRefs = /* @__PURE__ */ new Map(), this.numericSpacingInputShouldBeVisible = this._viewModel.numericSpacingInputShouldBeVisible, this.position = "bottom-right", this.icon = m.componentIcon, this.snappingOptions = this._viewModel.snappingOptions, this.hideColorSelection = !1, this.hideDynamicScaleToggle = !1, this.hideGridEnabledToggle = !1, this.hideNumericInputs = !1, this.hideGridSnapEnabledToggle = !1, this.hideLineIntervalInput = !1, this.hideOutOfScaleWarning = !1, this.hidePlacementButtons = !1, this.hideRotateWithMapToggle = !1, this.rotation = this._viewModel.rotation, this.rotateWithMap = this._viewModel.rotateWithMap, this.spacing = this._viewModel.spacing, this.majorLineInterval = this._viewModel.majorLineInterval, this.gridColor = this._viewModel.gridColor, this.displayEnabled = this._viewModel.displayEnabled, this.gridOutOfScale = this._viewModel.gridOutOfScale, this.unit = this._viewModel.unit, this.dynamicScaling = this._viewModel.dynamicScaling, this.gridControlsEnabled = this._viewModel.gridControlsEnabled, this.interactivePlacementState = this._viewModel.interactivePlacementState, this.snappingEnabled = this._viewModel.snappingEnabled, this.effectiveSpacingAfterDynamicScaling = this._viewModel.effectiveSpacingAfterDynamicScaling, this.placementDisabled = this._viewModel.placementDisabled, this.autoDestroyDisabled = !1, this.arcgisPropertyChange = T()("customColor", "theme", "spacing", "rotation", "majorLineInterval", "rotateWithMap", "dynamicScaling", "snappingEnabled", "interactivePlacementState", "displayEnabled", "gridOutOfScale", "effectiveSpacingAfterDynamicScaling", "gridControlsEnabled", "gridColor"), this.arcgisReady = P();
+    super(...arguments), this._labelUid = T(), this._messages = M({}), this._viewModel = j(this), this._placementModeButtonRefs = /* @__PURE__ */ new Map(), this.numericSpacingInputShouldBeVisible = this._viewModel.numericSpacingInputShouldBeVisible, this.position = "bottom-right", this.icon = m.componentIcon, this.snappingOptions = this._viewModel.snappingOptions, this.hideColorSelection = !1, this.hideDynamicScaleToggle = !1, this.hideGridEnabledToggle = !1, this.hideNumericInputs = !1, this.hideGridSnapEnabledToggle = !1, this.hideLineIntervalInput = !1, this.hideOutOfScaleWarning = !1, this.hidePlacementButtons = !1, this.hideRotateWithMapToggle = !1, this.rotation = this._viewModel.rotation, this.rotateWithMap = this._viewModel.rotateWithMap, this.spacing = this._viewModel.spacing, this.majorLineInterval = this._viewModel.majorLineInterval, this.gridColor = this._viewModel.gridColor, this.displayEnabled = this._viewModel.displayEnabled, this.gridOutOfScale = this._viewModel.gridOutOfScale, this.unit = this._viewModel.unit, this.dynamicScaling = this._viewModel.dynamicScaling, this.gridControlsEnabled = this._viewModel.gridControlsEnabled, this.interactivePlacementState = this._viewModel.interactivePlacementState, this.snappingEnabled = this._viewModel.snappingEnabled, this.effectiveSpacingAfterDynamicScaling = this._viewModel.effectiveSpacingAfterDynamicScaling, this.placementDisabled = this._viewModel.placementDisabled, this.autoDestroyDisabled = !1, this.arcgisPropertyChange = E()("customColor", "theme", "spacing", "rotation", "majorLineInterval", "rotateWithMap", "dynamicScaling", "snappingEnabled", "interactivePlacementState", "displayEnabled", "gridOutOfScale", "effectiveSpacingAfterDynamicScaling", "gridControlsEnabled", "gridColor"), this.arcgisReady = k();
   }
   static {
     this.properties = { _placementModeButtonRefs: 16, _warningIconTooltipRef: 16, _themePopoverRef: 16, numericSpacingInputShouldBeVisible: 16, referenceElement: 1, position: 3, icon: 1, customColor: [3, { converter: $ }], snappingOptions: 0, theme: 1, hideColorSelection: 5, hideDynamicScaleToggle: 5, hideGridEnabledToggle: 5, hideNumericInputs: 5, hideGridSnapEnabledToggle: 5, hideLineIntervalInput: 5, hideOutOfScaleWarning: 5, hidePlacementButtons: 5, hideRotateWithMapToggle: 5, rotation: 11, rotateWithMap: 5, spacing: 11, majorLineInterval: 11, gridColor: [3, { converter: $ }], displayEnabled: 4, gridOutOfScale: 7, unit: 1, dynamicScaling: 5, gridControlsEnabled: 4, interactivePlacementState: 3, snappingEnabled: 5, effectiveSpacingAfterDynamicScaling: 43, placementDisabled: 5, autoDestroyDisabled: 5, messageOverrides: 0, label: 1 };
@@ -59,7 +58,7 @@ class V extends x {
     this.styles = W;
   }
   static {
-    this.shadowRootOptions = k;
+    this.shadowRootOptions = R;
   }
   get theme() {
     const e = this.gridColor;
@@ -72,7 +71,7 @@ class V extends x {
         this.gridColor = b;
         break;
       case "custom":
-        this.customColor == null && (this.customColor = t?.theme?.accentColor ?? new C().accentColor), this.gridColor = this.customColor;
+        this.customColor == null && (this.customColor = t?.theme?.accentColor ?? new I().accentColor), this.gridColor = this.customColor;
         break;
       case "light":
       default:

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

@@ -3,10 +3,10 @@ import { usePropertyChange as e } from "@arcgis/lumina/controllers";
 import s from "@arcgis/core/widgets/HistogramRangeSlider.js";
 import { LitElement as a, createEvent as r, noShadowRoot as o } from "@arcgis/lumina";
 import { m as n } from "../../chunks/useWidget.js";
-import { css as d } from "@lit/reactive-element/css-tag.js";
+import { css as d } from "lit";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.5 */
+v4.34.0-next.50 */
 const 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

@@ -1,29 +1,28 @@
 import { c as l } from "../../chunks/runtime.js";
-import { html as o } from "lit-html";
-import { usePropertyChange as c } from "@arcgis/lumina/controllers";
-import { reEmitEvent as n } from "@arcgis/lumina/controllers/accessor";
-import { classes as m } from "@arcgis/components-utils";
-import d from "@arcgis/core/widgets/Home/HomeViewModel.js";
-import { LitElement as h, createEvent as g, noShadowRoot as p, safeClassMap as i, nothing as v } from "@arcgis/lumina";
-import { u as w } from "../../chunks/useT9n.js";
+import { css as c, html as o } from "lit";
+import { usePropertyChange as n } from "@arcgis/lumina/controllers";
+import { reEmitEvent as m } from "@arcgis/lumina/controllers/accessor";
+import { classes as d } from "@arcgis/components-utils";
+import h from "@arcgis/core/widgets/Home/HomeViewModel.js";
+import { LitElement as g, createEvent as p, noShadowRoot as v, safeClassMap as i, nothing as w } from "@arcgis/lumina";
+import { u } from "../../chunks/useT9n.js";
 import { m as f } from "../../chunks/useViewModel.js";
 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.5 */
-const b = u`@layer{arcgis-home{display:block}}`, y = {
+v4.34.0-next.50 */
+const b = c`@layer{arcgis-home{display:block}}`, y = {
   base: "esri-home"
-}, M = f(d);
-class $ extends h {
+}, M = f(h);
+class $ extends g {
   constructor() {
-    super(...arguments), this.messages = w(), this.viewModel = M(this), this.autoDestroyDisabled = !1, this.goToOverride = this.viewModel.goToOverride, this.icon = "home", this.position = "top-left", this.state = this.viewModel.state, this.viewpoint = this.viewModel.viewpoint, this.arcgisGo = n(() => this.viewModel, "go"), this.arcgisPropertyChange = c()("state"), this.arcgisReady = g();
+    super(...arguments), this.messages = u(), this.viewModel = M(this), this.autoDestroyDisabled = !1, this.goToOverride = this.viewModel.goToOverride, this.icon = "home", this.position = "top-left", this.state = this.viewModel.state, this.viewpoint = this.viewModel.viewpoint, this.arcgisGo = m(() => this.viewModel, "go"), this.arcgisPropertyChange = n()("state"), this.arcgisReady = p();
   }
   static {
     this.properties = { autoDestroyDisabled: 5, goToOverride: 0, icon: 1, label: 1, messageOverrides: 0, position: 3, referenceElement: 1, state: 3, viewpoint: 0 };
   }
   static {
-    this.shadowRootOptions = p;
+    this.shadowRootOptions = v;
   }
   static {
     this.styles = b;
@@ -43,7 +42,7 @@ class $ extends h {
   }
   render() {
     const { messages: e, icon: r } = this, t = this.viewModel?.state, s = t === "going-home";
-    return o`<div class=${i(m(y.base, a.widget))}><calcite-button class=${i(a.widgetButton)} .disabled=${t === "disabled"} .iconStart=${s ? void 0 : r ?? void 0} kind=neutral .label=${e.componentLabel} @click=${this._go} .scale=${s ? "s" : "m"} title=${(t === "going-home" ? e.cancel : e.title) ?? v}>${s ? o`<calcite-loader inline label></calcite-loader>` : null}</calcite-button></div>`;
+    return o`<div class=${i(d(y.base, a.widget))}><calcite-button class=${i(a.widgetButton)} .disabled=${t === "disabled"} .iconStart=${s ? void 0 : r ?? void 0} kind=neutral .label=${e.componentLabel} @click=${this._go} .scale=${s ? "s" : "m"} title=${(t === "going-home" ? e.cancel : e.title) ?? w}>${s ? o`<calcite-loader inline label></calcite-loader>` : null}</calcite-button></div>`;
   }
 }
 l("arcgis-home", $);

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

@@ -1,28 +1,27 @@
 import { c as d } from "../../chunks/runtime.js";
-import { ref as h } from "lit-html/directives/ref.js";
-import { html as n } from "lit-html";
-import { keyed as p } from "lit-html/directives/keyed.js";
-import { LitElement as m, createEvent as b, safeClassMap as c } from "@arcgis/lumina";
-import { css as f } from "@lit/reactive-element/css-tag.js";
+import { ref as h } from "lit/directives/ref.js";
+import { css as p, html as n } from "lit";
+import { keyed as b } from "lit/directives/keyed.js";
+import { LitElement as g, createEvent as m, safeClassMap as c } from "@arcgis/lumina";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.5 */
-const 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 = {
+v4.34.0-next.50 */
+const f = p`.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",
   iconInfo: "icon info",
   iconWarning: "icon warning",
   tooltip: "tooltip"
 };
-class w extends m {
+class w extends g {
   constructor() {
-    super(...arguments), this.checked = !1, this.disabled = !1, this.hintKind = "info", this.arcgisCheckedChanged = b();
+    super(...arguments), this.checked = !1, this.disabled = !1, this.hintKind = "info", this.arcgisCheckedChanged = m();
   }
   static {
     this.properties = { _icon: 16, checked: 7, disabled: 7, label: 1, hint: 1, hintIcon: 1, hintKind: 1 };
   }
   static {
-    this.styles = g;
+    this.styles = f;
   }
   async destroy() {
     await this.manager.destroy();
@@ -32,7 +31,7 @@ class w extends m {
   }
   render() {
     const { label: t, hint: a, hintKind: l, hintIcon: o, checked: s, disabled: r } = this;
-    return n`<calcite-label class=${c(e.label)} layout=inline-space-between scale=s>${a ? p("label-content", n`<div class=${c(e.labelContent)}><div>${t}</div><calcite-icon class=${c(l !== "warning" ? e.iconInfo : e.iconWarning)} .icon=${o ?? "information"} @click=${(i) => i.stopPropagation()} scale=s tabindex=0 ${h(this._setIconRef)}></calcite-icon><calcite-tooltip class=${c(e.tooltip)} overlay-positioning=fixed .referenceElement=${this._icon ?? void 0}>${a}</calcite-tooltip></div>`) : t}<calcite-switch .checked=${s} .disabled=${r} scale=s @calciteSwitchChange=${(i) => {
+    return n`<calcite-label class=${c(e.label)} layout=inline-space-between scale=s>${a ? b("label-content", n`<div class=${c(e.labelContent)}><div>${t}</div><calcite-icon class=${c(l !== "warning" ? e.iconInfo : e.iconWarning)} .icon=${o ?? "information"} @click=${(i) => i.stopPropagation()} scale=s tabindex=0 ${h(this._setIconRef)}></calcite-icon><calcite-tooltip class=${c(e.tooltip)} overlay-positioning=fixed .referenceElement=${this._icon ?? void 0}>${a}</calcite-tooltip></div>`) : t}<calcite-switch .checked=${s} .disabled=${r} scale=s @calciteSwitchChange=${(i) => {
       this.checked = i.target.checked, this.arcgisCheckedChanged.emit(i.target.checked);
     }}></calcite-switch></calcite-label>`;
   }

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.5 */
+v4.34.0-next.50 */
 const c = d(a);
 class m extends r {
   constructor() {

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

@@ -1,5 +1,5 @@
 import { c as T } from "../../chunks/runtime.js";
-import { html as r } from "lit-html";
+import { html as r } from "lit";
 import { classes as y } from "@arcgis/components-utils";
 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";
@@ -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.5 */
+v4.34.0-next.50 */
 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

@@ -3,10 +3,10 @@ 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 { css as n } from "lit";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.5 */
+v4.34.0-next.50 */
 const l = n`@layer{arcgis-legend{display:block}}`, d = o(i);
 class h extends s {
   constructor() {