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

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

@@ -1,23 +1,33 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
-import { c as s } from "../../chunks/runtime.js";
-import { css as a, html as r } from "lit";
-import c from "@arcgis/core/widgets/Compass/CompassViewModel.js";
-import { LitElement as l, createEvent as n, safeClassMap as h, nothing as i, safeStyleMap as d } from "@arcgis/lumina";
-import { usePropertyChange as v } from "@arcgis/lumina/controllers";
+import { c as r } from "../../chunks/runtime.js";
+import { getGoToDuration as n } from "@arcgis/core/applications/Components/navigationDuration.js";
+import { watch as e } from "@arcgis/core/core/reactiveUtils.js";
+import { LitElement as c, createEvent as l, nothing as o, safeClassMap as h, safeStyleMap as d } from "@arcgis/lumina";
+import { usePropertyChange as u } from "@arcgis/lumina/controllers";
 import { classes as m } from "@arcgis/toolkit/dom";
-import { u as g } from "../../chunks/useT9n.js";
-import { m as u } from "../../chunks/useViewModel.js";
-import { g as p } from "../../chunks/globalCss.js";
-const f = a`.arcgis-button{--calcite-icon-color: var(--calcite-color-text-3);--calcite-button-background-color: var(--calcite-color-foreground-1);color:var(--calcite-color-text-3);line-height:var(--calcite-font-line-height-relative-tight);display:flex;flex-flow:column;cursor:pointer;background-color:var(--calcite-color-foreground-1);font-size:var(--calcite-font-size);:hover{--calcite-icon-color: var(--calcite-color-text-1);--calcite-button-background-color: var(--calcite-color-transparent-hover)}}:host{calcite-button{width:var(--calcite-spacing-xxxl);height:var(--calcite-spacing-xxxl)}}:host([visual-scale="l"]){calcite-button{width:calc(var(--calcite-spacing-xxxl) + var(--calcite-spacing-md));height:calc(var(--calcite-spacing-xxxl) + var(--calcite-spacing-md))}}:host([visual-scale="s"]){calcite-button{width:var(--calcite-spacing-xxl);height:var(--calcite-spacing-xxl)}}.root{border-radius:50%;box-shadow:var(--arcgis-internal-box-shadow, none)}.icon-container{justify-content:center;display:flex;position:absolute;transform:translate(-50%,-50%)}.icon-container:dir(rtl){transform:translate(50%,-50%)}`, x = u(c);
-class b extends l {
+import { css as g, html as p } from "lit";
+import { u as v } from "../../chunks/useT9n.js";
+import { u as f } from "../../chunks/useView.js";
+import { g as w } from "../../chunks/globalCss.js";
+import { c as y } from "../../chunks/utils.js";
+import { c as s } from "../../chunks/goTo.js";
+const b = g`.arcgis-button{--calcite-icon-color: var(--calcite-color-text-3);--calcite-button-background-color: var(--calcite-color-foreground-1);color:var(--calcite-color-text-3);line-height:var(--calcite-font-line-height-relative-tight);calcite-button{--calcite-offset-invert-focus: 1}display:flex;flex-flow:column;cursor:pointer;background-color:var(--calcite-color-foreground-1);font-size:var(--calcite-font-size);:hover{--calcite-icon-color: var(--calcite-color-text-1);--calcite-button-background-color: var(--calcite-color-transparent-hover)}}:host{calcite-button{width:var(--calcite-spacing-xxxl);height:var(--calcite-spacing-xxxl)}}:host([visual-scale="l"]){calcite-button{width:calc(var(--calcite-spacing-xxxl) + var(--calcite-spacing-md));height:calc(var(--calcite-spacing-xxxl) + var(--calcite-spacing-md))}}:host([visual-scale="s"]){calcite-button{width:var(--calcite-spacing-xxl);height:var(--calcite-spacing-xxl)}}.root{border-radius:50%;box-shadow:var(--arcgis-internal-box-shadow, none)}.icon-container{justify-content:center;display:flex;position:absolute;transform:translate(-50%,-50%)}.icon-container:dir(rtl){transform:translate(50%,-50%)}`;
+class x extends c {
   constructor() {
-    super(...arguments), this.messages = g(), this.viewModel = x(this), this.view = this.viewModel.view, this.autoDestroyDisabled = !1, this.goToOverride = this.viewModel.goToOverride, this.orientation = this.viewModel.orientation, this.state = this.viewModel.state, this.visualScale = "m", this.arcgisPropertyChange = v()("state", "orientation"), this.arcgisReady = n();
+    super(...arguments), this._hasInitializedOrientation = !1, this._hasInitializedState = !1, this._lastState = "disabled", this.messages = v(), this._orientation = {
+      x: 0,
+      y: 0,
+      z: 0
+    }, this.view = f(this), this.autoDestroyDisabled = !1, this.visualScale = "m", this.arcgisPropertyChange = u()("state", "orientation"), this.arcgisReady = l();
   }
   static {
-    this.properties = { view: 0, autoDestroyDisabled: 5, goToOverride: 0, icon: 3, label: 1, messageOverrides: 0, orientation: 32, referenceElement: 1, state: 32, visualScale: 3 };
+    this.properties = { _orientation: 16, view: 0, autoDestroyDisabled: 5, canShowNorth: 32, goToOverride: 0, icon: 3, label: 1, messageOverrides: 0, orientation: 32, referenceElement: 1, state: 32, visualScale: 3 };
   }
   static {
-    this.styles = f;
+    this.styles = b;
+  }
+  get canShowNorth() {
+    return y(this.view);
   }
   get icon() {
     return this._icon ?? (this.state === "rotation" ? "arrow-up" : "compass-needle");
@@ -25,24 +35,68 @@ class b extends l {
   set icon(t) {
     this._icon = t;
   }
+  get orientation() {
+    return this._orientation;
+  }
+  get state() {
+    return !this.view?.ready || this.view.type === "2d" && !this.view.constraints.rotationEnabled ? "disabled" : this.canShowNorth ? "compass" : "rotation";
+  }
   async destroy() {
     await this.manager.destroy();
   }
   async reset() {
-    this.viewModel.reset();
+    const { view: t } = this;
+    t?.ready && (t?.type === "2d" ? s({
+      target: { rotation: 0 },
+      options: { animationMode: "always", duration: n() }
+    }, t, this.goToOverride) : s({ target: { heading: 0 } }, t, this.goToOverride));
+  }
+  updated(t) {
+    t.has("_orientation") && (this._hasInitializedOrientation ? this.arcgisPropertyChange.emit({ name: "orientation" }) : this._hasInitializedOrientation = !0);
+    const i = this.state;
+    this._hasInitializedState ? i !== this._lastState && this.arcgisPropertyChange.emit({ name: "state" }) : this._hasInitializedState = !0, this._lastState = i;
+  }
+  loaded() {
+    if (!this.view) {
+      this.manager.onLifecycle(() => [
+        e(() => this.view?.ready, () => {
+          this._watchRotationOrCamera();
+        }, { once: !0 })
+      ]);
+      return;
+    }
+    this._watchRotationOrCamera();
+  }
+  _watchRotationOrCamera() {
+    if (!this.view)
+      return;
+    const t = [];
+    this.view.type === "2d" ? t.push(e(() => this.view?.rotation, (i) => this._updateForRotation(i), { initial: !0 })) : t.push(e(() => this.view?.camera, (i) => this._updateForCamera(i), { initial: !0 })), this.manager.onLifecycle(() => t);
+  }
+  _updateForRotation(t) {
+    t != null && (this._orientation = {
+      z: t
+    });
   }
-  _reset() {
-    this.viewModel.reset();
+  _updateForCamera(t) {
+    if (!t)
+      return;
+    const i = -t.heading;
+    this._orientation = {
+      x: 0,
+      y: 0,
+      z: i
+    };
   }
   render() {
-    const { messages: t, icon: o } = this;
-    return r`<div class=${h(m("root", p.arcgisButton))}><calcite-button .disabled=${this.state === "disabled"} kind=neutral .label=${t.reset} @click=${this._reset} round .scale=${this.visualScale} title=${t.reset ?? i}><div aria-hidden=true class="icon-container" title=${t.reset ?? i}><calcite-icon .scale=${this.visualScale} .icon=${o} style=${d(w(this.orientation))}></calcite-icon></div></calcite-button></div>`;
+    const { messages: t, icon: i } = this;
+    return p`<div class=${h(m("root", w.arcgisButton))}><calcite-button .disabled=${this.state === "disabled"} kind=neutral .label=${t.reset} @click=${this.reset} round .scale=${this.visualScale} title=${t.reset ?? o}><div aria-hidden=true class="icon-container" title=${t.reset ?? o}><calcite-icon .scale=${this.visualScale} .icon=${i} style=${d(_(this.orientation))}></calcite-icon></div></calcite-button></div>`;
   }
 }
-const w = (e) => ({
-  transform: `rotateZ(${e.z}deg)`
+const _ = (a) => ({
+  transform: `rotateZ(${a.z}deg)`
 });
-s("arcgis-compass", b);
+r("arcgis-compass", x);
 export {
-  b as ArcgisCompass
+  x as ArcgisCompass
 };

package/dist/components/arcgis-coordinate-conversion/customElement.d.ts

@@ -1,14 +1,15 @@
 /// <reference path="../../index.d.ts" />
+import type Collection from "@arcgis/core/core/Collection.js";
 import type Point from "@arcgis/core/geometry/Point.js";
 import type Conversion from "@arcgis/core/widgets/CoordinateConversion/support/Conversion.js";
 import type Format from "@arcgis/core/widgets/CoordinateConversion/support/Format.js";
-import type Collection2 from "@arcgis/core/core/Collection.js";
 import type PictureMarkerSymbol from "@arcgis/core/symbols/PictureMarkerSymbol.js";
 import type SimpleMarkerSymbol from "@arcgis/core/symbols/SimpleMarkerSymbol.js";
 import type CIMSymbol from "@arcgis/core/symbols/CIMSymbol.js";
 import type PointSymbol3D from "@arcgis/core/symbols/PointSymbol3D.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 import type { ArcgisReferenceElement, IconName, HeadingLevel } from "../types.js";
+import type { LengthUnit } from "@arcgis/core/core/units.js";
 import type { Orientation, StorageType } from "./types.js";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
 import type { MapViewOrSceneView } from "@arcgis/core/views/MapViewOrSceneView.js";
@@ -64,7 +65,7 @@ export abstract class ArcgisCoordinateConversion extends LitElement {
    * ```
    * @since 4.7
    */
-  accessor conversions: Collection2<Conversion>;
+  accessor conversions: Collection<Conversion>;
   /**
    * Describes the location of the coordinates currently displayed by the component as a [Point](https://developers.arcgis.com/javascript/latest/references/core/geometry/Point/).
    * Setting this property will update all conversions.
@@ -80,12 +81,8 @@ export abstract class ArcgisCoordinateConversion extends LitElement {
   /**
    * Describes whether the component is expanded or not. If `true`, the component is expanded and all conversions are visible.
    *
+   * @deprecated since 5.1, the component no longer has expand/collapse functionality
    * @default false
-   * @example
-   * Expand the component.
-   * ```js
-   * coordinateConversionComponent.expanded = true;
-   * ```
    */
   accessor expanded: boolean;
   /**
@@ -109,7 +106,7 @@ export abstract class ArcgisCoordinateConversion extends LitElement {
    * coordinateConversionComponent.formats.removeMany(toRemove);
    * ```
    */
-  accessor formats: Collection2<Format>;
+  accessor formats: Collection<Format>;
   /**
    * This function provides the ability to override either the [arcgis-map.goTo()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#goTo) or [arcgis-scene.goTo()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#goTo) methods.
    *
@@ -137,42 +134,52 @@ export abstract class ArcgisCoordinateConversion extends LitElement {
   /**
    * Determines whether the capture button will be shown in the component. If `true`, the capture button will be hidden.
    *
+   * @deprecated since 5.1, use `hideCaptureSection` instead
    * @default false
-   * @example
-   * Hide the capture button.
-   * ```html
-   * <arcgis-map item-id="45b3b2fb35e94ab09381d0caa0da5946">
-   *   <arcgis-coordinate-conversion hide-capture-button slot="bottom-left"></arcgis-coordinate-conversion>
-   * </arcgis-map>
-   * ```
    */
   accessor hideCaptureButton: boolean;
   /**
-   * Determines whether the expand button will be shown in the component. If `true`, the expand button will be hidden.
+   * Determines whether the capture section will be shown in the component. If `true`, the capture section will be hidden.
    *
    * @default false
+   * @since 5.1
    * @example
-   * Hide the expand button.
+   * Hide the capture section.
    * ```html
    * <arcgis-map item-id="45b3b2fb35e94ab09381d0caa0da5946">
-   *   <arcgis-coordinate-conversion hide-expand-button slot="bottom-left"></arcgis-coordinate-conversion>
+   *   <arcgis-coordinate-conversion hide-capture-section slot="bottom-left"></arcgis-coordinate-conversion>
    * </arcgis-map>
    * ```
    */
+  accessor hideCaptureSection: boolean;
+  /**
+   * Determines whether the expand button will be shown in the component. If `true`, the expand button will be hidden.
+   *
+   * @deprecated since 5.1, the component no longer has expand/collapse functionality
+   * @default false
+   */
   accessor hideExpandButton: boolean;
   /**
    * Determines whether the input coordinate button will be shown in the component. If `true`, the input button will be hidden.
    *
+   * @deprecated since 5.1, use `hideInputSection` instead
+   * @default false
+   */
+  accessor hideInputButton: boolean;
+  /**
+   * Determines whether the input section will be shown in the component. If `true`, the input section will be hidden.
+   *
    * @default false
+   * @since 5.1
    * @example
-   * Hide the input button.
+   * Hide the input section.
    * ```html
    * <arcgis-map item-id="45b3b2fb35e94ab09381d0caa0da5946">
-   *   <arcgis-coordinate-conversion hide-input-button slot="bottom-left"></arcgis-coordinate-conversion>
+   *   <arcgis-coordinate-conversion hide-input-section slot="bottom-left"></arcgis-coordinate-conversion>
    * </arcgis-map>
    * ```
    */
-  accessor hideInputButton: boolean;
+  accessor hideInputSection: boolean;
   /**
    * Determines whether the settings button will be shown in the component. If `true`, the settings button will be hidden.
    *
@@ -194,12 +201,21 @@ export abstract class ArcgisCoordinateConversion extends LitElement {
    * @default "coordinate-system"
    */
   accessor icon: IconName;
+  /**
+   * If false, the component will estimate coordinate precision based on the current state of the
+   * view. As the view is zoomed farther out, fewer decimal places will be shown. Only affects `DD`,
+   * `DDM`, `DMS`, and `XY` formats.
+   *
+   * @default false
+   * @since 5.1
+   */
+  accessor ignoreCoordinatePrecision: boolean;
   /**
    * The component's default label.
    *
    * @default "Coordinate conversion"
    */
-  accessor label: string | undefined;
+  accessor label: string;
   /**
    * This symbol is used to visualize the location currently described by the component when `capture` mode
    * is active.
@@ -215,7 +231,7 @@ export abstract class ArcgisCoordinateConversion extends LitElement {
    */
   accessor locationSymbol: PictureMarkerSymbol | SimpleMarkerSymbol | CIMSymbol | PointSymbol3D;
   /** @internal */
-  protected messages: Partial<{
+  protected messages: {
       componentLabel: string;
       abbreviatedDirections: {
           north: string;
@@ -225,28 +241,45 @@ export abstract class ArcgisCoordinateConversion extends LitElement {
       };
       addConversion: string;
       alertLabel: string;
-      back: string;
       captureMode: string;
-      changeCoordinateDisplay: string;
-      collapse: string;
+      display: string;
       convert: string;
-      conversionOutput: string;
-      copy: string;
+      convertAndGoTo: string;
+      coordinates: string;
+      copyLabel: string;
+      copyElevationLabel: string;
       copySuccessMessage: string;
       defaultPattern: string;
-      expand: string;
-      goTo: string;
+      done: string;
+      elevation: string;
+      selectElevationUnit: string;
+      format: string;
+      formatDescriptions: {
+          dd: string;
+          dms: string;
+          ddm: string;
+          mgrs: string;
+          usng: string;
+          utm: string;
+          xy: string;
+          basemap: string;
+          custom: string;
+      };
+      input: string;
       inputCoordTitle: string;
+      inputFormat: string;
       invalidCoordinate: string;
       liveMode: string;
       locationOffBasemap: string;
       noBasemap: string;
+      noDisplayProperties: string;
+      noElevation: string;
       noLocation: string;
       preview: string;
-      removeConversion: string;
       selectFormat: string;
-      settingsTitle: string;
-  }> & T9nMeta<{
+      selectFormats: string;
+      settingsTitleWithFormat: string;
+  } & T9nMeta<{
       componentLabel: string;
       abbreviatedDirections: {
           north: string;
@@ -256,27 +289,44 @@ export abstract class ArcgisCoordinateConversion extends LitElement {
       };
       addConversion: string;
       alertLabel: string;
-      back: string;
       captureMode: string;
-      changeCoordinateDisplay: string;
-      collapse: string;
+      display: string;
       convert: string;
-      conversionOutput: string;
-      copy: string;
+      convertAndGoTo: string;
+      coordinates: string;
+      copyLabel: string;
+      copyElevationLabel: string;
       copySuccessMessage: string;
       defaultPattern: string;
-      expand: string;
-      goTo: string;
+      done: string;
+      elevation: string;
+      selectElevationUnit: string;
+      format: string;
+      formatDescriptions: {
+          dd: string;
+          dms: string;
+          ddm: string;
+          mgrs: string;
+          usng: string;
+          utm: string;
+          xy: string;
+          basemap: string;
+          custom: string;
+      };
+      input: string;
       inputCoordTitle: string;
+      inputFormat: string;
       invalidCoordinate: string;
       liveMode: string;
       locationOffBasemap: string;
       noBasemap: string;
+      noDisplayProperties: string;
+      noElevation: string;
       noLocation: string;
       preview: string;
-      removeConversion: string;
       selectFormat: string;
-      settingsTitle: string;
+      selectFormats: string;
+      settingsTitleWithFormat: string;
   }>;
   /**
    * Describes the current mode of the component.
@@ -284,13 +334,15 @@ export abstract class ArcgisCoordinateConversion extends LitElement {
    * * While in `live` mode, the component will update as the cursor moves.
    * * While in `capture` mode, the component will update on mouse click and display a graphic
    * marking the current location.
+   * * While in `idle` mode, the component will not update based on cursor movement or mouse clicks.
+   * This mode can be used to "pause" the component without losing the current location.
    *
    * @default "live"
    * @example
-   * Programmatically set the component to capture mode.
+   * Programmatically set the component to idle mode.
    * ```js
    * const coordinateConversionComponent = document.getElementsByTagName("arcgis-coordinate-conversion")[0];
-   * coordinateConversionComponent.mode = "capture";
+   * coordinateConversionComponent.mode = "idle";
    * ```
    */
   accessor mode: Mode;
@@ -304,6 +356,7 @@ export abstract class ArcgisCoordinateConversion extends LitElement {
    * Determines whether the component should expand up or down.  If set to `auto`,
    * the component will be oriented based on its position in the view.
    *
+   * @deprecated 5.1, the component no longer has an orientation
    * @default "auto"
    */
   accessor orientation: Orientation;
@@ -313,6 +366,22 @@ export abstract class ArcgisCoordinateConversion extends LitElement {
    * @see [Associate components with a Map or Scene component](https://developers.arcgis.com/javascript/latest/programming-patterns/#associate-components-with-a-map-or-scene-component)
    */
   accessor referenceElement: ArcgisReferenceElement | string | undefined;
+  /**
+   * Determines whether leading zeros will be shown in `DD`, `DDM`, and `DMS` formats.
+   * When false: 01.37°N, 008.71°E
+   * When true: 1.37°N, 8.71°E
+   *
+   * @default false
+   * @since 5.1
+   */
+  accessor removeLeadingZeros: boolean;
+  /**
+   * Determines whether the elevation of the current location will be shown. Only applicable when the view is a SceneView.
+   *
+   * @default false
+   * @since 5.1
+   */
+  accessor showElevation: boolean;
   /**
    * The current state of the component.
    *
@@ -335,6 +404,14 @@ export abstract class ArcgisCoordinateConversion extends LitElement {
    * @since 4.23
    */
   accessor storageType: StorageType;
+  /**
+   * Indicates the vertical unit to use when displaying elevation.
+   *
+   * @default "meters"
+   * @since 5.1
+   * @see [LengthUnit](https://developers.arcgis.com/javascript/latest/references/core/core/units/#LengthUnit)
+   */
+  accessor verticalUnit: LengthUnit;
   /**
    * 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-coordinate-conversion component will be associated with a map or scene component rather than using the `view` property.
@@ -345,7 +422,7 @@ export abstract class ArcgisCoordinateConversion extends LitElement {
   /**
    * Attempt to convert a string into a [point](https://developers.arcgis.com/javascript/latest/references/core/geometry/Point/).  The format of the
    * string must be specified.  A [collection](https://developers.arcgis.com/javascript/latest/references/core/core/Collection/) of available formats can be
-   * obtained from the [formats](#formats) property.
+   * obtained from the [formats](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-coordinate-conversion/#formats) property.
    *
    * @param coordinate - The coordinate string.
    * @param format - Specifies the format of the input coordinate.
@@ -359,7 +436,7 @@ export abstract class ArcgisCoordinateConversion extends LitElement {
    */
   readonly arcgisConversionChange: import("@arcgis/lumina").TargetedEvent<this, 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: "currentLocation" | "state" | "expanded" | "mode"; }>;
+  readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "currentLocation" | "state" | "mode" | "verticalUnit"; }>;
   /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
   readonly arcgisReady: import("@arcgis/lumina").TargetedEvent<this, void>;
   readonly "@eventTypes": {