@arcgis/map-components 5.2.0-next.99 → 6.0.0-next.1

package/dist/components/arcgis-video-player/customElement.js

@@ -1,26 +1,234 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import { c as h } from "../../chunks/runtime.js";
-import { css as u, html as e } from "lit";
-import { watch as t } from "@arcgis/core/core/reactiveUtils.js";
-import f from "@arcgis/core/widgets/VideoPlayer/VideoPlayerViewModel.js";
-import { LitElement as g, createEvent as l, safeClassMap as m } from "@arcgis/lumina";
-import { usePropertyChange as v } from "@arcgis/lumina/controllers";
-import { classes as p } from "@arcgis/toolkit/dom";
-import { createRef as _, ref as y } from "lit/directives/ref.js";
-import { u as w } from "../../chunks/useT9n.js";
-import { m as V } from "../../chunks/useViewModel.js";
-import { g as $ } from "../../chunks/globalCss.js";
-import { n as r } from "../../chunks/video-utils.js";
-const M = u`:host{--arcgis-internal-video-player-controls-spacing: 16px;width:531px;height:100%}:host([inline]){width:auto;height:auto}.root,.content{height:100%}.inline{display:flex;gap:var(--calcite-spacing-xs);background-color:var(--calcite-color-foreground-1);padding:var(--calcite-spacing-xxs)}.footer{flex:1}arcgis-video{display:flex;flex:1 1 auto;aspect-ratio:16 / 9;min-height:0}`, b = V(f);
-class T extends g {
+import { c as g } from "../../chunks/runtime.js";
+import { css as v, html as s } from "lit";
+import { watch as d } from "@arcgis/core/core/reactiveUtils.js";
+import { LitElement as w, createEvent as u, safeClassMap as _ } from "@arcgis/lumina";
+import { usePropertyChange as T } from "@arcgis/lumina/controllers";
+import { classes as M } from "@arcgis/toolkit/dom";
+import { createRef as b, ref as D } from "lit/directives/ref.js";
+import { u as V } from "../../chunks/useT9n.js";
+import { m as $ } from "../../chunks/useViewModel.js";
+import { g as P } from "../../chunks/globalCss.js";
+import { n as f } from "../../chunks/video-utils.js";
+import C from "@arcgis/core/core/Accessor.js";
+import { property as l, subclass as S } from "@arcgis/core/core/accessorSupport/decorators.js";
+var L = Object.defineProperty, k = Object.getOwnPropertyDescriptor, a = (e, i, n, h) => {
+  for (var r = h > 1 ? void 0 : h ? k(i, n) : i, y = e.length - 1, c; y >= 0; y--)
+    (c = e[y]) && (r = (h ? c(i, n, r) : c(r)) || r);
+  return h && r && L(i, n, r), r;
+};
+const o = {
+  FrameCenterElevation: 10025,
+  FrameCenterLatitude: 10023,
+  FrameCenterLongitude: 10024,
+  MissionId: 10003,
+  PlatformCallSign: 10059,
+  PlatformDesignation: 10010,
+  PlatformGroundRange: 10057,
+  PlatformTailNumber: 10004,
+  PlatformTrueAirspeed: 10008,
+  PrecisionTimeStamp: 10002
+};
+function m(e, i) {
+  const n = {};
+  for (const h of i) {
+    const r = e.get(h);
+    r && (n[r.name] = String(r.value));
+  }
+  return n;
+}
+let t = class extends C {
+  //#region Lifecycle
+  constructor(e) {
+    super(e), this.followingMode = "follow-both", this.seekLength = 10;
+  }
+  initialize() {
+    this.addHandles([
+      d(
+        () => this.layer,
+        (e, i) => {
+          i && i.pause(), e && e.load().then(() => this._followTelemetry()).catch(() => {
+          });
+        },
+        { initial: !0 }
+      ),
+      d(
+        () => [this.followingMode],
+        () => this._followTelemetry(),
+        { initial: !0 }
+      )
+    ]);
+  }
+  get buffered() {
+    return this.layer?.buffered || 0;
+  }
+  get currentTime() {
+    return this.layer?.currentTime || 0;
+  }
+  get duration() {
+    return this.layer?.duration || 0;
+  }
+  get ended() {
+    return this.layer?.ended ?? !0;
+  }
+  get metadata() {
+    const e = this.layer?.metadata;
+    return e ? {
+      missionInfo: m(e, [o.MissionId, o.PrecisionTimeStamp]),
+      platformInfo: m(e, [
+        o.PlatformTailNumber,
+        o.PlatformTrueAirspeed,
+        o.PlatformCallSign,
+        o.PlatformDesignation,
+        o.PlatformGroundRange
+      ]),
+      frameInfo: m(e, [
+        o.FrameCenterElevation,
+        o.FrameCenterLatitude,
+        o.FrameCenterLongitude
+      ])
+    } : null;
+  }
+  get playing() {
+    return this.layer?.playing ?? !1;
+  }
+  previewsInfo() {
+    return this.layer?.previewsInfo || null;
+  }
+  get state() {
+    return this.layer?.loadError ? "error" : this.layer?.state ?? "not-ready";
+  }
+  //#endregion
+  //#region Public Methods
+  changeGraphicsColor(e) {
+    e && this.layer.updateTelemetryColor(e);
+  }
+  changePlaybackSpeed(e) {
+    this.layer && (this.layer.playbackRate = e);
+  }
+  pause() {
+    this.layer?.pause();
+  }
+  play() {
+    this.layer?.play();
+  }
+  seekBackward() {
+    if (this.layer) {
+      const e = this.layer.currentTime - this.seekLength;
+      e <= 0 ? this.layer.reset() : this.layer.setCurrentTime(e);
+    }
+  }
+  seekForward() {
+    if (this.layer) {
+      const e = this.layer.currentTime + this.seekLength;
+      e >= this.layer.duration ? this.layer.reset() : this.layer.setCurrentTime(e);
+    }
+  }
+  seekTo(e) {
+    this.layer?.setCurrentTime(e);
+  }
+  seekToBeginning() {
+    this.layer?.setCurrentTime(0);
+  }
+  seekToEnding() {
+    this.layer?.setCurrentTime(this.layer.duration);
+  }
+  toggleFrameCenterDisplay() {
+    this.layer?.telemetryDisplay && (this.layer.telemetryDisplay.frameCenter = !this.layer.telemetryDisplay.frameCenter);
+  }
+  toggleFrameDisplay() {
+    this.layer?.telemetryDisplay && (this.layer.telemetryDisplay.frame = !this.layer.telemetryDisplay.frame);
+  }
+  toggleFrameOutlineDisplay() {
+    this.layer?.telemetryDisplay && (this.layer.telemetryDisplay.frameOutline = !this.layer.telemetryDisplay.frameOutline);
+  }
+  toggleLoopPlayback() {
+    this.layer && (this.layer.loop = !this.layer.loop);
+  }
+  toggleSensorDisplay() {
+    this.layer?.telemetryDisplay && (this.layer.telemetryDisplay.sensorLocation = !this.layer.telemetryDisplay.sensorLocation);
+  }
+  toggleSensorPathDisplay() {
+    this.layer?.telemetryDisplay && (this.layer.telemetryDisplay.sensorPath = !this.layer.telemetryDisplay.sensorPath);
+  }
+  toggleSensorSightLineDisplay() {
+    this.layer?.telemetryDisplay && (this.layer.telemetryDisplay.lineOfSight = !this.layer.telemetryDisplay.lineOfSight);
+  }
+  toggleSensorTrailDisplay() {
+    this.layer?.telemetryDisplay && (this.layer.telemetryDisplay.sensorTrail = !this.layer.telemetryDisplay.sensorTrail);
+  }
+  //#endregion
+  //#region Private Methods
+  _followTelemetry() {
+    this.removeHandles("follow"), this.view && this.layer && this.addHandles(
+      d(
+        () => this.layer?.telemetry,
+        () => {
+          const e = [], i = this.followingMode === "follow-frame" || this.followingMode === "follow-both";
+          if ((this.followingMode === "follow-sensor" || this.followingMode === "follow-both") && this.layer?.telemetry.sensorLocation && e.push(this.layer.telemetry.sensorLocation), i && this.layer?.telemetry.frameCenter && e.push(this.layer.telemetry.frameCenter), !e.length) {
+            this.layer?.initialExtent && this.followingMode !== "none" && this.view?.goTo(this.layer.initialExtent).catch(() => {
+            });
+            return;
+          }
+          this.view?.goTo(e).catch(() => {
+          });
+        },
+        { initial: !0 }
+      ),
+      "follow"
+    );
+  }
+  //#endregion
+};
+a([
+  l({ readOnly: !0 })
+], t.prototype, "buffered", 1);
+a([
+  l({ readOnly: !0 })
+], t.prototype, "currentTime", 1);
+a([
+  l({ readOnly: !0 })
+], t.prototype, "duration", 1);
+a([
+  l({ readOnly: !0 })
+], t.prototype, "ended", 1);
+a([
+  l()
+], t.prototype, "followingMode", 2);
+a([
+  l()
+], t.prototype, "layer", 2);
+a([
+  l({ readOnly: !0 })
+], t.prototype, "metadata", 1);
+a([
+  l({ readOnly: !0 })
+], t.prototype, "playing", 1);
+a([
+  l({ readOnly: !0 })
+], t.prototype, "previewsInfo", 1);
+a([
+  l()
+], t.prototype, "seekLength", 2);
+a([
+  l({ readOnly: !0 })
+], t.prototype, "state", 1);
+a([
+  l()
+], t.prototype, "view", 2);
+t = a([
+  S("map-components.video-player.VideoPlayerViewModel")
+], t);
+const x = t, O = v`:host{--arcgis-internal-video-player-controls-spacing: 16px;width:531px;height:100%}:host([inline]){width:auto;height:auto}.root,.content{height:100%}.inline{display:flex;gap:var(--calcite-spacing-xs);background-color:var(--calcite-color-foreground-1);padding:var(--calcite-spacing-xxs)}.footer{flex:1}arcgis-video{display:flex;flex:1 1 auto;aspect-ratio:16 / 9;min-height:0}`, F = $(x);
+class R extends w {
   constructor() {
-    super(...arguments), this.messages = w({ blocking: !0 }), this.viewModel = b(this), this._videoViewRef = _(), this._metadataVisible = !1, this._duration = 0, this._currentTime = 0, this._bufferedValue = 0, this._currentValue = 0, this._isBuffering = !1, this._videoViewReady = !1, this._loopPlayback = !1, this.icon = "video-web", this.state = this.viewModel.state, this.layer = this.viewModel.layer, this.autoDestroyDisabled = !1, this.inline = !1, this.showFullscreenToggle = !1, this.operationalDataVisible = !1, this.hideHeader = !1, this.view = this.viewModel.view, this.arcgisPropertyChange = v()("state", "layer"), this.arcgisReady = l(), this.arcgisVideoReady = l();
+    super(...arguments), this.messages = V({ blocking: !0 }), this.viewModel = F(this), this._videoViewRef = b(), this._metadataVisible = !1, this._duration = 0, this._currentTime = 0, this._bufferedValue = 0, this._currentValue = 0, this._isBuffering = !1, this._videoViewReady = !1, this._loopPlayback = !1, this.icon = "video-web", this.state = this.viewModel.state, this.layer = this.viewModel.layer, this.autoDestroyDisabled = !1, this.inline = !1, this.showFullscreenToggle = !1, this.operationalDataVisible = !1, this.hideHeader = !1, this.view = this.viewModel.view, this.arcgisPropertyChange = T()("state", "layer"), this.arcgisReady = u(), this.arcgisVideoReady = u();
   }
   static {
     this.properties = { _metadataVisible: 16, _duration: 16, _currentTime: 16, _bufferedValue: 16, _currentValue: 16, _isBuffering: 16, _videoViewReady: 16, _layerTitle: 16, _isLive: 16, _loopPlayback: 16, referenceElement: 1, icon: 1, state: 32, followingMode: 1, layer: 0, autoDestroyDisabled: 5, messageOverrides: 0, label: 3, inline: 7, showFullscreenToggle: 5, operationalDataVisible: 5, hideHeader: 5, view: 0 };
   }
   static {
-    this.styles = M;
+    this.styles = O;
   }
   get followingMode() {
     return this.viewModel.followingMode;
@@ -33,47 +241,47 @@ class T extends g {
   }
   loaded() {
     this.manager.onLifecycle(() => [
-      t(() => [this.viewModel.currentTime, this.viewModel.duration, this.viewModel.buffered, this.viewModel.ended], () => {
-        const { buffered: i, currentTime: o, duration: n, ended: d } = this.viewModel, s = r(n), a = r(o), c = r(i);
-        this._duration = s, this._currentTime = a, this._bufferedValue = c / (s || 1), this._currentValue = a / (s || 1), this._isBuffering = !d && this._bufferedValue < this._currentValue;
+      d(() => [this.viewModel.currentTime, this.viewModel.duration, this.viewModel.buffered, this.viewModel.ended], () => {
+        const { buffered: i, currentTime: n, duration: h, ended: r } = this.viewModel, y = f(h), c = f(n), p = f(i);
+        this._duration = y, this._currentTime = c, this._bufferedValue = p / (y || 1), this._currentValue = c / (y || 1), this._isBuffering = !r && this._bufferedValue < this._currentValue;
       }),
-      t(() => this.layer?.title, (i) => {
+      d(() => this.layer?.title, (i) => {
         this._layerTitle = i ?? void 0;
       }, { initial: !0 }),
-      t(() => this.layer?.isLive, (i) => {
+      d(() => this.layer?.isLive, (i) => {
         this._isLive = i ?? void 0;
       }, { initial: !0 }),
-      t(() => this.layer?.playbackRate, (i) => {
+      d(() => this.layer?.playbackRate, (i) => {
         typeof i == "number" && this.viewModel.changePlaybackSpeed(i);
       }, { initial: !0 }),
-      t(() => this.viewModel.view?.map, () => this.requestUpdate())
+      d(() => this.viewModel.view?.map, () => this.requestUpdate())
     ]);
   }
   render() {
-    return e`<div class=${m(p(this.inline ? "inline" : "root", $.widget))}><calcite-panel .heading=${this.hideHeader || this.inline ? void 0 : this._layerTitle ?? this.messages.videoPlayer}>${this.inline || this.hideHeader || !this.showFullscreenToggle ? null : e`<calcite-action slot=header-actions-end icon=full-screen-exit text=minimize @click=${() => this.inline = !this.inline}></calcite-action>`}${this.inline ? e`<div class="inline">${this._renderActionBar()}${this._renderSlider()}${this.showFullscreenToggle ? e`<calcite-action icon=full-screen text=maximize @click=${() => this.inline = !this.inline}></calcite-action>` : null}</div>` : e`<div class="content">${this._renderLoadingScrim()}${this._renderBuffering()}${this._renderVideoSection()}</div>`}${this.inline ? null : e`<div slot=footer class="footer">${this._renderSlider()}${this._renderActionBar()}${this._renderMetadataSection()}</div>`}</calcite-panel></div>`;
+    return s`<div class=${_(M(this.inline ? "inline" : "root", P.widget))}><calcite-panel .heading=${this.hideHeader || this.inline ? void 0 : this._layerTitle ?? this.messages.videoPlayer}>${this.inline || this.hideHeader || !this.showFullscreenToggle ? null : s`<calcite-action slot=header-actions-end icon=full-screen-exit text=minimize @click=${() => this.inline = !this.inline}></calcite-action>`}${this.inline ? s`<div class="inline">${this._renderActionBar()}${this._renderSlider()}${this.showFullscreenToggle ? s`<calcite-action icon=full-screen text=maximize @click=${() => this.inline = !this.inline}></calcite-action>` : null}</div>` : s`<div class="content">${this._renderLoadingScrim()}${this._renderBuffering()}${this._renderVideoSection()}</div>`}${this.inline ? null : s`<div slot=footer class="footer">${this._renderSlider()}${this._renderActionBar()}${this._renderMetadataSection()}</div>`}</calcite-panel></div>`;
   }
   _renderLoadingScrim() {
-    return this._videoViewReady ? null : e`<calcite-scrim .loading=${this.state !== "error"}>${this.state === "error" ? this.messages.errorLoadingLayer : null}</calcite-scrim>`;
+    return this._videoViewReady ? null : s`<calcite-scrim .loading=${this.state !== "error"}>${this.state === "error" ? this.messages.errorLoadingLayer : null}</calcite-scrim>`;
   }
   _renderBuffering() {
-    return this._isBuffering ? e`<calcite-progress type=indeterminate></calcite-progress>` : null;
+    return this._isBuffering ? s`<calcite-progress type=indeterminate></calcite-progress>` : null;
   }
   _renderVideoSection() {
-    return e`<arcgis-video .layer=${this.layer} .map=${this.viewModel.view?.map} .operationalDataVisible=${this.operationalDataVisible} @arcgisViewReadyChange=${() => {
+    return s`<arcgis-video .layer=${this.layer} .map=${this.viewModel.view?.map} .operationalDataVisible=${this.operationalDataVisible} @arcgisViewReadyChange=${() => {
       this._videoViewReady = !0, this.arcgisVideoReady.emit();
-    }} ${y(this._videoViewRef)}></arcgis-video>`;
+    }} ${D(this._videoViewRef)}></arcgis-video>`;
   }
   _renderSlider() {
-    return this._isLive ? null : e`<arcgis-video-player-slider .buffered=${this._bufferedValue} .messages=${this.messages} .value=${this._currentValue * 100} .viewModel=${this.viewModel}></arcgis-video-player-slider>`;
+    return this._isLive ? null : s`<arcgis-video-player-slider .buffered=${this._bufferedValue} .messages=${this.messages} .value=${this._currentValue * 100} .viewModel=${this.viewModel}></arcgis-video-player-slider>`;
   }
   _renderActionBar() {
-    return e`<arcgis-video-player-action-bar .currentTime=${this._currentTime} .duration=${this._duration} .messages=${this.messages} .toggleMetadata=${() => this._metadataVisible = !this._metadataVisible} .viewModel=${this.viewModel} .inline=${this.inline}></arcgis-video-player-action-bar>`;
+    return s`<arcgis-video-player-action-bar .currentTime=${this._currentTime} .duration=${this._duration} .messages=${this.messages} .toggleMetadata=${() => this._metadataVisible = !this._metadataVisible} .viewModel=${this.viewModel} .inline=${this.inline}></arcgis-video-player-action-bar>`;
   }
   _renderMetadataSection() {
-    return this._metadataVisible ? e`<arcgis-video-player-metadata .messages=${this.messages} .viewModel=${this.viewModel}></arcgis-video-player-metadata>` : null;
+    return this._metadataVisible ? s`<arcgis-video-player-metadata .messages=${this.messages} .viewModel=${this.viewModel}></arcgis-video-player-metadata>` : null;
   }
 }
-h("arcgis-video-player", T);
+g("arcgis-video-player", R);
 export {
-  T as ArcgisVideoPlayer
+  R as ArcgisVideoPlayer
 };

package/dist/components/arcgis-volume-measurement/customElement.d.ts

@@ -147,13 +147,21 @@ export abstract class ArcgisVolumeMeasurement extends LitElement {
    * Unit system (imperial, metric) or specific unit used for displaying the area. Possible values are listed in
    * [areaDisplayUnitOptions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-volume-measurement/#areaDisplayUnitOptions).
    *
+   * When no area unit is explicitly set on the component or its analysis, this property uses the area unit configured in the view through
+   * [view.options.displayUnits.area](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/options/ViewOptions/#displayUnits).
+   * This property overrides the area unit on this component's analysis without changing the units configured in the view.
+   *
    * @since 5.0
    */
   accessor areaDisplayUnit: SystemOrAreaUnit;
   /**
    * List of available units and unit systems (imperial, metric) that are shown in the component's area display unit dropdown.
    * By default, the following units are included: `metric`, `imperial`, `square-inches`, `square-feet`, `square-yards`, `square-miles`, `square-nautical-miles`, `square-us-feet`, `square-millimeters`, `square-centimeters`, `square-decimeters`, `square-meters`, `square-kilometers`, `acres`, `ares`, `hectares`.
-   * Possible [areaDisplayUnit](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-volume-measurement/#areaDisplayUnit) values can only be a subset of this list.
+   * If the unit inherited from the view through
+   * [view.options.displayUnits.area](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/options/ViewOptions/#displayUnits)
+   * is not listed in [areaDisplayUnitOptions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-volume-measurement/#areaDisplayUnitOptions), 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
+   * [areaDisplayUnitOptions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-volume-measurement/#areaDisplayUnitOptions).
    *
    * @since 5.0
    */
@@ -181,13 +189,21 @@ export abstract class ArcgisVolumeMeasurement extends LitElement {
    * Unit system (imperial, metric) or specific unit used for displaying the cut and fill target elevation. Possible values are listed in
    * [elevationDisplayUnitOptions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-volume-measurement/#elevationDisplayUnitOptions).
    *
+   * When no elevation unit is explicitly set on the component or its analysis, this property uses the vertical length unit configured in the view through
+   * [view.options.displayUnits.verticalLength](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/options/ViewOptions/#displayUnits).
+   * This property overrides the elevation unit on this component's analysis without changing the units configured in the view.
+   *
    * @since 5.0
    */
   accessor elevationDisplayUnit: 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`, `meters`, `millimeters`, `centimeters`, `decimeters`, `kilometers`, `inches`, `feet`, `yards`, `miles`, `nautical-miles`, `us-feet`.
-   * Possible [elevationDisplayUnit](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-volume-measurement/#elevationDisplayUnit) values can only be a subset of this list.
+   * If the unit inherited from the view through
+   * [view.options.displayUnits.verticalLength](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/options/ViewOptions/#displayUnits)
+   * is not listed in [elevationDisplayUnitOptions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-volume-measurement/#elevationDisplayUnitOptions), 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
+   * [elevationDisplayUnitOptions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-volume-measurement/#elevationDisplayUnitOptions).
    *
    * @since 5.0
    */
@@ -199,6 +215,12 @@ export abstract class ArcgisVolumeMeasurement extends LitElement {
    * This controls which unit is used when entering an elevation value via the tool's UI (for example, using the
    * shift manipulator tooltip input in "Cut & Fill Volume" mode).
    *
+   * When no elevation input unit is explicitly set on the component or its analysis, this property uses the vertical length input unit configured in the view through
+   * [view.options.inputUnits.verticalLength](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/options/ViewOptions/#inputUnits).
+   * The `metric` and `imperial` measurement systems resolve to `meters` and `feet`, respectively.
+   * This property overrides the elevation input unit on this component's analysis without changing the units configured in the view.
+   * Changing this property preserves the target surface elevation.
+   *
    * @since 5.0
    */
   accessor elevationInputUnit: LengthUnit;
@@ -207,7 +229,12 @@ export abstract class ArcgisVolumeMeasurement extends LitElement {
    *
    * By default, the following units are included: `inches`, `feet`, `yards`, `miles`, `nautical-miles`, `us-feet`,
    * `millimeters`, `centimeters`, `decimeters`, `meters`, `kilometers`.
-   * The current [elevationInputUnit](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-volume-measurement/#elevationInputUnit) value can only be a subset of this list.
+   * The unit inherited from the view through
+   * [view.options.inputUnits.verticalLength](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/options/ViewOptions/#inputUnits)
+   * resolves to `meters` for `metric` and `feet` for `imperial`.
+   * If the inherited unit is not listed in [elevationInputUnitOptions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-volume-measurement/#elevationInputUnitOptions), 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
+   * [elevationInputUnitOptions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-volume-measurement/#elevationInputUnitOptions).
    *
    * @since 5.0
    */
@@ -270,6 +297,13 @@ export abstract class ArcgisVolumeMeasurement extends LitElement {
    * @since 5.0
    */
   accessor hidePerimeterDisplayUnitSelect: 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 settings button that opens the settings popover will be hidden.
    *
@@ -302,10 +336,18 @@ export abstract class ArcgisVolumeMeasurement extends LitElement {
    * Icon which represents the component.
    * Typically used when the component is controlled by another component (e.g. by the Expand component).
    *
-   * @default "measure-area"
+   * @default "cut-and-fill-volume-calculation"
    * @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;
   /**
@@ -314,6 +356,7 @@ export abstract class ArcgisVolumeMeasurement extends LitElement {
    * _**Note**: Individual message keys may change between releases._
    */
   accessor messageOverrides: {
+      reset?: string | undefined;
       componentLabel?: string | undefined;
       title?: string | undefined;
       hint?: string | undefined;
@@ -347,6 +390,7 @@ export abstract class ArcgisVolumeMeasurement extends LitElement {
   };
   /** @internal */
   protected messages: {
+      reset: string;
       componentLabel: string;
       title: string;
       hint: string;
@@ -378,6 +422,7 @@ export abstract class ArcgisVolumeMeasurement extends LitElement {
       areaDisplayUnit: string;
       perimeterDisplayUnit: string;
   } & T9nMeta<{
+      reset: string;
       componentLabel: string;
       title: string;
       hint: string;
@@ -419,13 +464,21 @@ export abstract class ArcgisVolumeMeasurement extends LitElement {
    * Unit system (imperial, metric) or specific unit used for displaying the perimeter values. Possible values are
    * listed in [perimeterDisplayUnitOptions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-volume-measurement/#perimeterDisplayUnitOptions).
    *
+   * When no perimeter 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 perimeter unit on this component's analysis without changing the units configured in the view.
+   *
    * @since 5.0
    */
   accessor perimeterDisplayUnit: SystemOrLengthUnit;
   /**
    * List of available units and unit systems (imperial, metric) that are shown in the component's perimeter display unit dropdown.
    * By default, the following units are included: `metric`, `imperial`, `meters`, `millimeters`, `centimeters`, `decimeters`, `kilometers`, `inches`, `feet`, `yards`, `miles`, `nautical-miles`, `us-feet`.
-   * Possible [perimeterDisplayUnit](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-volume-measurement/#perimeterDisplayUnit) 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 [perimeterDisplayUnitOptions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-volume-measurement/#perimeterDisplayUnitOptions), 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
+   * [perimeterDisplayUnitOptions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-volume-measurement/#perimeterDisplayUnitOptions).
    *
    * @since 5.0
    */
@@ -456,13 +509,21 @@ export abstract class ArcgisVolumeMeasurement extends LitElement {
    * Unit system (imperial, metric) or specific unit used for displaying the volume values. Possible values are listed in
    * [volumeDisplayUnitOptions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-volume-measurement/#volumeDisplayUnitOptions).
    *
+   * When no volume unit is explicitly set on the component or its analysis, this property uses the volume unit configured in the view through
+   * [view.options.displayUnits.volume](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/options/ViewOptions/#displayUnits).
+   * This property overrides the volume unit on this component's analysis without changing the units configured in the view.
+   *
    * @since 5.0
    */
   accessor volumeDisplayUnit: SystemOrVolumeUnit;
   /**
    * List of available units and unit systems (imperial, metric) that are shown in the component's dropdown.
    * By default, the following units are included: `imperial`, `metric`, `liters`, `megaliters`, `gigaliters`, `cubic-millimeters`, `cubic-centimeters`, `cubic-decimeters`, `cubic-meters`, `cubic-kilometers`, `cubic-inches`, `cubic-us-feet`, `cubic-feet`, `cubic-yards`, `cubic-miles`.
-   * Possible [volumeDisplayUnit](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-volume-measurement/#volumeDisplayUnit) values can only be a subset of this list.
+   * If the unit inherited from the view through
+   * [view.options.displayUnits.volume](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/options/ViewOptions/#displayUnits)
+   * is not listed in [volumeDisplayUnitOptions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-volume-measurement/#volumeDisplayUnitOptions), 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
+   * [volumeDisplayUnitOptions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-volume-measurement/#volumeDisplayUnitOptions).
    *
    * @since 5.0
    */
@@ -482,8 +543,8 @@ export abstract class ArcgisVolumeMeasurement extends LitElement {
    */
   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: ArcgisVolumeMeasurement["arcgisPropertyChange"]["detail"];