@arcgis/map-components 5.2.0-next.98 → 6.0.0-next.0

package/dist/components/arcgis-directional-pad/customElement.js

@@ -1,37 +1,181 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import { c as l } from "../../chunks/runtime.js";
-import { css as d, html as i } from "lit";
-import { ref as h } from "lit/directives/ref.js";
-import { keyed as s } from "lit/directives/keyed.js";
-import { usePropertyChange as u } from "@arcgis/lumina/controllers";
-import { focusElement as p } from "@arcgis/toolkit/dom";
-import { watch as m } from "@arcgis/core/core/reactiveUtils.js";
-import b from "@arcgis/core/widgets/DirectionalPad/DirectionalPadViewModel.js";
-import { LitElement as g, createEvent as v, safeClassMap as f, nothing as a, safeStyleMap as w } from "@arcgis/lumina";
-import { u as _ } from "../../chunks/useT9n.js";
-import { m as $ } from "../../chunks/useViewModel.js";
-import { g as R } from "../../chunks/component-utils.js";
-import { g as r } from "../../chunks/globalCss.js";
-import { f as C, c as x } from "../../chunks/utils.js";
-const c = [-45, 0, 45, -90, 90, -135, 180, 135], y = {
-  0: { label: "north", iconName: "chevron-up" },
-  45: { label: "northEast", iconName: "chevron-up-right" },
-  90: { label: "east", iconName: "chevron-right" },
-  135: { label: "southEast", iconName: "chevron-down-right" },
-  180: { label: "south", iconName: "chevron-down" },
-  "-135": { label: "southWest", iconName: "chevron-down-left" },
-  "-90": { label: "west", iconName: "chevron-left" },
-  "-45": { label: "northWest", iconName: "chevron-up-left" }
-}, M = d`:host{outline:none;box-shadow:none!important;background-color:transparent!important;user-select:none;calcite-action-pad{display:contents}calcite-action-group{touch-action:none}calcite-action{aspect-ratio:1}}.root{display:flex;flex-direction:column;gap:var(--calcite-spacing-sm)}.buttons-container{--calcite-color-background: transparent;--calcite-action-group-gap: 0;calcite-action{--calcite-color-focus: var(--calcite-color-foreground-3)}calcite-action:not([active]){--calcite-action-background-color-press: var(--calcite-color-foreground-1)}calcite-action[active]{--calcite-action-background-color: var(--calcite-color-foreground-3)}calcite-icon{transform:var(--rotation, unset)}@media(hover:none){calcite-action{--calcite-action-background-color-hover: var(--calcite-color-foreground-1);--calcite-action-text-color-press: var(--calcite-color-text-3)}}}.rotation-container{display:block;width:100%;calcite-action{flex:.3}}.rotation-slider-container{display:flex;flex:1;align-items:center;calcite-slider{flex:1;padding-inline:var(--calcite-spacing-xxs)}}`, S = $(b);
-class B extends g {
+import { c as _ } from "../../chunks/runtime.js";
+import { css as g, html as c } from "lit";
+import { ref as b } from "lit/directives/ref.js";
+import { keyed as m } from "lit/directives/keyed.js";
+import { usePropertyChange as f } from "@arcgis/lumina/controllers";
+import { focusElement as w } from "@arcgis/toolkit/dom";
+import { watch as y } from "@arcgis/core/core/reactiveUtils.js";
+import { LitElement as M, createEvent as C, safeClassMap as $, nothing as h, safeStyleMap as x } from "@arcgis/lumina";
+import { u as R } from "../../chunks/useT9n.js";
+import { m as P } from "../../chunks/useViewModel.js";
+import { g as E } from "../../chunks/component-utils.js";
+import { g as v } from "../../chunks/globalCss.js";
+import { d as A, a as u, t as V, v as D, f as S, b as p, e as T, c as B } from "../../chunks/utils6.js";
+import { EventedAccessor as O } from "@arcgis/core/core/Evented.js";
+import { property as r, subclass as L } from "@arcgis/core/core/accessorSupport/decorators.js";
+import { c as I } from "../../chunks/goTo.js";
+var k = Object.defineProperty, N = Object.getOwnPropertyDescriptor, a = (n, t, e, i) => {
+  for (var o = i > 1 ? void 0 : i ? N(t, e) : t, d = n.length - 1, l; d >= 0; d--)
+    (l = n[d]) && (o = (i ? l(t, e, o) : l(o)) || o);
+  return i && o && k(t, e, o), o;
+};
+let s = class extends O {
+  constructor(n) {
+    super(n), this._anyAngleMovementEnabled = !1, this._disabled = !1, this._moveOnceDuration = A, this.speed = 1, this.beginFollowingPointer = (t, e) => {
+      if (this.disabled)
+        return;
+      this._widgetCenter = e;
+      const i = this._pointerLocationToVector(t);
+      if (i === void 0)
+        return;
+      const o = this._resolveClosestAngle(t, i);
+      o !== void 0 && (this._emitMove(u(o)), this.angle = o, this._initialAngle = o, this._setMovementTimeout(() => {
+        this._widgetCenter === void 0 && this._stopMovement();
+      }), document.addEventListener("pointermove", this._onPointerMove, { passive: !0 }), document.addEventListener("pointerup", this._onPointerUp, { passive: !0, once: !0 }));
+    }, this.moveOnce = (t) => {
+      this._emitMove(u(t)), this._setMovementTimeout(this._stopMovement);
+    }, this._pointerLocationToVector = (t) => {
+      if (this._widgetCenter === void 0)
+        return;
+      const { x: e, y: i } = V(this._widgetCenter, t);
+      return { x: e, y: -i };
+    }, this._resolveClosestAngle = (t, e) => {
+      const i = t.target;
+      if (i?.classList?.contains("compass"))
+        return;
+      const o = Number.parseInt(i?.getAttribute?.("data-angle") ?? "", 10);
+      return Number.isNaN(o) ? D(e) : o;
+    }, this._onPointerMove = (t) => {
+      if (t.buttons === 0) {
+        this._stopMovement();
+        return;
+      }
+      const e = this._pointerLocationToVector(t);
+      if (e === void 0)
+        return;
+      this._setMovementTimeout(void 0);
+      const i = this._resolveClosestAngle(t, e);
+      if (i === void 0) {
+        this._emitStop();
+        return;
+      }
+      const o = u(i), d = this._initialAngle != null && this._initialAngle !== i;
+      this._anyAngleMovementEnabled ||= d;
+      const l = this._anyAngleMovementEnabled ? e : o;
+      (l.x !== this._movementVector?.x || l.y !== this._movementVector?.y) && (this.angle = i, this._emitMove(l));
+    }, this._onPointerUp = () => {
+      this._movementTimeout === void 0 ? this._stopMovement() : this._widgetCenter = void 0;
+    }, this._stopMovement = () => {
+      this._emitStop(), this._widgetCenter = void 0, this._initialAngle = void 0, this._anyAngleMovementEnabled = !1, document.removeEventListener("pointermove", this._onPointerMove), document.removeEventListener("pointerup", this._onPointerUp), this._setMovementTimeout(void 0);
+    }, this.on("move-start", () => this._navigation?.begin()), this.on(
+      "move-direction-change",
+      ({ vector: { x: t, y: e } }) => this._navigation?.continuousPanVector({
+        x: t * this.speed,
+        y: e * this.speed
+      })
+    ), this.on("move-stop", () => this._navigation?.stop());
+  }
+  destroy() {
+    this._stopMovement();
+  }
+  get _navigation() {
+    return this.view?.mapViewNavigation;
+  }
+  get disabled() {
+    return this.view?.ready === !1 || this._disabled || !this.supported;
+  }
+  set disabled(n) {
+    this._disabled = n;
+  }
+  get rotation() {
+    return this.view?.rotation ?? this._get("rotation") ?? 0;
+  }
+  set rotation(n) {
+    this.view ? this.view.constraints.rotationEnabled && I(
+      { target: { rotation: n }, options: { animate: n === 0 ? void 0 : !1 } },
+      this.view
+    ) : this._set("rotation", n);
+  }
+  get supported() {
+    return this.view == null || this.view.type === "2d";
+  }
+  get state() {
+    return this.disabled ? "disabled" : this.angle != null ? "moving" : "ready";
+  }
+  _setMovementTimeout(n) {
+    if (clearTimeout(this._movementTimeout), n === void 0) {
+      this._movementTimeout = void 0;
+      return;
+    }
+    this._movementTimeout = setTimeout(() => {
+      this._movementTimeout = void 0, n();
+    }, this._moveOnceDuration);
+  }
+  _emitMove(n) {
+    this._movementVector == null && this.emit("move-start", { type: "move-start", vector: n });
+    const t = this._movementVector;
+    this._movementVector = n, this.emit("move-direction-change", { type: "move-direction-change", vector: n, oldVector: t });
+  }
+  _emitStop() {
+    this.angle = void 0, this._movementVector !== void 0 && (this.emit("move-stop", { type: "move-stop", oldVector: this._movementVector }), this._movementVector = void 0);
+  }
+};
+a([
+  r()
+], s.prototype, "_initialAngle", 2);
+a([
+  r()
+], s.prototype, "_movementVector", 2);
+a([
+  r()
+], s.prototype, "_widgetCenter", 2);
+a([
+  r()
+], s.prototype, "_anyAngleMovementEnabled", 2);
+a([
+  r()
+], s.prototype, "_movementTimeout", 2);
+a([
+  r()
+], s.prototype, "_disabled", 2);
+a([
+  r()
+], s.prototype, "_moveOnceDuration", 2);
+a([
+  r()
+], s.prototype, "disabled", 1);
+a([
+  r()
+], s.prototype, "angle", 2);
+a([
+  r()
+], s.prototype, "speed", 2);
+a([
+  r()
+], s.prototype, "rotation", 1);
+a([
+  r()
+], s.prototype, "supported", 1);
+a([
+  r({ readOnly: !0 })
+], s.prototype, "state", 1);
+a([
+  r()
+], s.prototype, "view", 2);
+s = a([
+  L("components.directional-pad.DirectionalPadViewModel")
+], s);
+const U = g`:host{outline:none;box-shadow:none!important;background-color:transparent!important;user-select:none;calcite-action-group{touch-action:none}calcite-action{aspect-ratio:1}}.root{display:flex;flex-direction:column;gap:var(--calcite-spacing-sm)}.buttons-container{--calcite-color-background: transparent;--calcite-action-group-gap: 0;calcite-action{--calcite-color-focus: var(--calcite-color-foreground-3)}calcite-action:not([active]){--calcite-action-background-color-press: var(--calcite-color-foreground-1)}calcite-action[active]{--calcite-action-background-color: var(--calcite-color-foreground-3)}calcite-icon{transform:var(--rotation, unset)}@media(hover:none){calcite-action{--calcite-action-background-color-hover: var(--calcite-color-foreground-1);--calcite-action-text-color-press: var(--calcite-color-text-3)}}}.rotation-container{display:block;width:100%;calcite-action{flex:.3}}.rotation-slider-container{display:flex;flex:1;align-items:center;calcite-slider{flex:1;padding-inline:var(--calcite-spacing-xxs)}}`, F = P(s);
+class j extends M {
   constructor() {
-    super(...arguments), this.messages = _({}), this._onContextMenu = (t) => t.preventDefault(), this._buttons = {}, this.viewModel = S(this), this.angle = this.viewModel.angle, this.rotation = this.viewModel.rotation, this.view = this.viewModel.view, this.autoDestroyDisabled = !1, this.disabled = this.viewModel.disabled, this.hideDirectionalButtons = !1, this.icon = "move", this.showRotationResetButton = !1, this.showRotationSlider = !1, this.state = this.viewModel.state, this.visualScale = "s", this.arcgisPropertyChange = u()("state"), this.arcgisReady = v();
+    super(...arguments), this.messages = R({}), this._onContextMenu = (t) => t.preventDefault(), this._buttons = {}, this.viewModel = F(this), this.angle = this.viewModel.angle, this.rotation = this.viewModel.rotation, this.view = this.viewModel.view, this.autoDestroyDisabled = !1, this.disabled = this.viewModel.disabled, this.hideDirectionalButtons = !1, this.icon = "move", this.showRotationResetButton = !1, this.showRotationSlider = !1, this.state = this.viewModel.state, this.visualScale = "s", this.arcgisPropertyChange = f()("state"), this.arcgisReady = C();
   }
   static {
     this.properties = { _rotationEnabled: 16, angle: 16, rotation: 16, view: 0, autoDestroyDisabled: 5, disabled: 5, hideDirectionalButtons: 5, icon: 1, label: 1, messageOverrides: 0, referenceElement: 1, showRotationResetButton: 5, showRotationSlider: 5, state: 32, visualScale: 1 };
   }
   static {
-    this.styles = M;
+    this.styles = U;
   }
   get _rotationEnabled() {
     return this.view?.ready ? this.view.constraints.rotationEnabled ?? !1 : !0;
@@ -42,8 +186,8 @@ class B extends g {
   loaded() {
     this.manager.onLifecycle(() => [
       // Move focus when movement angle changed by touch/mouse (not keyboard!)
-      m(() => this.viewModel.angle, () => {
-        this._buttonsContainer?.contains(document.activeElement) && (this.viewModel.angle == null ? R(this)?.focus() : p(this._buttons[this.viewModel.angle]));
+      y(() => this.viewModel.angle, () => {
+        this._buttonsContainer?.contains(document.activeElement) && (this.viewModel.angle == null ? E(this)?.focus() : w(this._buttons[this.viewModel.angle]));
       })
     ]);
   }
@@ -63,9 +207,9 @@ class B extends g {
   _onButtonPointerDown(t) {
     if (this._buttonsContainer === void 0)
       return;
-    t.composedPath().find((n) => n.hasPointerCapture?.(t.pointerId))?.releasePointerCapture(t.pointerId);
-    const o = C(this._buttonsContainer);
-    this.viewModel.beginFollowingPointer(t, o);
+    t.composedPath().find((o) => o.hasPointerCapture?.(t.pointerId))?.releasePointerCapture(t.pointerId);
+    const i = S(this._buttonsContainer);
+    this.viewModel.beginFollowingPointer(t, i);
   }
   _onSliderInput({ currentTarget: t }) {
     typeof t.value == "number" && (this.viewModel.rotation = t.value);
@@ -77,11 +221,11 @@ class B extends g {
     this.viewModel.moveOnce(t);
   }
   render() {
-    const { label: t, disabled: e } = this, o = this.view == null || this.view.type === "2d";
-    return i`<div .ariaLabel=${t ?? void 0} class=${f({ root: !0, [r.widget]: !0, [r.disabled]: e })} tabindex=-1>${o ? this._renderContent() : this._renderUnsupportedMessage()}</div>`;
+    const { label: t, disabled: e } = this, i = this.view == null || this.view.type === "2d";
+    return c`<div .ariaLabel=${t ?? void 0} class=${$({ root: !0, [v.widget]: !0, [v.disabled]: e })} tabindex=-1>${i ? this._renderContent() : this._renderUnsupportedMessage()}</div>`;
   }
   _renderUnsupportedMessage() {
-    return i`<section class="error"><p>${this.messages.unsupported}</p></section>`;
+    return c`<section class="error"><p>${this.messages.unsupported}</p></section>`;
   }
   _renderContent() {
     return [
@@ -90,31 +234,31 @@ class B extends g {
     ];
   }
   _renderDirectionalButtons() {
-    return s("directional-buttons-container", i`<calcite-action-bar expand-disabled floating layout=grid .scale=${this.visualScale} overflow-actions-disabled><calcite-action-group class="buttons-container" dir=ltr @contextmenu=${{
+    return m("directional-buttons-container", c`<calcite-action-bar expand-toggle-disabled floating layout=grid .scale=${this.visualScale} overflow-mode=none><calcite-action-group class="buttons-container" dir=ltr @contextmenu=${{
       handleEvent: this._onContextMenu,
       capture: !0
-    }} ${h(this._setButtonContainerRef)}>${c.slice(0, 4).map(this._renderButton, this)}${this._renderCompass()}${c.slice(4).map(this._renderButton, this)}</calcite-action-group></calcite-action-bar>`);
+    }} ${b(this._setButtonContainerRef)}>${p.slice(0, 4).map(this._renderButton, this)}${this._renderCompass()}${p.slice(4).map(this._renderButton, this)}</calcite-action-group></calcite-action-bar>`);
   }
   _renderButton(t) {
-    const { label: e, iconName: o } = y[t], n = this.messages[e];
-    return i`<calcite-action .active=${this.angle === t} alignment=center class="button" data-angle=${t ?? a} .disabled=${this.disabled} @click=${this._onClick.bind(this, t)} @pointerdown=${this._onButtonPointerDown} .text=${n ?? ""} title=${n ?? a}><calcite-icon .icon=${o} .scale=${this.visualScale}></calcite-icon></calcite-action>`;
+    const { label: e, iconName: i } = T[t], o = this.messages[e];
+    return c`<calcite-action .active=${this.angle === t} alignment=center class="button" data-angle=${t ?? h} .disabled=${this.disabled} @click=${this._onClick.bind(this, t)} @pointerdown=${this._onButtonPointerDown} .text=${o ?? ""} title=${o ?? h}><calcite-icon .icon=${i} .scale=${this.visualScale}></calcite-icon></calcite-action>`;
   }
   _renderCompass() {
-    const t = this.disabled || x(this.view) ? "compass-needle" : "arrow-up", e = this.rotation === 0, o = this.messages.resetHeading;
-    return i`<calcite-action alignment=center class="compass" .disabled=${this.disabled || !this._rotationEnabled || e} @click=${this._onRotationReset} style=${w(this._rotateIcon(this.rotation))} .text=${o ?? ""} title=${o ?? a}>${!e && i`<calcite-icon .icon=${t} .scale=${this.visualScale}></calcite-icon>` || ""}</calcite-action>`;
+    const t = this.disabled || B(this.view) ? "compass-needle" : "arrow-up", e = this.rotation === 0, i = this.messages.resetHeading;
+    return c`<calcite-action alignment=center class="compass" .disabled=${this.disabled || !this._rotationEnabled || e} @click=${this._onRotationReset} style=${x(this._rotateIcon(this.rotation))} .text=${i ?? ""} title=${i ?? h}>${!e && c`<calcite-icon .icon=${t} .scale=${this.visualScale}></calcite-icon>` || ""}</calcite-action>`;
   }
   _renderRotation() {
-    return s("slider-container", i`<calcite-action-bar expand-disabled floating layout=horizontal .scale=${this.visualScale}><calcite-action-group class="rotation-container">${this.showRotationResetButton ? this._renderRotationResetButton() : null}${this._renderRotationSlider()}</calcite-action-group></calcite-action-bar>`);
+    return m("slider-container", c`<calcite-action-bar expand-toggle-disabled floating layout=horizontal .scale=${this.visualScale}><calcite-action-group class="rotation-container">${this.showRotationResetButton ? this._renderRotationResetButton() : null}${this._renderRotationSlider()}</calcite-action-group></calcite-action-bar>`);
   }
   _renderRotationResetButton() {
     const t = this.messages.resetHeading;
-    return i`<calcite-action alignment=center class="rotation-reset-button" .disabled=${this.disabled || !this._rotationEnabled} @click=${this._onRotationReset} .text=${t ?? ""} title=${t ?? a}><calcite-icon flip-rtl icon=rotate .scale=${this.visualScale}></calcite-icon></calcite-action>`;
+    return c`<calcite-action alignment=center class="rotation-reset-button" .disabled=${this.disabled || !this._rotationEnabled} @click=${this._onRotationReset} .text=${t ?? ""} title=${t ?? h}><calcite-icon flip-rtl icon=rotate .scale=${this.visualScale}></calcite-icon></calcite-action>`;
   }
   _renderRotationSlider() {
-    return i`<div class="rotation-slider-container"><calcite-slider .ariaLabel=${this.messages.heading} .disabled=${this.disabled || !this._rotationEnabled} label-handles max=360 min=0 required .scale=${this.visualScale} .value=${Math.round(this.rotation)} @calciteSliderInput=${this._onSliderInput}></calcite-slider></div>`;
+    return c`<div class="rotation-slider-container"><calcite-slider .ariaLabel=${this.messages.heading} .disabled=${this.disabled || !this._rotationEnabled} label-handles max=360 min=0 required .scale=${this.visualScale} .value=${Math.round(this.rotation)} @calciteSliderInput=${this._onSliderInput}></calcite-slider></div>`;
   }
 }
-l("arcgis-directional-pad", B);
+_("arcgis-directional-pad", j);
 export {
-  B as ArcgisDirectionalPad
+  j as ArcgisDirectionalPad
 };

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

@@ -20,17 +20,17 @@ import type { SystemOrLengthUnit } from "@arcgis/core/core/units.js";
  * Search uses settings defined in the `Search properties`. This includes the `locationType`, which defines the type of geocoding result that is returned, and defaults to "street".
  *
  * Directions requires a RouteLayer to be associated with the `layer` property or using the `useDefaultRouteLayer` property. A RouteLayer can be programmatically created or derived from an external source like a portal item or webmap.
- * Please note that in order to view or interact with routing inputs and results, the RouteLayer must be added to the map. Routing service and symbology is configured in the layer, specifically the `url` and `defaultSymbols` properties respectively.
+ * Please note that in order to view or interact with routing inputs and results, the RouteLayer must be added to the map. Routing service and symbology are configured in the layer, specifically the `url` and `defaultSymbols` properties respectively.
  *
- * The ArcGIS Online routing service requires authentication. If an API key is specified at the app level (see [Config#apiKey](https://developers.arcgis.com/javascript/latest/references/core/config/#Config-apiKey)) or component level (see [apiKey](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-directions/#apiKey))) then this key will accompany requests to both the routing service and geocoder/reverse-geocoder.
+ * The ArcGIS Online routing service requires authentication. If an API key is specified at the app level (see [Config#apiKey](https://developers.arcgis.com/javascript/latest/references/core/config/#Config-apiKey)) or component level (see [apiKey](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-directions/#apiKey)) then this key will accompany requests to both the routing service and geocoder/reverse-geocoder.
  * Please refer to the Search component for more information on geocoding.
  *
  * Locations on the map can be reverse geocoded and used as stops in the route. Click the button with a crosshairs icon to associate a location with a new or existing stop.  After clicking the button, click the map once. To cancel this process, press the `escape` key.
- * The resulting driving directions are automatically collapsed and can be optionally saved to a new or existing portal item. This can be achieved programically with `save` and `saveAs`. The `Clear` button calls the `reset()` method, which removes all stops, directions, and the solved route.
+ * The resulting driving directions are automatically collapsed and can be optionally saved to a new or existing portal item. This can be achieved programmatically with `save` and `saveAs`. The `Clear` button calls the `reset()` method, which removes all stops, directions, and the solved route.
  *
- * Selecting the `Edit route` button allows you to add/move/remove stops, add/move/remove/reshape polyline barriers, and add/move/remove waypoints. To add a new waypoint, first hover the cursor over the route and select the desired point. Then select and drag the point to move and place the waypoint. By default the route will be automatically resolve at the completion of any editing operation. For more complex routes, it may be advantageous to disable auto-solving and solve as and when needed with the dedicated solve button. Currently, this is only supported in 2D MapViews.
+ * Selecting the `Edit route` button allows you to add/move/remove stops, add/move/remove/reshape polyline barriers, and add/move/remove waypoints. To add a new waypoint, first hover the cursor over the route and select the desired point. Then select and drag the point to move and place the waypoint. By default the route will be automatically resolved at the completion of any editing operation. For more complex routes, it may be advantageous to disable auto-solving and solve as and when needed with the dedicated solve button. Currently, this is only supported in 2D MapViews.
  *
- * **Note:** Printing in Directions is in beta and considered experimental. The print preview dialog, in some scenarios, may not display as aniticipated.
+ * **Note:** Printing in Directions is in beta and considered experimental. The print preview dialog, in some scenarios, may not display as anticipated.
  *
  * @see [Sample - Directions component with RouteLayer](https://developers.arcgis.com/javascript/latest/sample-code/directions-routelayer/)
  * @since 4.28
@@ -275,7 +275,7 @@ export abstract class ArcgisDirections extends LitElement {
   };
   /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
   readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "lastRoute" | "state"; }>;
-  /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
+  /** Emitted when the component associated with a map or scene view is ready for user interaction. */
   readonly arcgisReady: import("@arcgis/lumina").TargetedEvent<this, void>;
   readonly "@eventTypes": {
     arcgisPropertyChange: ArcgisDirections["arcgisPropertyChange"]["detail"];

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

@@ -1,7 +1,7 @@
 /// <reference path="../../index.d.ts" />
 import type MapView from "@arcgis/core/views/MapView.js";
 import type DistanceMeasurementAnalysis from "@arcgis/core/analysis/DistanceMeasurementAnalysis.js";
-import type SnappingOptions from "@arcgis/core/views/interactive/snapping/SnappingOptions.js";
+import type SnappingOptions from "@arcgis/core/views/interactive/options/SnappingOptions.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 import type { ArcgisReferenceElement } from "../types.js";
 import type { DistanceMeasurement2DState } from "./types.js";
@@ -13,7 +13,7 @@ import type { SystemOrLengthUnit } from "@arcgis/core/core/units.js";
  * The Distance Measurement 2D component can be added to an [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/)
  * component to calculate and display the length of a polyline.
  *
- * How distances are computed depends on the scene's spatial reference.
+ * How distances are computed depends on the map's spatial reference.
  *
  * In **geographic coordinate systems** (GCS), and in **Web Mercator**, lengths are computed geodetically, taking into consideration the curvature of the planet.
  *
@@ -106,6 +106,13 @@ export abstract class ArcgisDistanceMeasurement2d extends LitElement {
    * 
    */
   accessor autoDestroyDisabled: boolean;
+  /**
+   * If true, all unit-reset buttons will be hidden. Unit selection dropdowns remain available, but users cannot reset units to their defaults using the UI.
+   *
+   * @default false
+   * @since 5.2
+   */
+  accessor hideResetUnitsButton: boolean;
   /**
    * If true, the button that starts a new measurement will be hidden.
    *
@@ -135,6 +142,14 @@ export abstract class ArcgisDistanceMeasurement2d extends LitElement {
    * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
    */
   accessor icon: Icon["icon"] | undefined;
+  /**
+   * Indicates whether interactive creation and editing of the analysis are disabled. When true, users cannot create a new analysis interactively or modify an existing analysis using its editing manipulators. Any interactive operation in progress is canceled. If the analysis is already complete, it and its results remain visible.
+   *
+   * @default false
+   * @default false
+   * @since 5.2
+   */
+  accessor interactionDisabled: boolean;
   /** The component's default label. */
   accessor label: string | undefined;
   /**
@@ -143,6 +158,7 @@ export abstract class ArcgisDistanceMeasurement2d extends LitElement {
    * _**Note**: Individual message keys may change between releases._
    */
   accessor messageOverrides: {
+      reset?: string | undefined;
       componentLabel?: string | undefined;
       distance?: string | undefined;
       hint?: string | undefined;
@@ -158,6 +174,7 @@ export abstract class ArcgisDistanceMeasurement2d extends LitElement {
   };
   /** @internal */
   protected messages: {
+      reset: string;
       componentLabel: string;
       distance: string;
       hint: string;
@@ -171,6 +188,7 @@ export abstract class ArcgisDistanceMeasurement2d extends LitElement {
       unit: string;
       unsupported: string;
   } & T9nMeta<{
+      reset: string;
       componentLabel: string;
       distance: string;
       hint: string;
@@ -191,7 +209,13 @@ export abstract class ArcgisDistanceMeasurement2d extends LitElement {
    */
   accessor referenceElement: ArcgisReferenceElement | string | undefined;
   /**
-   * The [SnappingOptions](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/snapping/SnappingOptions/) for measuring.
+   * The [SnappingOptions](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/options/SnappingOptions/) for measuring.
+   *
+   * **Known limitations**
+   *
+   * - This component currently uses its own `snappingOptions` rather than
+   *   [view.options.snapping](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/options/ViewOptions/#snapping).
+   *   Tooltips and units configured through `view.options` still apply. Support for `view.options.snapping` is planned for a future release.
    *
    * @since 4.28
    */
@@ -208,12 +232,20 @@ export abstract class ArcgisDistanceMeasurement2d extends LitElement {
   /**
    * Unit system (imperial, metric) or specific unit used for displaying the distance values. Possible values are listed in
    * [unitOptions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-distance-measurement-2d/#unitOptions).
+   *
+   * When no unit is explicitly set on the component or its analysis, this property uses the length unit configured in the view through
+   * [view.options.displayUnits.length](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/options/ViewOptions/#displayUnits).
+   * This property overrides the distance unit on this component's analysis without changing the units configured in the view.
    */
   accessor unit: SystemOrLengthUnit;
   /**
    * 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`, `inches`, `feet`, `us-feet`, `yards`, `miles`, `nautical-miles`, `meters`, `kilometers`.
-   * Possible [unit](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-distance-measurement-2d/#unit) values can only be a subset of this list.
+   * If the unit inherited from the view through
+   * [view.options.displayUnits.length](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/options/ViewOptions/#displayUnits)
+   * is not listed in [unitOptions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-distance-measurement-2d/#unitOptions), the component checks whether its default unit is listed there.
+   * If it is, the component uses that default. If neither unit is listed, it uses the first entry in
+   * [unitOptions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-distance-measurement-2d/#unitOptions).
    */
   accessor unitOptions: Array<SystemOrLengthUnit>;
   /**
@@ -228,8 +260,8 @@ export abstract class ArcgisDistanceMeasurement2d extends LitElement {
   /** 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: import("@arcgis/lumina").TargetedEvent<this, { name: "analysis" | "state"; }>;
-  /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
+  readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "analysis" | "interactionDisabled" | "state"; }>;
+  /** Emitted when the component associated with a map or scene view is ready for user interaction. */
   readonly arcgisReady: import("@arcgis/lumina").TargetedEvent<this, void>;
   readonly "@eventTypes": {
     arcgisPropertyChange: ArcgisDistanceMeasurement2d["arcgisPropertyChange"]["detail"];