@arcgis/map-components 4.33.0-next.99 → 4.34.0-next.1

package/dist/components/arcgis-time-zone-label/customElement.js

@@ -1,16 +1,16 @@
 import { c as h } from "../../chunks/runtime.js";
 import { html as s } from "lit-html";
 import { useDirection as p, usePropertyChange as _ } from "@arcgis/lumina/controllers";
-import { classes as c } from "@arcgis/components-utils";
-import { LitElement as g, createEvent as u, noShadowRoot as v, nothing as d, safeClassMap as n } from "@arcgis/lumina";
+import { classes as d } from "@arcgis/components-utils";
+import { LitElement as g, createEvent as u, noShadowRoot as v, nothing as c, safeClassMap as n } from "@arcgis/lumina";
 import { u as x } from "../../chunks/useT9n.js";
 import { g as m } from "../../chunks/globalCss.js";
 import { css as f } from "@lit/reactive-element/css-tag.js";
 import { u as $ } from "../../chunks/useView.js";
 import { when as y, watch as z } from "@arcgis/core/core/reactiveUtils.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
-See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.99 */
+See https://js.arcgis.com/4.34/esri/copyright.txt for details.
+v4.34.0-next.1 */
 const D = f`@layer{.arcgis-time-zone-label{display:inline-flex;background-color:var(--calcite-color-foreground-1)}.arcgis-time-zone-label__badge{display:flex;padding-block:var(--calcite-spacing-sm);padding-inline:var(--calcite-spacing-sm);color:var(--calcite-color-text-1)}.arcgis-time-zone-label__badge--disabled{opacity:var(--calcite-opacity-disabled)}.arcgis-time-zone-label__badge--hidden{display:none}.arcgis-time-zone-label__badge-icon{align-self:center}.arcgis-time-zone-label__name{--calcite-color-background: transparent;--calcite-color-border-input: transparent;--calcite-font-weight-medium: normal;pointer-events:none}.arcgis-time-zone-label__name--hidden{display:none}.arcgis-time-zone-label__label{--calcite-label-margin-bottom: 0;align-items:center;padding-inline:var(--calcite-spacing-sm)}.arcgis-time-zone-label__label--disabled{opacity:var(--calcite-opacity-disabled)}.arcgis-time-zone-label__label--hidden{display:none}}`, t = "esri-time-zone-label", i = {
   base: t,
   badge: `${t}__badge`,
@@ -28,10 +28,10 @@ class w extends g {
   constructor() {
     super(...arguments), this._messages = x({ blocking: !0 }), this._onExpanderClick = () => {
       this.expanded = !this.expanded;
-    }, this.view = $(this), this._direction = p(), this._expandDirection = null, this._timeZone = null, this.state = "disabled", this.position = "top-left", this.disabled = !1, this.expanded = !1, this.icon = "time-zone", this.arcgisPropertyChange = _()("state"), this.arcgisReady = u();
+    }, this.view = $(this), this._direction = p(), this.state = "disabled", this.position = "top-left", this.disabled = !1, this.expanded = !1, this.arcgisPropertyChange = _()("state"), this.arcgisReady = u();
   }
   static {
-    this.properties = { _interactive: 16, _direction: 16, _expandDirection: 16, _timeZone: 16, state: 3, referenceElement: 1, position: 3, disabled: 7, expandDirection: 3, expanded: 7, icon: 3, messageOverrides: 0, label: 1 };
+    this.properties = { _interactive: 16, _direction: 16, _expandDirection: 16, _timeZone: 16, state: 3, referenceElement: 1, position: 3, disabled: 7, expandDirection: 3, expanded: 7, messageOverrides: 0, label: 1 };
   }
   static {
     this.styles = D;
@@ -39,28 +39,15 @@ class w extends g {
   static {
     this.shadowRootOptions = v;
   }
-  //#endregion
-  //#region State Properties
-  /** Convenience property to determine if the component is interactive. */
   get _interactive() {
     return !(this.disabled || this.state === "disabled");
   }
-  /**
-   * The direction the component will expand.
-   *
-   * By default, the component will expand inward if assigned to a View UI corner. If the component is positioned manually,
-   * the component will expand towards the "end" which is equivalent to right in a LTR application.
-   */
   get expandDirection() {
     return this._expandDirection ?? this._computeExpandDirection();
   }
   set expandDirection(e) {
     this._expandDirection = e;
   }
-  //#endregion
-  //#region Lifecycle
-  // The following method is a temporary fix for a reactive issue.
-  // When corrected, remove this method and add a getter for `state` instead.
   loaded() {
     this.state = this.view?.ready ? "ready" : "disabled", this.manager.onLifecycle(() => [
       y(() => this.view?.ready, (e) => {
@@ -71,8 +58,6 @@ class w extends g {
       })
     ]);
   }
-  //#endregion
-  //#region Private Methods
   _computeExpandDirection() {
     if (!this.referenceElement)
       return "end";
@@ -95,21 +80,19 @@ class w extends g {
     const { expanded: e, expandDirection: a } = this;
     return e ? this._direction === "rtl" ? a === "start" ? "chevrons-left" : "chevrons-right" : a === "start" ? "chevrons-right" : "chevrons-left" : "time-zone";
   }
-  //#endregion
-  //#region Rendering
   render() {
-    const e = c(i.base, m.widget, !this._interactive && m.disabled), a = this._renderExpander(), o = this._renderName(), r = this._renderBadge(), l = [a, o, r];
-    return this.expandDirection === "start" && l.reverse(), s`<div aria-label=${this.label ?? d} class=${n(e)}>${l}</div>`;
+    const e = d(i.base, m.widget, !this._interactive && m.disabled), a = this._renderExpander(), r = this._renderName(), o = this._renderBadge(), l = [a, r, o];
+    return this.expandDirection === "start" && l.reverse(), s`<div aria-label=${this.label ?? c} class=${n(e)}>${l}</div>`;
   }
   _renderExpander() {
     const e = this._getIcon();
-    return s`<calcite-action class=${n(i.expander)} .disabled=${!this._interactive} .icon=${e} @click=${this._onExpanderClick} scale=s .text=${this.label ?? ""} title=${this.label ?? "" ?? d}></calcite-action>`;
+    return s`<calcite-action class=${n(i.expander)} .disabled=${!this._interactive} .icon=${e} @click=${this._onExpanderClick} scale=s .text=${this.label ?? ""} title=${this.label ?? "" ?? c}></calcite-action>`;
   }
   _renderBadge() {
-    return s`<div class=${n(c(i.badge, !this.expanded && i.badgeHidden, !this._interactive && i.badgeDisabled))}><calcite-icon class=${n(i.badgeIcon)} icon=time-zone scale=s></calcite-icon></div>`;
+    return s`<div class=${n(d(i.badge, !this.expanded && i.badgeHidden, !this._interactive && i.badgeDisabled))}><calcite-icon class=${n(i.badgeIcon)} icon=time-zone scale=s></calcite-icon></div>`;
   }
   _renderName() {
-    const e = "system", a = "unknown", o = this._timeZone === e || this._timeZone == null ? Intl.DateTimeFormat().resolvedOptions().timeZone : this._timeZone, r = this._timeZone === a, l = s`<calcite-label class=${n(c(i.label, (!this.expanded || !r) && i.labelHidden, !this._interactive && i.labelDisabled))}>${this._messages.noAdjustment}</calcite-label>`, b = s`<calcite-input-time-zone class=${n(c(i.name, (!this.expanded || !o || r) && i.nameHidden))} .disabled=${!this._interactive} mode=region read-only .value=${o}></calcite-input-time-zone>`;
+    const e = "system", a = "unknown", r = this._timeZone === e || this._timeZone == null ? Intl.DateTimeFormat().resolvedOptions().timeZone : this._timeZone, o = this._timeZone === a, l = s`<calcite-label class=${n(d(i.label, (!this.expanded || !o) && i.labelHidden, !this._interactive && i.labelDisabled))}>${this._messages.noAdjustment}</calcite-label>`, b = s`<calcite-input-time-zone class=${n(d(i.name, (!this.expanded || !r || o) && i.nameHidden))} .disabled=${!this._interactive} mode=region read-only .value=${r}></calcite-input-time-zone>`;
     return [l, b];
   }
 }

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

@@ -1,64 +1,136 @@
 /// <reference types="@arcgis/core/interfaces.d.ts" />
 /// <reference types="../../index.d.ts" />
 import { Use } from '@arcgis/lumina/controllers';
-import { Nil } from '@arcgis/components-utils';
 import { default as TrackViewModel } from '@arcgis/core/widgets/Track/TrackViewModel.js';
 import { JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { ArcgisReferenceElement } from '../../utils/component-utils';
 
-declare const useTrackViewModel: (component: LitElement & Pick<TrackViewModel, never> & import('../../controllers/useViewModel').ViewModelControllerUses<TrackViewModel>, options?: {
-    editConstructorProperties(props: unknown): unknown;
-} | undefined) => TrackViewModel;
+declare const useTrackViewModel: (component: LitElement & Pick<TrackViewModel, never> & import('../../controllers/useViewModel').ViewModelControllerUses<TrackViewModel>) => TrackViewModel;
 /**
- * Track component is a button that animates the map or scene to the user's location when clicked.
+ * The Track component is a button that animates the map or scene to the user's location when clicked.
  * The view rotates based on device heading.
  * The default heading symbol will display when speed is greater than zero and the browser provides heading information.
  *
  * **Known Limitations**
  *
- * - The heading symbol is not currently supported within an `arcgis-scene` component.
+ * - The heading symbol is not currently supported within a Scene component.
+ *
+ * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-track/)
  */
 export declare class ArcgisTrack extends LitElement {
     /**
-     * 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 component to a different place on the page, or
-     * temporary hide it. If this is set, make sure to call the
-     * \`destroy\` method when you are done to prevent memory leaks.
+     * 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
+     * component to a different place on the page, or temporarily hide it. If this
+     * is set, make sure to call the [destroy](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-track/#destroy) method when you are done to
+     * prevent memory leaks.
+     *
+     * @default false
      */
     autoDestroyDisabled: boolean;
+    /**
+     * Error that caused the last [track-error](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Track-TrackViewModel.html#event:track-error) event to fire.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Track-TrackViewModel.html#error)
+     *
+     * @default null
+     */
     error: any;
+    /**
+     * An object used for setting optional position parameters.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Track-TrackViewModel.html#geolocationOptions)
+     *
+     * @default null
+     */
     geolocationOptions: any;
+    /**
+     * This function provides the ability to override either the
+     * [MapView goTo()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#goTo) or
+     * [SceneView goTo()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#goTo) methods.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Track-TrackViewModel.html#goToOverride)
+     */
     goToOverride: nullish | __esri.GoToOverride;
-    /** @default false */
+    /**
+     * Indicates whether to navigate the view to the position and scale of the geolocated result.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Track-TrackViewModel.html#goToLocationEnabled)
+     *
+     * @default false
+     */
     goToLocationDisabled: boolean;
+    /**
+     * The graphic used to show the user's location on the map.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Track-TrackViewModel.html#graphic)
+     */
     graphic: __esri.Graphic;
-    icon: Nil | string;
+    /** @default "compass-north-circle" */
+    icon?: string;
     /** The component's default label. */
-    label: Nil | string;
-    /** Replace localized message strings with your own strings. */
+    label?: string;
+    /** Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases. */
     messageOverrides?: typeof this.messages._overrides;
+    /** @default "top-left" */
     position: __esri.UIPosition;
+    /**
+     * A function that is used as an expression to evaluate geolocation points, and returns a boolean
+     * value.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Track-TrackViewModel.html#positionFilterFunction)
+     *
+     * @default null
+     */
     positionFilterFunction: Function | nullish;
-    referenceElement: ArcgisReferenceElement | Nil | string;
-    /** @default false */
+    referenceElement?: ArcgisReferenceElement | string;
+    /**
+     * Indicates whether the component will automatically rotate to the device heading based on
+     * the Geolocation APIs [`GeolocationCoordinates.heading`](https://developer.mozilla.org/en-US/docs/Web/API/GeolocationCoordinates/heading)
+     * property.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Track-TrackViewModel.html#rotationEnabled)
+     *
+     * @default false
+     */
     rotationDisabled: boolean;
+    /**
+     * Indicates the scale to set on the view when navigating to the position of the geolocated
+     * result, after a location is returned from the [track](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Track-TrackViewModel.html#event-track) event.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Track-TrackViewModel.html#scale)
+     *
+     * @default null
+     */
     scale: number | nullish;
     /**
-     * The current state of the component.
+     * The current state of the widget.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Track-TrackViewModel.html#state)
+     *
+     * @default "disabled"
      */
     readonly state: "ready" | "disabled" | "error" | "tracking" | "waiting" | "feature-unsupported";
+    /**
+     * Indicates whether new positions are being watched.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Track-TrackViewModel.html#tracking)
+     *
+     * @default false
+     */
     readonly tracking: boolean;
-    /** Permanently destroy the component */
+    /** Permanently destroy the component. */
     destroy(): Promise<void>;
     start(): Promise<void>;
     stop(): Promise<void>;
     readonly arcgisComplete: TargetedEvent<this, __esri.TrackViewModelTrackEvent>;
     readonly arcgisError: TargetedEvent<this, __esri.TrackViewModelTrackErrorEvent>;
+    /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
     readonly arcgisPropertyChange: TargetedEvent<this, {
         name: "state";
     }>;
-    readonly arcgisReady: TargetedEvent<this, undefined>;
+    /** Emitted when the component associated with a map or scene view is is ready to be interacted with. */
+    readonly arcgisReady: TargetedEvent<this, void>;
     private messages: Partial<{
         componentLabel: string;
         startTracking: string;

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

@@ -10,8 +10,8 @@ import { m as b } from "../../chunks/useViewModel.js";
 import { g as c } from "../../chunks/globalCss.js";
 import { css as T } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
-See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.99 */
+See https://js.arcgis.com/4.34/esri/copyright.txt for details.
+v4.34.0-next.1 */
 const y = T`@layer{arcgis-track{display:block}}`, $ = {
   base: "esri-track"
 }, D = b(v);
@@ -20,7 +20,7 @@ class O extends w {
     super(...arguments), this.messages = E(), this.viewModel = D(this), this.autoDestroyDisabled = !1, this.error = this.viewModel.error, this.geolocationOptions = this.viewModel.geolocationOptions, this.goToOverride = this.viewModel.goToOverride, this.goToLocationDisabled = this.viewModel.goToLocationEnabled, this.graphic = this.viewModel.graphic, this.icon = "compass-north-circle", this.position = "top-left", this.positionFilterFunction = this.viewModel.positionFilterFunction, this.rotationDisabled = this.viewModel.rotationEnabled, this.scale = this.viewModel.scale, this.state = this.viewModel.state, this.tracking = this.viewModel.tracking, this.arcgisComplete = a(() => this.viewModel, "track"), this.arcgisError = a(() => this.viewModel, "track-error"), this.arcgisPropertyChange = m()("state"), this.arcgisReady = f();
   }
   static {
-    this.properties = { autoDestroyDisabled: 5, error: 1, geolocationOptions: 1, goToOverride: 0, goToLocationDisabled: 7, graphic: 0, icon: 3, label: 1, messageOverrides: 0, position: 3, positionFilterFunction: 0, referenceElement: 1, rotationDisabled: 5, scale: 9, state: 0, tracking: 4 };
+    this.properties = { autoDestroyDisabled: 5, error: 1, geolocationOptions: 1, goToOverride: 0, goToLocationDisabled: 7, graphic: 0, icon: 1, label: 1, messageOverrides: 0, position: 3, positionFilterFunction: 0, referenceElement: 1, rotationDisabled: 5, scale: 9, state: 3, tracking: 4 };
   }
   static {
     this.shadowRootOptions = M;
@@ -28,9 +28,6 @@ class O extends w {
   static {
     this.styles = y;
   }
-  //#endregion
-  //#region Public Methods
-  /** Permanently destroy the component */
   async destroy() {
     await this.manager.destroy();
   }
@@ -40,8 +37,6 @@ class O extends w {
   async stop() {
     this.viewModel.stop();
   }
-  //#endregion
-  //#region Private Methods
   _localizeError(t) {
     if (t instanceof GeolocationPositionError)
       return t.code === GeolocationPositionError.PERMISSION_DENIED ? this.messages?.permissionError : t.code === GeolocationPositionError.TIMEOUT ? this.messages?.timeoutError : this.messages?.positionUnavailable;
@@ -60,8 +55,6 @@ class O extends w {
       this.viewModel.start();
     }
   }
-  //#endregion
-  //#region Rendering
   render() {
     const { viewModel: t, messages: o, icon: l } = this, i = t?.state, d = i === "tracking", s = this._localizeError(this.viewModel?.error), r = (d ? o?.stopTracking : o?.startTracking) ?? "", h = i === "feature-unsupported", g = (i === "tracking" ? "pause" : void 0) ?? l ?? void 0;
     return e`<div class=${n(u($.base, c.widget))}>${!h && e`<calcite-button class=${n(c.widgetButton)} .disabled=${i === "disabled"} .iconStart=${g} kind=neutral .label=${r} .loading=${i === "waiting"} @click=${this._toggleTracking} title=${r ?? k}></calcite-button>` || ""}${s ? e`<calcite-tooltip open overlay-positioning=fixed .referenceElement=${this.el}>${s}</calcite-tooltip>` : null}</div>`;

package/dist/components/arcgis-unit-select/customElement.d.ts

@@ -0,0 +1,26 @@
+/// <reference types="@arcgis/core/interfaces.d.ts" />
+/// <reference types="../../index.d.ts" />
+import { JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
+
+type SystemOrLengthUnit = __esri.LengthUnit | __esri.MeasurementSystem;
+type SystemOrAreaUnit = __esri.AreaUnit | __esri.MeasurementSystem;
+type UnitUnion = SystemOrAreaUnit | SystemOrLengthUnit;
+/**
+ * Component which displays a select component with a list of units or systems of units.
+ * Used by all the measurement components.
+ *
+ * @private
+ */
+export declare class ArcgisUnitSelect<Unit extends UnitUnion = UnitUnion> extends LitElement {
+    options: Unit[];
+    selectLabel: string;
+    value: Unit;
+    /** Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases. */
+    messageOverrides?: typeof this.messages._overrides;
+    label?: string;
+    /** Permanently destroy the component. */
+    destroy(): Promise<void>;
+    readonly arcgisUnitSelectChange: TargetedEvent<this, Unit>;
+    private messages;
+}
+export {};

package/dist/components/arcgis-unit-select/customElement.js

@@ -0,0 +1,39 @@
+import { c as n } from "../../chunks/runtime.js";
+import { repeat as m } from "lit-html/directives/repeat.js";
+import { html as c } from "lit-html";
+import { u as o } from "../../chunks/useT9n.js";
+import { LitElement as g, createEvent as u, safeClassMap as p } from "@arcgis/lumina";
+import { css as h } from "@lit/reactive-element/css-tag.js";
+/*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
+See https://js.arcgis.com/4.34/esri/copyright.txt for details.
+v4.34.0-next.1 */
+const b = h`.arcgis-unit-select{width:100%}.arcgis-unit-select__label{--calcite-label-margin-bottom: 0;width:100%}`, $ = "arcgis-unit-select", d = {
+  label: `${$}__label`
+};
+class f extends g {
+  constructor() {
+    super(...arguments), this.messages = o({}), this.options = [], this.arcgisUnitSelectChange = u();
+  }
+  static {
+    this.properties = { options: 0, selectLabel: 1, value: 0, messageOverrides: 0, label: 1 };
+  }
+  static {
+    this.styles = b;
+  }
+  async destroy() {
+    await this.manager.destroy();
+  }
+  render() {
+    const { messages: s, options: l, selectLabel: a, value: i, arcgisUnitSelectChange: r } = this;
+    return c`<calcite-label class=${p(d.label)}>${a}<calcite-select .label=${a} @calciteSelectChange=${(e) => {
+      r.emit(e.target.value);
+    }}>${m(l, (e) => e, (e) => c`<calcite-option .selected=${e === i} .value=${e}>${y(e) ? s.systems?.[e] : s.units?.[e]?.pluralCapitalized}</calcite-option>`)}</calcite-select></calcite-label>`;
+  }
+}
+function y(t) {
+  return t === "imperial" || t === "metric";
+}
+n("arcgis-unit-select", f);
+export {
+  f as ArcgisUnitSelect
+};

package/dist/components/arcgis-unit-select/index.d.ts

@@ -0,0 +1,4 @@
+import "@esri/calcite-components/components/calcite-label";
+import "@esri/calcite-components/components/calcite-select";
+import "@esri/calcite-components/components/calcite-option";
+export * from "./customElement.js";

package/dist/components/arcgis-unit-select/index.js

@@ -0,0 +1,4 @@
+import "@esri/calcite-components/components/calcite-label";
+import "@esri/calcite-components/components/calcite-select";
+import "@esri/calcite-components/components/calcite-option";
+export * from "./customElement.js";