@arcgis/map-components 5.1.0-next.1 → 5.1.0-next.10

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

@@ -7,7 +7,7 @@ import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 
 /**
  * The ArcGIS Video component provides a view for displaying video feeds from a
- * [VideoLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-VideoLayer.html).
+ * [VideoLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/VideoLayer/).
  * It is designed to render and interact with video layers.
  *
  * A Video component must have a valid VideoLayer.
@@ -61,32 +61,32 @@ export abstract class ArcgisVideo extends LitElement {
    *
    * @since 5.0
    */
-  accessor attributionMode: "light" | "dark" | null | undefined;
+  accessor attributionMode: "dark" | "light" | null | undefined;
   /** @default false */
   accessor autoDestroyDisabled: boolean;
-  /** The [VideoLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-VideoLayer.html) to display in the view. */
+  /** The [VideoLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/VideoLayer/) to display in the view. */
   accessor layer: VideoLayer | null | undefined;
-  /** A reference to the associated [Map](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html) or [WebMap](https://developers.arcgis.com/javascript/latest/api-reference/esri-WebMap.html). */
+  /** A reference to the associated [Map](https://developers.arcgis.com/javascript/latest/references/core/Map/) or [WebMap](https://developers.arcgis.com/javascript/latest/references/core/WebMap/). */
   accessor map: Map | WebMap | null | undefined;
   /**
    * When `true`, this property indicates whether the view successfully satisfied all dependencies,
    * signaling that the following conditions are met.
    *
-   * - [width](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-VideoView.html#width)
-   * - [height](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-VideoView.html#height)
-   * - [videoSize](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-VideoView.html#videoSize)
-   * - The [layer](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-VideoView.html#layer) is [ready](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-VideoLayer.html#state).
+   * - [width](https://developers.arcgis.com/javascript/latest/references/core/views/VideoView/#width)
+   * - [height](https://developers.arcgis.com/javascript/latest/references/core/views/VideoView/#height)
+   * - [videoSize](https://developers.arcgis.com/javascript/latest/references/core/views/VideoView/#videoSize)
+   * - The [layer](https://developers.arcgis.com/javascript/latest/references/core/views/VideoView/#layer) is [ready](https://developers.arcgis.com/javascript/latest/references/core/layers/VideoLayer/#state).
    *
    * When a view becomes ready it will resolve itself and invoke
-   * the callback defined in [when()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-VideoView.html#when) where code can execute on a working view. Subsequent
+   * the callback defined in [when()](https://developers.arcgis.com/javascript/latest/references/core/views/VideoView/#when) where code can execute on a working view. Subsequent
    * changes to a view's readiness would typically be handled by watching `view.ready` and providing
-   * logic for cases where the [layer](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-VideoView.html#layer) or [container](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-VideoView.html#container) change.
+   * logic for cases where the [layer](https://developers.arcgis.com/javascript/latest/references/core/views/VideoView/#layer) or [container](https://developers.arcgis.com/javascript/latest/references/core/views/VideoView/#container) change.
    *
    * @default false
-   * @see [when()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-VideoView.html#when)
+   * @see [when()](https://developers.arcgis.com/javascript/latest/references/core/views/VideoView/#when)
    */
   get ready(): boolean;
-  /** The [VideoView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-VideoView.html) instance created and manged by the component. Accessible once the component is fully loaded. */
+  /** The [VideoView](https://developers.arcgis.com/javascript/latest/references/core/views/VideoView/) instance created and manged by the component. Accessible once the component is fully loaded. */
   get view(): VideoView;
   /** Destroys the view, and any associated resources, including its map, popup, and UI elements. */
   destroy(): Promise<void>;

package/dist/components/arcgis-video-player/customElement.d.ts

@@ -3,12 +3,12 @@ import type VideoPlayerViewModel from "@arcgis/core/widgets/VideoPlayer/VideoPla
 import type VideoLayer from "@arcgis/core/layers/VideoLayer.js";
 import type MapView from "@arcgis/core/views/MapView.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
-import type { ArcgisReferenceElement } from "../../utils/component-utils.js";
+import type { ArcgisReferenceElement } from "../types.js";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
 import type { VideoState } from "@arcgis/core/layers/video/types.js";
 
 /**
- * The Video Player component provides a user interface for interacting with a [VideoLayer](api-reference/esri-layers-VideoLayer.html).
+ * The Video Player component provides a user interface for interacting with a [VideoLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/VideoLayer/).
  * It displays the original video content and provides controls for playing, pausing, seeking, and changing the video speed and quality.
  *
  * The Video Player component provides the following capabilities:
@@ -19,11 +19,11 @@ import type { VideoState } from "@arcgis/core/layers/video/types.js";
  *  - Adjustable speed and quality
  *  - Access to frame metadata
  *
- * The [VideoPlayerViewModel](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-VideoPlayer-VideoPlayerViewModel.html) class provides the logic for the Video Player.
+ * The [VideoPlayerViewModel](https://developers.arcgis.com/javascript/latest/references/core/widgets/VideoPlayer/VideoPlayerViewModel/) class provides the logic for the Video Player.
  *
  * **Known limitations**
  *
- * * Not supported in 3D [Scenes](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/).
+ * * Not supported in 3D [Scenes](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/).
  * * Not supported on macOS and iOS devices.
  *
  * [![](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/video-player-video-preview.png)](https://mediaspace.esri.com/media/1_ctc3psfr)
@@ -95,7 +95,7 @@ export abstract class ArcgisVideoPlayer extends LitElement {
   /** The component's default label. */
   accessor label: string | undefined;
   /**
-   * The [VideoLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-VideoLayer.html) to use as the data source for the video player.
+   * The [VideoLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/VideoLayer/) to use as the data source for the video player.
    *
    * @default null
    * @example

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

@@ -10,7 +10,7 @@ import { createRef as m, ref as f } from "lit/directives/ref.js";
 import { u as v } from "../../chunks/useT9n.js";
 import { m as _ } from "../../chunks/useViewModel.js";
 import { g as w } from "../../chunks/globalCss.js";
-const p = n`:host{--arcgis-internal-video-player-controls-spacing: 16px;width:531px;height:100%}:host([inline]){width:auto;height:auto}.root{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}`, y = _(c);
+const p = n`: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}`, y = _(c);
 class $ extends u {
   constructor() {
     super(...arguments), this.messages = v({ blocking: !0 }), this.viewModel = y(this), this._videoViewRef = m(), this._metadataVisible = !1, this._duration = 0, this._currentTime = 0, this._bufferedValue = 0, this._currentValue = 0, this._isBuffering = !1, this._videoViewReady = !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.hideHeader = !1, this.view = this.viewModel.view, this.arcgisPropertyChange = d()("state", "layer"), this.arcgisReady = a(), this.arcgisVideoReady = a();
@@ -46,7 +46,7 @@ class $ extends u {
     ]);
   }
   render() {
-    return e`<div class=${g(h(this.inline ? "inline" : "root", w.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>${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 e`<div class=${g(h(this.inline ? "inline" : "root", w.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>`;
   }
   _renderLoadingScrim() {
     return this._videoViewReady ? null : e`<calcite-scrim .loading=${this.state !== "error"}>${this.state === "error" ? this.messages.errorLoadingLayer : null}</calcite-scrim>`;

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

@@ -3,15 +3,18 @@ import type SceneView from "@arcgis/core/views/SceneView.js";
 import type VolumeMeasurementAnalysis2 from "@arcgis/core/analysis/VolumeMeasurementAnalysis.js";
 import type { VolumeMeasureType } from "@arcgis/core/analysis/VolumeMeasurement/types";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
-import type { HeadingLevel } from "../../support/heading.js";
-import type { ArcgisReferenceElement } from "../../utils/component-utils.js";
+import type { ArcgisReferenceElement, HeadingLevel } from "../types.js";
+import type { VolumeMeasurementState } from "./types.js";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
 import type { Icon as Icon } from "@esri/calcite-components/components/calcite-icon";
 import type { SystemOrVolumeUnit, SystemOrLengthUnit, LengthUnit, SystemOrAreaUnit } from "@arcgis/core/core/units.js";
 
 /**
+ * > The Volume Measurement component is currently in _preview_.
+ * > To learn about features in preview, see the [Frequently Asked Questions](https://developers.arcgis.com/javascript/latest/faq/#what-does-the-preview-tag-mean)
+ *
  * The Volume Measurement component can be added to a
- * [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/) to
+ * [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/) to
  * calculate and visualize the volume of ground surfaces within a defined polygonal area.
  *
  * ![measurement-volume](https://developers.arcgis.com/javascript/latest/assets/img/components/volume-measurement/volume_measurement_poster.png)
@@ -37,15 +40,15 @@ import type { SystemOrVolumeUnit, SystemOrLengthUnit, LengthUnit, SystemOrAreaUn
  * **Known Limitations**
  *
  * -  The Volume Measurement component can only be added to a
- * [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/) component.
+ * [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/) component.
  * - The results of the tool vary depending on the zoom level, as changes in zoom level affect the level of detail (LOD) of the scene geometry.
  * - If the view is too close or too far from the measurement polygon, the results will not be computed due to LOD-induced inaccuracies.
  * - The elevation of the target surface in the "Cut & Fill Volume" mode is restricted to the range of -11 km and +9 km.
- * - This tool operates only on the non-transparent [Map.ground](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html#ground),
- * [IntegratedMeshLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-IntegratedMeshLayer.html)
- * and an [IntegratedMesh3DTilesLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-IntegratedMesh3DTilesLayer.html).
+ * - This tool operates only on the non-transparent [Map.ground](https://developers.arcgis.com/javascript/latest/references/core/Map/#ground),
+ * [IntegratedMeshLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/IntegratedMeshLayer/)
+ * and an [IntegratedMesh3DTilesLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/IntegratedMesh3DTilesLayer/).
  * - This tool does not support WGS 1984 spatial reference in a local
- * [viewing mode](https://developers.arcgis.com/javascript/latest/api-reference/esri-webscene-InitialViewProperties.html#viewingMode).
+ * [viewing mode](https://developers.arcgis.com/javascript/latest/references/core/webscene/InitialViewProperties/#viewingMode).
  *
  * **Things to consider**
  *
@@ -53,35 +56,35 @@ import type { SystemOrVolumeUnit, SystemOrLengthUnit, LengthUnit, SystemOrAreaUn
  * and enter the target surface elevation.
  * - Snapping is enabled by default. This can be temporarily disabled by holding the `CTRL` key.
  * - Layer types currently supported for snapping are:
- * [FeatureLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html),
- * [GraphicsLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-GraphicsLayer.html) (except Mesh geometries),
- * [GeoJSONLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-GeoJSONLayer.html),
- * [WFSLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-WFSLayer.html),
- * [CSVLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-CSVLayer.html),
- * [3D Object SceneLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-SceneLayer.html),
- * and [BuildingSceneLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-BuildingSceneLayer.html).
+ * [FeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/),
+ * [GraphicsLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/GraphicsLayer/) (except Mesh geometries),
+ * [GeoJSONLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/GeoJSONLayer/),
+ * [WFSLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/WFSLayer/),
+ * [CSVLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/CSVLayer/),
+ * [3D Object SceneLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/SceneLayer/),
+ * and [BuildingSceneLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/BuildingSceneLayer/).
  *
  * **See also**
  *
- * - [Volume Measurement Analysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-VolumeMeasurementAnalysis.html)
- * - [VolumeMeasurementAnalysisView3D](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-analysis-VolumeMeasurementAnalysisView3D.html)
- * - [VolumeMeasurementResult](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-analysis-VolumeMeasurement-VolumeMeasurementResult.html)
- * - [VolumeMeasurementDisplayUnits](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-VolumeMeasurement-VolumeMeasurementDisplayUnits.html)
- * and [VolumeMeasurementInputUnits](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-VolumeMeasurement-VolumeMeasurementInputUnits.html)
- * - [VolumeMeasurementError](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-analysis-VolumeMeasurement-VolumeMeasurementError.html)
+ * - [Volume Measurement Analysis](https://developers.arcgis.com/javascript/latest/references/core/analysis/VolumeMeasurementAnalysis/)
+ * - [VolumeMeasurementAnalysisView3D](https://developers.arcgis.com/javascript/latest/references/core/views/3d/analysis/VolumeMeasurementAnalysisView3D/)
+ * - [VolumeMeasurementResult](https://developers.arcgis.com/javascript/latest/references/core/views/3d/analysis/VolumeMeasurement/VolumeMeasurementResult/)
+ * - [VolumeMeasurementDisplayUnits](https://developers.arcgis.com/javascript/latest/references/core/analysis/VolumeMeasurement/VolumeMeasurementDisplayUnits/)
+ * and [VolumeMeasurementInputUnits](https://developers.arcgis.com/javascript/latest/references/core/analysis/VolumeMeasurement/VolumeMeasurementInputUnits/)
+ * - [VolumeMeasurementError](https://developers.arcgis.com/javascript/latest/references/core/views/3d/analysis/VolumeMeasurement/VolumeMeasurementError/)
  * - [Sample - Volume measurement analysis object](https://developers.arcgis.com/javascript/latest/sample-code/analysis-volume-measurement/)
  *
  * @since 5.0
  */
 export abstract class ArcgisVolumeMeasurement extends LitElement {
   /**
-   * The [VolumeMeasurementAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-VolumeMeasurementAnalysis.html)
+   * The [VolumeMeasurementAnalysis](https://developers.arcgis.com/javascript/latest/references/core/analysis/VolumeMeasurementAnalysis/)
    * created or modified by the component.
    *
-   * When connecting the Volume Measurement component to the [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/)
+   * When connecting the Volume Measurement component to the [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/)
    * component, it automatically creates an empty analysis and adds it to the Scene's
-   * [analyses](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#analyses) collection.
-   * You can then wait for the [VolumeMeasurementAnalysisView3D](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-analysis-VolumeMeasurementAnalysisView3D.html)
+   * [analyses](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#analyses) collection.
+   * You can then wait for the [VolumeMeasurementAnalysisView3D](https://developers.arcgis.com/javascript/latest/references/core/views/3d/analysis/VolumeMeasurementAnalysisView3D/)
    * to be created before accessing the analysis results.
    *
    * ```js
@@ -105,7 +108,7 @@ export abstract class ArcgisVolumeMeasurement extends LitElement {
    * ```
    * Whenever the component is destroyed, the analysis is automatically removed from the collection.
    *
-   * Alternatively, a programmatically created [VolumeMeasurementAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-VolumeMeasurementAnalysis.html)
+   * Alternatively, a programmatically created [VolumeMeasurementAnalysis](https://developers.arcgis.com/javascript/latest/references/core/analysis/VolumeMeasurementAnalysis/)
    * can be provided to the component.
    * Then, the application itself needs to add it to and later remove it from the analyses collection of the Scene component.
    *
@@ -267,6 +270,7 @@ export abstract class ArcgisVolumeMeasurement extends LitElement {
    * Indicates whether the component's visualization is hidden in the view.
    *
    * @default false
+   * @since 5.0
    */
   accessor hideVisualization: boolean;
   /**
@@ -385,7 +389,7 @@ export abstract class ArcgisVolumeMeasurement extends LitElement {
    *
    * @since 5.0
    */
-  get state(): "disabled" | "ready" | "measured" | "measuring";
+  get state(): VolumeMeasurementState;
   /**
    * 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-volume-measurement component will be associated with a map or scene component rather than using the `view` property.