@arcgis/map-components 5.2.0-next.10 → 5.2.0-next.100

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

@@ -0,0 +1,150 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+import { c as u } from "../../chunks/runtime.js";
+import { css as h, html as a } from "lit";
+import c from "@arcgis/core/time/TimeExtent.js";
+import { LitElement as v, nothing as f, safeClassMap as g } from "@arcgis/lumina";
+import { createRef as o, ref as d } from "lit/directives/ref.js";
+import { m as w } from "../../chunks/handle.js";
+import { watch as x } from "@arcgis/core/core/reactiveUtils.js";
+const p = h`:host{background-color:var(--calcite-color-surface-2);block-size:var(--calcite-size-fixed-xxxl);color:var(--calcite-color-text-1);display:flex;flex:1 0 auto;font-family:var(--calcite-font-family);font-size:var(--calcite-font-size-sm);inline-size:auto}.root{align-items:center;block-size:100%;display:flex;inline-size:100%}slot[name=max],slot[name=min]{display:flex}.slider{--labels-container-width: 100%;flex:1 1 auto;min-inline-size:calc(var(--calcite-spacing-md) * 15)}.slider--has-ticks{margin-top:calc(var(--calcite-spacing-md) * -1)}.hidden,.max-date,.min-date{flex:0 0 auto}.hidden{inline-size:0}.max-date,.min-date{inline-size:calc(var(--calcite-size-md) * 3.125)}.popover{padding:var(--calcite-spacing-xxs) var(--calcite-spacing-xs) var(--calcite-spacing-xs)}.ticks-container{flex:1;position:relative;width:100%}.major-ticks,.minor-ticks{inset:0;position:absolute}.major-ticks,.minor-ticks{--arcgis-ticks-tick-transform: unset;--arcgis-ticks-tick-width: var(--calcite-size-px)}.minor-ticks{--arcgis-ticks-tick-length: var(--calcite-size-fixed-xxs)}.major-ticks{--arcgis-ticks-font-weight: var(--calcite-font-weight-normal)}.slider.slider--out-of-range{--arcgis-internal-slider-handle-color: var(--calcite-color-status-danger);--arcgis-internal-slider-track-range-background-color: var(--calcite-color-status-danger)}`;
+class T extends v {
+  constructor() {
+    super(...arguments), this.#e = new ResizeObserver(() => {
+      const e = this.#r.value?.clientWidth;
+      e && (this._sliderWidth = e);
+    }), this.#n = 3, this.#a = o(), this.#r = o(), this._sliderWidth = 100, this.autoDestroyDisabled = !1, this.showMax = !1, this.showMin = !1, this.showTicks = !1, this.showTimeExtentPopover = !1;
+  }
+  static {
+    this.properties = { _activeValue: 16, _sliderFillPlacement: 16, _sliderWidth: 16, _timeExtentEpochValues: 16, activeValue: 32, autoDestroyDisabled: 5, showMax: 5, showMin: 5, showTicks: 5, showTimeExtentPopover: 5, viewModel: 0 };
+  }
+  static {
+    this.styles = p;
+  }
+  #e;
+  #t;
+  #i;
+  #s;
+  #n;
+  #a;
+  #r;
+  get _sliderFillPlacement() {
+    switch (this.viewModel?.mode) {
+      case "cumulative-from-end":
+        return "end";
+      case "cumulative-from-start":
+        return "start";
+      case "instant":
+        return "none";
+      default:
+        return;
+    }
+  }
+  get _timeExtentEpochValues() {
+    const { viewModel: e } = this;
+    if (!e)
+      return;
+    const { timeExtent: t, fullTimeExtent: i } = e;
+    if (!t || !i)
+      return;
+    const { start: s, end: r } = t, { start: l, end: n } = i;
+    if (!(!l || !n))
+      switch (e.mode) {
+        case "cumulative-from-end":
+        case "instant":
+          return s ? s.getTime() < l.getTime() ? [l.getTime()] : s.getTime() > n.getTime() ? [n.getTime()] : [s.getTime()] : void 0;
+        case "cumulative-from-start":
+          return r ? r.getTime() < l.getTime() ? [l.getTime()] : r.getTime() > n.getTime() ? [n.getTime()] : [r.getTime()] : void 0;
+        case "time-window":
+          return s && r ? [s.getTime(), r.getTime()] : void 0;
+      }
+  }
+  get activeValue() {
+    switch (this._activeValue) {
+      case void 0:
+        return;
+      case "all":
+        return this.viewModel?.timeExtent;
+      default:
+        return new Date(this._activeValue);
+    }
+  }
+  async destroy() {
+    await this.manager.destroy();
+  }
+  async loaded() {
+    this.manager.onLifecycle(() => [
+      x(() => this.#a.value, (e) => {
+        this.#e.disconnect(), e && this.#e.observe(e);
+      }, { initial: !0 }),
+      w(() => {
+        this.#e.disconnect();
+      })
+    ]);
+  }
+  #l(e, t) {
+    const { viewModel: i } = this;
+    if (!i)
+      return;
+    const { start: s, end: r } = e;
+    if (!s || !r)
+      return;
+    const n = (r.getTime() - s.getTime()) / t;
+    return i.tickFormats.find(({ duration: m }) => m > this.#n * n) ?? i.tickFormats.at(-1);
+  }
+  #c(e) {
+    this._activeValue = e.target.activeValue;
+  }
+  #o(e) {
+    const { viewModel: t } = this, i = t?.mode;
+    i && (t.timeExtent = this.#d(e.target.values, i), this._activeValue = e.target.activeValue);
+  }
+  #d([e, t], i) {
+    switch (i) {
+      case "cumulative-from-end":
+        return new c({ start: new Date(e), end: null });
+      case "cumulative-from-start":
+        return new c({ start: null, end: new Date(e) });
+      case "instant":
+        return new c({ start: new Date(e), end: new Date(e) });
+      case "time-window":
+        return new c({ start: new Date(e), end: new Date(t ?? e) });
+    }
+  }
+  render() {
+    return a`<div class="root" ${d(this.#a)}>${this.#u()}${this.#f()}${this.#m()}</div>`;
+  }
+  #m() {
+    return this.showMax ? a`<slot name=max><arcgis-time-bar-date class="max-date" .date=${this.viewModel?.fullTimeExtent?.end} .viewModel=${this.viewModel}></arcgis-time-bar-date></slot>` : a`<div class="hidden"></div>`;
+  }
+  #u() {
+    return this.showMin ? a`<slot name=min><arcgis-time-bar-date class="min-date" .date=${this.viewModel?.fullTimeExtent?.start} .viewModel=${this.viewModel}></arcgis-time-bar-date></slot>` : a`<div class="hidden"></div>`;
+  }
+  #h() {
+    return this.showTimeExtentPopover ? a`<div class="popover" slot=popover><slot name=popover>${this.#v()}</slot></div>` : null;
+  }
+  #v() {
+    return this.activeValue ? this.activeValue instanceof Date ? a`<arcgis-time-bar-date .date=${this.activeValue} .viewModel=${this.viewModel}></arcgis-time-bar-date>` : a`<arcgis-time-bar-extent .viewModel=${this.viewModel}></arcgis-time-bar-extent>` : null;
+  }
+  #f() {
+    const { viewModel: e } = this;
+    if (!e?.fullTimeExtent?.start || !e?.fullTimeExtent?.end || !this._sliderWidth)
+      return null;
+    const t = this.#l(e.fullTimeExtent, this._sliderWidth);
+    if (!t)
+      return null;
+    (!this.#t || !this.#s || !this.#i || this.#t !== t) && (this.#t = t, this.#s = e.getTickValues(t.minor), this.#i = e.getTickValues(t.major), e.majorTickFormat = t.format);
+    const i = e.fullTimeExtent.start.getTime(), s = e.fullTimeExtent.end.getTime();
+    return a`<arcgis-slider allow-values-overlap class=${g({
+      slider: !0,
+      "slider--has-ticks": this.showTicks,
+      "slider--out-of-range": e.isOutOfRange
+    })} .disabled=${!e.interactive} fill-placement=${this._sliderFillPlacement ?? f} .max=${s} .min=${i} @arcgisActiveValueChange=${this.#c} @arcgisInput=${this.#o} precision=0 .steps=${e.effectiveStopsEpoch} .values=${this._timeExtentEpochValues} ${d(this.#r)}>${this.#h()}${this.#g(e, i, s)}</arcgis-slider>`;
+  }
+  #g(e, t, i) {
+    return this.showTicks ? a`<div slot=content-end class="ticks-container"><arcgis-ticks class="minor-ticks" .max=${i} .min=${t} mode=value .values=${this.#s}></arcgis-ticks><arcgis-ticks class="major-ticks" .labelFormatter=${e.majorTickFormatter} .max=${i} .min=${t} mode=value show-labels .values=${this.#i}></arcgis-ticks></div>` : null;
+  }
+}
+u("arcgis-time-bar-slider", T);
+export {
+  T as ArcgisTimeBarSlider
+};

package/dist/components/arcgis-time-bar-slider/index.d.ts

@@ -0,0 +1 @@
+export * from "./customElement.js";

package/dist/components/arcgis-time-bar-slider/index.js

@@ -0,0 +1,5 @@
+import "../arcgis-time-bar-date/index.js";
+import "../arcgis-time-bar-extent/index.js";
+import "@arcgis/common-components/components/arcgis-slider";
+import "@arcgis/common-components/components/arcgis-ticks";
+export * from "./customElement.js";

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

@@ -86,7 +86,7 @@ class j extends T {
   }
   render() {
     const e = this.mode === "single" && !this.disabled;
-    return f(this.messages._lang, m`<arcgis-slider .ariaLabel=${this.label} class=${_({ "wrap-labels": this._shouldWrapLabels })} .disabled=${this.disabled} fill-placement=none .labelFormatter=${this._sliderLabelFormatter} layout=horizontal min=0 .max=${c} .steps=${this.steps ?? 1} .valueLabelsDisplay=${this.mode === "range" ? "hidden" : "always"} value-labels-placement=start .values=${this._values} @arcgisInput=${({ currentTarget: { values: t } }) => {
+    return f(this.messages._lang, m`<arcgis-slider .ariaLabel=${this.label} class=${_({ "wrap-labels": this._shouldWrapLabels })} .disabled=${this.disabled} .fillPlacement=${this.mode === "range" ? "between" : "none"} .labelFormatter=${this._sliderLabelFormatter} layout=horizontal min=0 .max=${c} .steps=${this.steps ?? 1} .valueLabelsDisplay=${this.mode === "range" ? "hidden" : "always"} value-labels-placement=start .values=${this._values} @arcgisInput=${({ currentTarget: { values: t } }) => {
       this.mode === "single" ? this._setStartTime(t[0]) : this._setRange(t[0], t[1]);
     }}>${this.mode === "range" ? this._renderTimeRange() : void 0}<div class="ticks-container" slot=content-end><arcgis-ticks class="main-ticks" .interactive=${e} .labelFormatter=${this._tickLabelFormatter} layout=horizontal min=0 .max=${c} mode=value show-labels .values=${p} @arcgisTickClick=${(t) => this._setStartTime(t.detail.value)}></arcgis-ticks><arcgis-ticks class="secondary-ticks" layout=horizontal min=0 .max=${c} mode=value .values=${I} @arcgisTickClick=${(t) => this._setStartTime(t.detail.value)}></arcgis-ticks></div></arcgis-slider>`);
   }

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

@@ -19,7 +19,7 @@ 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/references/core/widgets/timeslider/ellipsis.png) in the component. The
+   * ![timeSlider-actions-menu](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/timeslider/ellipsis.avif) 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/references/core/widgets/TimeSlider/types/#Action) is defined with a unique id, a title,
    * and an icon.
@@ -28,7 +28,7 @@ export abstract class ArcgisTimeSlider extends LitElement {
    * 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/references/core/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.avif)](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/)
@@ -86,6 +86,15 @@ export abstract class ArcgisTimeSlider extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-time-slider auto-destroy-disabled></arcgis-time-slider>
+   * ```
+   *
+   * ```js
+   * timeSliderElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**
@@ -188,10 +197,10 @@ 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/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"> |
+   * 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 the same date: `{start: sameDate, end: sameDate}` | <img alt="mode-instance" src="https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/timeslider/mode-instance.avif"> |
+   * time-window           | The slider will show temporal data that falls within a given time range. This is the default. Set the [timeExtent](https://developers.arcgis.com/javascript/latest/references/core/widgets/TimeSlider/#timeExtent) property's `start` and `end` properties to the desired dates. | <img alt="mode-instance" src="https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/timeslider/mode-time-window.avif"> |
+   * cumulative-from-start | Similar to `time-window`, where 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.avif"> |
+   * 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.avif"> |
    *
    * @default "time-window"
    * @see [timeExtent](https://developers.arcgis.com/javascript/latest/references/core/widgets/TimeSlider/#timeExtent)
@@ -433,7 +442,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/references/core/views/MapView/#timeZone). When a MapView is not associated with the component
+   * inherited from the associated [MapView.timeZone](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#timeZone) or [SceneView.timeZone](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/#timeZone). When a view is not associated with the component
    * then the property will fallback to the `system` time zone.
    *
    * **Possible Values**
@@ -441,15 +450,15 @@ 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/references/core/widgets/TimeSlider/) will be disabled.
+   * unknown | Dates and times 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
    */
   accessor timeZone: string;
   /**
-   * 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-slider component will be associated with a map or scene component rather than using the `view` property.
+   * 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-slider component will be associated with a map or scene component rather than using the `view` property.
    *
    * @example
    * ```js

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

@@ -0,0 +1,36 @@
+/// <reference path="../../index.d.ts" />
+import type { TimeZone } from "@arcgis/core/time/types.js";
+import type { PublicLitElement as LitElement } from "@arcgis/lumina";
+import type { T9nMeta } from "@arcgis/lumina/controllers";
+import type { Chip as Chip } from "@esri/calcite-components/components/calcite-chip";
+
+/**
+ * A compact time-zone selector.
+ *
+ * @internal
+ */
+export abstract class ArcgisTimeZoneChip extends LitElement {
+  /** @internal */
+  protected _messages: {
+      popoverLabel: string;
+      chipLabel: string;
+  } & T9nMeta<{
+      popoverLabel: string;
+      chipLabel: string;
+  }>;
+  /** @default false */
+  accessor disabled: boolean;
+  /** @default "system" */
+  accessor timeZone: TimeZone;
+  /** @default "m" */
+  accessor visualScale: Chip["scale"];
+  /**
+   * Emitted when the selected time zone changes.
+   *
+   * @internal
+   */
+  readonly arcgisInternalTimeZoneChange: import("@arcgis/lumina").TargetedEvent<this, TimeZone>;
+  readonly "@eventTypes": {
+    arcgisInternalTimeZoneChange: ArcgisTimeZoneChip["arcgisInternalTimeZoneChange"]["detail"];
+  };
+}

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

@@ -0,0 +1,36 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+import { c } from "../../chunks/runtime.js";
+import { substitute as r } from "@arcgis/core/intl.js";
+import { LitElement as p, createEvent as d, nothing as i } from "@arcgis/lumina";
+import { generateGuid as s } from "@arcgis/toolkit/string";
+import { css as m, html as h } from "lit";
+import { u as b } from "../../chunks/useT9n.js";
+import { s as o, a as v, u as g } from "../../chunks/time-utils.js";
+const u = m`:host{display:inline-block;max-inline-size:100%}.container{--arcgis-internal-time-zone-popover-inline-size: min(20rem, calc(100vw - var(--calcite-spacing-xl)));max-inline-size:100%;.trigger{display:block;inline-size:fit-content;max-inline-size:100%;padding:0;border:0;background:transparent;color:inherit;cursor:pointer;&:focus-visible{outline:var(--calcite-border-width-md) solid var(--calcite-color-focus, var(--calcite-ui-focus-color, var(--calcite-color-brand)));outline-offset:2px}&:disabled{cursor:not-allowed}&[aria-expanded=true] calcite-chip{--calcite-chip-background-color: var(--calcite-color-foreground-3);--calcite-chip-border-color: var(--calcite-color-text-3)}}calcite-chip{--calcite-chip-icon-color: var(--calcite-color-text-2);max-inline-size:100%;pointer-events:none}.chip-label{display:block;overflow:hidden;max-inline-size:calc(6 * var(--calcite-size-md));text-overflow:ellipsis;white-space:nowrap}calcite-popover{--calcite-popover-max-size-x: var(--arcgis-internal-time-zone-popover-inline-size)}.popover-content{box-sizing:border-box;inline-size:var(--arcgis-internal-time-zone-popover-inline-size);padding:var(--calcite-spacing-md)}}`;
+class f extends p {
+  constructor() {
+    super(...arguments), this._messages = b({ blocking: !0 }), this.#e = s(), this.#i = s(), this._open = !1, this.disabled = !1, this.timeZone = o, this.visualScale = "m", this.arcgisInternalTimeZoneChange = d({ bubbles: !1, composed: !1 });
+  }
+  static {
+    this.properties = { _open: 16, disabled: 5, timeZone: 1, visualScale: 1 };
+  }
+  static {
+    this.styles = u;
+  }
+  #e;
+  #i;
+  willUpdate(e) {
+    e.has("disabled") && this.disabled && (this._open = !1);
+  }
+  #t(e) {
+    this.timeZone = e.detail, this.arcgisInternalTimeZoneChange.emit(e.detail);
+  }
+  render() {
+    const { _messages: e } = this, t = this.timeZone === o ? v : this.timeZone === g ? "UTC" : this.timeZone, l = (t.split("/").at(-1) ?? t).replaceAll("_", " "), n = `⁨${t}⁩`, a = r(e.chipLabel, { timeZone: n });
+    return h`<div class="container"><button aria-controls=${this.#e ?? i} aria-expanded=${this._open ?? i} aria-haspopup=dialog aria-label=${a ?? i} class="trigger" .disabled=${this.disabled} id=${this.#i ?? i} title=${t ?? i} type=button @click=${() => this._open = !this._open}><calcite-chip aria-hidden appearance=outline-fill .disabled=${this.disabled} icon=time-zone .label=${a} .scale=${this.visualScale}><span class="chip-label"><bdi>${l}</bdi></span></calcite-chip></button><calcite-popover auto-close id=${this.#e ?? i} .label=${e.popoverLabel} .open=${this._open} overlay-positioning=fixed placement=top-start .referenceElement=${this.#i} trigger-disabled @calcitePopoverClose=${() => this._open = !1} @calcitePopoverOpen=${() => this._open = !0}><div class="popover-content"><arcgis-time-zone-selector .disabled=${this.disabled} .timeZone=${this.timeZone} .visualScale=${this.visualScale} @arcgisInternalTimeZoneChange=${this.#t}></arcgis-time-zone-selector></div></calcite-popover></div>`;
+  }
+}
+c("arcgis-time-zone-chip", f);
+export {
+  f as ArcgisTimeZoneChip
+};

package/dist/components/arcgis-time-zone-chip/index.d.ts

@@ -0,0 +1 @@
+export * from "./customElement.js";

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

@@ -0,0 +1,4 @@
+import "@esri/calcite-components/components/calcite-chip";
+import "@esri/calcite-components/components/calcite-popover";
+import "../arcgis-time-zone-selector/index.js";
+export * from "./customElement.js";

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

@@ -61,8 +61,8 @@ export abstract class ArcgisTimeZoneLabel extends LitElement {
   /** 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.
+   * 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;
   /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */

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

@@ -0,0 +1,56 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+import { c as o } from "../../chunks/runtime.js";
+import { LitElement as l, createEvent as r } from "@arcgis/lumina";
+import { css as m, html as n } from "lit";
+import { u as d } from "../../chunks/useT9n.js";
+import { s as t, u as s, a as u } from "../../chunks/time-utils.js";
+const h = m`:host{--calcite-label-margin-bottom: initial;display:block;inline-size:100%}.time-zone-options{display:flex;flex-direction:column}.time-zone-indent{margin-inline-start:calc(var(--calcite-spacing-lg) * 1.5)}.time-zone-input{inline-size:100%;max-inline-size:100%;&:not([calcite-hydrated]){visibility:hidden}}.status{display:grid;grid-template-columns:min-content 1fr;align-items:start;gap:var(--calcite-spacing-sm);box-sizing:border-box;padding:var(--calcite-spacing-sm);border-radius:var(--calcite-corner-radius-sm);background-color:var(--calcite-color-foreground-2);color:var(--calcite-color-text-2)}.status-text{margin:0}`, p = ["device", "data", "specific"];
+class g extends l {
+  constructor() {
+    super(...arguments), this._messages = d({ blocking: !0 }), this.disabled = !1, this.timeZone = t, this.visualScale = "m", this.arcgisInternalTimeZoneChange = r({ bubbles: !1, composed: !1 });
+  }
+  static {
+    this.properties = { disabled: 5, timeZone: 1, visualScale: 1 };
+  }
+  static {
+    this.styles = h;
+  }
+  #i;
+  get #s() {
+    return this.timeZone === t ? "device" : this.timeZone === s ? "data" : "specific";
+  }
+  get #t() {
+    return this.timeZone !== t && this.timeZone !== s ? this.timeZone : this.#i ?? u;
+  }
+  willUpdate(e) {
+    e.has("timeZone") && this.timeZone !== t && this.timeZone !== s && (this.#i = this.timeZone);
+  }
+  #e(e) {
+    e !== this.timeZone && (this.timeZone = e, this.arcgisInternalTimeZoneChange.emit(e));
+  }
+  #a(e) {
+    switch (e.currentTarget.selectedItem?.value) {
+      case "device":
+        this.#e(t);
+        break;
+      case "specific":
+        this.#e(this.#t);
+        break;
+      case "data":
+        this.#e(s);
+        break;
+    }
+  }
+  #n(e) {
+    const i = e.currentTarget.value;
+    i && this.#e(i);
+  }
+  render() {
+    const { _messages: e } = this, i = this.#s, c = i === "data" ? e.dataStatus : i === "device" ? e.deviceStatus : void 0;
+    return n`<div class="time-zone-options"><calcite-radio-button-group .ariaLabel=${e.timeZone} .disabled=${this.disabled} layout=vertical name=time-zone-mode .scale=${this.visualScale} @calciteRadioButtonGroupChange=${this.#a}>${p.map((a) => n`<calcite-label layout=inline .scale=${this.visualScale}><calcite-radio-button .checked=${i === a} .disabled=${this.disabled} .value=${a}></calcite-radio-button>${e[a]}</calcite-label>`)}</calcite-radio-button-group><div class="time-zone-indent" .hidden=${i !== "specific"}><calcite-input-time-zone .ariaLabel=${e.specificTimeZone} class="time-zone-input" data-testid=time-zone-input .disabled=${this.disabled} mode=region overlay-positioning=fixed .scale=${this.visualScale} .value=${this.#t} @calciteInputTimeZoneChange=${this.#n}></calcite-input-time-zone></div>${c ? n`<div class="status" aria-live=polite><calcite-icon aria-hidden icon=time-zone scale=s></calcite-icon><p class="status-text">${c}</p></div>` : void 0}</div>`;
+  }
+}
+o("arcgis-time-zone-selector", g);
+export {
+  g as ArcgisTimeZoneSelector
+};

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

@@ -0,0 +1,6 @@
+import "@esri/calcite-components/components/calcite-radio-button-group";
+import "@esri/calcite-components/components/calcite-label";
+import "@esri/calcite-components/components/calcite-radio-button";
+import "@esri/calcite-components/components/calcite-input-time-zone";
+import "@esri/calcite-components/components/calcite-icon";
+export * from "./customElement.js";

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

@@ -15,7 +15,7 @@ import type { Button as Button } from "@esri/calcite-components/components/calci
  * The view rotates based on device heading, and the default heading symbol will display
  * 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.
+ * This component uses the browser's [Geolocation API](https://developer.mozilla.org/docs/Web/API/Geolocation_API) which is only available in [secure contexts](https://developer.mozilla.org/docs/Web/Security/Defenses/Secure_Contexts), such as HTTPS.
  * `localhost` is considered "potentially secure" and can be used for testing.
  *
  * > [!WARNING]
@@ -42,6 +42,15 @@ export abstract class ArcgisTrack extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-track auto-destroy-disabled></arcgis-track>
+   * ```
+   *
+   * ```js
+   * trackElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**
@@ -186,7 +195,7 @@ export abstract class ArcgisTrack extends LitElement {
   accessor referenceElement: ArcgisReferenceElement | string | undefined;
   /**
    * 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)
+   * the Geolocation APIs [`GeolocationCoordinates.heading`](https://developer.mozilla.org/docs/Web/API/GeolocationCoordinates/heading)
    * property. The map will not rotate if the speed is `0`,
    * or if the device is unable to provide heading information.
    *
@@ -219,8 +228,8 @@ export abstract class ArcgisTrack extends LitElement {
    */
   get tracking(): boolean;
   /**
-   * 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.
+   * 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: MapView | SceneView | undefined;
   /**

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

@@ -9,7 +9,7 @@ import { u as y } from "../../chunks/useT9n.js";
 import { m as M } from "../../chunks/useViewModel.js";
 import { g as P } from "../../chunks/globalCss.js";
 import { property as a, subclass as E } from "@arcgis/core/core/accessorSupport/decorators.js";
-import { i as I, b as O } from "../../chunks/async-utils.js";
+import { a as I, b as O } from "../../chunks/async-utils.js";
 import { debounce as C } from "lodash-es";
 import { G as S } from "../../chunks/GeolocationPositioning.js";
 const D = f`.arcgis-button{--calcite-icon-color: var(--calcite-color-text-3);--calcite-button-background-color: var(--calcite-color-foreground-1);color:var(--calcite-color-text-3);line-height:var(--calcite-font-line-height-relative-tight);calcite-button{--calcite-offset-invert-focus: 1}display:flex;flex-flow:column;cursor:pointer;background-color:var(--calcite-color-foreground-1);font-size:var(--calcite-font-size);:hover{--calcite-icon-color: var(--calcite-color-text-1);--calcite-button-background-color: var(--calcite-color-transparent-hover)}}:host{width:fit-content;height:fit-content}`;

package/dist/components/arcgis-unit-radio-button-group/customElement.js

@@ -1,11 +1,11 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import { c as l } from "../../chunks/runtime.js";
-import { css as o, html as e } from "lit";
+import { c as o } from "../../chunks/runtime.js";
+import { css as l, html as e } from "lit";
 import { keyed as n } from "lit/directives/keyed.js";
 import { LitElement as m, createEvent as u } from "@arcgis/lumina";
 import { u as g } from "../../chunks/useT9n.js";
-import { i as d } from "../../chunks/measurementUtils.js";
-const h = o`:host{width:100%}.root{--calcite-label-margin-bottom: 0;width:100%}calcite-radio-button-group{padding:var(--calcite-spacing-sm)}`;
+import { i as h } from "../../chunks/measurementUtils.js";
+const d = l`:host{width:100%}.root{--calcite-label-margin-bottom: 0;width:100%}calcite-radio-button-group{padding:var(--calcite-spacing-sm)}`;
 class p extends m {
   constructor() {
     super(...arguments), this.messages = g({}), this.options = [], this.scale = "m", this.layout = "block", this.arcgisUnitSelectChange = u();
@@ -14,7 +14,7 @@ class p extends m {
     this.properties = { options: [1, { type: Array }], scale: 1, name: 1, value: 0, messageOverrides: 0, label: 1, layout: 1 };
   }
   static {
-    this.styles = h;
+    this.styles = d;
   }
   async destroy() {
     await this.manager.destroy();
@@ -30,10 +30,10 @@ class p extends m {
     } = this;
     return e`<calcite-radio-button-group layout=vertical .name=${i} @calciteRadioButtonGroupChange=${(t) => {
       c.emit(t.target.selectedItem?.value);
-    }} .scale=${this.scale}>${s.map((t) => e`<calcite-label layout=inline .scale=${this.scale}>${n(t, e`<calcite-radio-button .checked=${t === r} .scale=${this.scale} .value=${t}></calcite-radio-button>`)}${d(t) ? a.systems?.[t] : a.units?.[t]?.pluralCapitalized}</calcite-label>`)}</calcite-radio-button-group>`;
+    }} .scale=${this.scale}>${s.map((t) => e`<calcite-label layout=inline .scale=${this.scale}>${n(t, e`<calcite-radio-button .checked=${t === r} .scale=${this.scale} .value=${t}></calcite-radio-button>`)}${h(t) ? a.systems?.[t] : a.units?.[t]}</calcite-label>`)}</calcite-radio-button-group>`;
   }
 }
-l("arcgis-unit-radio-button-group", p);
+o("arcgis-unit-radio-button-group", p);
 export {
   p as ArcgisUnitRadioButtonGroup
 };

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

@@ -22,15 +22,15 @@ class y extends m {
   render() {
     const {
       messages: t,
-      options: l = [],
+      options: i = [],
       // when running in the CI, sometimes this ends up being `undefined`, for unclear reasons.
       selectLabel: s,
-      value: i,
+      value: l,
       arcgisUnitSelectChange: c
     } = this;
     return a`<calcite-label class="root" .layout=${this.layout} .scale=${this.scale}>${s}<calcite-select .label=${s} @calciteSelectChange=${(e) => {
       c.emit(e.target.value);
-    }} .scale=${this.scale}>${o(l, (e) => e, (e) => a`<calcite-option .selected=${e === i} .value=${e}>${g(e) ? t.systems?.[e] : t.units?.[e]?.pluralCapitalized}</calcite-option>`)}</calcite-select></calcite-label>`;
+    }} .scale=${this.scale}>${o(i, (e) => e, (e) => a`<calcite-option .selected=${e === l} .value=${e}>${g(e) ? t.systems?.[e] : t.units?.[e]}</calcite-option>`)}</calcite-select></calcite-label>`;
   }
 }
 r("arcgis-unit-select", y);

package/dist/components/arcgis-utility-network-aggregated-geometry/customElement.d.ts

@@ -9,9 +9,7 @@ import type { T9nMeta } from "@arcgis/lumina/controllers";
  * This is a sub-component used by the **ArcgisUtilityNetworkTraceAnalysis** component.
  *
  * This sub-component renders the aggregated geometry from a `TraceResult` on a view.
- * The component does not project the geometry on the client.
  * This sub-component also renders a "Show graphics" toggle which shows or hides the aggregated geometry graphics.
- *
  * The user can specify a color to render the aggregated geometry graphics in.
  *
  * The map layer with the aggregated geometry graphics is removed on component disconnect.
@@ -43,6 +41,15 @@ export abstract class ArcgisUtilityNetworkAggregatedGeometry extends LitElement
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-utility-network-aggregated-geometry auto-destroy-disabled></arcgis-utility-network-aggregated-geometry>
+   * ```
+   *
+   * ```js
+   * utilityNetworkAggregatedGeometryElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /** @required */