@arcgis/map-components 4.33.0-next.151 → 4.33.0-next.153

package/dist/components/arcgis-distance-measurement-2d/customElement.js

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

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

@@ -6,7 +6,7 @@ import { m as n } from "../../chunks/useWidget.js";
 import { css as r } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.151 */
+v4.33.0-next.153 */
 const g = r`@layer{arcgis-editor{display:block}}`, d = n(s);
 class h extends o {
   constructor() {

package/dist/components/arcgis-elevation-profile/customElement.js

@@ -6,7 +6,7 @@ import { m as n } from "../../chunks/useWidget.js";
 import { css as l } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.151 */
+v4.33.0-next.153 */
 const r = l`@layer{arcgis-elevation-profile{display:block}}`, a = n(e);
 class d extends s {
   constructor() {

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

@@ -97,6 +97,7 @@ export declare class ArcgisExpand extends LitElement {
     /**
      * Disables focus trapping within the expand component.
      *
+     * @since 4.33
      * @default false
      */
     focusTrapDisabled: boolean;

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

@@ -5,7 +5,7 @@ import { m as a } 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.33/esri/copyright.txt for details.
-v4.33.0-next.151 */
+v4.33.0-next.153 */
 const d = n`@layer{arcgis-expand{display:flex;pointer-events:auto}arcgis-expand>.esri-expand__content--expanded{background-color:var(--calcite-color-background)}}`, c = a(e);
 class l extends s {
   constructor() {

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

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

package/dist/components/arcgis-feature-form/customElement.d.ts

@@ -80,7 +80,7 @@ export declare class ArcgisFeatureForm extends LitElement {
      *
      * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-FeatureForm.html#layer)
      */
-    layer: nullish | __esri.FeatureLayer | __esri.SceneLayer | __esri.GeoJSONLayer | __esri.OrientedImageryLayer | __esri.SubtypeSublayer;
+    layer: nullish | __esri.FeatureLayer | __esri.SceneLayer | __esri.GeoJSONLayer | __esri.OrientedImageryLayer | __esri.SubtypeSublayer | __esri.KnowledgeGraphSublayer;
     /** @default "bottom-left" */
     position: __esri.UIPosition;
     referenceElement?: ArcgisReferenceElement | string;

package/dist/components/arcgis-feature-form/customElement.js

@@ -7,7 +7,7 @@ import { m as h } from "../../chunks/useWidget.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.33/esri/copyright.txt for details.
-v4.33.0-next.151 */
+v4.33.0-next.153 */
 const l = m`@layer{arcgis-feature-form{display:block}}`, g = h(s);
 class n extends r {
   constructor() {

package/dist/components/arcgis-feature-table/customElement.js

@@ -9,7 +9,7 @@ import { e as m, g as c } from "../../chunks/component-utils.js";
 import { css as u } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.151 */
+v4.33.0-next.153 */
 const w = u`@layer{arcgis-feature-table{display:block}.arcgis-feature-table{width:100%;height:100%}}`, p = g(a);
 class b extends d {
   constructor() {

package/dist/components/arcgis-feature-templates/customElement.js

@@ -7,7 +7,7 @@ import { m as a } from "../../chunks/useWidget.js";
 import { css as h } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.151 */
+v4.33.0-next.153 */
 const n = h`@layer{arcgis-feature-templates{display:block}}`, c = a(s);
 class d extends o {
   constructor() {

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

@@ -8,7 +8,7 @@ import { css as l } from "@lit/reactive-element/css-tag.js";
 import { c } from "../../chunks/createCloseEvent.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.151 */
+v4.33.0-next.153 */
 const g = l`@layer{arcgis-features{display:flex;flex-direction:column;overflow:hidden;.esri-features{flex:1 1 auto;overflow:hidden}}}`, u = d(o);
 class w extends r {
   constructor() {

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

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

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

@@ -24,7 +24,11 @@ export declare class ArcgisFullscreen extends LitElement {
     element?: HTMLElement;
     /** The component's default label. */
     label?: string;
-    /** Replace localized message strings with your own strings. <br>_**Note**: 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;

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

@@ -9,7 +9,7 @@ import { css as p } from "@lit/reactive-element/css-tag.js";
 import { u as h } from "../../chunks/useView.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.151 */
+v4.33.0-next.153 */
 const g = p`arcgis-fullscreen{display:block}`, E = {
   base: "esri-fullscreen"
 };

package/dist/components/arcgis-grid-controls/customElement.d.ts

@@ -211,7 +211,11 @@ export declare class ArcgisGridControls extends LitElement {
      * @default false
      */
     autoDestroyDisabled: boolean;
-    /** Replace localized message strings with your own strings. <br>_**Note**: Individual message keys may change between releases._ */
+    /**
+     * Replace localized message strings with your own strings.
+     *
+     * _**Note**: Individual message keys may change between releases._
+     */
     messageOverrides?: typeof this._messages._overrides;
     /** The component's default label. */
     label?: string;

package/dist/components/arcgis-grid-controls/customElement.js

@@ -15,7 +15,7 @@ import { watch as D } from "@arcgis/core/core/reactiveUtils.js";
 import L from "@arcgis/core/widgets/support/GridControls/GridControlsViewModel.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.151 */
+v4.33.0-next.153 */
 function B(s) {
   if (s == null || Number.isNaN(s))
     return 0;

package/dist/components/arcgis-histogram-range-slider/customElement.js

@@ -6,7 +6,7 @@ import { m as n } from "../../chunks/useWidget.js";
 import { css as d } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.151 */
+v4.33.0-next.153 */
 const h = d`@layer{arcgis-histogram-range-slider{display:block}}`, l = n(s);
 class g extends a {
   constructor() {

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

@@ -42,7 +42,11 @@ export declare class ArcgisHome extends LitElement {
     icon?: string;
     /** The component's default label. */
     label?: string;
-    /** Replace localized message strings with your own strings. <br>_**Note**: 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;

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

@@ -11,7 +11,7 @@ import { g as a } from "../../chunks/globalCss.js";
 import { css as u } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.151 */
+v4.33.0-next.153 */
 const b = u`@layer{arcgis-home{display:block}}`, y = {
   base: "esri-home"
 }, M = f(d);

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

@@ -6,7 +6,7 @@ import { LitElement as m, createEvent as b, safeClassMap as c } from "@arcgis/lu
 import { css as f } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.151 */
+v4.33.0-next.153 */
 const g = f`.label{--calcite-label-margin-bottom: 0}.label-content{display:flex;flex:1;gap:var(--calcite-spacing-sm);align-items:center;text-wrap:balance}.label-content>div{flex-grow:1}.icon{margin-top:-1px;&.info{color:var(--calcite-color-status-info)}&.warning{color:var(--calcite-color-status-warning)}}.tooltip{text-wrap:wrap}`, e = {
   label: "label",
   labelContent: "label-content",

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

@@ -8,7 +8,7 @@ import { s as n } from "../../chunks/layer-list.js";
 import { c as g } from "../../chunks/createCloseEvent.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.151 */
+v4.33.0-next.153 */
 const c = d(a);
 class m extends r {
   constructor() {

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

@@ -10,7 +10,7 @@ import { s as E } from "../../chunks/layer-list.js";
 import { u as x } from "../../chunks/useT9n.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.151 */
+v4.33.0-next.153 */
 const D = {
   hideChildren: "hide-children"
 };

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

@@ -6,7 +6,7 @@ import { m as o } 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.33/esri/copyright.txt for details.
-v4.33.0-next.151 */
+v4.33.0-next.153 */
 const l = n`@layer{arcgis-legend{display:block}}`, d = o(i);
 class h extends s {
   constructor() {

package/dist/components/arcgis-line-of-sight/customElement.d.ts

@@ -51,7 +51,11 @@ export declare class ArcgisLineOfSight extends LitElement {
     icon?: HTMLCalciteIconElement["icon"];
     /** The component's default label. */
     label?: string;
-    /** Replace localized message strings with your own strings. <br>_**Note**: Individual message keys may change between releases._ */
+    /**
+     * Replace localized message strings with your own strings.
+     *
+     * _**Note**: Individual message keys may change between releases._
+     */
     messageOverrides?: typeof this._messages._overrides;
     /** @default "bottom-left" */
     position: __esri.UIPosition;

package/dist/components/arcgis-line-of-sight/customElement.js

@@ -11,7 +11,7 @@ import x from "@arcgis/core/analysis/LineOfSightAnalysis.js";
 import { property as O, subclass as A } from "@arcgis/core/core/accessorSupport/decorators.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.151 */
+v4.33.0-next.153 */
 const C = w`@layer{arcgis-line-of-sight{display:block}.arcgis-line-of-sight__container{display:flex;position:relative;flex-flow:column;gap:var(--calcite-spacing-md);padding:var(--esri-widget-padding);overflow-y:auto}.arcgis-line-of-sight__error{color:var(--calcite-color-status-danger)}.arcgis-line-of-sight__hint{display:flex;flex-direction:column;gap:var(--calcite-spacing-md)}.arcgis-line-of-sight__error,.arcgis-line-of-sight__hint{overflow:hidden;animation:arcgis-line-of-sight-fade-in .25s ease-in-out;p{margin:0;padding:0}}.arcgis-line-of-sight__actions{display:flex;flex-flow:column;gap:var(--calcite-spacing-xxs);justify-content:center}@keyframes arcgis-line-of-sight-fade-in{0%{opacity:0}25%{opacity:0}to{opacity:1}}}`, a = "arcgis-line-of-sight", r = {
   base: a,
   actions: `${a}__actions`,

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

@@ -91,6 +91,8 @@ export declare class ArcgisLinkChart extends LitElement {
      * A container of all [focus areas](https://developers.arcgis.com/javascript/latest/api-reference/esri-effects-FocusAreas.html) present in the map.
      *
      * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html#focusAreas)
+     *
+     * @since 4.33
      */
     get focusAreas(): __esri.FocusAreas;
     set focusAreas(newValue: __esri.FocusAreas);
@@ -308,8 +310,17 @@ export declare class ArcgisLinkChart 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-link-chart/#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-link-chart");
+     * await viewElement.viewOnReady();
+     * // The view is now ready to be used.
+     * ```
      */
     viewOnReady(callback?: () => void, errback?: (error: Error) => void): Promise<void>;
     /**

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

@@ -8,7 +8,7 @@ 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.33/esri/copyright.txt for details.
-v4.33.0-next.151 */
+v4.33.0-next.153 */
 const g = m`@layer{arcgis-link-chart{display:block;height:100%;.esri-view{height:100%;width:100%}}}`, d = r(
   w,
   /**

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

@@ -68,7 +68,11 @@ export declare class ArcgisLinkChartLayoutSwitcher extends LitElement {
      * @default "organic-standard"
      */
     readonly layout: DiagramLayoutType;
-    /** Replace localized message strings with your own strings. <br>_**Note**: 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;

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

@@ -11,7 +11,7 @@ import { LitElement as b, createEvent as f, noShadowRoot as v, safeClassMap as c
 import { css as $ } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.151 */
+v4.33.0-next.153 */
 const L = $`@layer{arcgis-link-chart-layout-switcher{display:block}}`, l = {
   basicLayoutCategory: [
     "basic-grid"

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';
@@ -23,21 +22,25 @@ 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. <br>_**Note**: 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;
@@ -50,7 +53,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.33/esri/copyright.txt for details.
-v4.33.0-next.151 */
+v4.33.0-next.153 */
 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

@@ -131,6 +131,8 @@ export declare class ArcgisMap extends LitElement {
      * A container of all [focus areas](https://developers.arcgis.com/javascript/latest/api-reference/esri-effects-FocusAreas.html) present in the map.
      *
      * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html#focusAreas)
+     *
+     * @since 4.33
      */
     get focusAreas(): __esri.FocusAreas;
     set focusAreas(newValue: __esri.FocusAreas);
@@ -192,7 +194,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).
      *
@@ -387,8 +389,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,7 +8,7 @@ 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.33/esri/copyright.txt for details.
-v4.33.0-next.151 */
+v4.33.0-next.153 */
 const g = m`@layer{arcgis-map{display:block;height:100%;.esri-view{height:100%;width:100%}}}`, d = r(
   w,
   /**
@@ -95,16 +95,16 @@ class y 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();
@@ -145,7 +145,9 @@ class y 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 })
     ]);

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.33/esri/copyright.txt for details.
-v4.33.0-next.151 */
+v4.33.0-next.153 */
 const c = n`@layer{arcgis-measurement{display:block}}`, l = r(i);
 class h extends s {
   constructor() {