@arcgis/map-components 5.0.0-next.75 → 5.0.0-next.77

package/dist/components/arcgis-map/customElement.js

@@ -14,7 +14,7 @@ import { U as b, u as V, a as C } from "../../chunks/useArcgisViewReadyError.js"
 import E from "@arcgis/core/core/Collection.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/5.0/esri/copyright.txt for details.
-v5.0.0-next.75 */
+v5.0.0-next.77 */
 const A = c(
   v,
   /**
@@ -34,7 +34,7 @@ class _ extends m {
     };
   }
   static {
-    this.properties = { _map: 16, view: 32, animationsDisabled: 5, aria: 0, allLayerViews: 0, analyses: 0, attributionItems: 32, attributionMode: 1, autoDestroyDisabled: 5, background: 0, basemap: 1, basemapView: 0, center: 1, constraints: 0, displayFilterDisabled: 5, extent: 0, fatalError: 0, floors: 0, focusAreas: 0, gamepad: 32, graphics: 0, ground: 1, hideAttribution: 5, highlights: 0, highlightOptions: 0, interacting: 32, ipsInfo: 0, itemId: 3, layerViews: 0, magnifier: 0, map: 0, navigating: 32, navigation: 0, padding: 0, popup: 0, popupDisabled: 5, ready: 4, resizeAlign: 1, resolution: 8, rotation: 9, scale: 9, spatialReference: 0, spatialReferenceLocked: 5, stationary: 32, suspended: 7, theme: 0, timeExtent: 0, timeZone: 1, updating: 4, viewpoint: 0, visibleArea: 0, zoom: 9, loadErrorSources: 0 };
+    this.properties = { _map: 16, view: 32, animationsDisabled: 5, aria: 0, allLayerViews: 0, analyses: 0, attributionItems: 32, attributionMode: 1, autoDestroyDisabled: 5, background: 0, basemap: 1, basemapView: 0, center: 1, constraints: 0, displayFilterDisabled: 5, extent: 0, fatalError: 0, floors: 0, focusAreas: 0, gamepad: 32, graphics: 0, ground: 1, hideAttribution: 5, highlights: 0, highlightOptions: 0, interacting: 32, ipsInfo: 0, itemId: 3, layerViews: 0, magnifier: 0, map: 0, navigating: 32, navigation: 0, padding: 0, popup: 0, popupDisabled: 5, ready: 5, resizeAlign: 1, resolution: 9, rotation: 9, scale: 9, spatialReference: 0, spatialReferenceLocked: 5, stationary: 32, suspended: 7, theme: 0, timeExtent: 0, timeZone: 1, updating: 5, viewpoint: 0, visibleArea: 0, zoom: 9, loadErrorSources: 0 };
   }
   static {
     this.styles = [g, u];

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

@@ -7,7 +7,7 @@ import { ArcgisReferenceElement } from '../../utils/component-utils';
 
 declare const useMeasurementWidget: (component: LitElement & Pick<Measurement, "label" | "viewModel" | "icon" | "activeTool" | "areaUnit" | "linearUnit"> & {
     state?: unknown;
-    viewModel?: __esri.MeasurementViewModel | undefined;
+    viewModel?: import('@arcgis/core/widgets/Measurement/MeasurementViewModel').default | undefined;
     closed?: boolean;
     icon: import('@arcgis/toolkit/type').nil | string;
     label: import('@arcgis/toolkit/type').nil | string;
@@ -35,28 +35,66 @@ export declare class ArcgisMeasurement extends LitElement {
     /**
      * The view associated with the component.
      *   > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the Measurement component will be associated with a map or scene component rather than using the `view` property.
+     *
+     * @example
+     * // To create the Measurement widget for SceneView with the direct-line tool active.
+     * const measurement = new Measurement({
+     *   view: sceneView,
+     *   activeTool: "direct-line"
+     * });
      */
-    view?: nullish | __esri.MapView | __esri.SceneView;
+    view?: import('@arcgis/core/views/MapViewOrSceneView').MapViewOrSceneView | null | undefined;
     /**
-     * Specifies the current measurement tool to display.
+     * Specifies the current measurement tool to display. Setting its value to `area` activates
+     * the area measurement tool and it works for both [MapView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html) and
+     * [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html). To measure distance in a [MapView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html)
+     * set the property to `distance` and in a [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html) set it to `direct-line`.
+     * If this property is not set, the widget will not be displayed.
+     *
+     * @example
+     * // To create the Measurement widget with SceneView's direct-line tool active.
+     * const measurement = new Measurement({
+     *   view: view,
+     *   activeTool: "direct-line"
+     * });
      *
-     * @default null
+     * // To switch between direct line and area measurement tools
+     * function switchTool() {
+     *  const tool = measurement.activeTool === "direct-line" ? "area" : "direct-line";
+     *  measurement.activeTool = tool;
+     * }
      */
-    activeTool: nullish | "area" | "distance" | "direct-line";
+    activeTool: import('@arcgis/core/widgets/Measurement/interfaces').MeasurementComponentType | null | undefined;
     /**
-     * The measurement widget that is currently being used.
-     *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Measurement.html#activeWidget)
+     * The measurement widget that is currently being used. Use this property to
+     * get access to the active widget.
      *
-     * @default null
+     * @example
+     * // Print the active widget to the console.
+     * const measurement = new Measurement({
+     *   view: view,
+     *   activeTool: "distance"
+     * });
+     * view.ui.add(measurement, "top-right");
+     * console.log("Active Widget: ", measurement.activeWidget);
      */
-    readonly activeWidget: nullish | __esri.AreaMeasurement2D | __esri.AreaMeasurement3D | __esri.DirectLineMeasurement3D | __esri.DistanceMeasurement2D;
+    activeWidget: import('@arcgis/core/widgets/Measurement.js').MeasurementWidget | null | undefined;
     /**
      * Unit system (imperial, metric) or specific unit used for displaying the area values.
+     * Possible values are: `metric`, `imperial`, `square-inches`, `square-feet`, `square-us-feet`, `square-yards`, `square-miles`, `square-nautical-miles`, `square-meters`, `square-kilometers`, `acres`, `ares`, `hectares`.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Measurement.html#areaUnit)
+     * @example
+     * // To create the Measurement widget that displays area in square US feet
+     * const measurement = new Measurement({
+     *   view: view,
+     *   activeTool: "area",
+     *   areaUnit: "square-us-feet"
+     * });
+     *
+     * // To display the current area measurement unit
+     * console.log("Current unit: ", measurement.areaUnit);
      */
-    areaUnit: __esri.SystemOrAreaUnit;
+    areaUnit: import('@arcgis/core/core/units').SystemOrAreaUnit;
     /**
      * If true, the component will not be destroyed automatically when it is
      * disconnected from the document. This is useful when you want to move the
@@ -72,21 +110,35 @@ export declare class ArcgisMeasurement extends LitElement {
      * Typically used when the component is controlled by another component (e.g. by the Expand component).
      *
      * @default "measure"
+     * @since 4.27
+     * @see [Calcite Icon Search](https://developers.arcgis.com/calcite-design-system/icons/)
+     * @see [Calcite Icon Search](https://developers.arcgis.com/calcite-design-system/icons/)
      * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
      */
     icon: string;
     /**
-     * The widget's default label.
+     * The widget's default label. This property is useful whenever the widget is controlled by another one
+     * (e.g. [Expand](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Expand.html)).
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Measurement.html#label)
+     * @since 4.11
      */
     label: string;
     /**
      * Unit system (imperial, metric) or specific unit used for displaying the distance values.
+     * Possible values are: `metric`, `imperial`, `inches`, `feet`, `us-feet`, `yards`, `miles`, `nautical-miles`, `meters`, `kilometers`.
+     *
+     * @example
+     * // To create the Measurement widget that displays distance in yards
+     * const measurement = new Measurement({
+     *   view: view,
+     *   activeTool: "distance",
+     *   linearUnit: "yards"
+     * });
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Measurement.html#linearUnit)
+     * // To display the current linear measurement unit
+     * console.log('Current linear unit: ', measurement.linearUnit);
      */
-    linearUnit: __esri.SystemOrLengthUnit;
+    linearUnit: import('@arcgis/core/core/units').SystemOrLengthUnit;
     /** @deprecated since 4.34, use [`slot`](https://developers.arcgis.com/javascript/latest/building-your-ui/#slots) instead. */
     position?: __esri.UIPosition;
     /**
@@ -99,8 +151,18 @@ export declare class ArcgisMeasurement extends LitElement {
      * The current state of the component.
      *
      * @default "disabled"
+     * @example
+     * // To display the state of the AreaMeasurement2D widget
+     * let measurement = new Measurement({
+     *   view: view,
+     *   activeTool: "area"
+     * });
+     * reactiveUtils.watch(
+     *   () => measurement.viewModel.state,
+     *   (state) => console.log("Current state: ", state)
+     * );
      */
-    readonly state: "ready" | "disabled" | "measured" | "measuring";
+    state: import('@arcgis/core/widgets/interfaces').MeasurementState;
     clear(): Promise<void>;
     /** Permanently destroy the component. */
     destroy(): Promise<void>;

package/dist/components/arcgis-measurement/customElement.js

@@ -6,7 +6,7 @@ import { m as a } from "../../chunks/useWidget.js";
 import { css as n } from "lit";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/5.0/esri/copyright.txt for details.
-v5.0.0-next.75 */
+v5.0.0-next.77 */
 const s = n`.esri-widget__heading{color:var(--calcite-color-text-2);margin:0 0 .5rem;font-weight:var(--calcite-font-weight-semibold)}h1.esri-widget__heading{font-size:var(--calcite-font-size-xl)}h2.esri-widget__heading{font-size:var(--calcite-font-size-md)}h3.esri-widget__heading,h4.esri-widget__heading,h5.esri-widget__heading,h6.esri-widget__heading{font-size:var(--calcite-font-size)}.esri-widget{--esri-widget-padding-x: 15px;--esri-widget-padding-y: var(--calcite-spacing-md);--esri-widget-padding: var(--esri-widget-padding-y) var(--esri-widget-padding-x);box-sizing:border-box;color:var(--calcite-color-text-2);background-color:var(--calcite-color-foreground-1);font-size:var(--calcite-font-size);line-height:var(--calcite-font-line-height-relative-tight)}.esri-widget *,.esri-widget :before,.esri-widget :after{box-sizing:inherit}.esri-widget.esri-widget--disabled>*{opacity:.4;pointer-events:none}.esri-widget.esri-widget--compact{--esri-widget-padding-y: 0;--esri-widget-padding-x: 0}.esri-widget__anchor{color:var(--calcite-color-text-2)}.esri-widget__anchor:hover{color:var(--calcite-color-text-3)}.esri-widget__anchor:hover,.esri-widget__anchor:focus{text-decoration:underline}.esri-widget__anchor--disabled{opacity:.4;pointer-events:none}.esri-widget__header{background-color:var(--calcite-color-foreground-1);flex:1 0 100%;justify-content:space-between;align-items:center;width:100%;min-height:48px;padding:12px 0 12px 15px;display:flex}.esri-widget__header .esri-widget__heading{width:calc(100% - 48px);text-align:initial;color:var(--calcite-color-text-1);align-items:center;margin:0;padding:0;display:flex}.esri-widget__header-button{appearance:none;cursor:pointer;color:var(--calcite-color-text-2);background-color:var(--calcite-color-foreground-1);border:none;flex:0 0 48px;justify-content:center;align-self:stretch;align-items:center;width:48px;padding:0;display:flex}.esri-widget__footer{background-color:var(--calcite-color-foreground-1);justify-content:center;align-items:center;width:100%;min-height:48px;display:flex}.esri-widget__footer-pagination{color:var(--calcite-color-text-2);justify-content:space-between;align-items:center;display:flex}.esri-widget__footer-pagination-previous-button,.esri-widget__footer-pagination-next-button{cursor:pointer;background-color:var(--calcite-color-foreground-1);border:0;margin:0 7px;padding:12px 15px;transition:background-color .125s ease-in-out}.esri-widget__footer-pagination-previous-button:hover,.esri-widget__footer-pagination-previous-button:focus,.esri-widget__footer-pagination-next-button:hover,.esri-widget__footer-pagination-next-button:focus{color:var(--calcite-color-text-1);background-color:var(--calcite-color-foreground-1)}.esri-menu{visibility:hidden;z-index:1;background-clip:padding;background-color:var(--calcite-color-foreground-1);background-clip:padding-box;width:100%;max-height:0;margin:2px 0 0;padding:0;font-size:var(--calcite-font-size);line-height:var(--calcite-spacing-xl);position:absolute;top:100%;left:0;overflow:hidden;box-shadow:0 1px 2px #0000004d}.esri-menu .esri-menu__header{color:var(--calcite-color-text-inverse);background-color:var(--calcite-color-inverse);padding:6px 12px}.esri-menu__list{margin:0;padding:0;list-style:none}.esri-menu__list-item{cursor:pointer;border-top:1px solid #adadad4d;border-left:3px solid #0000;padding:.8em 1em}.esri-menu__list-item [class^=esri-icon-],.esri-menu__list-item [class*=" esri-icon-"]{padding-right:2.8px}.esri-menu__list-item:first-child{border-top:none}.esri-menu__list-item--focus,.esri-menu__list-item:hover,.esri-menu__list-item:focus{background-color:var(--calcite-color-foreground-1)}.esri-menu__list-item:active{background-color:var(--calcite-color-foreground-current)}.esri-menu__list-item--active,.esri-menu__list-item--active:hover,.esri-menu__list-item--active:focus{background-color:var(--calcite-color-foreground-1);border-left-color:var(--calcite-color-brand)}.esri-widget__table{border-collapse:collapse;color:var(--calcite-color-text-1);border:none;width:100%;line-height:var(--calcite-font-line-height-relative-tight)}.esri-widget__table tr:nth-child(odd){background-color:var(--calcite-color-transparent)}.esri-widget__table tr:nth-child(2n){background-color:var(--calcite-color-transparent-press)}.esri-widget__table tr a{color:var(--calcite-color-text-2)}.esri-widget__table tr a:hover,.esri-widget__table tr a:focus{color:var(--calcite-color-text-1)}.esri-widget__table tr td,.esri-widget__table tr th{vertical-align:top;word-break:break-word;padding:.5em .7em;font-size:var(--calcite-font-size-sm);font-weight:var(--calcite-font-weight-regular)}.esri-widget__table tr th{text-align:left;border-right:3px solid #0000000d;width:50%}.esri-widget__table tr td{width:50%}.esri-input{color:var(--calcite-color-text-1);background-color:var(--calcite-color-foreground-1);border:1px solid #959595;font-size:var(--calcite-font-size)}.esri-input::-ms-clear{display:none}.esri-input::placeholder{opacity:1;color:var(--calcite-color-text-2)}.esri-input:placeholder-shown{text-overflow:ellipsis}.esri-input[type=text],.esri-input[type=password],.esri-input[type=number]{height:32px;padding:0 .5em}calcite-combobox.esri-input{border:none}.esri-widget__content--empty{text-align:center;color:var(--calcite-color-border-input);flex-flow:column wrap;align-items:center;padding:18px 22px;display:flex}.esri-widget__content--empty h1.esri-widget__heading,.esri-widget__content--empty h2.esri-widget__heading,.esri-widget__content--empty h3.esri-widget__heading,.esri-widget__content--empty h4.esri-widget__heading,.esri-widget__content--empty h5.esri-widget__heading{font-weight:var(--calcite-font-weight-regular)}.esri-widget__content-illustration--empty{width:128px;padding:1rem 0}.esri-widget__content-icon--empty{width:32px;padding:.5rem 0}.esri-select{appearance:none;cursor:pointer;color:var(--calcite-color-text-2);background:var(--calcite-color-foreground-1) url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='-8 -8 32 32' width='32' height='32'%3E%3Cpath d='M8 11.207l-4-4V5.793l4 4 4-4v1.414z' fill='%23adadad' fillrule='nonzero'/%3E%3C/svg%3E") 100% no-repeat;border:1px solid #959595;border-radius:0;width:100%;height:32px;margin:0;padding:0 .5em;font-family:inherit;font-size:.85em;display:block}.esri-select[disabled]{cursor:auto}.esri-select::-ms-expand{display:none}.esri-disabled a,.esri-disabled [role=menu],.esri-disabled [role=checkbox],.esri-disabled [class^=esri-icon-],.esri-disabled [class*=" esri-icon-"]{color:var(--calcite-color-text-3)}.keynav-mode .esri-widget:focus,.keynav-mode .esri-widget :focus{z-index:1;outline-offset:2px;outline:2px solid #adadad}.esri-widget__loader-animation{border:.15em solid #adadad4d;border-top-color:var(--calcite-color-border-input);border-radius:100%;width:1em;height:1em;font-size:var(--calcite-font-size-md);animation:1.25s linear infinite esri-rotate;display:block;transform:translateZ(0)}:dir(rtl) .esri-widget__table th{text-align:right;border-left:3px solid #0000000d;border-right:none}:dir(rtl) .esri-select{background-position:0}:dir(rtl) .esri-menu__list-item{border-left:none;border-right:3px solid #0000}:dir(rtl) .esri-menu__list-item [class^=esri-icon-],:dir(rtl) .esri-menu__list-item [class*=" esri-icon-"]{padding-left:2px;padding-right:0}:dir(rtl) .esri-menu__list-item--active{border-right-color:var(--calcite-color-brand)}.esri-icon-font-fallback-text{clip:rect(0 0 0 0);width:1px;height:1px;position:absolute;overflow:hidden}.esri-rotating{animation:1.25s linear infinite esri-rotate;transform:translateZ(0)}.esri-clearfix:before,.esri-clearfix:after{content:" ";display:table}.esri-clearfix:after{clear:both}.esri-interactive{cursor:pointer}.esri-hidden{display:none!important}.esri-invisible{visibility:hidden!important}.esri-offscreen{position:absolute;top:-999em;left:-999em}.esri-match-height{flex-direction:column;flex:auto;display:flex;overflow:hidden}.esri-unit-select{width:100%}.esri-unit-select__label{--calcite-label-margin-bottom: 0;width:100%}:host{display:block}.esri-measurement-widget-content{padding:var(--esri-widget-padding);flex-direction:column;gap:var(--calcite-spacing-xxl);display:flex;position:relative;overflow-y:auto}.esri-measurement-widget-content__error{color:var(--calcite-color-status-danger)}.esri-measurement-widget-content__error,.esri-measurement-widget-content__hint{overflow:hidden}.esri-measurement-widget-content__error p,.esri-measurement-widget-content__hint p{margin:0;padding:0}.esri-measurement-widget-content__hint,.esri-measurement-widget-content__error,.esri-measurement-widget-content__measurement,.esri-measurement-widget-content__measurement-item{flex-direction:column;gap:var(--calcite-spacing-md);animation:.25s ease-in-out esri-fade-in;display:flex}.esri-measurement-widget-content__measurement-item--disabled{color:var(--calcite-color-border-ghost)}.esri-measurement-widget-content__measurement-item__value{font-weight:var(--calcite-font-weight-semibold)}.esri-measurement-widget-content__actions{flex-direction:column;justify-content:center;gap:var(--calcite-spacing-xs);display:flex}:host{min-width:300px}`, c = a(t);
 class d extends r {
   constructor() {

package/dist/components/arcgis-measurement-content/customElement.js

@@ -5,7 +5,7 @@ import { LitElement as r, safeClassMap as l } from "@arcgis/lumina";
 import { f as c } from "../../chunks/measurementUtils.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/5.0/esri/copyright.txt for details.
-v5.0.0-next.75 */
+v5.0.0-next.77 */
 const m = n`:host,.hint,.error,.section,.actions,.item{display:flex;flex-direction:column;gap:var(--calcite-spacing-md);animation:esri-fade-in .25s ease-in-out}.error{color:var(--calcite-color-status-danger)}.error,.hint{overflow:hidden;p{margin:0;padding:0}}.item-disabled{color:var(--calcite-color-text-1);opacity:var(--calcite-opacity-light)}.item-value{font-weight:var(--calcite-font-weight-semibold)}.actions{justify-content:center}.actions[hidden]{display:none}`;
 class u extends r {
   constructor() {

package/dist/components/arcgis-navigation-toggle/customElement.js

@@ -8,7 +8,7 @@ import { u as y } from "../../chunks/useView.js";
 import { g as M } from "../../chunks/globalCss.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/5.0/esri/copyright.txt for details.
-v5.0.0-next.75 */
+v5.0.0-next.77 */
 const x = "arcgis-navigation-toggle", l = {
   base: x,
   button: "arcgis-button"

package/dist/components/arcgis-oriented-imagery-viewer/customElement.d.ts

@@ -7,9 +7,9 @@ import { PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { PropertyValues } from 'lit';
 import { ArcgisReferenceElement } from '../../utils/component-utils';
 
-declare const useOrientedImageryViewerWidget: (component: LitElement & Pick<OrientedImageryViewer, "disabled" | "label" | "viewModel" | "icon" | "layer" | "currentCoverageVisible" | "dataCaptureEnabled" | "galleryOpened" | "imageEnhancementToolActive" | "isAdditionalCoverageVisible" | "isAdditionalPointSourcesVisible" | "mapImageConversionToolState" | "navigationToolActive"> & {
+declare const useOrientedImageryViewerWidget: (component: LitElement & Pick<OrientedImageryViewer, "disabled" | "label" | "icon" | "layer" | "currentCoverageVisible" | "dataCaptureEnabled" | "galleryOpened" | "imageEnhancementToolActive" | "isAdditionalCoverageVisible" | "isAdditionalPointSourcesVisible" | "mapImageConversionToolState" | "navigationToolActive"> & {
     state?: unknown;
-    viewModel?: __esri.OrientedImageryViewerViewModel | undefined;
+    viewModel?: import('@arcgis/core/widgets/OrientedImageryViewer/OrientedImageryViewerViewModel').default | undefined;
     closed?: boolean;
     icon: import('@arcgis/toolkit/type').nil | string;
     label: import('@arcgis/toolkit/type').nil | string;
@@ -39,8 +39,10 @@ export declare class ArcgisOrientedImageryViewer extends LitElement {
     /**
      * The view associated with the component.
      *   > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the Oriented Imagery Viewer component will be associated with a map or scene component rather than using the `view` property.
+     *
+     * @since 4.30
      */
-    view?: nullish | __esri.MapView | __esri.SceneView;
+    view?: import('@arcgis/core/views/MapViewOrSceneView').MapViewOrSceneView | null | undefined;
     /**
      * If true, the component will not be destroyed automatically when it is
      * disconnected from the document. This is useful when you want to move the
@@ -53,24 +55,33 @@ export declare class ArcgisOrientedImageryViewer extends LitElement {
     autoDestroyDisabled: boolean;
     /**
      * Toggles the visibility of the current footprint polygon associated with the selected image loaded in the viewer.
+     * Current footprint coverage allows you to better understand how the images in the oriented imagery layer relate to the map.
+     * The footprint of the image is symbolized with red fill on the map. If you zoom or pan in the oriented imagery viewer,
+     * the footprint coverage graphic will update on the map to highlight the area on the map that is visible in the image.
      *
      * @default true
      */
     currentCoverageVisible: boolean;
     /**
      * Indicates whether the data capture tools are enabled in the oriented imagery viewer for digitization.
+     * When set to `true` , the data capture (edit) option will be visible on the digitizable overlayed feature layers available in the image overlays tab.
+     * On clicking the data capture option, the digitization tools will appear at the bottom of the viewer once the overlay tab is closed.
      *
      * @default false
+     * @since 4.32
      */
     dataCaptureEnabled: boolean;
     /**
-     * When `false`, the view click interaction is enabled for the oriented imagery viewer widget.
+     * When `false`, the view click interaction is enabled for the oriented imagery viewer widget. This allows users to pick a location on the map and display the best image to the viewer.
+     * When `true` the view click interaction will be defaulted to map navigation.
      *
      * @default false
      */
     disabled: boolean;
     /**
      * Indicates if the image gallery functionality is available in the widget.
+     * To visualize additional images of the same location, select the image gallery from the oriented imagery viewer.
+     * The galley is a carousel of low-resolution thumbnails of all images that depict the selected map location. Click a thumbnail to view the full-resolution image in the oriented imagery viewer.
      *
      * @default false
      */
@@ -80,39 +91,47 @@ export declare class ArcgisOrientedImageryViewer extends LitElement {
      * Typically used when the component is controlled by another component (e.g. by the Expand component).
      *
      * @default "oriented-imagery-widget"
+     * @since 4.27
+     * @see [Calcite Icon Search](https://developers.arcgis.com/calcite-design-system/icons/)
+     * @see [Calcite Icon Search](https://developers.arcgis.com/calcite-design-system/icons/)
      * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
      */
     icon: string;
     /**
-     * Indicates if the image enhancement tool is active.
+     * Indicates if the image enhancement tool is active. When `true` the widget displays the functionalities to adjust the brightness, contrast, and sharpness of the
+     * image in the oriented imagery viewer using interactive sliders.
+     * Settings will be preserved for subsequent images loaded in the oriented imagery viewer.
      *
      * @default false
      */
     imageEnhancementToolActive: boolean;
     /**
      * When `true`, the image gallery functionality is available in the widget.
-     *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-OrientedImageryViewer.html#imageGalleryEnabled)
+     * Image gallery currently only supports MRF and Tif image formats.
      *
      * @default false
      */
-    readonly imageGalleryEnabled: boolean;
+    imageGalleryEnabled: boolean;
     /**
      * Indicates whether the image overlays tab in the oriented imagery viewer is open.
-     *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-OrientedImageryViewer.html#imageOverlaysOpened)
+     * When set to `true` , the overlays tab appears at the bottom of the viewer. It includes two toggle options: overlay camera locations and overlay map features.
+     * These options enable users to visualize and overlay map features that intersect with the image’s footprint within the viewer.
      *
      * @default false
+     * @since 4.32
      */
     imageOverlaysOpened: boolean;
     /**
      * Indicates if the additional footprint polygons are visible for the selected image loaded in the viewer.
+     * The footprint graphics (appearing in blue) show the coverage footprints of all the additional images in the
+     * layer that depict the location selected by the user.
      *
      * @default false
      */
     isAdditionalCoverageVisible: boolean;
     /**
      * Indicates if the additional camera locations are visible for the selected image loaded in the viewer.
+     * The point location graphics (appearing in blue) show the camera locations for additional images that depict the location the user selects.
      *
      * @default false
      */
@@ -120,23 +139,28 @@ export declare class ArcgisOrientedImageryViewer extends LitElement {
     /**
      * The widget's label.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Widget.html#label)
+     * This property is useful whenever the widget is controlled by another one (e.g. [Expand](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Expand.html))
+     *
+     * @since 4.11
      */
-    label: string | nullish;
+    label: string | null | undefined;
     /**
-     * Specifies the current [OrientedImageryLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-OrientedImageryLayer.html) to use.
-     *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-OrientedImageryViewer.html#layer)
+     * Specifies the current [OrientedImageryLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-OrientedImageryLayer.html) to use. The layer is one the widget connects to and utilizes to populate the image.
+     * The layer contains the feature data and oriented imagery properties required by the viewer to load the image and generate the associated graphics.
      */
-    layer: nullish | OrientedImageryLayer;
+    layer: OrientedImageryLayer | null | undefined;
     /**
      * Indicates if the map-image location tool is available in the widget.
+     * When `true`, the user can select a point on the map and the corresponding location in pixel space will be displayed in the image, and vice versa.
      *
      * @default false
      */
     mapImageConversionToolState: boolean;
     /**
      * When `true`, the navigation tool is available in the widget.
+     * The navigation tool can be used to explore the images that contain the selected location on the map using a compass.
+     * To view a different image of the selected map location, click the camera locations (blue dots), or click a segment to view
+     * the best image from that segment (segments with images are shown in white; segments without images are gray).
      *
      * @default false
      */
@@ -153,9 +177,9 @@ export declare class ArcgisOrientedImageryViewer extends LitElement {
     /**
      * This property provides the location of an image pixel in Map coordinates when using map-image conversion tool.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-OrientedImageryViewer.html#referencePoint)
+     * @since 4.29
      */
-    readonly referencePoint: __esri.Point | nullish;
+    referencePoint: import('@arcgis/core/geometry/Point').default | null;
     /** Permanently destroy the component. */
     destroy(): Promise<void>;
     /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */

package/dist/components/arcgis-oriented-imagery-viewer/customElement.js

@@ -8,14 +8,14 @@ import { css as l } from "lit";
 import { s as c } from "../../chunks/esri-main.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/5.0/esri/copyright.txt for details.
-v5.0.0-next.75 */
+v5.0.0-next.77 */
 const g = l`.esri-imagery-viewer{width:100%;height:100%}.esri-oriented-imagery-viewer{--esri-oriented-imagery-viewer-action-icon-size: 8px;--esri-oriented-imagery-viewer-min-width: 288px;--esri-oriented-imagery-viewer-min-height: 348px;--calcite-dialog-size-x: 210px;--calcite-dialog-min-size-y: 90px;--calcite-icon-size: var(--esri-oriented-imagery-viewer-action-icon-size);box-sizing:border-box;z-index:1;width:100%;min-width:var(--esri-oriented-imagery-viewer-min-width);height:100%;min-height:var(--esri-oriented-imagery-viewer-min-height);flex-direction:column;align-items:flex-start;display:flex;overflow:hidden}.esri-oriented-imagery-viewer:has(.esri-widget .esri-oriented-imagery-viewer__image-overlays-no-result){--esri-oriented-imagery-viewer-min-height: 420px}.esri-oriented-imagery-viewer__body{flex-direction:column;flex:1 0 auto;order:1;align-self:stretch;height:100%;display:flex}.esri-oriented-imagery-viewer__body-current-coverage{--calcite-icon-color: var(--calcite-color-status-danger)}.esri-oriented-imagery-viewer__body-additional-camera-locations{--calcite-icon-color: var(--calcite-color-brand)}.esri-oriented-imagery-viewer__body-additional-coverage{--calcite-icon-color: var(--calcite-color-status-info)}.esri-oriented-imagery-viewer__body-footprint{--calcite-icon-color: var(--calcite-color-status-success)}.esri-oriented-imagery-viewer__carousel{z-index:1;border:1px solid var(--calcite-color-border-2);align-items:center;width:98%;height:140px;margin:auto 1% 0;position:absolute;bottom:0;box-shadow:0 0 1px #0000004d}.esri-oriented-imagery-viewer__carousel-container{height:auto;display:inline-block;overflow:auto hidden}.esri-oriented-imagery-viewer__carousel header{--calcite-font-weight-medium: $font-weight--light;--calcite-font-size-0: $font-size--tiny}.esri-oriented-imagery-viewer__carousel-item{width:100px;height:70px}.esri-oriented-imagery-viewer__carousel-item-wrapper{box-sizing:border-box;justify-content:center;align-items:center;width:106px;height:78px;margin:auto 10px;display:flex;box-shadow:0 1px 2px #0000004d}.esri-oriented-imagery-viewer__carousel-item-wrapper--selected{box-sizing:border-box;border:2px solid var(--calcite-color-brand);justify-content:center;align-items:center;width:106px;height:78px;margin:auto 10px;display:flex;box-shadow:0 1px 2px #0000004d}.esri-oriented-imagery-viewer__carousel-content{display:flex}.esri-oriented-imagery-viewer__close{background:var(--calcite-color-foreground-1);flex-direction:row;flex-grow:0;order:7;justify-content:center;align-items:center;width:48px;height:59px;display:flex}.esri-oriented-imagery-viewer__image-enhancement-wrapper{z-index:1;border:1px solid var(--calcite-color-border-2);align-items:center;width:98%;height:140px;margin:auto 1% 0;position:absolute;bottom:0;box-shadow:0 0 1px #0000004d}.esri-oriented-imagery-viewer__image-enhancement-tools{display:flex}.esri-oriented-imagery-viewer__image-enhancement-tool-container{width:50%;margin-block:2px;padding-inline:.75rem}.esri-oriented-imagery-viewer__image-overlays{z-index:1;margin:auto;border:1px solid var(--calcite-color-border-2);align-items:center;width:100%;position:absolute;bottom:0;overflow-y:auto;box-shadow:0 0 1px #0000004d}.esri-oriented-imagery-viewer__image-overlays-layer-list,.esri-oriented-imagery-viewer__image-overlays-switch{padding:0 var(--calcite-spacing-md)}.esri-oriented-imagery-viewer__image-overlays-container{height:auto;display:flex}.esri-oriented-imagery-viewer__image-overlays-no-result{z-index:1;border:1px solid var(--calcite-color-border-2);align-items:center;width:98%;height:auto;margin:auto 1% 0;position:absolute;bottom:0;overflow-y:auto;box-shadow:0 0 1px #0000004d}.esri-oriented-imagery-viewer__image-overlays-no-result-layer-list,.esri-oriented-imagery-viewer__image-overlays-no-result-switch{padding:0 var(--calcite-spacing-md)}.esri-oriented-imagery-viewer__image-overlays-increased-height{z-index:1;border:1px solid var(--calcite-color-border-2);align-items:center;width:98%;height:200px;margin:auto 1% 0;position:absolute;bottom:0;overflow-y:auto;box-shadow:0 0 1px #0000004d}.esri-oriented-imagery-viewer__image-overlays-increased-height-layer-list,.esri-oriented-imagery-viewer__image-overlays-increased-height-switch{padding:0 var(--calcite-spacing-md)}.esri-oriented-imagery-viewer__measurement-results{width:auto;height:fit-content}.esri-oriented-imagery-viewer__measurements-table{margin-block-start:var(--calcite-spacing-sm)}.esri-oriented-imagery-viewer__measurements-bar{flex-wrap:nowrap;display:flex}.esri-oriented-imagery-viewer__measurements-button{display:flex}.esri-oriented-imagery-viewer__measurement-display{text-align:center;margin-block-end:var(--calcite-spacing-xxs)}.esri-oriented-imagery-viewer__viewer{cursor:url(data:text/svg+xml,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20height%3D%2226%22%20width%3D%2226%22%3E%0A%3Cpath%20stroke%3D%22%23000%22%20stroke-width%3D%221px%22%20fill%3D%22%23fff%22%20d%3D%22m15.3%2020.5s6.38-6.73%204.64-8.24-3.47%201.01-3.47%201.01%203.61-5.72%201.41-6.49c-2.2-0.769-3.33%204.36-3.33%204.36s0.873-5.76-1.06-5.76-1.58%205.39-1.58%205.39-0.574-4.59-2.18-4.12c-1.61%200.468-0.572%205.51-0.572%205.51s-1.58-4.89-2.93-3.79c-1.35%201.11%200.258%205.25%200.572%206.62%200.836%202.43%202.03%202.94%202.17%205.55%22%2F%3E%0A%3C%2Fsvg%3E%0A);flex-grow:1;width:100%;margin:0;display:flex}.esri-oriented-imagery-viewer__viewer--hidden{display:none}.esri-oriented-imagery-viewer__viewer-container{border-top:1px solid var(--calcite-color-border-3);background:var(--calcite-color-foreground-1);border-radius:0 0 3px 3px;flex:1 0 auto;order:1;align-self:stretch;width:100%;height:100%;display:flex}.esri-oriented-imagery-viewer__alert{inset-block-end:var(--calcite-spacing-md);inset-inline:var(--calcite-spacing-md);position:absolute}@keyframes rotateOrientedImageryNavigationTool{0%{transform:rotate(var(--oi-navigation-tool-rotation-from, 0deg))}to{transform:rotate(var(--oi-navigation-tool-rotation-to, 0deg))}}.esri-oriented-imagery-viewer__message-box{text-align:center;word-break:break-word;justify-content:center;align-items:center;width:100%;height:100%;padding:0 25%;font-size:var(--calcite-font-size-sm);display:flex;position:relative}.esri-oriented-imagery-viewer__navigation{transform:rotate(var(--oi-navigation-tool-rotation-to, 0deg))}.esri-oriented-imagery-viewer__navigation-animate{animation:.7s linear forwards rotateOrientedImageryNavigationTool}.esri-oriented-imagery-viewer__navigation-feature{fill:var(--calcite-color-brand);stroke:var(--calcite-color-foreground-1);stroke-width:1px}.esri-oriented-imagery-viewer__navigation-feature.selected{fill:var(--calcite-color-status-danger)}.esri-oriented-imagery-viewer__navigation-feature-path{pointer-events:none}.esri-oriented-imagery-viewer__navigation-feature-path-stop-offset-0{stop-color:var(--calcite-color-status-danger);stop-opacity:.4}.esri-oriented-imagery-viewer__navigation-feature-path-stop-offset-1{stop-color:var(--calcite-color-status-danger);stop-opacity:.2}.esri-oriented-imagery-viewer__navigation-pointer{fill:var(--calcite-color-foreground-1);fill-rule:evenodd;stroke:#0000;stroke-dasharray:none;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-width:0}.esri-oriented-imagery-viewer__navigation-pointer-north{fill:var(--calcite-color-status-danger)}.esri-oriented-imagery-viewer__navigation-wrapper{z-index:1;position:absolute;bottom:0;right:0;overflow:hidden}.esri-oriented-imagery-viewer__navigation-wrapper--zoomed{transform-origin:100% 100%;transform:scale(1.5)}.esri-oriented-imagery-viewer__navigation-wrapper-boundary{fill:var(--calcite-color-foreground-1);fill-opacity:.25;stroke:var(--calcite-color-border-2)}.esri-oriented-imagery-viewer__navigation-sector{fill:none}.esri-oriented-imagery-viewer__navigation-sector-separator{stroke:var(--calcite-color-border-2);stroke-width:1px}.esri-oriented-imagery-viewer__navigation-sector-cross{stroke:var(--calcite-color-status-danger);stroke-width:1px}.esri-oriented-imagery-viewer__navigation-sector-enabled{fill:var(--calcite-color-foreground-1);stroke:var(--calcite-color-border-2);stroke-width:1px}.esri-oriented-imagery-viewer__navigation-sector-disabled{fill:var(--calcite-color-foreground-3);stroke:var(--calcite-color-border-2);stroke-width:1px}.esri-oriented-imagery-viewer__navigation-sector-outer{fill:var(--calcite-color-foreground-1);fill-opacity:.4;stroke:none}.esri-oriented-imagery-viewer__pro .esri-oriented-imagery-viewer{width:100%;max-width:unset;height:100%;max-height:unset;position:static}.esri-oriented-imagery-viewer__sketch-tools{justify-content:center;align-items:center;width:100%;display:flex;position:absolute;bottom:0}.esri-oriented-imagery-viewer__navigation-ui{box-sizing:border-box;inset-block-end:var(--calcite-spacing-md);inset-inline:var(--calcite-spacing-md);transform-style:preserve-3d;z-index:var(--calcite-z-index-overlay);pointer-events:none;flex-direction:column;align-items:center;display:flex;position:absolute;overflow:hidden}.esri-oriented-imagery-viewer__navigation-ui__direction{--esri-oriented-imagery-viewer__navigation-ui-direction-color: wheat;--calcite-icon-color: var(--esri-oriented-imagery-viewer__navigation-ui-direction-color);cursor:not-allowed;width:160px;height:160px;position:absolute}.esri-oriented-imagery-viewer__navigation-ui__direction:not([disabled]){cursor:pointer;pointer-events:auto}.esri-oriented-imagery-viewer__navigation-ui__direction:not([disabled]):hover{--calcite-icon-color: var(--calcite-color-brand);background-color:rgba(var(--calcite-color-brand),var(--calcite-opacity-half));border-radius:50%}.esri-oriented-imagery-viewer__navigation-ui__direction-pad{box-sizing:border-box;transform:perspective(400px) rotateX(60deg) var(--rotate-transform);filter:drop-shadow(0 2px 1px #00000080);width:330px;height:330px}.esri-oriented-imagery-viewer__navigation-ui__direction--top{transform-style:preserve-3d;top:0;left:50%;transform:translate(-50%)}.esri-oriented-imagery-viewer__navigation-ui__direction--bottom{transform-style:preserve-3d;bottom:0;left:50%;transform:translate(-50%)}.esri-oriented-imagery-viewer__navigation-ui__direction--left{transform-style:preserve-3d;top:50%;left:0;transform:translateY(-50%)}.esri-oriented-imagery-viewer__navigation-ui__direction--right{transform-style:preserve-3d;top:50%;right:0;transform:translateY(-50%)}.esri-panoramic-viewer{z-index:1;position:relative;width:100%;height:100%}`, m = d(a);
 class v extends n {
   constructor() {
     super(...arguments), this.widget = m(this), this._hasOrientedImageryLayerToAdd = !1, this.viewModel = this.widget.viewModel, this.view = this.widget.view, this.autoDestroyDisabled = !1, this.currentCoverageVisible = this.widget.currentCoverageVisible, this.dataCaptureEnabled = this.widget.dataCaptureEnabled, this.disabled = this.widget.disabled, this.galleryOpened = this.widget.galleryOpened, this.icon = this.widget.icon, this.imageEnhancementToolActive = this.widget.imageEnhancementToolActive, this.imageGalleryEnabled = this.widget.imageGalleryEnabled, this.imageOverlaysOpened = this.widget.imageOverlaysOpened, this.isAdditionalCoverageVisible = this.widget.isAdditionalCoverageVisible, this.isAdditionalPointSourcesVisible = this.widget.isAdditionalPointSourcesVisible, this.label = this.widget.label, this.layer = this.widget.layer, this.mapImageConversionToolState = this.widget.mapImageConversionToolState, this.navigationToolActive = this.widget.navigationToolActive, this.referencePoint = this.widget.referencePoint, this.arcgisPropertyChange = t()("imageGalleryEnabled", "layer"), this.arcgisReady = s();
   }
   static {
-    this.properties = { view: 0, autoDestroyDisabled: 5, currentCoverageVisible: 5, dataCaptureEnabled: 5, disabled: 5, galleryOpened: 5, icon: 1, imageEnhancementToolActive: 5, imageGalleryEnabled: 4, imageOverlaysOpened: 5, isAdditionalCoverageVisible: 5, isAdditionalPointSourcesVisible: 5, label: 1, layer: 0, mapImageConversionToolState: 5, navigationToolActive: 5, orientedImageryLayerItemId: 1, position: 1, referenceElement: 1, referencePoint: 0 };
+    this.properties = { view: 0, autoDestroyDisabled: 5, currentCoverageVisible: 5, dataCaptureEnabled: 5, disabled: 5, galleryOpened: 5, icon: 1, imageEnhancementToolActive: 5, imageGalleryEnabled: 5, imageOverlaysOpened: 5, isAdditionalCoverageVisible: 5, isAdditionalPointSourcesVisible: 5, label: 1, layer: 0, mapImageConversionToolState: 5, navigationToolActive: 5, orientedImageryLayerItemId: 1, position: 1, referenceElement: 1, referencePoint: 0 };
   }
   static {
     this.styles = [c, g];

package/dist/components/arcgis-placement/customElement.js

@@ -5,7 +5,7 @@ import { a as i } from "../../chunks/component-utils.js";
 import { u as a } from "../../chunks/useView.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/5.0/esri/copyright.txt for details.
-v5.0.0-next.75 */
+v5.0.0-next.77 */
 const m = e`:host{pointer-events:auto}`;
 class c extends r {
   constructor() {