@arcgis/map-components 5.2.0-next.16 → 5.2.0-next.161

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,18 +20,19 @@ 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
  */
 export abstract class ArcgisDirections extends LitElement {
@@ -64,6 +65,15 @@ export abstract class ArcgisDirections extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-directions auto-destroy-disabled></arcgis-directions>
+   * ```
+   *
+   * ```js
+   * directionsElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**
@@ -233,8 +243,8 @@ export abstract class ArcgisDirections extends LitElement {
    */
   accessor useDefaultRouteLayer: boolean;
   /**
-   * 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 arcgis-directions component will be associated with a map or scene component rather than using the `view` property.
+   * 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 arcgis-directions component will be associated with a map or scene component rather than using the `view` property.
    */
   accessor view: MapViewOrSceneView | null | undefined;
   /** Permanently destroy the component. */
@@ -265,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-directions/customElement.js

@@ -7,7 +7,7 @@ import c from "@arcgis/core/widgets/Directions.js";
 import { LitElement as l, createEvent as d } from "@arcgis/lumina";
 import { log as g } from "@arcgis/toolkit/log";
 import { m as p } from "../../chunks/useWidget.js";
-import { d as h } from "../../chunks/component-utils.js";
+import { f as h } from "../../chunks/component-utils.js";
 import { css as m } from "lit";
 import { u as f } from "../../chunks/useLayerById.js";
 const u = m`.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{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__heading{word-break:break-word}.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-search{flex-flow:row;justify-content:center;align-items:center;width:240px;display:flex}.esri-search__dropdown{--calcite-color-border-1: var(--calcite-color-border-input);--calcite-dropdown-width: 240px;width:31px}.esri-search__autocomplete{flex:1}.esri-search__container{flex-flow:row;flex:1 0 100%;align-items:stretch;display:flex;position:relative}.esri-search__form{flex-flow:row;flex:1 0;align-items:stretch;margin:0;padding:0;display:flex}.esri-search-result-renderer calcite-block,.esri-search-result-renderer calcite-block[expanded]{margin-block:0;border:0;margin-block-start:var(--calcite-spacing-md)}.esri-search__submit-button{position:absolute;margin:-1px;border-width:0;padding:0;width:1px;height:1px;overflow:hidden;white-space:nowrap;clip:rect(0,0,0,0)}:host{display:flex}.esri-directions{display:flex;flex:1 1 auto;overflow:hidden}.esri-directions calcite-flow-item{--calcite-color-background: var(--calcite-color-foreground-1)}.esri-directions calcite-flow{z-index:1;position:relative}.esri-directions__accordion{--calcite-accordion-border-color: transparent}.esri-directions__stop-container{--calcite-list-border-color: transparent;--calcite-list-background-color-hover: var(--calcite-color-foreground-1);margin-block-start:var(--calcite-spacing-sm);display:flex}.esri-directions__stop-list{flex:auto}.esri-directions__action-container{margin-top:var(--calcite-spacing-sm);margin-inline:var(--calcite-spacing-sm);display:flex}.esri-directions__add-stop-button{margin-inline-end:var(--calcite-spacing-xs)}.esri-directions__departure-time{--calcite-label-margin-bottom: 0}.esri-directions__departure-time-options{margin-bottom:var(--calcite-spacing-sm);display:flex}.esri-directions__departure-time-options calcite-input-date-picker,.esri-directions__departure-time-options calcite-input-time-picker{flex:1}.esri-directions__directions-header{line-height:var(--calcite-font-line-height-relative-snug);color:var(--calcite-color-text-3);font-size:var(--calcite-font-size--2);flex-direction:column;display:flex}.esri-directions__header-stops{gap:var(--calcite-spacing-base) var(--calcite-spacing-xxs);font-size:var(--calcite-font-size--1);grid-template-columns:auto 1fr;margin-block-end:var(--calcite-spacing-base);display:grid}.esri-directions__directions-header-stop-name{text-overflow:ellipsis;color:var(--calcite-color-text-1);font-weight:var(--calcite-font-weight-medium);overflow:hidden}.esri-directions__edit-footer{border-top:var(--calcite-border-width-sm) solid var(--calcite-color-border-3);padding:var(--calcite-spacing-md)}.esri-directions__edit-information-container{border-bottom:var(--calcite-border-width-sm) solid var(--calcite-color-border-3);background-color:var(--calcite-color-surface-1);padding:var(--calcite-spacing-md)}.esri-directions__edit-toolbar-container{margin:var(--calcite-spacing-md);flex-flow:column;align-items:flex-start;display:flex}.esri-directions__edit-toolbar{border-width:var(--calcite-border-width-sm);border-radius:var(--calcite-corner-radius-round);border-style:solid;border-color:var(--calcite-color-foreground-3);flex-flow:row;display:flex;overflow:hidden}.esri-directions__solve-route{border-inline-start:solid var(--calcite-border-width-sm) var(--calcite-color-border-3)}.esri-directions__flex-column{flex-direction:column;display:flex}.esri-directions__flex-row{flex-direction:row;display:flex}.esri-directions__label-emphasize{font-weight:var(--calcite-font-weight-medium)}.esri-directions__label-no-bottom-margin{--calcite-label-margin-bottom: 0}.esri-directions__margin-inline-medium{margin-inline:var(--calcite-spacing-md)}.esri-directions__padding-medium{padding:var(--calcite-spacing-md)}.esri-directions__route-item{margin:var(--calcite-spacing-md);border:var(--calcite-border-width-sm) solid var(--calcite-color-border-3);border-radius:var(--calcite-corner-radius-round);flex:1 0 auto;width:auto;margin-block-start:var(--calcite-spacing-sm);display:flex;overflow:hidden}.esri-directions__route-item-button{background-color:transparent;padding:var(--calcite-spacing-sm) var(--calcite-spacing-md);text-align:unset;font-family:var(--calcite-font-family);border:none;flex:1 0 auto;align-items:center;margin:0;padding-inline-end:var(--calcite-spacing-xs);display:flex;calcite-icon{color:var(--calcite-action-text-color)}}.esri-directions__route-item-button:hover{background-color:var(--calcite-color-foreground-2);cursor:pointer}.esri-directions__route-item-button-content{flex-direction:column;flex:1 0 auto;display:flex}.esri-directions__route-item-label{line-height:var(--calcite-font-line-height-relative-snug);color:var(--calcite-color-text-1);font-size:var(--calcite-font-size-md);font-weight:var(--calcite-font-weight-medium)}.esri-directions__route-item-description{line-height:var(--calcite-font-line-height-relative-snug);color:var(--calcite-color-text-3);font-size:var(--calcite-font-size--2);font-weight:var(--calcite-font-weight-regular)}.esri-directions__optimize-section{--calcite-block-section-header-text-color: var(--calcite-color-text-1)}.esri-directions__optimize-switches{cursor:pointer;margin-inline-start:var(--calcite-spacing-md)}.esri-directions__panel-header-action{align-items:center;display:flex}.esri-directions__primary-flow-item{flex-flow:column;flex:auto;justify-content:flex-start;align-items:stretch;display:flex;overflow:visible}.esri-directions__primary-footer{border-top:var(--calcite-border-width-sm) solid var(--calcite-color-border-3);padding:var(--calcite-spacing-md)}.esri-directions__primary-footer-centered{border-top:var(--calcite-border-width-sm) solid var(--calcite-color-border-3);padding:var(--calcite-spacing-md);flex-flow:column wrap;align-items:center;display:flex}.esri-directions__primary-footer-loader{--calcite-loader-spacing: 0;margin-top:var(--calcite-spacing-md);margin-bottom:var(--calcite-spacing-md)}.esri-directions__save-error{flex-direction:column;align-items:center;display:flex}.esri-directions__save-error-icon{margin-top:calc(var(--calcite-spacing-lg) * 3);margin-bottom:var(--calcite-spacing-xxs);color:var(--calcite-color-status-danger)}.esri-directions__save-error-label{margin-inline:var(--calcite-spacing-sm)}.esri-directions__save-process-loader{padding-top:calc(var(--calcite-spacing-lg) * 3);padding-bottom:calc(var(--calcite-spacing-lg) * 2)}.esri-directions__selected-feature-container{margin-inline:var(--calcite-spacing-md);height:100px;overflow-y:auto}.esri-directions__separator{margin:var(--calcite-spacing-md) 0;background-color:var(--calcite-color-border-3);height:var(--calcite-border-width-sm)}.esri-directions__stop-item .esri-search{width:auto}.esri-directions__print-document{box-sizing:border-box;z-index:var(--calcite-z-index-overlay);background-color:var(--calcite-color-foreground-1);width:100%;height:100%;position:fixed;top:0;left:0;overflow-y:scroll}.esri-directions__print-body{padding-inline:var(--calcite-spacing-md);flex-direction:column;display:flex}.esri-directions__print-header{margin-bottom:var(--calcite-spacing-lg);border-block-end:var(--calcite-border-width-sm) solid var(--calcite-color-border-3);align-items:center;display:flex}.esri-directions__print-header-label{padding-block:var(--calcite-spacing-sm);line-height:var(--calcite-font-line-height-relative-snug);color:var(--calcite-color-text-3);font-size:var(--calcite-font-size--2);font-weight:var(--calcite-font-weight-bold);flex-direction:column;flex-grow:1;display:flex}.esri-directions__print-section{margin-top:var(--calcite-spacing-md);flex-direction:column;display:flex}.esri-directions__print-header-buttons{padding-inline-end:var(--calcite-spacing-md);display:flex}.esri-directions__print--avoid-page-break{break-inside:avoid}@media print{body.esri-directions__print-media{margin:0;padding:0}body.esri-directions__print-media>:not(div.esri-directions__print-document){display:none}}@media print{.esri-directions__print-document{height:auto;position:static;overflow:visible}.esri-directions__print--hide-on-print{display:none}}`, v = p(c), t = "map-components:arcgis-directions";

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.
  *
@@ -95,8 +95,26 @@ export abstract class ArcgisDistanceMeasurement2d extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-distance-measurement-2d auto-destroy-disabled></arcgis-distance-measurement-2d>
+   * ```
+   *
+   * ```js
+   * distanceMeasurement-2dElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
+  /**
+   * If true, hides all unit-reset buttons. Unit-selection dropdowns remain available.
+   *
+   * Resetting a unit clears the corresponding overrides on the component and its analysis. The component then uses the corresponding value from [ViewOptions.displayUnits](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/options/ViewOptions/#displayUnits), or [ViewOptions.inputUnits](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/options/ViewOptions/#inputUnits) for input units, when that option is set and its resolved unit is included in the component's available units. Otherwise, it uses its default unit if available, or the first available unit.
+   *
+   * @default false
+   * @since 5.2
+   */
+  accessor hideResetUnitsButton: boolean;
   /**
    * If true, the button that starts a new measurement will be hidden.
    *
@@ -126,10 +144,39 @@ 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;
+  /**
+   * Replace localized message strings with your own strings.
+   *
+   * _**Note**: Individual message keys may change between releases._
+   */
+  accessor messageOverrides: {
+      reset?: string | undefined;
+      componentLabel?: string | undefined;
+      distance?: string | undefined;
+      hint?: string | undefined;
+      mode?: string | undefined;
+      modes?: {
+          auto?: string | undefined;
+          planar?: string | undefined;
+          geodesic?: string | undefined;
+      } | undefined;
+      newMeasurement?: string | undefined;
+      unit?: string | undefined;
+      unsupported?: string | undefined;
+  };
   /** @internal */
   protected messages: {
+      reset: string;
       componentLabel: string;
       distance: string;
       hint: string;
@@ -143,6 +190,7 @@ export abstract class ArcgisDistanceMeasurement2d extends LitElement {
       unit: string;
       unsupported: string;
   } & T9nMeta<{
+      reset: string;
       componentLabel: string;
       distance: string;
       hint: string;
@@ -163,7 +211,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
    */
@@ -180,17 +234,28 @@ 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).
+   * If that option is unset or unavailable in [unitOptions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-distance-measurement-2d/#unitOptions),
+   * the component uses its default unit if available, or the first available unit.
+   * This property overrides the distance unit on this component's analysis without changing the units configured in the view.
+   * The reset button clears both overrides and resumes this inheritance and fallback behavior.
    */
   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.
+   * When neither the component nor its analysis has an explicit unit, the unit inherited from
+   * [view.options.displayUnits.length](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/options/ViewOptions/#displayUnits)
+   * is used if listed in [unitOptions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-distance-measurement-2d/#unitOptions). Otherwise, 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>;
   /**
-   * 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 arcgis-distance-measurement-2d component will be associated with a map or scene component rather than using the `view` property.
+   * 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 arcgis-distance-measurement-2d component will be associated with a map or scene component rather than using the `view` property.
    */
   accessor view: MapView | undefined;
   /** Clears the current measurement. */
@@ -200,8 +265,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"];