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

package/dist/components/arcgis-locate/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 { Nil } from '@arcgis/components-utils';
 import { JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { ArcgisReferenceElement } from '../../utils/component-utils';
 import { default as LocateViewModel } from './LocateViewModel';
@@ -10,6 +9,10 @@ declare const useLocateViewModel: (component: LitElement & Pick<LocateViewModel,
 /**
  * The Locate component animates the Map or Scene to the user's current location.
  *
+ * This component uses the browser's [Geolocation API](https://developer.mozilla.org/en-US/docs/Web/API/Geolocation_API) which is only available in [secure contexts](https://developer.mozilla.org/en-US/docs/Web/Security/Secure_Contexts), such as HTTPS.
+ * Note that localhost is considered "potentially secure" and can be used for easy testing in browsers that support
+ * [Window.isSecureContext](https://developer.mozilla.org/en-US/docs/Web/API/isSecureContext#browser_compatibility).
+ *
  * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-locate/)
  */
 export declare class ArcgisLocate extends LitElement {
@@ -23,26 +26,35 @@ export declare class ArcgisLocate extends LitElement {
      * @default false
      */
     autoDestroyDisabled: boolean;
-    geolocationOptions: Nil | PositionOptions;
+    geolocationOptions: PositionOptions | undefined;
     /**
      * Indicates whether to navigate the view to the position and scale of the geolocated result.
      *
      * @default false
      */
     goToLocationDisabled: boolean;
-    goToOverride: Nil | __esri.GoToOverride;
+    goToOverride: __esri.GoToOverride | undefined;
     /** The graphic used to show the user's location on the map. */
     graphic: __esri.Graphic;
     /** @default "gps-off" */
     icon?: 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 false */
     popupDisabled: boolean;
     /** @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;
     /**
      * Indicates the scale to set on the view when navigating to the position of the geolocated
@@ -50,7 +62,7 @@ export declare class ArcgisLocate extends LitElement {
      *
      * @default null
      */
-    scale: number | Nil;
+    scale: number | undefined;
     /** The current state of the component. */
     state: "ready" | "disabled" | "error" | "feature-unsupported" | "locating";
     /**

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

@@ -1,20 +1,19 @@
-import { c as I } from "../../chunks/runtime.js";
-import { html as m } from "lit-html";
-import { usePropertyChange as G } from "@arcgis/lumina/controllers";
-import { classes as F } from "@arcgis/components-utils";
+import { c as _ } from "../../chunks/runtime.js";
+import { css as G, html as m } from "lit";
+import { usePropertyChange as F } from "@arcgis/lumina/controllers";
+import { classes as z } from "@arcgis/components-utils";
 import { watch as y } from "@arcgis/core/core/reactiveUtils.js";
-import { LitElement as z, createEvent as f, noShadowRoot as j, safeClassMap as w, nothing as Q } from "@arcgis/lumina";
-import { u as V } from "../../chunks/useT9n.js";
-import { m as k } from "../../chunks/useViewModel.js";
+import { LitElement as j, createEvent as f, noShadowRoot as Q, safeClassMap as w, nothing as V } from "@arcgis/lumina";
+import { u as k } from "../../chunks/useT9n.js";
+import { m as H } from "../../chunks/useViewModel.js";
 import { g as b } from "../../chunks/globalCss.js";
-import { l as H } from "../../chunks/legacyIcon.js";
-import { css as K } from "@lit/reactive-element/css-tag.js";
-import { property as n, subclass as S } from "@arcgis/core/core/accessorSupport/decorators.js";
+import { l as K } from "../../chunks/legacyIcon.js";
+import { property as n, subclass as C } from "@arcgis/core/core/accessorSupport/decorators.js";
 import u from "@arcgis/core/core/Error.js";
 import { onLocaleChange as J } from "@arcgis/core/intl.js";
 import q from "@arcgis/core/PopupTemplate.js";
 import W from "@arcgis/core/support/actions/ActionButton.js";
-import { t as X, a as E } from "../../chunks/async-utils.js";
+import { t as X, i as E } from "../../chunks/async-utils.js";
 import B from "@arcgis/core/core/Accessor.js";
 import O from "@arcgis/core/Graphic.js";
 import Z from "@arcgis/core/symbols/CIMSymbol.js";
@@ -27,8 +26,8 @@ import { project as te } from "@arcgis/core/rest/geometryService.js";
 import oe from "@arcgis/core/rest/support/ProjectParameters.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 ie = K`@layer{arcgis-locate{display:block}}`;
+v4.34.0-next.51 */
+const ie = G`@layer{arcgis-locate{display:block}}`;
 let M = !1;
 const re = {
   maximumAge: 0,
@@ -46,7 +45,7 @@ function se() {
 function ne() {
   return ae() && se();
 }
-function le(e) {
+function ce(e) {
   return e ??= re, new Promise((o, r) => {
     setTimeout(
       () => r(new u("geolocation:timeout", "getting the current geolocation position timed out")),
@@ -54,7 +53,7 @@ function le(e) {
     ), navigator.geolocation.getCurrentPosition(o, r, e ?? void 0);
   });
 }
-function ce(e, t) {
+function le(e, t) {
   const { position: o, view: r } = e, a = pe(o)?.coords;
   if (!a)
     throw new u("geometry-service:no-coords", "Geolocation has no coordinates");
@@ -263,11 +262,11 @@ const L = {
     ]
   }
 });
-let l = class extends B {
+let c = class extends B {
   constructor() {
-    super(...arguments), this._geolocationUsable = !0, this.geolocationOptions = null, this.goToLocationEnabled = !0, this.goToOverride = null, this.graphic = new O({
+    super(...arguments), this._geolocationUsable = !0, this.goToLocationEnabled = !0, this.graphic = new O({
       symbol: we
-    }), this.scale = null, this.rotationEnabled = !0, this.view = null;
+    }), this.rotationEnabled = !0;
   }
   //#region Lifecycle
   initialize() {
@@ -282,7 +281,7 @@ let l = class extends B {
     ]);
   }
   destroy() {
-    this._clearGraphic(), this.view = null;
+    this._clearGraphic(), this.view = void 0;
   }
   //#endregion
   //#region Private Methods
@@ -351,7 +350,7 @@ let l = class extends B {
   }
   async updatePosition(e, t) {
     try {
-      const o = this.view, r = await ce({ position: e, view: o }, { signal: t.signal }), { graphic: i } = this, { timestamp: a, coords: s } = e, { accuracy: g, altitude: h, altitudeAccuracy: N, latitude: D, longitude: x, speed: R } = s, v = this._getHeading(e, o), U = {
+      const o = this.view, r = await le({ position: e, view: o }, { signal: t.signal }), { graphic: i } = this, { timestamp: a, coords: s } = e, { accuracy: g, altitude: h, altitudeAccuracy: N, latitude: D, longitude: x, speed: R } = s, v = this._getHeading(e, o), U = {
         timestamp: a,
         accuracy: g,
         altitude: h,
@@ -362,8 +361,8 @@ let l = class extends B {
         speed: R
       };
       i && (i.geometry = r, i.attributes = U);
-      const _ = this._getScale(o);
-      await this._animatePoint(r, _, v, t);
+      const I = this._getScale(o);
+      await this._animatePoint(r, I, v, t);
     } catch (o) {
       if (!E(o))
         throw new u("geolocation-positioning:invalid-point", "Cannot position invalid point", {
@@ -376,33 +375,33 @@ let l = class extends B {
 };
 p([
   n()
-], l.prototype, "_geolocationUsable", 2);
+], c.prototype, "_geolocationUsable", 2);
 p([
   n()
-], l.prototype, "geolocationOptions", 2);
+], c.prototype, "geolocationOptions", 2);
 p([
   n()
-], l.prototype, "goToLocationEnabled", 2);
+], c.prototype, "goToLocationEnabled", 2);
 p([
   n()
-], l.prototype, "goToOverride", 2);
+], c.prototype, "goToOverride", 2);
 p([
   n({
     type: O
   })
-], l.prototype, "graphic", 2);
+], c.prototype, "graphic", 2);
 p([
   n()
-], l.prototype, "scale", 2);
+], c.prototype, "scale", 2);
 p([
   n()
-], l.prototype, "rotationEnabled", 2);
+], c.prototype, "rotationEnabled", 2);
 p([
   n()
-], l.prototype, "view", 2);
-l = p([
-  S("map-components.geolocation.GeolocationPositioning")
-], l);
+], c.prototype, "view", 2);
+c = p([
+  C("map-components.geolocation.GeolocationPositioning")
+], c);
 var be = Object.defineProperty, Ae = Object.getOwnPropertyDescriptor, d = (e, t, o, r) => {
   for (var i = r > 1 ? void 0 : r ? Ae(t, o) : t, a = e.length - 1, s; a >= 0; a--)
     (s = e[a]) && (i = (r ? s(t, o, i) : s(i)) || i);
@@ -490,10 +489,10 @@ function Me(e) {
     ]
   });
 }
-let c = class extends l {
+let l = class extends c {
   //#region Lifecycle
   constructor(e) {
-    super(e), this._locateController = null, this.currentPosition = null, this.error = void 0, this.messages = null, this.popupEnabled = !0, this.locate = this.locate.bind(this);
+    super(e), this.popupEnabled = !0, this.locate = this.locate.bind(this);
   }
   initialize() {
     this.addHandles([
@@ -521,19 +520,19 @@ let c = class extends l {
     const e = new AbortController();
     this._locateController = e, this.error = void 0;
     try {
-      const t = await le(this.geolocationOptions);
+      const t = await ce(this.geolocationOptions);
       if (await this.updatePosition(t, e), this._locateController !== e)
         return null;
       const { graphic: o } = this;
-      return o && this._updatePopupTemplate(o), this._addGraphic(), this.currentPosition = t, this._locateController = null, t;
+      return o && this._updatePopupTemplate(o), this._addGraphic(), this.currentPosition = t, this._locateController = void 0, t;
     } catch (t) {
       if (E(t))
         return null;
-      throw e === this._locateController && (this._locateController = null), this.error = t, t;
+      throw e === this._locateController && (this._locateController = void 0), this.error = t, t;
     }
   }
   cancelLocate() {
-    this._clearGraphic(), this._locateController && this._locateController.abort(), this._locateController = null;
+    this._clearGraphic(), this._locateController && this._locateController.abort(), this._locateController = void 0;
   }
   //#endregion
   //#region Private Methods
@@ -547,37 +546,37 @@ let c = class extends l {
 };
 d([
   n()
-], c.prototype, "_locateController", 2);
+], l.prototype, "_locateController", 2);
 d([
   n()
-], c.prototype, "currentPosition", 2);
+], l.prototype, "currentPosition", 2);
 d([
   n()
-], c.prototype, "error", 2);
+], l.prototype, "error", 2);
 d([
   n()
-], c.prototype, "messages", 2);
+], l.prototype, "messages", 2);
 d([
   n()
-], c.prototype, "popupEnabled", 2);
+], l.prototype, "popupEnabled", 2);
 d([
   n({ readOnly: !0 })
-], c.prototype, "state", 1);
-c = d([
-  S("map-components.locate.LocateViewModel")
-], c);
-const Ce = {
+], l.prototype, "state", 1);
+l = d([
+  C("map-components.locate.LocateViewModel")
+], l);
+const Se = {
   base: "esri-locate"
-}, C = "gps-off", Se = k(c);
-class Ee extends z {
+}, S = "gps-off", Ce = H(l);
+class Ee extends j {
   constructor() {
-    super(...arguments), this.messages = V(), this.viewModel = Se(this), this.autoDestroyDisabled = !1, this.geolocationOptions = this.viewModel.geolocationOptions, this.goToLocationDisabled = this.viewModel.goToLocationEnabled, this.goToOverride = this.viewModel.goToOverride, this.graphic = this.viewModel.graphic, this.icon = C, this.popupDisabled = this.viewModel.popupEnabled, this.position = "top-left", this.scale = this.viewModel.scale, this.state = this.viewModel.state, this.arcgisError = f(), this.arcgisPropertyChange = G()("state"), this.arcgisReady = f(), this.arcgisSuccess = f();
+    super(...arguments), this.messages = k(), this.viewModel = Ce(this), this.autoDestroyDisabled = !1, this.geolocationOptions = this.viewModel.geolocationOptions, this.goToLocationDisabled = this.viewModel.goToLocationEnabled, this.goToOverride = this.viewModel.goToOverride, this.graphic = this.viewModel.graphic, this.icon = S, this.popupDisabled = this.viewModel.popupEnabled, this.position = "top-left", this.scale = this.viewModel.scale, this.state = this.viewModel.state, this.arcgisError = f(), this.arcgisPropertyChange = F()("state"), this.arcgisReady = f(), this.arcgisSuccess = f();
   }
   static {
     this.properties = { autoDestroyDisabled: 5, geolocationOptions: 0, goToLocationDisabled: 7, goToOverride: 0, graphic: 0, icon: 1, label: 1, messageOverrides: 0, popupDisabled: 5, position: 3, referenceElement: 1, scale: 9, state: 3 };
   }
   static {
-    this.shadowRootOptions = j;
+    this.shadowRootOptions = Q;
   }
   static {
     this.styles = ie;
@@ -613,11 +612,11 @@ class Ee extends z {
     });
   }
   render() {
-    const { viewModel: t, icon: o } = this, { state: r } = t, i = r === "locating", a = i ? this.messages.cancel : this.messages.title, s = r === "feature-unsupported", g = H === void 0 ? C : void 0, h = this._localizeError(this.viewModel?.error);
-    return m`<div class=${w(F(Ce.base, b.widget))}>${!s && m`<calcite-button class=${w(b.widgetButton)} .disabled=${r === "disabled"} .iconStart=${i ? void 0 : o ?? g} kind=neutral .label=${a} @click=${this._locate} title=${a ?? Q}>${i ? m`<calcite-loader inline label></calcite-loader>` : null}</calcite-button>` || ""}${h ? m`<calcite-tooltip open overlay-positioning=fixed .referenceElement=${this.el}>${h}</calcite-tooltip>` : null}</div>`;
+    const { viewModel: t, icon: o } = this, { state: r } = t, i = r === "locating", a = i ? this.messages.cancel : this.messages.title, s = r === "feature-unsupported", g = K === void 0 ? S : void 0, h = this._localizeError(this.viewModel?.error);
+    return m`<div class=${w(z(Se.base, b.widget))}>${!s && m`<calcite-button class=${w(b.widgetButton)} .disabled=${r === "disabled"} .iconStart=${i ? void 0 : o ?? g} kind=neutral .label=${a} @click=${this._locate} title=${a ?? V}>${i ? m`<calcite-loader inline label></calcite-loader>` : null}</calcite-button>` || ""}${h ? m`<calcite-tooltip open overlay-positioning=fixed .referenceElement=${this.el}>${h}</calcite-tooltip>` : null}</div>`;
   }
 }
-I("arcgis-locate", Ee);
+_("arcgis-locate", Ee);
 export {
   Ee as ArcgisLocate
 };

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

@@ -6,7 +6,7 @@ import { default as MapView } from '@arcgis/core/views/MapView.js';
 import { default as WebMap } from '@arcgis/core/WebMap.js';
 import { PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 
-declare const useWebMap: (component: LitElement & Omit<Pick<WebMap, "basemap" | "ground" | "ipsInfo" | "layers" | "bookmarks" | "tables" | "presentation" | "widgets" | "applicationProperties" | "authoringApp" | "authoringAppVersion" | "floorInfo" | "geotriggersInfo" | "initialViewProperties" | "portalItem" | "thumbnailUrl" | "utilityNetworks">, "basemap" | "ground" | ("destroyed" | "initialized" | "declaredClass" | "set" | "watch" | "addHandles" | "removeHandles" | "hasHandles") | "layers" | "bookmarks" | "tables" | "presentation" | "widgets" | "applicationProperties" | "authoringApp" | "authoringAppVersion" | "floorInfo" | "geotriggersInfo" | "initialViewProperties" | "portalItem" | "thumbnailUrl" | "utilityNetworks"> & {
+declare const useWebMap: (component: LitElement & Omit<Pick<WebMap, "basemap" | "focusAreas" | "ground" | "ipsInfo" | "layers" | "bookmarks" | "tables" | "presentation" | "widgets" | "applicationProperties" | "authoringApp" | "authoringAppVersion" | "floorInfo" | "geotriggersInfo" | "initialViewProperties" | "portalItem" | "thumbnailUrl" | "utilityNetworks">, "basemap" | "ground" | ("destroyed" | "initialized" | "declaredClass" | "set" | "watch" | "addHandles" | "removeHandles" | "hasHandles") | "layers" | "bookmarks" | "tables" | "presentation" | "widgets" | "applicationProperties" | "authoringApp" | "authoringAppVersion" | "floorInfo" | "geotriggersInfo" | "initialViewProperties" | "portalItem" | "thumbnailUrl" | "utilityNetworks"> & {
     autoDestroyDisabled: boolean;
     destroy: () => Promise<void>;
 }) => WebMap;
@@ -15,7 +15,7 @@ declare const useMapView: (component: LitElement & Omit<Pick<MapView, "container
     destroy: () => Promise<void>;
 }) => MapView;
 /**
- * The ArcGIS Map Component is used to add 2D maps to web applications. For 3D maps, use the
+ * The ArcGIS Map component is used to add 2D maps to web applications. For 3D maps, use the
  * [ArcGIS Scene component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/).
  *
  * The Map component creates a [MapView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html) and loads a WebMap from either [ArcGIS Online](https://www.arcgis.com/home/index.html) or [ArcGIS Enterprise portal](https://enterprise.arcgis.com/en/portal/latest/administer/windows/what-is-portal-for-arcgis-.htm).
@@ -51,7 +51,7 @@ declare const useMapView: (component: LitElement & Omit<Pick<MapView, "container
  *
  * See also:
  * - [SDK sample apps using the Map component](https://developers.arcgis.com/javascript/latest/sample-code/?tagged=arcgis-map)
- * - [Getting started](https://developers.arcgis.com/javascript/latest/get-started-overview/)
+ * - [Get started](https://developers.arcgis.com/javascript/latest/get-started/)
  * - [Programming patterns](https://developers.arcgis.com/javascript/latest/programming-patterns/)
  *
  * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/)
@@ -131,13 +131,14 @@ export declare class ArcgisMap extends LitElement {
     get gamepad(): __esri.GamepadSettings;
     /**
      * Allows for adding graphics directly to the default graphics in the View.
-     * Example:
-     * ```
+     *
+     * @example
+     * ```js
      * // Adds a graphic to the View
      * graphics.add(pointGraphic);
      * ```
-     * Example:
-     * ```
+     * @example
+     * ```js
      * // Removes a graphic from the View
      * graphics.remove(pointGraphic);
      * ```
@@ -155,6 +156,8 @@ export declare class ArcgisMap extends LitElement {
      * Options for configuring the highlight.
      *
      * @deprecated
+     * since 4.33, use [highlights](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/#highlights) instead.
+     *
      * Options for configuring the highlight. Use the highlight method on the
      * appropriate esri/views/layers/LayerView to highlight a feature.
      * The layerView's `highlightOptions` will take precedence over the MapView's `highlightOptions` if both properties are set.
@@ -184,7 +187,7 @@ export declare class ArcgisMap extends LitElement {
     /** The magnifier allows for showing a portion of the view as a magnifier image on top of the view. */
     readonly magnifier: __esri.Magnifier;
     /** An instance of a esri/Map object to display in the view. */
-    map: __esri.Map;
+    map: __esri.Map | nullish;
     /**
      * Indication whether the view is being navigated (for example when panning).
      *
@@ -331,28 +334,28 @@ export declare class ArcgisMap extends LitElement {
     set zoom(newValue: number);
     /**
      * @deprecated
-     * since 4.33. Use `element.map.add(layer)` instead.
+     * since 4.33, use `element.map.add(layer)` instead.
      *
      * Adds a layer to the map layers collection.
      */
     addLayer(layer: __esri.Layer | Promise<any>, index?: number): Promise<void>;
     /**
      * @deprecated
-     * since 4.33. Use `element.map.addMany([layer])` instead.
+     * since 4.33, use `element.map.addMany([layer])` instead.
      *
      * Adds a layer or array of layers to the map layers collection.
      */
     addLayers(layers: __esri.Layer[], index?: number): Promise<void>;
     /**
      * @deprecated
-     * since 4.33. Use `element.map.tables.add(table)` instead.
+     * since 4.33, use `element.map.tables.add(table)` instead.
      *
      * Adds a table to the map tables collection.
      */
     addTable(table: __esri.FeatureLayer): Promise<void>;
     /**
      * @deprecated
-     * since 4.33. Use `element.map.tables.addMany([table])` instead.
+     * since 4.33, use `element.map.tables.addMany([table])` instead.
      *
      * Adds a table or array of tables to the map tables collection.
      */
@@ -379,8 +382,18 @@ export declare class ArcgisMap extends LitElement {
     /** Gets the LayerView created on the view for the given layer. */
     whenLayerView(layer: __esri.Layer): Promise<__esri.LayerView>;
     /**
-     * `viewOnReady()` may be leveraged once an instance of the component is created and ready.
-     * This method takes two input parameters: a `callback` function and an `errback` function.
+     * `viewOnReady()` may be leveraged once an instance of the component and its underlying [view](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/#view) is created and ready.
+     * This method takes two input parameters, a `callback` function and an `errback` function, and returns a promise. The `callback` executes when the promise resolves, and the `errback` executes if the promise is rejected.
+     *
+     * @since 4.33
+     * @see [Watch for changes - waiting for components or views to be ready](https://developers.arcgis.com/javascript/latest/watch-for-changes/#waiting-for-components-or-views-to-be-ready)
+     * @example
+     * ```js
+     * const viewElement = document.querySelector("arcgis-map");
+     * await viewElement.viewOnReady();
+     * // The view is now ready to be used.
+     * viewElement.map.add(new FeatureLayer({...}));
+     * ```
      */
     viewOnReady(callback?: () => void, errback?: (error: Error) => void): Promise<void>;
     /**

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

@@ -5,11 +5,11 @@ import o from "@arcgis/core/views/MapView.js";
 import w from "@arcgis/core/WebMap.js";
 import { LitElement as p, createEvent as a, noShadowRoot as c } from "@arcgis/lumina";
 import { c as v, i as l } from "../../chunks/component-utils.js";
-import { css as m } from "@lit/reactive-element/css-tag.js";
+import { css as m } 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 */
-const d = m`@layer{arcgis-map{display:block;height:100%;.esri-view{height:100%;width:100%}}}`, g = r(
+v4.34.0-next.51 */
+const g = m`@layer{arcgis-map{display:block;height:100%;.esri-view{height:100%;width:100%}}}`, d = r(
   w,
   /**
    * Since omitProps is only needed for typing, not runtime, `{} as { ... }` is
@@ -20,21 +20,21 @@ const d = m`@layer{arcgis-map{display:block;height:100%;.esri-view{height:100%;w
    * in an externalized package.
    */
   {}
-), y = r(o, {});
-class u extends p {
+), u = r(o, {});
+class y extends p {
   constructor() {
-    super(), this._map = g(this), this.view = y(this), this.allLayerViews = this.view.allLayerViews, this.autoDestroyDisabled = !1, this.background = this.view.background, this.basemap = this._map.basemap, this.basemapView = this.view.basemapView, this.constraints = this.view.constraints, this.displayFilterDisabled = this.view.displayFilterEnabled, this.fatalError = this.view.fatalError, this.floors = this.view.floors, this.graphics = this.view.graphics, this.ground = this._map.ground, this.highlights = this.view.highlights, this.highlightOptions = this.view.highlightOptions, this.ipsInfo = this._map.ipsInfo, this.layerViews = this.view.layerViews, this.magnifier = this.view.magnifier, this.map = this.view.map, this.navigation = this.view.navigation, this.padding = this.view.padding, this.popup = this.view.popup, this.popupDisabled = this.view.popupEnabled, this.ready = this.view.ready, this.resizeAlign = this.view.resizeAlign, this.resolution = this.view.resolution, this.rotation = this.view.rotation, this.spatialReference = this.view.spatialReference, this.suspended = this.view.suspended, this.theme = this.view.theme, this.timeExtent = this.view.timeExtent, this.timeZone = this.view.timeZone, this.updating = this.view.updating, this.visibleArea = this.view.visibleArea, this.arcgisViewChange = a(), this.arcgisViewClick = e(() => this.view, "click"), this.arcgisViewDoubleClick = e(() => this.view, "double-click"), this.arcgisViewDrag = e(() => this.view, "drag"), this.arcgisViewHold = e(() => this.view, "hold"), this.arcgisViewImmediateClick = e(() => this.view, "immediate-click"), this.arcgisViewImmediateDoubleClick = e(() => this.view, "immediate-double-click"), this.arcgisViewKeyDown = e(() => this.view, "key-down"), this.arcgisViewKeyUp = e(() => this.view, "key-up"), this.arcgisViewLayerviewCreate = e(() => this.view, "layerview-create"), this.arcgisViewLayerviewCreateError = e(() => this.view, "layerview-create-error"), this.arcgisViewLayerviewDestroy = e(() => this.view, "layerview-destroy"), this.arcgisViewMouseWheel = e(() => this.view, "mouse-wheel"), this.arcgisViewPointerDown = e(() => this.view, "pointer-down"), this.arcgisViewPointerEnter = e(() => this.view, "pointer-enter"), this.arcgisViewPointerLeave = e(() => this.view, "pointer-leave"), this.arcgisViewPointerMove = e(() => this.view, "pointer-move"), this.arcgisViewPointerUp = e(() => this.view, "pointer-up"), this.arcgisViewReadyChange = a(), this.view.ui = {
+    super(), this._map = d(this), this.view = u(this), this.allLayerViews = this.view.allLayerViews, this.autoDestroyDisabled = !1, this.background = this.view.background, this.basemap = this._map.basemap, this.basemapView = this.view.basemapView, this.constraints = this.view.constraints, this.displayFilterDisabled = this.view.displayFilterEnabled, this.fatalError = this.view.fatalError, this.floors = this.view.floors, this.graphics = this.view.graphics, this.ground = this._map.ground, this.highlights = this.view.highlights, this.highlightOptions = this.view.highlightOptions, this.ipsInfo = this._map.ipsInfo, this.layerViews = this.view.layerViews, this.magnifier = this.view.magnifier, this.map = this.view.map, this.navigation = this.view.navigation, this.padding = this.view.padding, this.popup = this.view.popup, this.popupDisabled = this.view.popupEnabled, this.ready = this.view.ready, this.resizeAlign = this.view.resizeAlign, this.resolution = this.view.resolution, this.rotation = this.view.rotation, this.spatialReference = this.view.spatialReference, this.suspended = this.view.suspended, this.theme = this.view.theme, this.timeExtent = this.view.timeExtent, this.timeZone = this.view.timeZone, this.updating = this.view.updating, this.visibleArea = this.view.visibleArea, this.arcgisViewChange = a(), this.arcgisViewClick = e(() => this.view, "click"), this.arcgisViewDoubleClick = e(() => this.view, "double-click"), this.arcgisViewDrag = e(() => this.view, "drag"), this.arcgisViewHold = e(() => this.view, "hold"), this.arcgisViewImmediateClick = e(() => this.view, "immediate-click"), this.arcgisViewImmediateDoubleClick = e(() => this.view, "immediate-double-click"), this.arcgisViewKeyDown = e(() => this.view, "key-down"), this.arcgisViewKeyUp = e(() => this.view, "key-up"), this.arcgisViewLayerviewCreate = e(() => this.view, "layerview-create"), this.arcgisViewLayerviewCreateError = e(() => this.view, "layerview-create-error"), this.arcgisViewLayerviewDestroy = e(() => this.view, "layerview-destroy"), this.arcgisViewMouseWheel = e(() => this.view, "mouse-wheel"), this.arcgisViewPointerDown = e(() => this.view, "pointer-down"), this.arcgisViewPointerEnter = e(() => this.view, "pointer-enter"), this.arcgisViewPointerLeave = e(() => this.view, "pointer-leave"), this.arcgisViewPointerMove = e(() => this.view, "pointer-move"), this.arcgisViewPointerUp = e(() => this.view, "pointer-up"), this.arcgisViewReadyChange = a(), this.view.ui = {
       components: ["attribution"]
     };
   }
   static {
-    this.properties = { _map: 16, view: 32, allLayerViews: 0, autoDestroyDisabled: 5, background: 0, basemap: 1, basemapView: 0, center: 1, constraints: 0, displayFilterDisabled: 5, extent: 0, fatalError: 0, floors: 0, gamepad: 32, graphics: 0, ground: 1, highlights: 0, highlightOptions: 0, interacting: 32, ipsInfo: 0, itemId: 3, layerViews: 0, magnifier: 0, map: 0, navigating: 32, navigation: 0, padding: 0, popup: 0, popupDisabled: 5, ready: 4, resizeAlign: 1, resolution: 8, rotation: 9, scale: 9, spatialReference: 0, stationary: 32, suspended: 7, theme: 0, timeExtent: 0, timeZone: 1, updating: 4, viewpoint: 0, visibleArea: 0, zoom: 9 };
+    this.properties = { _map: 16, view: 32, allLayerViews: 0, autoDestroyDisabled: 5, background: 0, basemap: 1, basemapView: 0, center: 1, constraints: 0, displayFilterDisabled: 5, extent: 0, fatalError: 0, floors: 0, focusAreas: 0, gamepad: 32, graphics: 0, ground: 1, highlights: 0, highlightOptions: 0, interacting: 32, ipsInfo: 0, itemId: 3, layerViews: 0, magnifier: 0, map: 0, navigating: 32, navigation: 0, padding: 0, popup: 0, popupDisabled: 5, ready: 4, resizeAlign: 1, resolution: 8, rotation: 9, scale: 9, spatialReference: 0, stationary: 32, suspended: 7, theme: 0, timeExtent: 0, timeZone: 1, updating: 4, viewpoint: 0, visibleArea: 0, zoom: 9 };
   }
   static {
     this.shadowRootOptions = c;
   }
   static {
-    this.styles = d;
+    this.styles = g;
   }
   get center() {
     return this.view.center;
@@ -49,6 +49,15 @@ class u extends p {
   set extent(i) {
     i && !this.extent?.equals(i) && (this.view.extent = i);
   }
+  get focusAreas() {
+    return this.map ? this.map.focusAreas : {
+      areas: [],
+      style: "bright"
+    };
+  }
+  set focusAreas(i) {
+    this.map && (this.map.focusAreas = i);
+  }
   get gamepad() {
     return this.view.input.gamepad;
   }
@@ -86,16 +95,16 @@ class u extends p {
     this.view.zoom = i;
   }
   async addLayer(i, t) {
-    this.map.add(i, t);
+    this.map?.add(i, t);
   }
   async addLayers(i, t) {
-    this.map.addMany(i, t);
+    this.map?.addMany(i, t);
   }
   async addTable(i) {
-    this.map.tables.add(i);
+    this.map?.tables.add(i);
   }
   async addTables(i, t) {
-    this.map.tables.addMany(i, t);
+    this.map?.tables.addMany(i, t);
   }
   async closePopup() {
     this.view.closePopup();
@@ -136,13 +145,15 @@ class u extends p {
   }
   loaded() {
     this.map ||= this._map, this.manager.onLifecycle(() => [
-      s(() => this.map, () => this._map = this.map, { initial: !0, sync: !0 }),
+      s(() => this.map, (i) => {
+        i && (this._map = i);
+      }, { initial: !0, sync: !0 }),
       s(() => this.view.stationary, () => this.arcgisViewChange.emit(), { initial: !0 }),
       s(() => this.view.ready, () => this.arcgisViewReadyChange.emit(), { initial: this.view.ready })
     ]);
   }
 }
-h("arcgis-map", u);
+h("arcgis-map", y);
 export {
-  u as ArcgisMap
+  y as ArcgisMap
 };

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

@@ -83,6 +83,11 @@ export declare class ArcgisMeasurement extends LitElement {
     linearUnit: __esri.SystemOrLengthUnit;
     /** @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 ViewModel's state.

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

@@ -3,10 +3,10 @@ import { usePropertyChange as e } from "@arcgis/lumina/controllers";
 import i from "@arcgis/core/widgets/Measurement.js";
 import { LitElement as s, createEvent as a, noShadowRoot as o } from "@arcgis/lumina";
 import { m as r } 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.51 */
 const c = n`@layer{arcgis-measurement{display:block}}`, l = r(i);
 class h extends s {
   constructor() {

package/dist/components/arcgis-measurement-content/customElement.js

@@ -1,13 +1,12 @@
-import { c as n } from "../../chunks/runtime.js";
-import { html as i } from "lit-html";
-import o from "@arcgis/core/applications/Components/QuantityFormatter.js";
-import { LitElement as c, safeClassMap as s } from "@arcgis/lumina";
-import { f as l } from "../../chunks/measurementUtils.js";
-import { css as m } from "@lit/reactive-element/css-tag.js";
+import { c as r } from "../../chunks/runtime.js";
+import { css as o, html as i } from "lit";
+import c from "@arcgis/core/applications/Components/QuantityFormatter.js";
+import { LitElement as l, safeClassMap as s } from "@arcgis/lumina";
+import { f as m } from "../../chunks/measurementUtils.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.5 */
-const u = m`:host,.hint,.error,.section,.actions,.item{display:flex;flex-direction:column;gap:var(--calcite-spacing-md);animation:esri-fade-in .25s ease-in-out}.error{color:var(--calcite-color-status-danger)}.error,.hint{overflow:hidden;p{margin:0;padding:0}}.item-disabled{color:var(--calcite-color-text-1);opacity:var(--calcite-opacity-light)}.item-value{font-weight:var(--calcite-font-weight-semibold)}.actions{justify-content:center}`, e = {
+v4.34.0-next.51 */
+const u = o`:host,.hint,.error,.section,.actions,.item{display:flex;flex-direction:column;gap:var(--calcite-spacing-md);animation:esri-fade-in .25s ease-in-out}.error{color:var(--calcite-color-status-danger)}.error,.hint{overflow:hidden;p{margin:0;padding:0}}.item-disabled{color:var(--calcite-color-text-1);opacity:var(--calcite-opacity-light)}.item-value{font-weight:var(--calcite-font-weight-semibold)}.actions{justify-content:center}`, e = {
   error: "error",
   hint: "hint",
   actions: "actions",
@@ -17,9 +16,9 @@ const u = m`:host,.hint,.error,.section,.actions,.item{display:flex;flex-directi
   itemTitle: "item-title",
   itemValue: "item-value"
 };
-class d extends c {
+class d extends l {
   constructor() {
-    super(...arguments), this._formatter = new o(), this.items = [], this.state = "disabled", this.unsupportedLabel = "";
+    super(...arguments), this._formatter = new c(), this.items = [], this.state = "disabled", this.unsupportedLabel = "";
   }
   static {
     this.properties = { hintLabel: 1, items: 0, state: 1, unsupportedLabel: 1 };
@@ -47,13 +46,13 @@ function h(t) {
   return i`<section class=${s(e.section)}>${t.items.map((a) => f({ formatter: t.formatter, measurement: a.measurement, title: a.title }))}</section>`;
 }
 function f(t) {
-  const a = t.measurement.state === "available" ? l(t.formatter, t.measurement.value) : null, r = t.measurement.state === "unavailable";
+  const a = t.measurement.state === "available" ? m(t.formatter, t.measurement.value) : null, n = t.measurement.state === "unavailable";
   return i`<div class=${s({
     [e.item]: !0,
-    [e.itemDisabled]: r
+    [e.itemDisabled]: n
   })}><span class=${s(e.itemTitle)}>${t.title}</span><span aria-live=polite class=${s(e.itemValue)}>${a ?? "-"}</span></div>`;
 }
-n("arcgis-measurement-content", d);
+r("arcgis-measurement-content", d);
 export {
   d as ArcgisMeasurementContent
 };