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

package/dist/components/arcgis-time-slider/customElement.d.ts

@@ -1,14 +1,12 @@
 /// <reference path="../../index.d.ts" />
-import type WebMap from "@arcgis/core/WebMap";
+import type WebMap from "@arcgis/core/WebMap.js";
 import type Collection from "@arcgis/core/core/Collection.js";
 import type TimeExtent from "@arcgis/core/time/TimeExtent.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
-import type { ArcgisReferenceElement } from "../../utils/component-utils.js";
-import type { IconName } from "../../utils/action-utils.js";
-import type { TimeSliderViewModelTriggerActionEvent } from "@arcgis/core/widgets/TimeSlider/TimeSliderViewModel";
-import type { TimeSliderProperties } from "@arcgis/core/webdoc/widgets/TimeSlider";
+import type { ArcgisReferenceElement, IconName } from "../types.js";
+import type { TimeSliderViewModelTriggerActionEvent } from "@arcgis/core/widgets/TimeSlider/TimeSliderViewModel.js";
+import type { TimeSliderSettings, Action, TimeSliderMode, TimeSliderState, Stops } from "@arcgis/core/widgets/TimeSlider/types.js";
 import type { MapViewOrSceneView } from "@arcgis/core/views/MapViewOrSceneView.js";
-import type { Action, TimeSliderMode, TimeSliderState, Stops } from "@arcgis/core/widgets/TimeSlider/types.js";
 import type { Icon } from "@esri/calcite-components/components/calcite-icon";
 import type { TimeSliderLayout } from "@arcgis/core/widgets/TimeSlider.js";
 import type { TickConfig } from "@arcgis/core/widgets/Slider/types.js";
@@ -21,16 +19,16 @@ import type { TickConfig } from "@arcgis/core/widgets/Slider/types.js";
 export abstract class ArcgisTimeSlider extends LitElement {
   /**
    * Defines actions that will appear in a menu when the user clicks the ellipsis button
-   * ![timeSlider-actions-menu](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/timeslider/ellipsis.png) in the component. The
+   * ![timeSlider-actions-menu](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/timeslider/ellipsis.png) in the component. The
    * ellipsis button will not display if this property is `null` or if the collection is empty.
-   * Each [Action](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TimeSlider-types.html#Action) is defined with a unique id, a title,
+   * Each [Action](https://developers.arcgis.com/javascript/latest/references/core/widgets/TimeSlider/types/#Action) is defined with a unique id, a title,
    * and an icon.
    *
-   * The [@trigger-action](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TimeSlider.html#event-trigger-action) event fires each time an action in the menu is clicked. This event
-   * can be used to execute custom code such as setting the [timeExtent](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TimeSlider.html#timeExtent) to a specific date or copying the
+   * The [@trigger-action](https://developers.arcgis.com/javascript/latest/references/core/widgets/TimeSlider/#event-trigger-action) event fires each time an action in the menu is clicked. This event
+   * can be used to execute custom code such as setting the [timeExtent](https://developers.arcgis.com/javascript/latest/references/core/widgets/TimeSlider/#timeExtent) to a specific date or copying the
    * timeExtent to the browser's clipboard.
    *
-   * [![widgets-timeSlider-actions](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/timeslider/widgets-timeslider-actions.png)](https://developers.arcgis.com/javascript/latest/sample-code/sandbox/?sample=widgets-timeslider-offset)
+   * [![widgets-timeSlider-actions](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/timeslider/widgets-timeslider-actions.png)](https://developers.arcgis.com/javascript/latest/sample-code/sandbox/?sample=widgets-timeslider-offset)
    *
    * @since 4.21
    * @see [Sample - TimeSlider with offset](https://developers.arcgis.com/javascript/latest/sample-code/widgets-timeslider-offset/)
@@ -91,10 +89,9 @@ export abstract class ArcgisTimeSlider extends LitElement {
    */
   accessor autoDestroyDisabled: boolean;
   /**
-   * When `true`, sets the component to a disabled state so the user cannot interact with it.
+   * When true, the component is visually withdrawn and cannot receive user interaction.
    *
    * @default false
-   * @since 4.16
    * @example
    * // Create a timeslider widget that is initially disabled.
    * const timeSlider = new TimeSlider({
@@ -190,13 +187,13 @@ export abstract class ArcgisTimeSlider extends LitElement {
    *
    * Possible Values       | Description   | Example |
    * ----------------------|-------------- | ------- |
-   * instant               | The slider will show temporal data that falls on a single instance in time. Set the [timeExtent](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TimeSlider.html#timeExtent) property's `start` and `end` dates to same date: `{start: sameDate, end: sameDate}` | <img alt="mode-instance" src="https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/timeslider/mode-instance.png"> |
-   * time-window           | The slider will show temporal data that falls within a given time range. This is the default. Set [timeExtent](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TimeSlider.html#timeExtent) property's `start` and `date` properties to desired dates. | <img alt="mode-instance" src="https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/timeslider/mode-time-window.png"> |
-   * cumulative-from-start | Similar to `time-window` with the start time is always pinned to the start of the slider. Set the [timeExtent](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TimeSlider.html#timeExtent) property's `start` date to `null` and set `end` date to a desired date: `{start: null, end: date}` | <img alt="mode-instance" src="https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/timeslider/mode-from-start.png"> |
-   * cumulative-from-end   | Also, similar to the `time-window` with the end time pinned to the end of the slider. Set the [timeExtent](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TimeSlider.html#timeExtent) property's `start` date to a desired date and set `end` date to `null`: `{start: date, end: null}` | <img alt="mode-instance" src="https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/timeslider/mode-from-end.png"> |
+   * instant               | The slider will show temporal data that falls on a single instance in time. Set the [timeExtent](https://developers.arcgis.com/javascript/latest/references/core/widgets/TimeSlider/#timeExtent) property's `start` and `end` dates to same date: `{start: sameDate, end: sameDate}` | <img alt="mode-instance" src="https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/timeslider/mode-instance.png"> |
+   * time-window           | The slider will show temporal data that falls within a given time range. This is the default. Set [timeExtent](https://developers.arcgis.com/javascript/latest/references/core/widgets/TimeSlider/#timeExtent) property's `start` and `date` properties to desired dates. | <img alt="mode-instance" src="https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/timeslider/mode-time-window.png"> |
+   * cumulative-from-start | Similar to `time-window` with the start time is always pinned to the start of the slider. Set the [timeExtent](https://developers.arcgis.com/javascript/latest/references/core/widgets/TimeSlider/#timeExtent) property's `start` date to `null` and set `end` date to a desired date: `{start: null, end: date}` | <img alt="mode-instance" src="https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/timeslider/mode-from-start.png"> |
+   * cumulative-from-end   | Also, similar to the `time-window` with the end time pinned to the end of the slider. Set the [timeExtent](https://developers.arcgis.com/javascript/latest/references/core/widgets/TimeSlider/#timeExtent) property's `start` date to a desired date and set `end` date to `null`: `{start: date, end: null}` | <img alt="mode-instance" src="https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/timeslider/mode-from-end.png"> |
    *
    * @default "time-window"
-   * @see [timeExtent](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TimeSlider.html#timeExtent)
+   * @see [timeExtent](https://developers.arcgis.com/javascript/latest/references/core/widgets/TimeSlider/#timeExtent)
    * @example
    * // Create a single thumbed time slider that includes all historic content.
    * const timeSlider = new TimeSlider({
@@ -219,7 +216,7 @@ export abstract class ArcgisTimeSlider extends LitElement {
    *
    * > [!WARNING]
    * >
-   * > When a [View](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View.html) is associated with a TimeSlider and the TimeSlider is playing, the playback will pause before advancing if the View is still updating.
+   * > When a [View](https://developers.arcgis.com/javascript/latest/references/core/views/View/) is associated with a TimeSlider and the TimeSlider is playing, the playback will pause before advancing if the View is still updating.
    * > For example, if the `playRate` is set to 1,000 (one second) and the `View` takes 1.5 seconds to render then the TimeSlider thumb(s) will advance every
    * > 1.5 seconds rather than every second.
    *
@@ -269,8 +266,8 @@ export abstract class ArcgisTimeSlider extends LitElement {
    * ```
    *
    * To define regularly spaced stops, parse an object with `interval` and `timeExtent` properties
-   * with types [TimeInterval](https://developers.arcgis.com/javascript/latest/api-reference/esri-time-TimeInterval.html) and [TimeExtent](https://developers.arcgis.com/javascript/latest/api-reference/esri-time-TimeExtent.html) respectively.
-   * The [timeExtent](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TimeSlider.html#timeExtent) property is optional and used to confine stops to a certain date range.
+   * with types [TimeInterval](https://developers.arcgis.com/javascript/latest/references/core/time/TimeInterval/) and [TimeExtent](https://developers.arcgis.com/javascript/latest/references/core/time/TimeExtent/) respectively.
+   * The [timeExtent](https://developers.arcgis.com/javascript/latest/references/core/widgets/TimeSlider/#timeExtent) property is optional and used to confine stops to a certain date range.
    * This property is useful to commence stops on a specific day of the week or month.
    * If a stop definition by interval results in excess of 10,000 stops, then the view model
    * will default to ten evenly spaced stops.
@@ -333,7 +330,7 @@ export abstract class ArcgisTimeSlider extends LitElement {
   accessor stops: Stops | null | undefined;
   /**
    * When set, overrides the default TimeSlider ticks labelling system.
-   * Please refer to [TickConfig](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Slider-types.html#TickConfig) for detailed documentation
+   * Please refer to [TickConfig](https://developers.arcgis.com/javascript/latest/references/core/widgets/Slider/types/#TickConfig) for detailed documentation
    * on how to configure tick placement, style, and behavior.
    *
    * @since 4.16
@@ -380,7 +377,7 @@ export abstract class ArcgisTimeSlider extends LitElement {
   /**
    * The current time extent of the time slider. This property can be watched for
    * updates and used to update the time extent property in queries and/or the layer filters and effects.
-   * The following table shows the `timeExtent` values returned for each [mode](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TimeSlider.html#mode).
+   * The following table shows the `timeExtent` values returned for each [mode](https://developers.arcgis.com/javascript/latest/references/core/widgets/TimeSlider/#mode).
    *
    * | Mode    | The timeExtent value |
    * | ------- | -------------------- |
@@ -435,7 +432,7 @@ export abstract class ArcgisTimeSlider extends LitElement {
   accessor timeVisible: boolean;
   /**
    * Dates and times displayed in the component will be displayed in this time zone. By default this time zone is
-   * inherited from [MapView#timeZone](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#timeZone). When a MapView is not associated with the component
+   * inherited from [MapView#timeZone](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#timeZone). When a MapView is not associated with the component
    * then the property will fallback to the `system` time zone.
    *
    * **Possible Values**
@@ -443,7 +440,7 @@ export abstract class ArcgisTimeSlider extends LitElement {
    * Value | Description |
    * ----- | ----------- |
    * system  | Dates and times will be displayed in the timezone of the device or browser.
-   * unknown | Dates and time are not adjusted for any timezone. [TimeSlider](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TimeSlider.html) will be disabled.
+   * unknown | Dates and time are not adjusted for any timezone. [TimeSlider](https://developers.arcgis.com/javascript/latest/references/core/widgets/TimeSlider/) will be disabled.
    * Specified IANA timezone | Dates and times will be displayed in the specified IANA time zone. See [wikipedia - List of tz database time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones).
    *
    * @since 4.28
@@ -481,7 +478,7 @@ export abstract class ArcgisTimeSlider extends LitElement {
    */
   accessor view: MapViewOrSceneView | null | undefined;
   /** @param settings */
-  applyTimeSliderSettings(settings: Pick<TimeSliderProperties, "fullTimeExtent" | "loop" | "stops">): Promise<void>;
+  applyTimeSliderSettings(settings: TimeSliderSettings): Promise<void>;
   /** Permanently destroy the component. */
   destroy(): Promise<void>;
   next(): Promise<void>;

package/dist/components/arcgis-time-slider/customElement.js

@@ -19,7 +19,7 @@ class _ extends s {
     this.styles = c;
   }
   async applyTimeSliderSettings(e) {
-    Object.assign(this, e);
+    this.widget?.set(e);
   }
   async destroy() {
     await this.manager.destroy();

package/dist/components/arcgis-time-zone-label/customElement.d.ts

@@ -1,19 +1,13 @@
 /// <reference path="../../index.d.ts" />
-import type MapView from "@arcgis/core/views/MapView";
+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 { UIPosition } from "@arcgis/core/views/ui/types";
+import type { ArcgisReferenceElement } from "../types.js";
+import type { State } from "./types.js";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
 import type { Icon as Icon } from "@esri/calcite-components/components/calcite-icon";
 
 /**
- * Time Zone Label is a component for displaying the current [time zone](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/#timeZone) of a [Map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/).
- * The component has two states, collapsed as a small button and expanded displaying the internationalized name of the Map's time zone.
- * Users can toggle between these states by clicking the component's expand/collapse button.
- * By default the component is collapsed.
- *
- * When expanding, the component will lengthen inwards when [positioned](#position) within a Map.
- * This behavior can be overridden by setting the [expandDirection](#expandDirection) property to either `"start"` or `"end"`.
+ * Time Zone Label is a component for displaying the current [arcgis-map.timeZone](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#timeZone) of an [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/).
  *
  * @since 4.33
  */
@@ -27,25 +21,17 @@ export abstract class ArcgisTimeZoneLabel extends LitElement {
       noAdjustment: string;
   }>;
   /**
-   * When `true`, sets the component to a disabled state so the user cannot interact with it.
-   *
-   * @default false
-   */
-  accessor disabled: boolean;
-  /**
-   * The direction the component will expand.
+   * An optional leading icon that is displayed within the component.
    *
-   * 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.
+   * @since 5.0
    */
-  get expandDirection(): ExpandDirection;
-  set expandDirection(value: ExpandDirection | undefined);
+  accessor actionIcon: Icon["icon"] | undefined;
   /**
-   * The expanded state of the component.
+   * When true, the component is visually withdrawn and cannot receive user interaction.
    *
    * @default false
    */
-  accessor expanded: boolean;
+  accessor disabled: boolean;
   /**
    * Icon which represents the component.
    * Typically used when the component is controlled by another component (e.g. by the Expand component).
@@ -66,15 +52,19 @@ export abstract class ArcgisTimeZoneLabel extends LitElement {
       componentLabel?: string | undefined;
       noAdjustment?: string | undefined;
   };
-  /** @default "top-left" */
-  accessor position: UIPosition;
+  /**
+   * By assigning the `id` attribute of the Map or Scene component to this property, you can position a child component anywhere in the DOM while still maintaining a connection to the Map or Scene.
+   *
+   * @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;
   /** The state of the component. */
   get state(): State;
+  /**
+   * 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-time-zone-label component will be associated with a map or scene component rather than using the `view` property.
+   */
   accessor view: MapView | undefined;
-  "@setterTypes": {
-    expandDirection?: ExpandDirection | undefined;
-  };
   /** 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: "state"; }>;
   /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
@@ -83,8 +73,4 @@ export abstract class ArcgisTimeZoneLabel extends LitElement {
     arcgisPropertyChange: ArcgisTimeZoneLabel["arcgisPropertyChange"]["detail"];
     arcgisReady: ArcgisTimeZoneLabel["arcgisReady"]["detail"];
   };
-}
-
-export type ExpandDirection = "end" | "start";
-
-export type State = "disabled" | "ready";
+}

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

@@ -1,76 +1,37 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
-import { c as p } from "../../chunks/runtime.js";
-import { css as h, html as o } from "lit";
-import { useDirection as m, usePropertyChange as _ } from "@arcgis/lumina/controllers";
-import { classes as n } from "@arcgis/toolkit/dom";
-import { LitElement as u, createEvent as b, nothing as s, safeClassMap as c } from "@arcgis/lumina";
-import { u as f } from "../../chunks/useT9n.js";
-import { g as l } from "../../chunks/globalCss.js";
-import { u as v } from "../../chunks/useView.js";
-const x = h`.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)}}.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{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__heading{word-break:break-word}.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}.root{display:inline-flex}.badge{display:flex;padding-block:var(--calcite-spacing-sm);padding-inline:var(--calcite-spacing-sm);color:var(--calcite-color-text-1)}.badge-disabled{opacity:var(--calcite-opacity-disabled)}.badge-hidden{display:none}.badge-icon{align-self:center}.name{--calcite-color-background: transparent;--calcite-color-border-input: transparent;--calcite-font-weight-medium: normal;pointer-events:none}.name-hidden{display:none}.label{--calcite-label-margin-bottom: 0;align-items:center;padding-inline:var(--calcite-spacing-sm)}.label-disabled{opacity:var(--calcite-opacity-disabled)}.label-hidden{display:none}`;
-class w extends u {
+import { c as i } from "../../chunks/runtime.js";
+import { css as o, html as t } from "lit";
+import { usePropertyChange as c } from "@arcgis/lumina/controllers";
+import { LitElement as a, createEvent as r } from "@arcgis/lumina";
+import { u as s } from "../../chunks/useT9n.js";
+import { u as n } from "../../chunks/useView.js";
+import { s as l, a as m, u as d } from "../../chunks/time-utils.js";
+const u = o`calcite-action{--calcite-action-background-color-hover: var(--calcite-color-foreground-1);--calcite-action-background-color-press: var(--calcite-color-foreground-1);--calcite-action-background-color: var(--calcite-color-foreground-1);--calcite-action-text-color-press: var(--calcite-color-text-1);--calcite-action-text-color: var(--calcite-color-text-1);cursor:default}calcite-input-time-zone{--calcite-color-background: var(--calcite-color-foreground-1);--calcite-color-border-input: transparent}calcite-label{--calcite-label-margin-bottom: 0;font-weight:var(--calcite-font-weight-medium);padding-block:var(--calcite-spacing-sm);padding-inline:var(--calcite-spacing-md)}`;
+class g extends a {
   constructor() {
-    super(...arguments), this._messages = f({ blocking: !0 }), this._onExpanderClick = () => {
-      this.expanded = !this.expanded;
-    }, this._direction = m(), this.view = v(this), this.position = "top-left", this.disabled = !1, this.expanded = !1, this.icon = "time-zone", this.arcgisPropertyChange = _()("state"), this.arcgisReady = b();
+    super(...arguments), this._messages = s({ blocking: !0 }), this.disabled = !1, this.icon = "time-zone", this.view = n(this), this.arcgisPropertyChange = c()("state"), this.arcgisReady = r();
   }
   static {
-    this.properties = { _interactive: 16, _direction: 16, _expandDirection: 16, view: 0, state: 32, referenceElement: 1, position: 3, disabled: 7, expandDirection: 3, expanded: 7, icon: 3, messageOverrides: 0, label: 1 };
+    this.properties = { _interactive: 16, _resolvedTimeZone: 16, actionIcon: 3, disabled: 7, icon: 3, messageOverrides: 0, label: 1, referenceElement: 1, state: 32, view: 0 };
   }
   static {
-    this.styles = x;
+    this.styles = u;
   }
   get _interactive() {
     return !(this.disabled || this.state === "disabled");
   }
+  get _resolvedTimeZone() {
+    const e = this.view?.timeZone;
+    return !e || e === l ? m : e;
+  }
   get state() {
     return this.view?.ready ? "ready" : "disabled";
   }
-  get expandDirection() {
-    return this._expandDirection ?? this._computeExpandDirection();
-  }
-  set expandDirection(e) {
-    this._expandDirection = e;
-  }
-  _computeExpandDirection() {
-    if (!this.referenceElement)
-      return "end";
-    switch (this.position) {
-      case "top-right":
-      case "bottom-right":
-      case "top-trailing":
-      case "bottom-trailing":
-        return this._direction === "ltr" ? "start" : "end";
-      case "top-left":
-      case "bottom-left":
-      case "top-leading":
-      case "bottom-leading":
-        return this._direction === "ltr" ? "end" : "start";
-      default:
-        return "end";
-    }
-  }
-  _getIcon() {
-    const { expanded: e, expandDirection: i } = this;
-    return e ? this._direction === "rtl" ? i === "start" ? "chevrons-left" : "chevrons-right" : i === "start" ? "chevrons-right" : "chevrons-left" : "time-zone";
-  }
   render() {
-    const e = n("root", l.widget, !this._interactive && l.disabled), i = this._renderExpander(), t = this._renderName(), a = this._renderBadge(), r = [i, t, a];
-    return this.expandDirection === "start" && r.reverse(), o`<div aria-label=${this.label ?? s} class=${c(e)}>${r}</div>`;
-  }
-  _renderExpander() {
-    const e = this._getIcon();
-    return o`<calcite-action class="expander" .disabled=${!this._interactive} .icon=${e} @click=${this._onExpanderClick} .text=${this.label ?? ""} title=${this.label ?? "" ?? s}></calcite-action>`;
-  }
-  _renderBadge() {
-    return o`<div class=${c(n("badge", !this.expanded && "badge-hidden", !this._interactive && "badge-disabled"))}><calcite-icon class="badge-icon" icon=time-zone scale=s></calcite-icon></div>`;
-  }
-  _renderName() {
-    const e = "system", i = "unknown", t = this.view?.timeZone, a = t === e || t == null ? Intl.DateTimeFormat().resolvedOptions().timeZone : t, r = t === i, d = o`<calcite-label class=${c(n("label", (!this.expanded || !r) && "label-hidden", !this._interactive && "label-disabled"))}>${this._messages.noAdjustment}</calcite-label>`, g = o`<calcite-input-time-zone class=${c(n("name", (!this.expanded || !a || r) && "name-hidden"))} .disabled=${!this._interactive} mode=region read-only .value=${a}></calcite-input-time-zone>`;
-    return [d, g];
+    return t`<calcite-action .disabled=${!this._interactive} .icon=${this.actionIcon} text>${this._resolvedTimeZone === d ? t`<calcite-label>${this._messages.noAdjustment}</calcite-label>` : t`<calcite-input-time-zone mode=region overlay-positioning=fixed read-only .value=${this._resolvedTimeZone}></calcite-input-time-zone>`}</calcite-action>`;
   }
 }
-p("arcgis-time-zone-label", w);
+i("arcgis-time-zone-label", g);
 export {
-  w as ArcgisTimeZoneLabel
+  g as ArcgisTimeZoneLabel
 };

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

@@ -1,5 +1,4 @@
 import "@esri/calcite-components/components/calcite-action";
-import "@esri/calcite-components/components/calcite-icon";
 import "@esri/calcite-components/components/calcite-label";
 import "@esri/calcite-components/components/calcite-input-time-zone";
 export * from "./customElement.js";

package/dist/components/arcgis-time-zone-label/types.d.ts

@@ -0,0 +1 @@
+export type State = "disabled" | "ready";

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

@@ -1,13 +1,12 @@
 /// <reference path="../../index.d.ts" />
+import type MapView from "@arcgis/core/views/MapView.js";
+import type SceneView from "@arcgis/core/views/SceneView.js";
 import type Graphic from "@arcgis/core/Graphic.js";
-import type { TrackViewModelTrackErrorEvent, TrackViewModelTrackEvent, TrackViewModelState } from "@arcgis/core/widgets/Track/TrackViewModel.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
-import type { ArcgisReferenceElement } from "../../utils/component-utils.js";
-import type { IconName } from "../../utils/action-utils.js";
+import type { ArcgisReferenceElement, IconName } from "../types.js";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
-import type { MapViewOrSceneView } from "@arcgis/core/views/MapViewOrSceneView.js";
 import type { GoToOverride } from "@arcgis/core/widgets/support/types.js";
-import type { PositionFilterFunction } from "@arcgis/core/widgets/Track/types.js";
+import type { PositionFilterFunction, TrackViewModelState } from "./types.js";
 import type { Button as Button } from "@esri/calcite-components/components/calcite-button";
 
 /**
@@ -17,12 +16,20 @@ import type { Button as Button } from "@esri/calcite-components/components/calci
  * when speed is greater than zero and the browser provides heading information.
  *
  * This component uses the browser's [Geolocation API](https://developer.mozilla.org/en-US/docs/Web/API/Geolocation_API) which is only available in [secure contexts](https://developer.mozilla.org/en-US/docs/Web/Security/Secure_Contexts), such as HTTPS.
- * Note that localhost is considered "potentially secure" and can be used for easy testing in browsers that support
- * [Window.isSecureContext](https://developer.mozilla.org/en-US/docs/Web/API/isSecureContext#browser_compatibility).
+ * `localhost` is considered "potentially secure" and can be used for testing.
+ *
+ * > [!WARNING]
+ * >
+ * > **Note**
+ * >
+ * > To avoid unexpected navigation, especially when using custom spatial references, configure the view [constraints](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#constraints)
+ * > such as `extent`, `minZoom`, and `maxZoom`.
+ * > This helps when the geolocated position is inaccurate or causes the map to navigate to a location that is no longer visible because it is outside of
+ * > a layer's `fullExtent`.
  *
  * **Known limitations**
  *
- * - The heading symbol is not currently supported within a [Scene component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/).
+ * - The heading symbol is not currently supported within an [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/).
  *
  * @since 4.28
  */
@@ -38,14 +45,21 @@ export abstract class ArcgisTrack extends LitElement {
    */
   accessor 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.
+   * Indicates the current position of the geolocation result returned by the browser's Geolocation API.
+   * This property is updated when a new position is returned by the API, and is used to update the graphic and navigate to that location.
+   *
+   * @since 5.1
+   */
+  accessor currentPosition: GeolocationPosition | undefined;
+  /**
+   * Error that caused the last [track-error](https://developers.arcgis.com/javascript/latest/references/core/widgets/Track/TrackViewModel/#event:track-error) event to fire.
    *
    * @since 4.29
    * @example
    * if(track.viewModel.state === 'error')
    *   console.error(track.viewModel.error);
    */
-  accessor error: Error | GeolocationPositionError | null | undefined;
+  accessor error: Error | GeolocationPositionError | undefined;
   /**
    * An object used for setting optional position parameters. Refer to the
    * [Geolocation API Specification](https://www.w3.org/TR/geolocation/#position_options_interface)
@@ -62,7 +76,7 @@ export abstract class ArcgisTrack extends LitElement {
    *   }
    * });
    */
-  accessor geolocationOptions: PositionOptions | null | undefined;
+  accessor geolocationOptions: PositionOptions | undefined;
   /**
    * Indicates whether to navigate the view to the position and scale of the geolocated result.
    *
@@ -83,7 +97,7 @@ export abstract class ArcgisTrack extends LitElement {
    * };
    * ```
    */
-  accessor goToOverride: GoToOverride | null | undefined;
+  accessor goToOverride: GoToOverride | undefined;
   /**
    * The graphic used to show the user's location on the map.
    *
@@ -163,7 +177,7 @@ export abstract class ArcgisTrack extends LitElement {
    *   return geometryEngine.within(myLocation, geofenceExtent);
    * };
    */
-  accessor positionFilterFunction: PositionFilterFunction | null | undefined;
+  accessor positionFilterFunction: PositionFilterFunction | undefined;
   /**
    * By assigning the `id` attribute of the Map or Scene component to this property, you can position a child component anywhere in the DOM while still maintaining a connection to the Map or Scene.
    *
@@ -185,13 +199,13 @@ export abstract class ArcgisTrack extends LitElement {
    * result, after a location is returned.
    *
    * By default, the view will navigate to a scale of `2500` for 3D and `4514` for 2D.
-   * To override the default in 2D, set the `scale` property and also set [snapToZoom](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#constraints) to `false`.
-   * For 2D views the value should be within the [effectiveMinScale](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#constraints)
-   * and [effectiveMaxScale](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#constraints).
+   * To override the default in 2D, set the `scale` property and also set [snapToZoom](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#constraints) to `false`.
+   * For 2D views the value should be within the [effectiveMinScale](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#constraints)
+   * and [effectiveMaxScale](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#constraints).
    *
    * @since 4.7
    */
-  accessor scale: number | null | undefined;
+  accessor scale: number | undefined;
   /**
    * The current state of the component.
    *
@@ -208,7 +222,7 @@ export abstract class ArcgisTrack 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 arcgis-track component will be associated with a map or scene component rather than using the `view` property.
    */
-  accessor view: MapViewOrSceneView | null | undefined;
+  accessor view: MapView | SceneView | undefined;
   /**
    * Specifies the size of the component.
    *
@@ -222,8 +236,8 @@ export abstract class ArcgisTrack extends LitElement {
   start(): Promise<void>;
   /** Stop tracking the user's location. */
   stop(): Promise<void>;
-  readonly arcgisComplete: import("@arcgis/lumina").TargetedEvent<this, TrackViewModelTrackEvent>;
-  readonly arcgisError: import("@arcgis/lumina").TargetedEvent<this, TrackViewModelTrackErrorEvent>;
+  readonly arcgisComplete: import("@arcgis/lumina").TargetedEvent<this, { position: GeolocationPosition; }>;
+  readonly arcgisError: import("@arcgis/lumina").TargetedEvent<this, { error: GeolocationPositionError; }>;
   /** 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: "state"; }>;
   /** Emitted when the component associated with a map or scene view is ready to be interacted with. */