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

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

@@ -1,4 +1,4 @@
-import { c as I } from "../../chunks/runtime.js";
+import { c as _ } 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";
@@ -9,12 +9,12 @@ import { m as k } 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 { 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,7 +27,7 @@ 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.4 */
+v4.34.0-next.40 */
 const ie = K`@layer{arcgis-locate{display:block}}`;
 let M = !1;
 const re = {
@@ -46,7 +46,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 +54,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 +263,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 +282,7 @@ let l = class extends B {
     ]);
   }
   destroy() {
-    this._clearGraphic(), this.view = null;
+    this._clearGraphic(), this.view = void 0;
   }
   //#endregion
   //#region Private Methods
@@ -351,7 +351,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 +362,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 +376,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 +490,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 +521,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,31 +547,31 @@ 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);
+}, S = "gps-off", Ce = k(l);
 class Ee extends z {
   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 = V(), 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 = G()("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 };
@@ -613,11 +613,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 = H === void 0 ? S : void 0, h = this._localizeError(this.viewModel?.error);
+    return m`<div class=${w(F(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 ?? 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>`;
   }
 }
-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

@@ -8,8 +8,8 @@ import { c as v, i as l } from "../../chunks/component-utils.js";
 import { css as m } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.4 */
-const d = m`@layer{arcgis-map{display:block;height:100%;.esri-view{height:100%;width:100%}}}`, g = r(
+v4.34.0-next.40 */
+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

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

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

@@ -6,7 +6,7 @@ import { f as l } from "../../chunks/measurementUtils.js";
 import { css as m } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.4 */
+v4.34.0-next.40 */
 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 = {
   error: "error",
   hint: "hint",

package/dist/components/arcgis-navigation-toggle/customElement.d.ts

@@ -6,7 +6,7 @@ import { PropertyValues } from 'lit';
 import { useView } from '../../controllers/useView';
 import { ArcgisReferenceElement } from '../../utils/component-utils';
 
-type State = "disabled" | "ready";
+type NavigationToggleState = "disabled" | "ready";
 type NavigationMode = "pan" | "rotate";
 type LayoutMode = "horizontal" | "vertical";
 /**
@@ -16,7 +16,9 @@ type LayoutMode = "horizontal" | "vertical";
  * to rotate the view. When the navigation mode is set to "rotate", the mouse drag gesture rotates the view and
  * right-click + drag pans the view.
  *
- * The Navigation Toggle component is only supported in 3D.
+ * **Known limitations**
+ *
+ * Navigation Toggle is only supported in a 3D [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/) component.
  *
  * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-navigation-toggle/)
  */
@@ -36,29 +38,31 @@ export declare class ArcgisNavigationToggle extends LitElement {
      * @default "vertical"
      */
     layout: LayoutMode;
-    /** 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 navigation mode of the view. See the table below for a list of
-     * possible values.
+     * The navigation mode of the view. The possible values:
      *
-     * Possible Value | Description
-     * ---------------|-------------
-     * pan | The mouse drag gesture pans the view. Right-click + drag allows the user to perform a 3D rotate around the center of the view.
-     * rotate | The mouse drag gesture performs a 3D rotate around the center of the view and the right-click + drag gesture pans the view.
+     * * `pan` - The mouse drag gesture pans the view. Right-click + drag allows the user to perform a 3D rotate around the center of the view.
+     * * `rotate` - The mouse drag gesture performs a 3D rotate around the center of the view and the right-click + drag gesture pans the view.
      *
      * @default "pan"
      */
     navigationMode: NavigationMode;
     /** @default "top-left" */
     position: __esri.UIPosition;
-    referenceElement?: ArcgisReferenceElement | string;
     /**
-     * The current state of the component.
+     * 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.
      *
-     * @default "disabled"
+     * @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)
      */
-    state: State;
+    referenceElement?: ArcgisReferenceElement | string;
+    /** The current state of the component. */
+    get state(): NavigationToggleState;
     toggle(): Promise<void>;
     /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
     readonly arcgisPropertyChange: TargetedEvent<this, {

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

@@ -9,22 +9,25 @@ import { g as b } from "../../chunks/globalCss.js";
 import { css as M } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.4 */
-const $ = "arcgis-navigation-toggle", w = {
+v4.34.0-next.40 */
+const $ = "arcgis-navigation-toggle", _ = {
   base: $
-}, x = M`@layer{.arcgis-navigation-toggle{display:flex;box-shadow:0 1px 2px #0000004d;inline-size:fit-content;block-size:fit-content}}`, e = { pan: "move", rotate: "rotate" };
-class _ extends g {
+}, w = M`@layer{.arcgis-navigation-toggle{display:flex;box-shadow:0 1px 2px #0000004d;inline-size:fit-content;block-size:fit-content}}`, e = { pan: "move", rotate: "rotate" };
+class x extends g {
   constructor() {
-    super(...arguments), this.view = f(this), this._messages = y(), this.icon = e.pan, this.layout = "vertical", this.navigationMode = "pan", this.position = "top-left", this.state = "disabled", this.arcgisPropertyChange = d()("layout", "state"), this.arcgisReady = h();
+    super(...arguments), this.view = f(this), this._messages = y(), this._state = "disabled", this.icon = e.pan, this.layout = "vertical", this.navigationMode = "pan", this.position = "top-left", this.arcgisPropertyChange = d()("layout", "state"), this.arcgisReady = h();
   }
   static {
-    this.properties = { icon: 1, label: 1, layout: 3, messageOverrides: 0, navigationMode: 3, position: 1, referenceElement: 1, state: 3 };
+    this.properties = { _state: 16, icon: 1, label: 1, layout: 3, messageOverrides: 0, navigationMode: 3, position: 1, referenceElement: 1, state: 35 };
   }
   static {
     this.shadowRootOptions = m;
   }
   static {
-    this.styles = x;
+    this.styles = w;
+  }
+  get state() {
+    return this._state;
   }
   async toggle() {
     this.state !== "disabled" && (this.navigationMode = this.navigationMode !== "pan" ? "pan" : "rotate");
@@ -36,7 +39,7 @@ class _ extends g {
         const { view: t } = this;
         return t?.ready && t?.type === "3d" ? "ready" : "disabled";
       }, (t) => {
-        this.state = t;
+        this._state = t;
       }, { sync: !0, initial: !0 })
     ]);
   }
@@ -58,10 +61,10 @@ class _ extends g {
   }
   render() {
     const { _messages: t, navigationMode: a, state: l } = this, s = t.pan ?? "", o = t.rotate ?? "", i = l === "disabled", n = a === "pan";
-    return u`<calcite-action-bar class=${v({ [w.base]: !0, [b.disabled]: i })} expand-disabled .layout=${this.layout} scale=s><calcite-action .active=${n} appearance=solid .disabled=${i} .icon=${e.pan} @click=${this._onPanClick} scale=s .text=${s} title=${s ?? r}></calcite-action><calcite-action .active=${!n} appearance=solid .disabled=${i} .icon=${e.rotate} @click=${this._onRotateClick} scale=s .text=${o} title=${o ?? r}></calcite-action></calcite-action-bar>`;
+    return u`<calcite-action-bar class=${v({ [_.base]: !0, [b.disabled]: i })} expand-disabled .layout=${this.layout} scale=s><calcite-action .active=${n} appearance=solid .disabled=${i} .icon=${e.pan} @click=${this._onPanClick} scale=s .text=${s} title=${s ?? r}></calcite-action><calcite-action .active=${!n} appearance=solid .disabled=${i} .icon=${e.rotate} @click=${this._onRotateClick} scale=s .text=${o} title=${o ?? r}></calcite-action></calcite-action-bar>`;
   }
 }
-p("arcgis-navigation-toggle", _);
+p("arcgis-navigation-toggle", x);
 export {
-  _ as ArcgisNavigationToggle
+  x as ArcgisNavigationToggle
 };

package/dist/components/arcgis-oriented-imagery-viewer/customElement.d.ts

@@ -136,6 +136,11 @@ export declare class ArcgisOrientedImageryViewer extends LitElement {
     orientedImageryLayerItemId?: string;
     /** @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;
     /**
      * This property provides the location of an image pixel in Map coordinates when using map-image conversion tool.

package/dist/components/arcgis-oriented-imagery-viewer/customElement.js

@@ -7,7 +7,7 @@ import { m as l } from "../../chunks/useWidget.js";
 import { css as g } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.4 */
+v4.34.0-next.40 */
 const h = g`@layer{arcgis-oriented-imagery-viewer{display:block}}`, m = l(r);
 class y extends o {
   constructor() {

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

@@ -12,6 +12,11 @@ import { ToElement, PublicLitElement as LitElement, TargetedEvent } from '@arcgi
 export declare class ArcgisPlacement extends LitElement {
     /** @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;
     /** Emitted when the component associated with a map or scene view is is ready to be interacted with. */
     readonly arcgisReady: TargetedEvent<this, void>;