@arcgis/map-components 4.34.0-next.3 → 4.34.0-next.31

package/dist/components/arcgis-link-chart-layout-switcher/customElement.d.ts

@@ -55,7 +55,6 @@ export declare class ArcgisLinkChartLayoutSwitcher extends LitElement {
      * Icon displayed in the component's button, when `appearance` is `dropdown`.
      *
      * @see [Calcite Icon Search](https://developers.arcgis.com/calcite-design-system/icons/)
-     * @since 4.28
      * @default "nodes-link"
      */
     icon?: string;
@@ -69,7 +68,11 @@ export declare class ArcgisLinkChartLayoutSwitcher extends LitElement {
      * @default "organic-standard"
      */
     readonly layout: DiagramLayoutType;
-    /** 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;
@@ -81,6 +84,12 @@ export declare class ArcgisLinkChartLayoutSwitcher extends LitElement {
      * @default false
      */
     preventExtentUpdate: boolean;
+    /**
+     * 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 also:
+     * - [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.
@@ -98,9 +107,11 @@ export declare class ArcgisLinkChartLayoutSwitcher extends LitElement {
      * Fires when component has completed the layout switch
      *
      * @example
+     * ```js
      * layoutswitcher.addEventListener("arcgisSwitchLayout", (event) => {
      *   console.log("Layout Switched");
      * });
+     * ```
      */
     readonly arcgisSwitchLayout: TargetedEvent<this, __esri.LinkChartLayoutSwitcherViewModelSwitchLayoutEvent>;
     /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */

package/dist/components/arcgis-link-chart-layout-switcher/customElement.js

@@ -1,18 +1,17 @@
-import { c as d } from "../../chunks/runtime.js";
+import { c as n } from "../../chunks/runtime.js";
 import { html as e } from "lit-html";
-import { classes as m } from "@arcgis/components-utils";
-import { g as s } from "../../chunks/globalCss.js";
-import g from "@arcgis/core/widgets/LinkChartLayoutSwitcher/LinkChartLayoutSwitcherViewModel.js";
-import { usePropertyChange as p } from "@arcgis/lumina/controllers";
-import { m as u } from "../../chunks/useViewModel.js";
-import { u as y } from "../../chunks/useT9n.js";
-import { reEmitEvent as w } from "@arcgis/lumina/controllers/accessor";
-import { LitElement as b, createEvent as f, noShadowRoot as v, safeClassMap as c } from "@arcgis/lumina";
-import { css as $ } from "@lit/reactive-element/css-tag.js";
+import { classes as h } from "@arcgis/components-utils";
+import d from "@arcgis/core/widgets/LinkChartLayoutSwitcher/LinkChartLayoutSwitcherViewModel.js";
+import { usePropertyChange as m } from "@arcgis/lumina/controllers";
+import { m as g } from "../../chunks/useViewModel.js";
+import { u as p } from "../../chunks/useT9n.js";
+import { reEmitEvent as u } from "@arcgis/lumina/controllers/accessor";
+import { LitElement as y, createEvent as w, noShadowRoot as b, safeClassMap as f } from "@arcgis/lumina";
+import { css as v } 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.3 */
-const L = $`@layer{arcgis-link-chart-layout-switcher{display:block}}`, l = {
+v4.34.0-next.31 */
+const L = v`@layer{arcgis-link-chart-layout-switcher{display:block}}`, c = {
   basicLayoutCategory: [
     "basic-grid"
     /* SIMPLE */
@@ -37,7 +36,7 @@ const L = $`@layer{arcgis-link-chart-layout-switcher{display:block}}`, l = {
     "chronological-multi-timeline"
     /* CHRONOLOGICAL_MULTIPLE */
   ]
-}, n = {
+}, s = {
   "organic-standard": "force-directed-link-chart-layout",
   "organic-community": "community-link-chart-layout",
   "basic-grid": "simple-link-chart-layout",
@@ -47,7 +46,7 @@ const L = $`@layer{arcgis-link-chart-layout-switcher{display:block}}`, l = {
   "geographic-organic-standard": "geographic-link-chart-layout",
   "chronological-mono-timeline": "single-timeline",
   "chronological-multi-timeline": "multi-timeline"
-}, h = {
+}, l = {
   "organic-standard": "forceDirected",
   "organic-community": "community",
   "basic-grid": "simple",
@@ -57,18 +56,18 @@ const L = $`@layer{arcgis-link-chart-layout-switcher{display:block}}`, l = {
   "geographic-organic-standard": "geographic",
   "chronological-mono-timeline": "chronologicalSingle",
   "chronological-multi-timeline": "chronologicalMultiple"
-}, k = {
+}, $ = {
   base: "esri-link-chart-layout-switcher"
-}, M = u(g);
-class C extends b {
+}, k = g(d);
+class M extends y {
   constructor() {
-    super(...arguments), this.messages = y(), this.viewModel = M(this), this.appearance = "dropdown", this.autoDestroyDisabled = !1, this.closeOnSelectDisabled = !1, this.icon = "nodes-link", this.layout = this.viewModel.layout, this.position = "top-left", this.preventExtentUpdate = this.viewModel.preventExtentUpdate, this.state = this.viewModel.state, this.arcgisSwitchLayout = w(() => this.viewModel, "switchLayout"), this.arcgisPropertyChange = p()("state"), this.arcgisReady = f();
+    super(...arguments), this.messages = p(), this.viewModel = k(this), this.appearance = "dropdown", this.autoDestroyDisabled = !1, this.closeOnSelectDisabled = !1, this.icon = "nodes-link", this.layout = this.viewModel.layout, this.position = "top-left", this.preventExtentUpdate = this.viewModel.preventExtentUpdate, this.state = this.viewModel.state, this.arcgisSwitchLayout = u(() => this.viewModel, "switchLayout"), this.arcgisPropertyChange = m()("state"), this.arcgisReady = w();
   }
   static {
     this.properties = { appearance: 1, autoDestroyDisabled: 5, closeOnSelectDisabled: 5, icon: 1, label: 1, layout: 32, messageOverrides: 0, position: 3, preventExtentUpdate: 5, referenceElement: 1, state: 3 };
   }
   static {
-    this.shadowRootOptions = v;
+    this.shadowRootOptions = b;
   }
   static {
     this.styles = L;
@@ -80,19 +79,19 @@ class C extends b {
     this.viewModel.switchLayout(t);
   }
   _renderDropdown() {
-    const { messages: t, icon: o } = this;
-    return e`<calcite-dropdown scale=s width=m max-items=9 .closeOnSelectDisabled=${this.closeOnSelectDisabled}><calcite-button class=${c(s.widgetButton)} slot=trigger kind=neutral .disabled=${this.viewModel.state === "disabled"} .iconStart=${o ?? void 0} .label=${t.layoutOptions ?? "Layout"}></calcite-button>${Object.entries(l).map(([r, i]) => e`<calcite-dropdown-group selection-mode=single .groupTitle=${this.messages[r]}>${i.map((a) => e`<calcite-dropdown-item .iconStart=${n[a]} .selected=${a === this.layout ? !0 : void 0} @click=${() => void this.switchLayout(a)}>${t[h[a]]}</calcite-dropdown-item>`)}</calcite-dropdown-group>`)}</calcite-dropdown>`;
+    const { messages: t, icon: a } = this;
+    return e`<calcite-dropdown scale=s width=m max-items=9 .closeOnSelectDisabled=${this.closeOnSelectDisabled}><calcite-action slot=trigger .disabled=${this.viewModel.state === "disabled"} .icon=${a ?? void 0} .label=${t.layoutOptions ?? "Layout"} appearance=solid scale=s .text=${t.layoutOptions ?? "Layout"}></calcite-action>${Object.entries(c).map(([r, i]) => e`<calcite-dropdown-group selection-mode=single .groupTitle=${this.messages[r]}>${i.map((o) => e`<calcite-dropdown-item .iconStart=${s[o]} .selected=${o === this.layout ? !0 : void 0} @click=${() => void this.switchLayout(o)}>${t[l[o]]}</calcite-dropdown-item>`)}</calcite-dropdown-group>`)}</calcite-dropdown>`;
   }
   _renderMenuBar() {
     const { messages: t } = this;
-    return e`<calcite-action-bar scale=s floating overflow-actions-disabled>${Object.entries(l).map(([o, r]) => e`<calcite-action-group .label=${this.messages[o]}>${r.map((i) => e`<calcite-action scale=s .icon=${n[i]} .active=${i === this.layout ? !0 : void 0} @click=${() => void this.switchLayout(i)} .text=${t[h[i]]}></calcite-action>`)}</calcite-action-group>`)}</calcite-action-bar>`;
+    return e`<calcite-action-bar scale=s floating overflow-actions-disabled>${Object.entries(c).map(([a, r]) => e`<calcite-action-group .label=${this.messages[a]}>${r.map((i) => e`<calcite-action scale=s .icon=${s[i]} .active=${i === this.layout ? !0 : void 0} @click=${() => void this.switchLayout(i)} .text=${t[l[i]]}></calcite-action>`)}</calcite-action-group>`)}</calcite-action-bar>`;
   }
   render() {
-    const { appearance: t } = this, o = t === "menu-bar" ? this._renderMenuBar() : this._renderDropdown();
-    return e`<div class=${c(m(k.base, s.widget))}>${o}</div>`;
+    const { appearance: t } = this, a = t === "menu-bar" ? this._renderMenuBar() : this._renderDropdown();
+    return e`<div class=${f(h($.base))}>${a}</div>`;
   }
 }
-d("arcgis-link-chart-layout-switcher", C);
+n("arcgis-link-chart-layout-switcher", M);
 export {
-  C as ArcgisLinkChartLayoutSwitcher
+  M as ArcgisLinkChartLayoutSwitcher
 };

package/dist/components/arcgis-link-chart-layout-switcher/index.d.ts

@@ -1,8 +1,7 @@
 import "@esri/calcite-components/components/calcite-dropdown";
-import "@esri/calcite-components/components/calcite-button";
+import "@esri/calcite-components/components/calcite-action";
 import "@esri/calcite-components/components/calcite-dropdown-group";
 import "@esri/calcite-components/components/calcite-dropdown-item";
 import "@esri/calcite-components/components/calcite-action-bar";
 import "@esri/calcite-components/components/calcite-action-group";
-import "@esri/calcite-components/components/calcite-action";
 export * from "./customElement.js";

package/dist/components/arcgis-link-chart-layout-switcher/index.js

@@ -1,8 +1,7 @@
 import "@esri/calcite-components/components/calcite-dropdown";
-import "@esri/calcite-components/components/calcite-button";
+import "@esri/calcite-components/components/calcite-action";
 import "@esri/calcite-components/components/calcite-dropdown-group";
 import "@esri/calcite-components/components/calcite-dropdown-item";
 import "@esri/calcite-components/components/calcite-action-bar";
 import "@esri/calcite-components/components/calcite-action-group";
-import "@esri/calcite-components/components/calcite-action";
 export * from "./customElement.js";

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

@@ -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.3 */
+v4.34.0-next.31 */
 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,
@@ -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([
+], c.prototype, "view", 2);
+c = p([
   S("map-components.geolocation.GeolocationPositioning")
-], l);
+], 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,7 +490,7 @@ 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);
@@ -521,7 +521,7 @@ 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;
@@ -547,28 +547,28 @@ 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([
+], l.prototype, "state", 1);
+l = d([
   S("map-components.locate.LocateViewModel")
-], c);
+], l);
 const Ce = {
   base: "esri-locate"
-}, C = "gps-off", Se = k(c);
+}, C = "gps-off", Se = 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();

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.3 */
-const d = m`@layer{arcgis-map{display:block;height:100%;.esri-view{height:100%;width:100%}}}`, g = r(
+v4.34.0-next.31 */
+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.3 */
+v4.34.0-next.31 */
 const c = n`@layer{arcgis-measurement{display:block}}`, l = r(i);
 class h extends s {
   constructor() {