@arcgis/map-components 4.34.0-next.14 → 4.34.0-next.141

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.14 */
-const I = (d, e) => (t) => P(t, d);
-class f extends b {
+v4.34.0-next.141 */
+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.14 */
+v4.34.0-next.141 */
 const s = /* @__PURE__ */ new Map([
   ["a3-landscape", "a3-landscape"],
   ["a3-portrait", "a3-portrait"],

package/dist/chunks/utils2.js

@@ -0,0 +1,92 @@
+import { substitute as o, formatNumber as l } from "@arcgis/core/intl.js";
+import { stripHTML as s } from "@arcgis/core/applications/Components/stringUtils.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.141 */
+function d(r, t) {
+  return t;
+}
+function u(r, t, i) {
+  if (!t)
+    return;
+  if (typeof t == "number")
+    return t;
+  if (typeof t == "string")
+    return s(t);
+  if ("value" in t || "unit" in t)
+    return o(r.dotValue ?? "", t);
+  if ("colorName" in t && "bandName" in t) {
+    const n = r[t.colorName], a = r[t.bandName] || t.bandName;
+    return `${n}: ${a}`;
+  }
+  if ("showCount" in t)
+    return t.showCount ? r.clusterCountTitle : void 0;
+  let e = null;
+  return d(t, i) ? e = t.ratioPercentTotal ? "showRatioPercentTotal" : t.ratioPercent ? "showRatioPercent" : t.ratio ? "showRatio" : t.normField ? "showNormField" : t.field ? "showField" : null : c(t, i) && (e = t.normField ? "showNormField" : t.normByPct ? "showNormPct" : t.field ? "showField" : null), e ? o(e === "showField" ? "{field}" : r[e] ?? "", {
+    field: t.field,
+    normField: t.normField
+  }) : void 0;
+}
+function c(r, t) {
+  return !t;
+}
+function h(r, t) {
+  if (!r.title || typeof r.title == "string")
+    return r.title;
+  const i = r.type === "color-ramp" || r.type === "opacity-ramp", e = r.title, n = u(t, e, i);
+  return c(e, i) && e.title ? `${e.title} (${n})` : n;
+}
+const m = /^-?(\d+(\.\d+)?)\s*((px)|(pt))?$/iu;
+function y(r, t, i) {
+  switch (t) {
+    case "heatmap-ramp":
+      return (i[r.label] || r.label) ?? null;
+    case "stretch-ramp":
+      const e = "value" in r ? r.value : void 0, n = r.label ? i[r.label] : "";
+      return n ? `${n}: ${typeof e == "string" ? e : l(e ?? 0, {
+        style: "decimal",
+        notation: e?.toString().toLowerCase().includes("e") ? "scientific" : "standard"
+      })}` : "";
+    default:
+      return r.label ?? null;
+  }
+}
+function w(r, t) {
+  return !!(t && t === "Stretched" && "version" in r && typeof r.version == "number" && r.version >= 10.3 && r.declaredClass === "esri.layers.ImageryLayer");
+}
+function N(r) {
+  return r ? r / 72 * 96 : 0;
+}
+function b(r) {
+  return r ? r * 72 / 96 : 0;
+}
+function v(r) {
+  if (typeof r == "string") {
+    const t = r.match(m);
+    if (t) {
+      const i = Number(t[1]), e = t[3]?.toLowerCase(), n = r.startsWith("-"), a = e === "px" ? b(i) : i;
+      return n ? -a : a;
+    }
+    return null;
+  }
+  return r;
+}
+function L(r, t) {
+  const i = u(r, t, !1), e = i ? r.previewTemplateAriaLabel : r.previewAriaLabel;
+  return o(e ?? "", { label: i });
+}
+function F(r, t) {
+  if (!t || !r)
+    return;
+  (r.querySelector("svg") ?? r.querySelector("canvas") ?? r).setAttribute("aria-label", t);
+}
+export {
+  u as a,
+  h as b,
+  y as c,
+  L as g,
+  w as i,
+  N as p,
+  F as s,
+  v as t
+};

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,10 +11,10 @@ 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;
+    position?: __esri.UIPosition;
     arcgisReady: import('@arcgis/lumina').EventEmitter;
     arcgisPropertyChange: import('@arcgis/lumina').EventEmitter<{
         name: string;
@@ -23,7 +23,7 @@ declare const useAreaMeasurement2dWidget: (component: LitElement & Pick<AreaMeas
         childElem?: HTMLElement & {
             ownedBy?: HTMLElement;
         };
-        view?: __esri.LinkChartView | __esri.MapView | __esri.SceneView;
+        view?: __esri.LinkChartView | __esri.MapView | __esri.SceneView | nullish;
     };
     autoDestroyDisabled: boolean;
     destroy: () => Promise<void>;
@@ -34,8 +34,15 @@ declare const useAreaMeasurement2dWidget: (component: LitElement & Pick<AreaMeas
  * 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/)
+ *
+ * @since 4.28
  */
 export declare class ArcgisAreaMeasurement2d extends LitElement {
+    /**
+     * The view associated with the component.
+     *   > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the ArcgisAreaMeasurement2d component will be associated with a map or scene component rather than using the `view` property.
+     */
+    view?: __esri.MapView | nullish;
     /**
      * 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
@@ -47,7 +54,8 @@ export declare class ArcgisAreaMeasurement2d extends LitElement {
      */
     autoDestroyDisabled: boolean;
     /**
-     * Icon which represents the widget.
+     * Icon which represents the component.
+     * Typically used when the component is controlled by another component (e.g. by the Expand component).
      *
      * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
      * @default "measure-area"
@@ -59,8 +67,13 @@ export declare class ArcgisAreaMeasurement2d extends LitElement {
      * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-AreaMeasurement2D.html#label)
      */
     label: string;
-    /** @default "bottom-left" */
-    position: __esri.UIPosition;
+    /** @deprecated since 4.34, use [`slot`](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/slot) instead. */
+    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.
@@ -69,13 +82,11 @@ export declare class ArcgisAreaMeasurement2d extends LitElement {
      */
     snappingOptions: __esri.SnappingOptions;
     /**
-     * The ViewModel's state.
-     *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-AreaMeasurement2D-AreaMeasurement2DViewModel.html#state)
+     * The current state of the component.
      *
      * @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 +109,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.14 */
-const h = n`@layer{arcgis-area-measurement-2d{display:block}}`, l = r(
+v4.34.0-next.141 */
+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-size:var(--calcite-font-size);line-height:var(--calcite-font-line-height-relative-tight)}.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:var(--calcite-color-foreground-1)}.esri-menu__list-item:active{background-color:var(--calcite-color-foreground-current)}.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:var(--calcite-color-brand)}.esri-widget__table{border-collapse:collapse;color:var(--calcite-color-text-1);border:none;width:100%;line-height:var(--calcite-font-line-height-relative-tight)}.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%}:host{display:block}.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-border-ghost)}.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}`, c = a(
   // Workaround for https://devtopia.esri.com/WebGIS/arcgis-js-api/issues/61559
-  s
+  i
 );
-class m extends i {
+class d 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 = c(this), this.viewModel = this.widget.viewModel, this.view = this.widget.view, this.autoDestroyDisabled = !1, this.icon = this.widget.icon, this.label = this.widget.label, 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 };
+    this.properties = { view: 0, 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", d);
 export {
-  m as ArcgisAreaMeasurement2d
+  d as ArcgisAreaMeasurement2d
 };

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

@@ -1,5 +1,5 @@
 /// <reference types="@arcgis/core/interfaces.d.ts" />
-/// <reference types="../../index.d.ts" />
+/// <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';
@@ -7,14 +7,102 @@ 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/)
+ *
+ * @since 4.28
  */
 export declare class ArcgisAreaMeasurement3d extends LitElement {
-    /** Analysis data object. */
+    /**
+     * The view associated with the component.
+     *   > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the ArcgisAreaMeasurement3d component will be associated with a map or scene component rather than using the `view` property.
+     */
+    view?: __esri.SceneView | undefined;
+    /**
+     * 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
@@ -36,24 +124,45 @@ export declare class ArcgisAreaMeasurement3d extends LitElement {
     icon?: HTMLCalciteIconElement["icon"];
     /** The component's default label. */
     label?: string;
-    /** @default "bottom-left" */
-    position: __esri.UIPosition;
+    /** @deprecated since 4.34, use [`slot`](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/slot) instead. */
+    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 {};