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

package/dist/components/arcgis-table-list/customElement.js

@@ -7,15 +7,15 @@ import { m as a } from "../../chunks/useWidget.js";
 import { css as h } from "@lit/reactive-element/css-tag.js";
 import { c as d } from "../../chunks/createCloseEvent.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.0 */
 const n = h`@layer{arcgis-table-list{display:block}}`, m = a(s);
 class c extends o {
   constructor() {
-    super(...arguments), this.widget = m(this), this.viewModel = this.widget.viewModel, this.arcgisClose = d(this), this.autoDestroyDisabled = !1, this.collapsed = this.widget.collapsed, this.dragEnabled = this.widget.dragEnabled, this.filterPlaceholder = this.widget.filterPlaceholder, this.filterPredicate = this.widget.filterPredicate, this.filterText = this.widget.filterText, this.icon = this.widget.icon, this.label = this.widget.label, this.listItemCreatedFunction = this.widget.listItemCreatedFunction, this.minDragEnabledItems = this.widget.minDragEnabledItems, this.minFilterItems = this.widget.minFilterItems, this.position = "bottom-left", this.selectedItems = this.widget.selectedItems, this.selectionMode = this.widget.selectionMode, this.state = this.viewModel.state, this.showCloseButton = this.widget.visibleElements.closeButton, this.showCollapseButton = this.widget.visibleElements.collapseButton, this.showErrors = this.widget.visibleElements.errors, this.showFilter = this.widget.visibleElements.filter, this.hideFlow = this.widget.visibleElements.flow, this.showHeading = this.widget.visibleElements.heading, this.hideStatusIndicators = this.widget.visibleElements.statusIndicators, this.showTemporaryTableIndicators = this.widget.visibleElements.temporaryTableIndicators, this.arcgisPropertyChange = e()("state"), this.arcgisReady = l(), this.arcgisTriggerAction = i(() => this.widget, "trigger-action");
+    super(...arguments), this.widget = m(this), this.viewModel = this.widget.viewModel, this.arcgisClose = d(this), this.autoDestroyDisabled = !1, this.closed = !1, this.collapsed = this.widget.collapsed, this.dragEnabled = this.widget.dragEnabled, this.filterPlaceholder = this.widget.filterPlaceholder, this.filterPredicate = this.widget.filterPredicate, this.filterText = this.widget.filterText, this.icon = this.widget.icon, this.label = this.widget.label, this.listItemCreatedFunction = this.widget.listItemCreatedFunction, this.minDragEnabledItems = this.widget.minDragEnabledItems, this.minFilterItems = this.widget.minFilterItems, this.position = "bottom-left", this.selectedItems = this.widget.selectedItems, this.selectionMode = this.widget.selectionMode, this.state = this.viewModel.state, this.showCloseButton = this.widget.visibleElements.closeButton, this.showCollapseButton = this.widget.visibleElements.collapseButton, this.showErrors = this.widget.visibleElements.errors, this.showFilter = this.widget.visibleElements.filter, this.hideFlow = this.widget.visibleElements.flow, this.showHeading = this.widget.visibleElements.heading, this.hideStatusIndicators = this.widget.visibleElements.statusIndicators, this.showTemporaryTableIndicators = this.widget.visibleElements.temporaryTableIndicators, this.arcgisPropertyChange = e()("state"), this.arcgisReady = l(), this.arcgisTriggerAction = i(() => this.widget, "trigger-action");
   }
   static {
-    this.properties = { autoDestroyDisabled: 5, collapsed: 7, dragEnabled: 5, filterPlaceholder: 1, filterPredicate: 0, filterText: 1, icon: 1, label: 1, listItemCreatedFunction: 0, minDragEnabledItems: 9, minFilterItems: 9, position: 1, referenceElement: 1, selectedItems: 0, selectionMode: 1, state: 3, tableItems: 32, showCloseButton: 5, showCollapseButton: 5, showErrors: 5, showFilter: 5, hideFlow: 5, showHeading: 5, hideStatusIndicators: 5, showTemporaryTableIndicators: 5 };
+    this.properties = { autoDestroyDisabled: 5, closed: 5, collapsed: 7, dragEnabled: 5, filterPlaceholder: 1, filterPredicate: 0, filterText: 1, icon: 1, label: 1, listItemCreatedFunction: 0, minDragEnabledItems: 9, minFilterItems: 9, position: 1, referenceElement: 1, selectedItems: 0, selectionMode: 1, state: 3, tableItems: 32, showCloseButton: 5, showCollapseButton: 5, showErrors: 5, showFilter: 5, hideFlow: 5, showHeading: 5, hideStatusIndicators: 5, showTemporaryTableIndicators: 5 };
   }
   static {
     this.shadowRootOptions = r;
@@ -23,13 +23,9 @@ class c extends o {
   static {
     this.styles = n;
   }
-  /** The collection of table ListItems displayed within the component. */
   get tableItems() {
     return this.widget.tableItems;
   }
-  //#endregion
-  //#region Public Methods
-  /** Permanently destroy the component */
   async destroy() {
     await this.manager.destroy();
   }

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

@@ -1,17 +1,17 @@
 /// <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 TimeSlider } from '@arcgis/core/widgets/TimeSlider.js';
 import { PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { ArcgisReferenceElement } from '../../utils/component-utils';
 
-declare const useTimeSliderWidget: (component: LitElement & Pick<TimeSlider, never> & {
+declare const useTimeSliderWidget: (component: LitElement & Pick<TimeSlider, "icon" | "label" | "viewModel" | "timeExtent" | "timeZone" | "mode" | "layout" | "loop" | "playRate" | "disabled" | "actions" | "fullTimeExtent" | "stops" | "tickConfigs" | "timeVisible"> & {
     state?: unknown;
     viewModel?: __esri.TimeSliderViewModel | undefined;
-    icon: Nil | string;
-    label: Nil | string;
-    referenceElement: ArcgisReferenceElement | Nil | string;
+    closed?: boolean;
+    icon: import('@arcgis/components-utils').Nil | string;
+    label: import('@arcgis/components-utils').Nil | string;
+    referenceElement?: ArcgisReferenceElement | string;
     position: __esri.UIPosition;
     arcgisReady: import('@arcgis/lumina').EventEmitter;
     arcgisPropertyChange: import('@arcgis/lumina').EventEmitter<{
@@ -21,60 +21,147 @@ declare const useTimeSliderWidget: (component: LitElement & Pick<TimeSlider, nev
         childElem?: HTMLElement & {
             ownedBy?: HTMLElement;
         };
-        view?: __esri.MapView | __esri.SceneView | Nil;
+        view?: __esri.LinkChartView | __esri.MapView | __esri.SceneView;
     };
     autoDestroyDisabled: boolean;
     destroy: () => Promise<void>;
-}, options?: {
-    editConstructorProperties(props: __esri.widgetsTimeSliderProperties | undefined): __esri.widgetsTimeSliderProperties | Promise<__esri.widgetsTimeSliderProperties | undefined> | undefined;
-} | undefined) => TimeSlider;
-/** The Time Slider component simplifies visualization of temporal data in your application.
+}) => TimeSlider;
+/**
+ * The Time Slider component simplifies visualization of temporal data in your application.
+ *
+ * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-time-slider/)
  */
 export declare 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 widget.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TimeSlider.html#actions)
+     */
     actions: __esri.Collection<__esri.Action>;
     /**
      * 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\` method when you are done to prevent
-     * memory leaks.
+     * is set, make sure to call the [destroy](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-time-slider/#destroy) method when you are done to
+     * prevent memory leaks.
+     *
+     * @default false
      */
     autoDestroyDisabled: boolean;
+    /**
+     * When `true`, sets the widget to a disabled state so the user cannot interact with it.
+     *
+     * @default false
+     */
     disabled: boolean;
+    /**
+     * Lists the specific locations on the timeline where handle(s) will snap to when manipulated.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TimeSlider.html#effectiveStops)
+     *
+     * @default null
+     */
     readonly effectiveStops: nullish | Date[];
+    /**
+     * The temporal extent of the entire slider.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TimeSlider.html#fullTimeExtent)
+     */
     fullTimeExtent: nullish | __esri.TimeExtent;
     /**
-     * Icon which represents the component.
-     * Typically used when the component is controlled by another component (e.g. by the Expand component).
-     * Search [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/) for possible values.
+     * Icon which represents the widget.
+     *
+     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
+     * @default "clock"
      */
     icon: string;
-    /** The component's default label. */
+    /**
+     * The widget's default label.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TimeSlider.html#label)
+     */
     label: string;
+    /**
+     * Determines the layout used by the TimeSlider widget.
+     *
+     * @default "auto"
+     */
     layout: "auto" | "compact" | "wide";
+    /**
+     * When `true`, the time slider will play its animation in a loop.
+     *
+     * @default false
+     */
     loop: boolean;
+    /**
+     * The time slider mode.
+     *
+     * @default "time-window"
+     */
     mode: "instant" | "time-window" | "cumulative-from-start" | "cumulative-from-end";
+    /**
+     * The time (in milliseconds) between animation steps.
+     *
+     * @default 1000
+     */
     playRate: number;
+    /** @default "bottom-left" */
     position: __esri.UIPosition;
-    referenceElement: ArcgisReferenceElement | Nil | string;
+    referenceElement?: ArcgisReferenceElement | string;
+    /**
+     * The view model's state.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TimeSlider-TimeSliderViewModel.html#state)
+     *
+     * @default "disabled"
+     */
     readonly state: "ready" | "disabled" | "playing";
+    /**
+     * Defines specific locations on the time slider where thumbs will snap to when manipulated.
+     *
+     * @default { count : 10 }
+     */
     stops: nullish | __esri.StopsByDates | __esri.StopsByCount | __esri.StopsByInterval;
+    /**
+     * When set, overrides the default TimeSlider ticks labelling system.
+     *
+     * @default null
+     */
     tickConfigs: nullish | __esri.TickConfig[];
+    /**
+     * The current time extent of the time slider.
+     *
+     * @default null
+     */
     timeExtent: nullish | __esri.TimeExtent;
+    /**
+     * Shows/hides time in the display.
+     *
+     * @default false
+     */
     timeVisible: boolean;
+    /**
+     * Dates and times displayed in the widget will be displayed in this time zone.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TimeSlider.html#timeZone)
+     */
     timeZone: string;
     applyTimeSliderSettings(settings: Pick<__esri.TimeSliderProperties, "fullTimeExtent" | "loop" | "stops">): Promise<void>;
-    /** Permanently destroy the component */
+    /** Permanently destroy the component. */
     destroy(): Promise<void>;
     next(): Promise<void>;
     play(): Promise<void>;
     previous(): Promise<void>;
     stop(): Promise<void>;
     updateWebDocument(webmap: __esri.WebMap): Promise<void>;
+    /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
     readonly arcgisPropertyChange: TargetedEvent<this, {
         name: "state" | "timeExtent" | "effectiveStops" | "fullTimeExtent";
     }>;
-    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>;
+    /** Emitted when an action is triggered on the component. */
     readonly arcgisTriggerAction: TargetedEvent<this, __esri.TimeSliderTriggerActionEvent>;
 }
 export {};

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

@@ -3,15 +3,16 @@ import { usePropertyChange as e } from "@arcgis/lumina/controllers";
 import { reEmitEvent as s } from "@arcgis/lumina/controllers/accessor";
 import o from "@arcgis/core/widgets/TimeSlider.js";
 import { LitElement as a, createEvent as h, noShadowRoot as l } from "@arcgis/lumina";
-import { m as r } from "../../chunks/useWidget.js";
+import { m as n } from "../../chunks/useWidget.js";
 import { css as d } from "@lit/reactive-element/css-tag.js";
+import { when as r } 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 */
-const n = d`@layer{arcgis-time-slider{display:block}}`, m = r(o);
-class c extends a {
+See https://js.arcgis.com/4.34/esri/copyright.txt for details.
+v4.34.0-next.0 */
+const m = d`@layer{arcgis-time-slider{display:block}}`, c = n(o);
+class g extends a {
   constructor() {
-    super(...arguments), this.widget = m(this), this.viewModel = this.widget.viewModel, this.actions = this.widget.actions, this.autoDestroyDisabled = !1, this.disabled = this.widget.disabled, this.effectiveStops = this.widget.effectiveStops, this.fullTimeExtent = this.widget.fullTimeExtent, this.icon = this.widget.icon, this.label = this.widget.label, this.layout = this.widget.layout, this.loop = this.widget.loop, this.mode = this.widget.mode, this.playRate = this.widget.playRate, this.position = "bottom-left", this.state = this.viewModel.state, this.stops = this.widget.stops, this.tickConfigs = this.widget.tickConfigs, this.timeExtent = this.widget.timeExtent, this.timeVisible = this.widget.timeVisible, this.timeZone = this.widget.timeZone, this.arcgisPropertyChange = e()("effectiveStops", "fullTimeExtent", "timeExtent", "state"), this.arcgisReady = h(), this.arcgisTriggerAction = s(() => this.widget, "trigger-action");
+    super(...arguments), this.widget = c(this), this.viewModel = this.widget.viewModel, this.actions = this.widget.actions, this.autoDestroyDisabled = !1, this.disabled = this.widget.disabled, this.effectiveStops = this.widget.effectiveStops, this.fullTimeExtent = this.widget.fullTimeExtent, this.icon = this.widget.icon, this.label = this.widget.label, this.layout = this.widget.layout, this.loop = this.widget.loop, this.mode = this.widget.mode, this.playRate = this.widget.playRate, this.position = "bottom-left", this.state = this.viewModel.state, this.stops = this.widget.stops, this.tickConfigs = this.widget.tickConfigs, this.timeExtent = this.widget.timeExtent, this.timeVisible = this.widget.timeVisible, this.timeZone = this.widget.timeZone, this.arcgisPropertyChange = e()("effectiveStops", "fullTimeExtent", "timeExtent", "state"), this.arcgisReady = h(), this.arcgisTriggerAction = s(() => this.widget, "trigger-action");
   }
   static {
     this.properties = { actions: 0, autoDestroyDisabled: 5, disabled: 7, effectiveStops: 0, fullTimeExtent: 0, icon: 1, label: 1, layout: 1, loop: 5, mode: 1, playRate: 9, position: 1, referenceElement: 1, state: 3, stops: 0, tickConfigs: 0, timeExtent: 0, timeVisible: 5, timeZone: 1 };
@@ -20,14 +21,11 @@ class c extends a {
     this.shadowRootOptions = l;
   }
   static {
-    this.styles = n;
+    this.styles = m;
   }
-  //#endregion
-  //#region Public Methods
   async applyTimeSliderSettings(t) {
     Object.assign(this, t);
   }
-  /** Permanently destroy the component */
   async destroy() {
     await this.manager.destroy();
   }
@@ -46,8 +44,13 @@ class c extends a {
   async updateWebDocument(t) {
     this.widget?.updateWebDocument(t);
   }
+  loaded() {
+    this.manager.onLifecycle(() => r(() => this.viewModel.view?.ready, () => {
+      this.timeExtent && this.viewModel.view && (this.viewModel.view.timeExtent = this.timeExtent);
+    }, { initial: !0 }));
+  }
 }
-i("arcgis-time-slider", c);
+i("arcgis-time-slider", g);
 export {
-  c as ArcgisTimeSlider
+  g as ArcgisTimeSlider
 };

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

@@ -1,7 +1,6 @@
 /// <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 { JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { ArcgisReferenceElement } from '../../utils/component-utils';
 import { useView } from '../../controllers/useView';
@@ -9,23 +8,31 @@ type ExpandDirection = "end" | "start";
 type State = "disabled" | "ready";
 
 /**
- * TimeZoneLabel is 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/).
+ * 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"`.
+ *
+ * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-time-zone-label/)
  */
 export declare class ArcgisTimeZoneLabel extends LitElement {
     /**
      * The state of the component.
-     * @readonly
+     *
+     * @default "disabled"
      */
     readonly state: State;
-    referenceElement: ArcgisReferenceElement | Nil | string;
+    referenceElement?: ArcgisReferenceElement | string;
+    /** @default "top-left" */
     position: __esri.UIPosition;
-    /** When `true`, sets the component to a disabled state so the user cannot interact with it. */
+    /**
+     * When `true`, sets the component to a disabled state so the user cannot interact with it.
+     *
+     * @default false
+     */
     disabled: boolean;
     /**
      * The direction the component will expand.
@@ -34,28 +41,41 @@ export declare class ArcgisTimeZoneLabel extends LitElement {
      * the component will expand towards the "end" which is equivalent to right in a LTR application.
      */
     get expandDirection(): ExpandDirection;
-    set expandDirection(value: ExpandDirection | Nil);
-    /** The expanded state of the component. */
+    set expandDirection(value: ExpandDirection | undefined);
+    /**
+     * The expanded state of the component.
+     *
+     * @default false
+     */
     expanded: boolean;
     /**
-     * Icon which represents the component. It is typically used when the
-     * component is controlled by another one (e.g. in the arcgis-expand
-     * component).
+     * Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases.
      *
-     * @see [Calcite Icon Search](https://developers.arcgis.com/calcite-design-system/icons/)
+     * @property
+     * ({ reflect: true })
+     * icon?: HTMLCalciteIconElement["icon"] = "time-zone";
+     *
+     * /**
+     * @copyDoc
      */
-    icon: HTMLCalciteIconElement["icon"] | Nil;
-    /** Overwrite localized strings for this component */
     messageOverrides?: typeof this._messages._overrides;
     /** The component's default label. */
-    label: Nil | string;
+    label?: string;
+    /** 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>;
-    private _messages;
+    /** 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: {
+        componentLabel: string;
+        noAdjustment: string;
+    } & import('@arcgis/lumina/controllers').T9nMeta<{
+        componentLabel: string;
+        noAdjustment: string;
+    }>;
     readonly _setterTypes: {
-        expandDirection?: ExpandDirection | Nil;
+        expandDirection?: ExpandDirection | undefined;
     };
 }
 export {};

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.0 */
 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.
+ *
+ * [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;