@arcgis/map-components 4.34.0-next.9 → 4.34.0-next.90

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.34/esri/copyright.txt for details.
-v4.34.0-next.9 */
+v4.34.0-next.90 */
 class o {
   constructor() {
     this._groups = /* @__PURE__ */ new Map();
   }
   /**
-   * A handle to a [highlight](https://next.sites.afd.arcgis.com/javascript/latest/api-reference/esri-views-layers-FeatureLayerView.html#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 [Handles.remove()](https://next.sites.afd.arcgis.com/javascript/latest/api-reference/esri-core-Handles.html#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 [Accessor.removeHandles()](https://next.sites.afd.arcgis.com/javascript/latest/api-reference/esri-core-Accessor.html#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.34/esri/copyright.txt for details.
-v4.34.0-next.9 */
+v4.34.0-next.90 */
 const s = o(t);
 export {
   s as u

package/dist/chunks/useView.js

@@ -4,7 +4,7 @@ import { signal as a } from "@arcgis/core/applications/Components/reactiveUtils.
 import { a as i } from "./component-utils.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.9 */
+v4.34.0-next.90 */
 const v = (s) => m(s);
 class d extends c {
   #e = a(void 0);

package/dist/chunks/useViewModel.js

@@ -1,11 +1,11 @@
 import { proxyExports as s } from "@arcgis/lumina/controllers";
 import { AccessorController as i } from "@arcgis/lumina/controllers/accessor";
-import { isEsriInternalEnv as n } from "@arcgis/components-utils";
+import { isEsriInternalEnv as n } from "@arcgis/toolkit/error";
 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.34/esri/copyright.txt for details.
-v4.34.0-next.9 */
+v4.34.0-next.90 */
 const v = (t, o) => (e) => a(e, t);
 class r extends i {
   #o = void 0;

package/dist/chunks/useWidget.js

@@ -1,35 +1,35 @@
 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 { isEsriInternalEnv as M } from "@arcgis/toolkit/error";
 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.34/esri/copyright.txt for details.
-v4.34.0-next.9 */
-const I = (d, e) => (t) => P(t, d);
-class f extends b {
+v4.34.0-next.90 */
+const I = (d, e) => (t) => C(t, d);
+class p extends b {
   #o = /* @__PURE__ */ new Map();
   #e;
   #t;
   constructor(e, t) {
     super(e, t), new g(e);
-    const s = this, o = s.instance;
+    const i = this, o = i.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);
+      get(s, c, h) {
+        return c === "viewModel" ? n : c === "visibleElements" ? l : Reflect.get(s, c, h);
       }
     });
-    if (s.#t = o, s.instance = r, s.exports = r, n) {
-      const i = {
+    if (i.#t = o, i.instance = r, i.exports = r, n) {
+      const s = {
         component: e,
         get exports() {
-          return s.instance.viewModel;
+          return i.instance.viewModel;
         }
       };
-      E(s).set("viewModel", "viewModel"), e.addController(i), n = x(e, new WeakRef(i), w(e) - 1, n, s.#o);
+      E(i).set("viewModel", "viewModel"), e.addController(s), n = x(e, new WeakRef(s), w(e) - 1, n, i.#o);
     }
-    s.instance.visibleElements && (l = s.#s(o));
+    i.instance.visibleElements && (l = i.#i(o));
   }
   hostConnected() {
     this.instance = this.#t, super.hostConnected();
@@ -45,58 +45,58 @@ class f extends b {
   }
   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 }));
+    e.childElem ??= document.createElement("div"), this.instance.container = e.childElem, (this.component.el.shadowRoot ?? this.component.el).appendChild(this.instance.container), this.component.closed !== void 0 && this.onLifecycle(() => m(() => this.instance.visible, (i) => this.component.closed = !i, { initial: !0 }));
   }
-  #s(e) {
+  #i(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);
+      get: (t, i) => {
+        if (typeof i == "symbol" || i in Promise.prototype)
+          return t[i];
+        const o = [i], n = this.#s(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];
+          let s = e.visibleElements ?? {}, c;
+          for (const a of o.slice(0, -1))
+            if (typeof s[a] == "object" && s[a] !== null)
+              s = s[a];
             else {
-              a = !!i[c];
+              c = !!s[a];
               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)) {
+          c === void 0 && (c = !!(s[o.slice(-1)[0]] ?? !0));
+          const f = r.startsWith("hide") || r.startsWith("show") ? r.startsWith("hide") : c;
+          this.onUpdate((a) => {
+            if (a.has(r)) {
               const u = this.component[r];
-              this.#n(o, u, p);
+              this.#n(o, u, f);
             }
           });
         }, n);
       }
     });
   }
-  #i(e) {
+  #s(e) {
     const t = new Proxy({}, {
-      get: (s, o) => {
-        const n = Reflect.get(s, o);
+      get: (i, o) => {
+        const n = Reflect.get(i, o);
         return typeof o == "symbol" || o in Promise.prototype ? n : (e.push(o), t);
       }
     });
     return t;
   }
-  #n(e, t, s) {
+  #n(e, t, i) {
     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);
+    const n = !!(i ? !t : t);
     o[e.at(-1)] = n;
   }
   hostDestroy() {
     this.#e?.remove(), super.hostDestroy();
   }
 }
-process.env.NODE_ENV !== "production" && M() && (f.devOnly$allowedPropNameMismatches = /* @__PURE__ */ new Set([
+process.env.NODE_ENV !== "production" && M() && (p.devOnly$allowedPropNameMismatches = /* @__PURE__ */ new Set([
   "manager",
   "el",
   "position",
@@ -107,7 +107,7 @@ process.env.NODE_ENV !== "production" && M() && (f.devOnly$allowedPropNameMismat
   // Deprecated
   "hideLastEditInfo"
 ]));
-const P = v(f);
+const C = v(p);
 export {
   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.34/esri/copyright.txt for details.
-v4.34.0-next.9 */
+v4.34.0-next.90 */
 const s = /* @__PURE__ */ new Map([
   ["a3-landscape", "a3-landscape"],
   ["a3-portrait", "a3-portrait"],

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

@@ -1,8 +1,8 @@
 /// <reference types="@arcgis/core/interfaces.d.ts" />
-/// <reference types="../../index.d.ts" />
-import { Use } from '@arcgis/lumina/controllers';
+/// <reference path="../../index.d.ts" />
 import { default as AreaMeasurement2D } from '@arcgis/core/widgets/AreaMeasurement2D.js';
 import { PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
+import { Use } from '@arcgis/lumina/controllers';
 import { ArcgisReferenceElement } from '../../utils/component-utils';
 
 declare const useAreaMeasurement2dWidget: (component: LitElement & Pick<AreaMeasurement2D & {
@@ -11,8 +11,8 @@ declare const useAreaMeasurement2dWidget: (component: LitElement & Pick<AreaMeas
     state?: unknown;
     viewModel?: (__esri.AreaMeasurement2DViewModel & __esri.Accessor) | undefined;
     closed?: boolean;
-    icon: import('@arcgis/components-utils').Nil | string;
-    label: import('@arcgis/components-utils').Nil | string;
+    icon: import('@arcgis/toolkit/type').nil | string;
+    label: import('@arcgis/toolkit/type').nil | string;
     referenceElement?: ArcgisReferenceElement | string;
     position: __esri.UIPosition;
     arcgisReady: import('@arcgis/lumina').EventEmitter;
@@ -20,7 +20,7 @@ declare const useAreaMeasurement2dWidget: (component: LitElement & Pick<AreaMeas
         name: string;
     }> | undefined;
     el: HTMLElement & {
-        childElem?: HTMLElement & {
+        childElem? /** @copyDoc */: HTMLElement & {
             ownedBy?: HTMLElement;
         };
         view?: __esri.LinkChartView | __esri.MapView | __esri.SceneView;
@@ -61,6 +61,11 @@ export declare class ArcgisAreaMeasurement2d extends LitElement {
     label: string;
     /** @default "bottom-left" */
     position: __esri.UIPosition;
+    /**
+     * By assigning the `id` attribute of the Map or Scene component to this property, you can position a child component anywhere in the DOM while still maintaining a connection to the Map or Scene.
+     *
+     * @see [Associate components with a Map or Scene component](https://developers.arcgis.com/javascript/latest/programming-patterns/#associate-components-with-a-map-or-scene-component)
+     */
     referenceElement?: ArcgisReferenceElement | string;
     /**
      * The [SnappingOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-interactive-snapping-SnappingOptions.html) for sketching.
@@ -75,7 +80,7 @@ export declare class ArcgisAreaMeasurement2d extends LitElement {
      *
      * @default "disabled"
      */
-    readonly state: "ready" | "disabled" | "measuring" | "measured";
+    readonly state: "ready" | "disabled" | "measured" | "measuring";
     /**
      * Unit system (imperial, metric) or specific unit used for displaying the area values.
      *
@@ -98,7 +103,7 @@ export declare class ArcgisAreaMeasurement2d extends LitElement {
     readonly arcgisPropertyChange: TargetedEvent<this, {
         name: "state";
     }>;
-    /** Emitted when the component associated with a map or scene view is is ready to be interacted with. */
+    /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
     readonly arcgisReady: TargetedEvent<this, void>;
 }
 export {};

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

@@ -1,28 +1,25 @@
-import { c as t } from "../../chunks/runtime.js";
-import { usePropertyChange as e } from "@arcgis/lumina/controllers";
-import s from "@arcgis/core/widgets/AreaMeasurement2D.js";
-import { LitElement as i, createEvent as a, noShadowRoot as o } from "@arcgis/lumina";
-import { m as r } from "../../chunks/useWidget.js";
-import { css as n } from "@lit/reactive-element/css-tag.js";
+import { c as e } from "../../chunks/runtime.js";
+import i from "@arcgis/core/widgets/AreaMeasurement2D.js";
+import { LitElement as t, createEvent as r } from "@arcgis/lumina";
+import { usePropertyChange as o } from "@arcgis/lumina/controllers";
+import { m as a } from "../../chunks/useWidget.js";
+import { css as n } from "lit";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.9 */
-const h = n`@layer{arcgis-area-measurement-2d{display:block}}`, l = r(
+v4.34.0-next.90 */
+const s = n`.esri-widget__heading{color:var(--calcite-color-text-2);margin:0 0 .5rem;font-weight:var(--calcite-font-weight-semibold)}h1.esri-widget__heading{font-size:var(--calcite-font-size-xl)}h2.esri-widget__heading{font-size:var(--calcite-font-size-md)}h3.esri-widget__heading,h4.esri-widget__heading,h5.esri-widget__heading,h6.esri-widget__heading{font-size:var(--calcite-font-size)}.esri-widget{--esri-widget-padding-x: 15px;--esri-widget-padding-y: var(--calcite-spacing-md);--esri-widget-padding: var(--esri-widget-padding-y) var(--esri-widget-padding-x);box-sizing:border-box;color:var(--calcite-color-text-2);background-color:var(--calcite-color-foreground-1);font-family:Avenir Next,Helvetica Neue,helvetica,arial,sans-serif;font-size:var(--calcite-font-size);line-height:1.3em}.esri-widget *,.esri-widget :before,.esri-widget :after{box-sizing:inherit}.esri-widget.esri-widget--disabled>*{opacity:.4;pointer-events:none}.esri-widget.esri-widget--compact{--esri-widget-padding-y: 0;--esri-widget-padding-x: 0}.esri-widget__anchor{color:var(--calcite-color-text-2)}.esri-widget__anchor:hover{color:var(--calcite-color-text-3)}.esri-widget__anchor:hover,.esri-widget__anchor:focus{text-decoration:underline}.esri-widget__anchor--disabled{opacity:.4;pointer-events:none}.esri-widget__header{background-color:var(--calcite-color-foreground-1);flex:1 0 100%;justify-content:space-between;align-items:center;width:100%;min-height:48px;padding:12px 0 12px 15px;display:flex}.esri-widget__header .esri-widget__heading{width:calc(100% - 48px);text-align:initial;color:var(--calcite-color-text-1);align-items:center;margin:0;padding:0;display:flex}.esri-widget__header-button{appearance:none;cursor:pointer;color:var(--calcite-color-text-2);background-color:var(--calcite-color-foreground-1);border:none;flex:0 0 48px;justify-content:center;align-self:stretch;align-items:center;width:48px;padding:0;display:flex}.esri-widget__footer{background-color:var(--calcite-color-foreground-1);justify-content:center;align-items:center;width:100%;min-height:48px;display:flex}.esri-widget__footer-pagination{color:var(--calcite-color-text-2);justify-content:space-between;align-items:center;display:flex}.esri-widget__footer-pagination-previous-button,.esri-widget__footer-pagination-next-button{cursor:pointer;background-color:var(--calcite-color-foreground-1);border:0;margin:0 7px;padding:12px 15px;transition:background-color .125s ease-in-out}.esri-widget__footer-pagination-previous-button:hover,.esri-widget__footer-pagination-previous-button:focus,.esri-widget__footer-pagination-next-button:hover,.esri-widget__footer-pagination-next-button:focus{color:var(--calcite-color-text-1);background-color:var(--calcite-color-foreground-1)}.esri-menu{visibility:hidden;z-index:1;background-clip:padding;background-color:var(--calcite-color-foreground-1);background-clip:padding-box;width:100%;max-height:0;margin:2px 0 0;padding:0;font-size:var(--calcite-font-size);line-height:var(--calcite-spacing-xl);position:absolute;top:100%;left:0;overflow:hidden;box-shadow:0 1px 2px #0000004d}.esri-menu .esri-menu__header{color:var(--calcite-color-text-inverse);background-color:var(--calcite-color-inverse);padding:6px 12px}.esri-menu__list{margin:0;padding:0;list-style:none}.esri-menu__list-item{cursor:pointer;border-top:1px solid #adadad4d;border-left:3px solid #0000;padding:.8em 1em}.esri-menu__list-item [class^=esri-icon-],.esri-menu__list-item [class*=" esri-icon-"]{padding-right:2.8px}.esri-menu__list-item:first-child{border-top:none}.esri-menu__list-item--focus,.esri-menu__list-item:hover,.esri-menu__list-item:focus{background-color:#303030}.esri-menu__list-item:active{background-color:#000}.esri-menu__list-item--active,.esri-menu__list-item--active:hover,.esri-menu__list-item--active:focus{background-color:var(--calcite-color-foreground-1);border-left-color:#2493f2}.esri-widget__table{border-collapse:collapse;color:var(--calcite-color-text-1);border:none;width:100%;line-height:1.3em}.esri-widget__table tr:nth-child(odd){background-color:var(--calcite-color-transparent)}.esri-widget__table tr:nth-child(2n){background-color:var(--calcite-color-transparent-press)}.esri-widget__table tr a{color:var(--calcite-color-text-2)}.esri-widget__table tr a:hover,.esri-widget__table tr a:focus{color:var(--calcite-color-text-1)}.esri-widget__table tr td,.esri-widget__table tr th{vertical-align:top;word-break:break-word;padding:.5em .7em;font-size:var(--calcite-font-size-sm);font-weight:var(--calcite-font-weight-regular)}.esri-widget__table tr th{text-align:left;border-right:3px solid #0000000d;width:50%}.esri-widget__table tr td{width:50%}.esri-input{color:var(--calcite-color-text-1);background-color:var(--calcite-color-foreground-1);border:1px solid #959595;font-size:var(--calcite-font-size)}.esri-input::-ms-clear{display:none}.esri-input::placeholder{opacity:1;color:var(--calcite-color-text-2)}.esri-input:placeholder-shown{text-overflow:ellipsis}.esri-input[type=text],.esri-input[type=password],.esri-input[type=number]{height:32px;padding:0 .5em}calcite-combobox.esri-input{border:none}.esri-widget__content--empty{text-align:center;color:var(--calcite-color-border-input);flex-flow:column wrap;align-items:center;padding:18px 22px;display:flex}.esri-widget__content--empty h1.esri-widget__heading,.esri-widget__content--empty h2.esri-widget__heading,.esri-widget__content--empty h3.esri-widget__heading,.esri-widget__content--empty h4.esri-widget__heading,.esri-widget__content--empty h5.esri-widget__heading{font-weight:var(--calcite-font-weight-regular)}.esri-widget__content-illustration--empty{width:128px;padding:1rem 0}.esri-widget__content-icon--empty{width:32px;padding:.5rem 0}.esri-select{appearance:none;cursor:pointer;color:var(--calcite-color-text-2);background:var(--calcite-color-foreground-1) url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='-8 -8 32 32' width='32' height='32'%3E%3Cpath d='M8 11.207l-4-4V5.793l4 4 4-4v1.414z' fill='%23adadad' fillrule='nonzero'/%3E%3C/svg%3E") 100% no-repeat;border:1px solid #959595;border-radius:0;width:100%;height:32px;margin:0;padding:0 .5em;font-family:inherit;font-size:.85em;display:block}.esri-select[disabled]{cursor:auto}.esri-select::-ms-expand{display:none}.esri-disabled a,.esri-disabled [role=menu],.esri-disabled [role=checkbox],.esri-disabled [class^=esri-icon-],.esri-disabled [class*=" esri-icon-"]{color:var(--calcite-color-text-3)}.keynav-mode .esri-widget:focus,.keynav-mode .esri-widget :focus{z-index:1;outline-offset:2px;outline:2px solid #adadad}.esri-widget__loader-animation{border:.15em solid #adadad4d;border-top-color:var(--calcite-color-border-input);border-radius:100%;width:1em;height:1em;font-size:var(--calcite-font-size-md);animation:1.25s linear infinite esri-rotate;display:block;transform:translateZ(0)}:dir(rtl) .esri-widget__table th{text-align:right;border-left:3px solid #0000000d;border-right:none}:dir(rtl) .esri-select{background-position:0}:dir(rtl) .esri-menu__list-item{border-left:none;border-right:3px solid #0000}:dir(rtl) .esri-menu__list-item [class^=esri-icon-],:dir(rtl) .esri-menu__list-item [class*=" esri-icon-"]{padding-left:2px;padding-right:0}:dir(rtl) .esri-menu__list-item--active{border-right-color:var(--calcite-color-brand)}.esri-icon-font-fallback-text{clip:rect(0 0 0 0);width:1px;height:1px;position:absolute;overflow:hidden}.esri-rotating{animation:1.25s linear infinite esri-rotate;transform:translateZ(0)}.esri-clearfix:before,.esri-clearfix:after{content:" ";display:table}.esri-clearfix:after{clear:both}.esri-interactive{cursor:pointer}.esri-hidden{display:none!important}.esri-invisible{visibility:hidden!important}.esri-offscreen{position:absolute;top:-999em;left:-999em}.esri-match-height{flex-direction:column;flex:auto;display:flex;overflow:hidden}.esri-unit-select{width:100%}.esri-unit-select__label{--calcite-label-margin-bottom: 0;width:100%}.esri-measurement-widget-content{padding:var(--esri-widget-padding);flex-direction:column;gap:var(--calcite-spacing-xxl);display:flex;position:relative;overflow-y:auto}.esri-measurement-widget-content__error{color:var(--calcite-color-status-danger)}.esri-measurement-widget-content__error,.esri-measurement-widget-content__hint{overflow:hidden}.esri-measurement-widget-content__error p,.esri-measurement-widget-content__hint p{margin:0;padding:0}.esri-measurement-widget-content__hint,.esri-measurement-widget-content__error,.esri-measurement-widget-content__measurement,.esri-measurement-widget-content__measurement-item{flex-direction:column;gap:var(--calcite-spacing-md);animation:.25s ease-in-out esri-fade-in;display:flex}.esri-measurement-widget-content__measurement-item--disabled{color:var(--calcite-color-high-saturation-blue-h-bb-070)}.esri-measurement-widget-content__measurement-item__value{font-weight:var(--calcite-font-weight-semibold)}.esri-measurement-widget-content__actions{flex-direction:column;justify-content:center;gap:var(--calcite-spacing-xs);display:flex}:host{display:block}`, d = a(
   // Workaround for https://devtopia.esri.com/WebGIS/arcgis-js-api/issues/61559
-  s
+  i
 );
-class m extends i {
+class l extends t {
   constructor() {
-    super(...arguments), this.widget = l(this), this.viewModel = this.widget.viewModel, this.autoDestroyDisabled = !1, this.icon = this.widget.icon, this.label = this.widget.label, this.position = "bottom-left", this.snappingOptions = this.widget.snappingOptions, this.state = this.viewModel.state, this.unit = this.widget.unit, this.unitOptions = this.widget.unitOptions, this.arcgisPropertyChange = e()("state"), this.arcgisReady = a();
+    super(...arguments), this.widget = d(this), this.viewModel = this.widget.viewModel, this.autoDestroyDisabled = !1, this.icon = this.widget.icon, this.label = this.widget.label, this.position = "bottom-left", this.snappingOptions = this.widget.snappingOptions, this.state = this.viewModel.state, this.unit = this.widget.unit, this.unitOptions = this.widget.unitOptions, this.arcgisPropertyChange = o()("state"), this.arcgisReady = r();
   }
   static {
     this.properties = { autoDestroyDisabled: 5, icon: 1, label: 1, position: 1, referenceElement: 1, snappingOptions: 0, state: 3, unit: 1, unitOptions: 0 };
   }
   static {
-    this.shadowRootOptions = o;
-  }
-  static {
-    this.styles = h;
+    this.styles = s;
   }
   async clear() {
     this.viewModel?.clear();
@@ -34,7 +31,7 @@ class m extends i {
     this.viewModel?.start();
   }
 }
-t("arcgis-area-measurement-2d", m);
+e("arcgis-area-measurement-2d", l);
 export {
-  m as ArcgisAreaMeasurement2d
+  l as ArcgisAreaMeasurement2d
 };

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

@@ -1,6 +1,5 @@
 /// <reference types="@arcgis/core/interfaces.d.ts" />
-/// <reference types="../../index.d.ts" />
-import { default as AreaMeasurementAnalysis } from '@arcgis/core/analysis/AreaMeasurementAnalysis.js';
+/// <reference path="../../index.d.ts" />
 import { PublicLitElement as LitElement, JsxNode, TargetedEvent } from '@arcgis/lumina';
 import { Use } from '@arcgis/lumina/controllers';
 import { ArcgisReferenceElement } from '../../utils/component-utils';
@@ -8,14 +7,96 @@ import { default as AreaMeasurement3dViewModel } from './AreaMeasurement3dViewMo
 
 declare const useViewModel: (component: LitElement & Pick<AreaMeasurement3dViewModel, never> & import('../../controllers/useViewModel').ViewModelControllerUses<AreaMeasurement3dViewModel>) => AreaMeasurement3dViewModel;
 /**
- * The Area Measurement 3D component calculates and displays the area and perimeter of a polygon.
- * This component can be used in a [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html)
- * to measure the area and perimeter of a polygon.
+ * The Area Measurement 3D component can be added to a [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/)
+ * component to calculate and display area and perimeter of polygons.
+ *
+ * [![measurement-area-3d](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/3D_AreaMeasurement_widget.png)](https://developers.arcgis.com/javascript/latest/sample-code/measurement-3d/)
+ *
+ * How the area and perimeter are computed depends on the scene's spatial reference and the length of the measured perimeter.
+ *
+ * In **geographic coordinate systems** (GCS) and in **Web Mercator**:
+ * - If the measurement's perimeter is below 100 km, they are computed in a Euclidean manner,
+ *   in an [ECEF](https://en.wikipedia.org/wiki/ECEF) coordinate system (or equivalent on other planets).
+ * - If the perimeter is above 100 km, they are computed geodetically, and the visualization takes
+ *   the curvature of the planet into consideration.
+ *
+ * In **projected coordinate systems** (PCS), apart from Web Mercator, the area and perimeter
+ * are always calculated in a Euclidean manner (in their respective PCS).
+ *
+ * The area may be visualized and calculated in two ways:
+ * 1. If all the vertices are mostly coplanar (lying on the same plane),
+ *    the measurement polygon is formed on that plane, and area and perimeter are calculated from its geometry.
+ * 2. If the vertices don't form a planar surface, the measurement polygon
+ *    is projected to a horizontal plane, and area and perimeter are calculated from its geometry.
+ *
+ * ![area-measurement-3d-types](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/area-measurement-3d-types.png)
+ *
+ * When the component is active, a horizontal "laser" line is drawn which indicates the height at the current mouse position.
+ * This line can help in analyzing the heights of objects relative to each other and the terrain.
+ *
+ * **Things to consider**
+ *
+ * * Area Measurement 3D is designed to work in the Scene component. For measurements in the [Map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/)
+ * component, use [Area Measurement 2D](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-area-measurement-2d/).
+ * * Snapping is enabled by default. Holding the `CTRL` key disables it.
+ * * Layer types currently supported for snapping are:
+ * [FeatureLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html),
+ * [GraphicsLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-GraphicsLayer.html) (except Mesh geometries),
+ * [GeoJSONLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-GeoJSONLayer.html),
+ * [WFSLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-WFSLayer.html),
+ * [CSVLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-CSVLayer.html),
+ * [3D Object SceneLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-SceneLayer.html),
+ * and [BuildingSceneLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-BuildingSceneLayer.html).
+ *
+ * **See also**
+ *
+ * - [AreaMeasurementAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-AreaMeasurementAnalysis.html)
+ * - [Sample - Measurement in 3D](https://developers.arcgis.com/javascript/latest/sample-code/measurement-3d/)
+ * - [Sample - Analysis objects](https://developers.arcgis.com/javascript/latest/sample-code/analysis-objects/)
  *
  * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-area-measurement-3d/)
  */
 export declare class ArcgisAreaMeasurement3d extends LitElement {
-    get analysis(): AreaMeasurementAnalysis;
+    /**
+     * The [AreaMeasurementAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-AreaMeasurementAnalysis.html)
+     * created or modified by the component.
+     *
+     * When connecting the Area Measurement 3D component to the [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/)
+     * component, it automatically creates an empty analysis and adds it to the Scene's
+     * [analyses](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#analyses) collection.
+     * Whenever the component is destroyed, the analysis is automatically removed from the collection.
+     *
+     * Alternatively, a programmatically created analysis can be provided to the component.
+     * Then, the application itself needs to add it to and later remove it from the Scene's analyses collection.
+     *
+     * ```js
+     * // Create the analysis.
+     * const areaMeasurementAnalysis = new AreaMeasurementAnalysis({
+     *    geometry: new Polygon({
+     *      spatialReference: { latestWkid: 3857, wkid: 102100 },
+     *      rings: [
+     *        [
+     *          [-13624861.22274897, 4550346.5519295, 63.378210234455764],
+     *          [-13624935.305160372, 4550273.144585712, 63.37829629518092],
+     *          [-13624995.61798748, 4550334.030096778, 63.37819860037416],
+     *          [-13624921.53589075, 4550407.42357004, 63.3783810287714],
+     *          [-13624861.22274897, 4550346.5519295, 63.378210234455764]
+     *        ]
+     *      ]
+     *    })
+     * });
+     * // Get the Scene and measurement component and wait until they are ready.
+     * const viewElement = document.querySelector("arcgis-scene");
+     * await viewElement.viewOnReady();
+     * const areaMeasurement3d = document.querySelector("arcgis-area-measurement-3d");
+     * await areaMeasurement3d.componentOnReady();
+     * // Add the analysis to the Scene component.
+     * viewElement.analyses.add(areaMeasurementAnalysis);
+     * // Connect the analysis to the measurement component:
+     * areaMeasurement3d.analysis = areaMeasurementAnalysis;
+     * ```
+     */
+    analysis: __esri.AreaMeasurementAnalysis;
     /**
      * 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
@@ -38,22 +119,43 @@ export declare class ArcgisAreaMeasurement3d extends LitElement {
     label?: string;
     /** @default "bottom-left" */
     position: __esri.UIPosition;
+    /**
+     * By assigning the `id` attribute of the Map or Scene component to this property, you can position a child component anywhere in the DOM while still maintaining a connection to the Map or Scene.
+     *
+     * @see [Associate components with a Map or Scene component](https://developers.arcgis.com/javascript/latest/programming-patterns/#associate-components-with-a-map-or-scene-component)
+     */
     referenceElement?: ArcgisReferenceElement | string;
-    /** The current state of the component. */
-    state: "ready" | "disabled" | "measuring" | "measured";
-    /** Unit system (imperial, metric) or specific unit used for displaying the distance values. */
+    /**
+     * The component's state. The values mean the following:
+     *
+     * * `disabled` -  not ready yet
+     * * `ready` - ready for measuring
+     * * `measuring` - currently measuring
+     * * `measured` - measuring has finished
+     */
+    readonly state: "ready" | "disabled" | "measured" | "measuring";
+    /**
+     * Unit system (imperial, metric) or specific unit used for displaying the area values. Possible values are listed in
+     * [unitOptions](#unitOptions).
+     */
     unit: __esri.SystemOrAreaUnit;
-    /** List of unit systems (imperial, metric) and specific units for displaying the distance values. */
+    /**
+     * List of available units and unit systems (imperial, metric) that are shown in the component's dropdown.
+     * By default, the following units are included: `metric`, `imperial`, `square-inches`, `square-feet`, `square-us-feet`, `square-yards`, `square-miles`, `square-meters`, `square-kilometers`, `acres`, `ares`, `hectares`.
+     * Possible [unit](#unit) values can only be a subset of this list.
+     */
     unitOptions: __esri.SystemOrAreaUnit[];
+    /** Clears the current measurement. */
     clear(): Promise<void>;
     /** 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" | "analysis";
     }>;
-    /** Emitted when the component associated with a map or scene view is is ready to be interacted with. */
+    /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
     readonly arcgisReady: TargetedEvent<this, void>;
 }
 export {};