@arcgis/map-components 4.33.0-next.99 → 4.33.0

package/dist/chunks/measurementUtils.js

@@ -0,0 +1,50 @@
+/*! 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 */
+const t = ["metric", "imperial"], r = [
+  "inches",
+  "feet",
+  "yards",
+  "miles",
+  "nautical-miles",
+  "us-feet",
+  "millimeters",
+  "centimeters",
+  "decimeters",
+  "meters",
+  "kilometers"
+], a = [
+  "square-inches",
+  "square-feet",
+  "square-yards",
+  "square-miles",
+  "square-nautical-miles",
+  "square-us-feet",
+  "square-millimeters",
+  "square-centimeters",
+  "square-decimeters",
+  "square-meters",
+  "square-kilometers",
+  "acres",
+  "ares",
+  "hectares"
+], n = [...t, ...a], i = [...t, ...r];
+function u(e, s = !0) {
+  return s ? e == null ? { state: "unavailable" } : { state: "available", value: e } : { state: "invalid" };
+}
+function m(e, s) {
+  switch (s.type) {
+    case "length":
+      return e.formatLength(s);
+    case "area":
+      return e.formatArea(s);
+    default:
+      return "";
+  }
+}
+export {
+  n as a,
+  m as f,
+  u as g,
+  i as m
+};

package/dist/chunks/runtime.js

@@ -1,11 +1,16 @@
-import { makeRuntime as t } from "@arcgis/lumina";
+import { makeRuntime as e } from "@arcgis/lumina";
+import { trackAccess as s, createObservable as a, createTrackingTarget as r, runTracked as c } from "@arcgis/core/applications/Components/reactiveUtils.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.99 */
-const s = t({ defaultAssetPath: "https://jsdev.arcgis.com/map-components/next/", hydratedAttribute: "hydrated" }), { customElement: a, getAssetPath: m, setAssetPath: o } = s;
+v4.33.0 */
+const t = e({ defaultAssetPath: "https://js.arcgis.com/4.33/map-components/", hydratedAttribute: "hydrated" }), { customElement: n, getAssetPath: i, setAssetPath: d } = t;
+t.t = s;
+t.o = a;
+t.c = r;
+t.r = c;
 export {
-  a as c,
-  m as g,
-  s as r,
-  o as s
+  n as c,
+  i as g,
+  t as r,
+  d as s
 };

package/dist/chunks/useHandles.js

@@ -1,13 +1,13 @@
 import { toFunction as i, Controller as n } from "@arcgis/lumina/controllers";
 /*! 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.99 */
+v4.33.0 */
 class o {
   constructor() {
     this._groups = /* @__PURE__ */ new Map();
   }
   /**
-   * A handle to a {@link module:esri/views/layers/FeatureLayerView#highlight highlight} call result.
+   * A handle to a [highlight](https://next.gha.afd.arcgis.com/javascript/latest/api-reference/esri-views-layers-FeatureLayerView.html#highlight) call result.
    * The handle can be used to remove the installed highlight.
    *
    * @typedef module:esri/core/Handles~Handle
@@ -53,7 +53,7 @@ class o {
    * @param {module:esri/core/Accessor~WatchHandle | module:esri/core/Accessor~WatchHandle[] | module:esri/core/Collection<module:esri/core/Accessor~WatchHandle>} handles - An array or collection handles to group.
    * @param {*} [groupKey]
    *    Key identifying the group to which the handles should be added. All the handles in the group
-   *    can later be removed with {@link module:esri/core/Handles#remove Handles.remove()}. If no
+   *    can later be removed with [Handles.remove()](https://next.gha.afd.arcgis.com/javascript/latest/api-reference/esri-core-Handles.html#remove). If no
    *    key is provided the handles are added to a default group.
    *
    * @example
@@ -191,7 +191,7 @@ class h extends n {
    *    Handles marked for removal once the object is destroyed.
    * @param {*} [groupKey]
    *    Key identifying the group to which the handles should be added. All the handles in the group
-   *    can later be removed with {@link module:esri/core/Accessor#removeHandles Accessor.removeHandles()}.
+   *    can later be removed with [Accessor.removeHandles()](https://next.gha.afd.arcgis.com/javascript/latest/api-reference/esri-core-Accessor.html#removeHandles).
    *    If no key is provided the handles are added to a default group.
    */
   addHandles(e, s) {

package/dist/chunks/useT9n.js

@@ -2,7 +2,7 @@ import { makeT9nController as o } from "@arcgis/lumina/controllers";
 import { g as t } from "./runtime.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.99 */
+v4.33.0 */
 const s = o(t);
 export {
   s as u

package/dist/chunks/useView.js

@@ -1,60 +1,61 @@
-import { proxyExports as a, GenericController as c } from "@arcgis/lumina/controllers";
-import * as h from "@arcgis/core/core/reactiveUtils.js";
-import { signal as l } from "@arcgis/core/applications/Components/reactiveUtils.js";
-import { a as o } from "./component-utils.js";
+import { proxyExports as h, GenericController as c } from "@arcgis/lumina/controllers";
+import * as l from "@arcgis/core/core/reactiveUtils.js";
+import { signal as a } from "@arcgis/core/applications/Components/reactiveUtils.js";
+import { a as i } from "./component-utils.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.99 */
-const y = (s) => m(s);
+v4.33.0 */
+const v = (s) => m(s);
 class d extends c {
+  #e = a(void 0);
+  #o = void 0;
+  #t = !1;
   constructor(e) {
-    super(e), this._view$ = l(void 0), this._viewDestroyHandle = void 0, this._canEmitArcgisReady = !1;
+    super(e);
     const { el: t } = e, n = t.view;
     this.setProvisionalExports(void 0), Object.defineProperty(t, "view", {
-      get: () => this._view$.value,
-      set: (i) => {
-        if (this.exports === i)
+      get: () => this.#e.value,
+      set: (o) => {
+        if (this.exports === o)
           return;
         const r = t.view;
-        this._view$.value = i, this.exports = i, this.component.requestUpdate("view", r), this._notifyViewReady();
+        this.#e.value = o, this.exports = o, this.component.requestUpdate("view", r), this.#i();
       },
       configurable: !0,
       enumerable: !0
     }), e !== t && Object.defineProperty(e, "view", {
       get: () => t.view,
-      set: (i) => {
-        t.view = i;
+      set: (o) => {
+        t.view = o;
       }
-    }), queueMicrotask(() => {
-      n && (t.view = n);
-    });
+    }), queueMicrotask(() => n ? t.view = n : 0);
   }
   hostConnected() {
-    this.component.manager.hasDestroy && (this._viewDestroyHandle ??= h.when(
-      () => this._view$.value?.destroyed,
+    this.component.manager.hasDestroy && (this.#o ??= l.when(
+      () => this.#e.value?.destroyed,
       () => void this.component.destroy?.().catch(console.error),
       { sync: !0 }
-    ), this.onDestroy(() => this._viewDestroyHandle?.remove())), this.component.manager.loadedCalled && o(this.component);
+    ), this.onDestroy(() => this.#o?.remove())), this.component.manager.loadedCalled && i(this.component);
   }
   hostLoad() {
     this.component.manager.destroyed;
   }
   hostLoaded() {
     const { el: e } = this.component, t = e.shadowRoot?.firstElementChild ?? e.firstElementChild ?? void 0;
-    e.childElem = t ?? e.childElem, this._canEmitArcgisReady = !0, this._notifyViewReady(), e.isConnected && o(this.component);
+    e.childElem ??= t, this.#t = !0, this.#i(), e.isConnected && i(this.component);
   }
   hostDisconnected() {
-    typeof this.component.el.childElem == "object" && this._view$.value?.ui?.remove(this.component.el.childElem);
+    typeof this.component.el.childElem == "object" && this.#e.value?.ui?.remove(this.component.el.childElem);
   }
   hostUpdate(e) {
-    e.has("position") && this.component.el.childElem != null && typeof this.component.position == "string" && o(this.component), e.has("referenceElement") && o(this.component);
+    e.has("position") && this.component.el.childElem != null && typeof this.component.position == "string" && i(this.component), e.has("referenceElement") && i(this.component);
   }
-  _notifyViewReady() {
-    !this._canEmitArcgisReady || this._view$.value == null || (this._canEmitArcgisReady = !1, this.component.arcgisReady.emit());
+  #i() {
+    !this.#t || this.#e.value == null || (this.#t = !1, this.component.arcgisReady.emit());
   }
 }
-const m = a(d);
+const m = h(d);
 export {
   d as V,
-  y as u
+  v as u
 };

package/dist/chunks/useViewModel.js

@@ -1,31 +1,32 @@
 import { proxyExports as s } from "@arcgis/lumina/controllers";
 import { AccessorController as i } from "@arcgis/lumina/controllers/accessor";
-import { V as n } from "./useView.js";
-import { watch as a } from "@arcgis/core/core/reactiveUtils.js";
+import { isEsriInternalEnv as n } from "@arcgis/components-utils";
+import { V as m } from "./useView.js";
+import { watch as p } from "@arcgis/core/core/reactiveUtils.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.99 */
-const d = (t, o) => (e, r) => c(e, t, r);
-class l extends i {
-  constructor() {
-    super(...arguments), this.viewController = new n(
-      this.component
-    ), this._viewWatchHandle = void 0;
+v4.33.0 */
+const v = (t, o) => (e) => a(e, t);
+class r extends i {
+  #o = void 0;
+  constructor(o, e) {
+    super(o, e), new m(this.component);
   }
-  async hostLoad() {
-    await super.hostLoad(), this._viewWatchHandle = a(
+  hostLoad() {
+    this.#o = p(
       () => this.component.el.view,
       (o) => {
-        this._instance.view = o, this._instance.map = o?.map;
+        this.instance.view = o, this.instance.map = o?.map;
       },
       { sync: !0, initial: !0 }
     );
   }
   hostDestroy() {
-    this._viewWatchHandle?.remove(), super.hostDestroy();
+    this.#o?.remove(), super.hostDestroy();
   }
 }
-const c = s(l);
+process.env.NODE_ENV !== "production" && n() && (r.devOnly$allowedPropNameMismatches = /* @__PURE__ */ new Set(["manager", "el", "swipePosition"]));
+const a = s(r);
 export {
-  d as m
+  v as m
 };

package/dist/chunks/useWidget.js

@@ -1,125 +1,113 @@
-import { proxyExports as f, trackPropKey as p } from "@arcgis/lumina/controllers";
-import { AccessorController as y, accessorSupport as r } from "@arcgis/lumina/controllers/accessor";
-import { a as h } from "./component-utils.js";
-import { watch as u, when as _ } from "@arcgis/core/core/reactiveUtils.js";
+import { proxyExports as v, getControllersCount as w, trackPropKey as y } from "@arcgis/lumina/controllers";
+import { AccessorController as b, getAccessorControllerBoundProperties as E, makeBinderProxy as x } from "@arcgis/lumina/controllers/accessor";
+import { isEsriInternalEnv as M } from "@arcgis/components-utils";
+import { V as g } from "./useView.js";
+import { watch as m } from "@arcgis/core/core/reactiveUtils.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.99 */
-const M = (d, i) => (t, s) => b(t, d, s);
-class v extends y {
-  constructor(i, t, s) {
-    super(i, t, s), this._watchedViewModelProperties = /* @__PURE__ */ new Map(), this._watchedVisibleElementsProperties = {}, this._isBindingViewModel = { value: !0 }, Object.defineProperty(this.exports, "viewModel", {
-      value: r.makeGetterProxy(i, this._watchedViewModelProperties, this._isBindingViewModel)
-    }), Object.defineProperty(this.exports, "visibleElements", {
-      value: this._makeVisibleElementsBinder()
+v4.33.0 */
+const I = (d, e) => (t) => P(t, d);
+class f extends b {
+  #o = /* @__PURE__ */ new Map();
+  #e;
+  #t;
+  constructor(e, t) {
+    super(e, t), new g(e);
+    const s = this, o = s.instance;
+    let n = o.viewModel, l = o.visibleElements;
+    const r = new Proxy(this.exports, {
+      get(i, a, h) {
+        return a === "viewModel" ? n : a === "visibleElements" ? l : Reflect.get(i, a, h);
+      }
     });
-  }
-  hostConnected() {
-    super.hostConnected(), this._isBindingViewModel.value = !1, this.component.manager.loadedCalled && h(this.component);
-  }
-  async hostLoad() {
-    if (this._watchedProperties.delete("viewModel"), await super.hostLoad(), this.component.manager.destroyed)
-      return;
-    this.onLifecycle(() => u(() => this._instance.viewModel, (s) => {
-      this.component.viewModel = s;
-    }, { initial: !0 }));
-    const i = this._instance.viewModel;
-    typeof i == "object" && (r.watchComponentUpdates(this, i, this._watchedViewModelProperties), r.watchAccessorUpdates(this, i, this._watchedViewModelProperties));
-    const t = Object.entries(this._watchedVisibleElementsProperties);
-    if (t.length > 0) {
-      const s = /* @__PURE__ */ new Set();
-      t.forEach(([e, n]) => {
-        let o = this._instance.visibleElements ?? {}, c;
-        for (const l of n.slice(0, -1))
-          if (typeof o[l] == "object" && o[l] !== null)
-            o = o[l];
-          else {
-            c = !!o[l];
-            break;
-          }
-        c === void 0 && (c = !!(o[n.slice(-1)[0]] ?? !0)), e.startsWith("hide");
-        const w = e.startsWith("hide") || e.startsWith("show") ? e.startsWith("hide") : c, a = this.component;
-        typeof a[e] == "boolean" ? this._updateWidgetVisibleElement(n, a[e], w) : a[e] = !1, w && s.add(e);
-      }), this.onUpdate((e) => t.forEach(([n, o]) => {
-        if (e.has(n)) {
-          const c = this.component[n], m = s.has(n);
-          this._updateWidgetVisibleElement(o, c, m);
+    if (s.#t = o, s.instance = r, s.exports = r, n) {
+      const i = {
+        component: e,
+        get exports() {
+          return s.instance.viewModel;
         }
-      }));
+      };
+      E(s).set("viewModel", "viewModel"), e.addController(i), n = x(e, new WeakRef(i), w(e) - 1, n, s.#o);
     }
+    s.instance.visibleElements && (l = s.#s(o));
   }
-  _updateWidgetVisibleElement(i, t, s) {
-    let e = this._instance.visibleElements ?? {};
-    for (const o of i.slice(0, -1))
-      (typeof e[o] != "object" || e[o] === null) && (e[o] = {}), e = e[o];
-    const n = !!(s ? !t : t);
-    e[i.at(-1)] = n;
-  }
-  hostLoaded() {
-    const { el: i } = this.component;
-    i.childElem ??= document.createElement("div"), this._instance.container = i.childElem;
-    let t = !1;
-    const s = this.component.el.view;
-    Object.defineProperty(this.component.el, "view", {
-      get: () => this._instance.view ?? this._instance.viewModel?.view,
-      set: (e) => {
-        !("view" in this._instance) && typeof this._instance.viewModel == "object" ? this._instance.viewModel.view = e : this._instance.view = e, !("map" in this._instance) && typeof this._instance.viewModel == "object" ? this._instance.viewModel.map = e.map : this._instance.map = e.map, this._watchViewDestroy(), e && !t && (t = !0, this.component.arcgisReady.emit());
-      },
-      configurable: !0,
-      enumerable: !0
-    }), s && (this._instance.view = s), this.component.el.isConnected && (h(this.component), this._watchViewDestroy());
+  hostConnected() {
+    this.instance = this.#t, super.hostConnected();
   }
-  hostDisconnected() {
-    typeof this.component.el.childElem == "object" && this.component.el.view?.ui?.remove(this.component.el.childElem);
+  hostLoad() {
+    this.#e = m(() => this.component.el.view, (e) => {
+      const t = this.instance;
+      !("view" in t) && typeof t.viewModel == "object" ? t.viewModel.view = e : t.view = e, !("map" in t) && typeof t.viewModel == "object" ? t.viewModel.map = e?.map : t.map = e?.map;
+    }, { sync: !0, initial: !0 });
   }
-  hostDestroy() {
-    super.hostDestroy(), this._watchViewDestroyHandle?.remove();
+  hostUpdate(e) {
+    e.has("closed") && (this.instance.visible = !this.component.closed);
   }
-  hostUpdated(i) {
-    i.has("position") && this.component.el.childElem != null && typeof this.component.position == "string" && h(this.component), i.has("referenceElement") && h(this.component);
+  hostLoaded() {
+    const { el: e } = this.component;
+    e.childElem ??= document.createElement("div"), this.instance.container = e.childElem, this.component.closed !== void 0 && this.onLifecycle(() => m(() => this.instance.visible, (t) => this.component.closed = !t, { initial: !0 }));
   }
-  _makeVisibleElementsBinder() {
-    return new Proxy({}, {
-      has: (i, t) => typeof t == "string" || Reflect.has(i, t),
-      get: (i, t) => {
-        if (typeof t == "symbol" || t in Promise.prototype)
-          return Reflect.get(i, t);
-        const s = [t], e = this._makeRecursiveProxy(s);
-        return p(this.component, (n) => {
-          const o = n;
-          this.component[o] = !1, this._watchedVisibleElementsProperties[o] = s;
-        }, e);
+  #s(e) {
+    return new Proxy(e.visibleElements, {
+      get: (t, s) => {
+        if (typeof s == "symbol" || s in Promise.prototype)
+          return t[s];
+        const o = [s], n = this.#i(o);
+        return y(this.component, (l) => {
+          const r = l;
+          this.component[r] = !1;
+          let i = e.visibleElements ?? {}, a;
+          for (const c of o.slice(0, -1))
+            if (typeof i[c] == "object" && i[c] !== null)
+              i = i[c];
+            else {
+              a = !!i[c];
+              break;
+            }
+          a === void 0 && (a = !!(i[o.slice(-1)[0]] ?? !0));
+          const p = r.startsWith("hide") || r.startsWith("show") ? r.startsWith("hide") : a;
+          this.onUpdate((c) => {
+            if (c.has(r)) {
+              const u = this.component[r];
+              this.#n(o, u, p);
+            }
+          });
+        }, n);
       }
     });
   }
-  _makeRecursiveProxy(i) {
+  #i(e) {
     const t = new Proxy({}, {
-      get: (s, e) => {
-        const n = Reflect.get(s, e);
-        return typeof e == "symbol" || e in Promise.prototype ? n : (i.push(e), t);
+      get: (s, o) => {
+        const n = Reflect.get(s, o);
+        return typeof o == "symbol" || o in Promise.prototype ? n : (e.push(o), t);
       }
     });
     return t;
   }
-  /**
-   * Destroy the component if view gets destroyed.
-   *
-   * When view is destroyed, component disconnect is triggered, which will
-   * destroy the component in 1s but that can be too late, because in the
-   * meanwhile, a watcher on the widget/viewModel instance may get triggered,
-   * and throw an error if it's not able to access this.view.map or etc
-   * (happens in VersionManagementViewModel for example).
-   *
-   * We can't check for this in disconnectedCallback though as, if the entire
-   * component tree is removed, the disconnect for the component will be
-   * triggered before that of arcgis-map, so the view might not be destroyed
-   * yet at that point.
-   */
-  _watchViewDestroy() {
-    this._watchViewDestroyHandle?.remove(), this._watchViewDestroyHandle = _(() => this.component.el.view?.destroyed === !0, () => void this.component.destroy().catch(console.error), { sync: !0 });
+  #n(e, t, s) {
+    let o = this.instance.visibleElements ?? {};
+    for (const l of e.slice(0, -1))
+      (typeof o[l] != "object" || o[l] === null) && (o[l] = {}), o = o[l];
+    const n = !!(s ? !t : t);
+    o[e.at(-1)] = n;
+  }
+  hostDestroy() {
+    this.#e?.remove(), super.hostDestroy();
   }
 }
-const b = f(v);
+process.env.NODE_ENV !== "production" && M() && (f.devOnly$allowedPropNameMismatches = /* @__PURE__ */ new Set([
+  "manager",
+  "el",
+  "position",
+  "multipleSortEnabled",
+  // Deprecated
+  "focusTrapEnabled",
+  "focusTrapDisabled",
+  // Deprecated
+  "hideLastEditInfo"
+]));
+const P = v(f);
 export {
-  M as m
+  I as m
 };

package/dist/chunks/utils.js

@@ -1,7 +1,7 @@
 import { formatNumber as r } from "@arcgis/core/intl.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.99 */
+v4.33.0 */
 const s = /* @__PURE__ */ new Map([
   ["a3-landscape", "a3-landscape"],
   ["a3-portrait", "a3-portrait"],

package/dist/components/arcgis-area-measurement-2d/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 { default as AreaMeasurement2D } from '@arcgis/core/widgets/AreaMeasurement2D.js';
 import { PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { ArcgisReferenceElement } from '../../utils/component-utils';
@@ -11,9 +10,10 @@ declare const useAreaMeasurement2dWidget: (component: LitElement & Pick<AreaMeas
 }, "icon" | "label" | "viewModel" | "snappingOptions" | "unit" | "unitOptions"> & {
     state?: unknown;
     viewModel?: (__esri.AreaMeasurement2DViewModel & __esri.Accessor) | undefined;
-    icon: Nil | string;
-    label: Nil | string;
-    referenceElement: ArcgisReferenceElement | Nil | string;
+    closed?: boolean;
+    icon: import('@arcgis/components-utils').Nil | string;
+    label: import('@arcgis/components-utils').Nil | string;
+    referenceElement?: ArcgisReferenceElement | string;
     position: __esri.UIPosition;
     arcgisReady: import('@arcgis/lumina').EventEmitter;
     arcgisPropertyChange: import('@arcgis/lumina').EventEmitter<{
@@ -23,49 +23,86 @@ declare const useAreaMeasurement2dWidget: (component: LitElement & Pick<AreaMeas
         childElem?: HTMLElement & {
             ownedBy?: HTMLElement;
         };
-        view?: __esri.MapView | __esri.SceneView | Nil;
+        view?: __esri.LinkChartView | __esri.MapView | __esri.SceneView;
     };
     autoDestroyDisabled: boolean;
     destroy: () => Promise<void>;
-}, options?: {
-    editConstructorProperties(props: __esri.AreaMeasurement2DProperties): __esri.AreaMeasurement2DProperties | Promise<__esri.AreaMeasurement2DProperties>;
-} | undefined) => AreaMeasurement2D & {
+}) => AreaMeasurement2D & {
     viewModel: __esri.Accessor;
 };
-/** AreaMeasurement2D component calculates and displays the area and perimeter of a polygon only in a [MapView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html).
+/**
+ * The Area Measurement 2D component calculates and displays the area and perimeter of a polygon only in a [MapView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html).
+ *
+ * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-area-measurement-2d/)
  */
 export declare class ArcgisAreaMeasurement2d extends LitElement {
     /**
      * If true, the component will not be destroyed automatically when it is
      * disconnected from the document. This is useful when you want to move the
      * component to a different place on the page, or temporarily hide it. If this
-     * is set, make sure to call the \`destroy\` method when you are done to prevent
-     * memory leaks.
+     * is set, make sure to call the [destroy](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-area-measurement-2d/#destroy) method when you are done to
+     * prevent memory leaks.
+     *
+     * @default false
      */
     autoDestroyDisabled: boolean;
     /**
      * Icon which represents the component.
      * Typically used when the component is controlled by another component (e.g. by the Expand component).
-     * Search [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/) for possible values.
+     *
+     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
+     * @default "measure-area"
      */
     icon: string;
-    /** The component's default label. */
+    /**
+     * The widget's default label.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-AreaMeasurement2D.html#label)
+     */
     label: string;
+    /** @default "bottom-left" */
     position: __esri.UIPosition;
-    referenceElement: ArcgisReferenceElement | Nil | string;
+    /**
+     * 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 [SnappingOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-interactive-snapping-SnappingOptions.html) for sketching.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-AreaMeasurement2D.html#snappingOptions)
+     */
     snappingOptions: __esri.SnappingOptions;
+    /**
+     * The current state of the component.
+     *
+     * @default "disabled"
+     */
     readonly state: "ready" | "disabled" | "measuring" | "measured";
+    /**
+     * Unit system (imperial, metric) or specific unit used for displaying the area values.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-AreaMeasurement2D.html#unit)
+     */
     unit: __esri.SystemOrAreaUnit;
+    /**
+     * List of available units and unit systems (imperial, metric) for displaying the area values.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-AreaMeasurement2D.html#unitOptions)
+     */
     unitOptions: __esri.SystemOrAreaUnit[];
     /** Clear the current measurement. */
     clear(): Promise<void>;
-    /** Permanently destroy the component */
+    /** Permanently destroy the component. */
     destroy(): Promise<void>;
     /** Starts a new measurement. */
     start(): Promise<void>;
+    /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
     readonly arcgisPropertyChange: TargetedEvent<this, {
         name: "state";
     }>;
-    readonly arcgisReady: TargetedEvent<this, undefined>;
+    /** Emitted when the component associated with a map or scene view is is ready to be interacted with. */
+    readonly arcgisReady: TargetedEvent<this, void>;
 }
 export {};

package/dist/components/arcgis-area-measurement-2d/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.99 */
+v4.33.0 */
 const h = n`@layer{arcgis-area-measurement-2d{display:block}}`, l = r(
   // Workaround for https://devtopia.esri.com/WebGIS/arcgis-js-api/issues/61559
   s
@@ -24,17 +24,12 @@ class m extends i {
   static {
     this.styles = h;
   }
-  //#endregion
-  //#region Public Methods
-  /** Clear the current measurement. */
   async clear() {
     this.viewModel?.clear();
   }
-  /** Permanently destroy the component */
   async destroy() {
     await this.manager.destroy();
   }
-  /** Starts a new measurement. */
   async start() {
     this.viewModel?.start();
   }