@arcgis/map-components 5.2.0-next.13 → 5.2.0-next.131

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

@@ -0,0 +1,277 @@
+/// <reference path="../../index.d.ts" />
+import type TimeExtent from "@arcgis/core/time/TimeExtent.js";
+import type { PopoverDisplay } from "../arcgis-time-bar/types.js";
+import type { TimeBarViewModel } from "../arcgis-time-bar/TimeBarViewModel.js";
+import type { PublicLitElement as LitElement } from "@arcgis/lumina";
+
+/**
+ * The `arcgis-time-bar-slider` component renders a time-based slider intended for use `arcgis-time-bar`'s "time-extent" slot.
+ *
+ * @slot [content-end] - A slot that displays ticks at the end of the slider. If not provided, default ticks will be rendered.
+ * @slot [max] - A slot that displays a label for the end date of the slider. If not provided, a default label will be rendered.
+ * @slot [min] - A slot that displays a label for the start date of the slider. If not provided, a default label will be rendered.
+ * @slot [popover] - A slot that displays a popover's content while interacting with the slider's thumb or range. If not provided, a default content will be rendered.
+ * @since 5.2
+ * @example
+ * An example of a `<arcgis-time-bar-slider>` slotted into time-bar's `time-extent` slot.
+ * ```html
+ * <arcgis-map basemap="satellite" zoom="6" center="-2,54">
+ *   <arcgis-time-bar show-play show-next show-previous show-time-extent slot="top-right">
+ *     <arcgis-time-bar-slider slot="time-extent"></arcgis-time-bar-slider>
+ *   </arcgis-time-bar>
+ * </arcgis-map>
+ * ```
+ * ```js
+ * <script type="module">
+ *   const [TimeExtent] = await $arcgis.import([
+ *     "@arcgis/core/time/TimeExtent.js",
+ *   ]);
+ *
+ *   const viewElement = document.querySelector("arcgis-map");
+ *   const timeBarElement = document.querySelector("arcgis-time-bar");
+ *   const timeBarSliderElement = document.querySelector("arcgis-time-bar-slider");
+ *
+ *   const [_, timeBar] = await Promise.all([
+ *     viewElement.viewOnReady(),
+ *     timeBarElement.componentOnReady(),
+ *     timeBarSliderElement.componentOnReady(),
+ *   ]);
+ *
+ *   timeBar.fullTimeExtent = new TimeExtent({
+ *     start: new Date(2020, 0, 1),
+ *     end: new Date(2021, 0, 1),
+ *   });
+ * </script>
+ * ```
+ */
+export abstract class ArcgisTimeBarSlider extends LitElement {
+  /**
+   * This property is intended to be used when inserting an element in the "popover" slot.
+   * This property will return either `undefined`, a
+   * [Date](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date) or a
+   * [TimeExtent](https://developers.arcgis.com/javascript/latest/references/core/time/TimeExtent/)
+   * depending on [popoverDisplay](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar-slider/#popoverDisplay) and user interaction.
+   *
+   * When the `popover-display` is set to:
+   * - `"none"`, this property will always return `undefined`
+   * - `"always"`, this property will always return [arcgis-time-bar.timeExtent](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar/#timeExtent),
+   * - `"auto"`, this property will either return a [Date](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date)
+   *             if the user is interacting with a slider thumb, or
+   *             [arcgis-time-bar.timeExtent](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar/#timeExtent) if the user is interacting with a slider track, or
+   *             `undefined` if the user is not interacting with either a slider thumb or slider track.
+   *
+   * @example
+   * The following example demonstrates how to use the `activeValue` property to update the content of a popover while
+   * interacting with the slider's thumb or track.
+   *
+   * When the time-bar-slider's thumb is being dragged, the popover will display the day of the week associated with the thumb's position.
+   *
+   * When the time-bar-slider's track is being dragged, the popover will display the day of the week associated with the start and end of the time extent.
+   *
+   * ```html
+   * <arcgis-map basemap="satellite" zoom="6" center="-2,54">
+   *   <arcgis-time-bar show-play show-next show-previous show-time-extent slot="top-right">
+   *     <arcgis-time-bar-slider slot="time-extent" popover-display="auto">
+   *       <div slot="popover" style="color: red; font-weight: bold; text-align: center; width: 100px;" />
+   *     </arcgis-time-bar-slider>
+   *   </arcgis-time-bar>
+   * </arcgis-map>
+   * ```
+   * ```js
+   * <script type="module">
+   *   const [TimeExtent, TimeInterval, reactiveUtils] = await $arcgis.import([
+   *     "@arcgis/core/time/TimeExtent.js",
+   *     "@arcgis/core/time/TimeInterval.js",
+   *     "@arcgis/core/core/reactiveUtils.js",
+   *   ]);
+   *
+   *   const viewElement = document.querySelector("arcgis-map");
+   *   const timeBarElement = document.querySelector("arcgis-time-bar");
+   *   const timeBarSliderElement = document.querySelector("arcgis-time-bar-slider");
+   *   const popoverSlotElement = timeBarSliderElement.querySelector('[slot="popover"]');
+   *
+   *   const [_, timeBar, timeBarSlider] = await Promise.all([
+   *     viewElement.viewOnReady(),
+   *     timeBarElement.componentOnReady(),
+   *     timeBarSliderElement.componentOnReady(),
+   *   ]);
+   *
+   *   timeBar.fullTimeExtent = new TimeExtent({
+   *     start: new Date(2026, 5, 22),
+   *     end: new Date(2026, 5, 26),
+   *   });
+   *   timeBar.stops = {
+   *     interval: new TimeInterval({
+   *       value: 1,
+   *       unit: "days",
+   *     }),
+   *   };
+   *
+   * reactiveUtils.watch(
+   *   () => timeBarSlider.activeValue,
+   *   (activeValue) => {
+   *     if (!activeValue) {
+   *       popoverSlotElement.innerHTML = "";
+   *     }
+   *
+   *     // A date is returned when the user is interacting with the slider's thumb.
+   *     if (activeValue instanceof Date) {
+   *       popoverSlotElement.innerHTML = activeValue.toLocaleDateString(undefined, { weekday: "long" });
+   *       popoverSlotElement.style.width = "100px";
+   *     }
+   *
+   *     // A time extent is returned when the user is interacting with the slider's track.
+   *     if (activeValue instanceof TimeExtent) {
+   *       const start = activeValue.start?.toLocaleDateString(undefined, { weekday: "long" });
+   *       const end = activeValue.end?.toLocaleDateString(undefined, { weekday: "long" });
+   *       popoverSlotElement.innerHTML = `${start} - ${end}`;
+   *       popoverSlotElement.style.width = "150px";
+   *     }
+   *   },
+   *   { initial: true },
+   * );
+   * </script>
+   * ```
+   */
+  get activeValue(): Date | TimeExtent | null | undefined;
+  /**
+   * 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/components/arcgis-time-bar-slider/#destroy) method when you are done to
+   * prevent memory leaks.
+   *
+   * @default false
+   * @example
+   * ```html
+   * <arcgis-time-bar-slider auto-destroy-disabled></arcgis-time-bar-slider>
+   * ```
+   *
+   * ```js
+   * timeBarSliderElement.autoDestroyDisabled = true;
+   * ```
+   * 
+   */
+  accessor autoDestroyDisabled: boolean;
+  /**
+   * When `true` and the time bar is in `time-window` mode, users will not be able to adjust individual thumbs. The thumbs will maintain a finite stop separation.
+   * This ensures that the time window behaves as a single unit rather than allowing individual thumbs to be moved independently.
+   *
+   * @default false
+   */
+  accessor lockTimeWindow: boolean;
+  accessor messages: {
+      componentLabel: string;
+      count: string;
+      countPrompt: string;
+      date: string;
+      display: string;
+      displayDescription: string;
+      emptyTimeExtent: string;
+      end: string;
+      endDescription: string;
+      everyDurationPartsTemplate: string;
+      everyDurationTemplate: string;
+      formatOptions: {
+          dateAndTime: string;
+          dateOnly: string;
+      };
+      from: string;
+      lockTimeWindow: string;
+      loop: string;
+      mode: string;
+      modeDescription: string;
+      modeOptions: {
+          "cumulative-from-end": string;
+          "cumulative-from-start": string;
+          instant: string;
+          "time-window": string;
+      };
+      next: string;
+      noTimeExtent: string;
+      noTimeZoneAdjustment: string;
+      overview: string;
+      play: string;
+      playbackRate: string;
+      playbackRateDescription: string;
+      previous: string;
+      regularInterval: string;
+      settings: string;
+      start: string;
+      startDescription: string;
+      stop: string;
+      stopOptions: {
+          discreteDates: string;
+          evenlySpaced: string;
+          evenlySpacedTemplate: string;
+          freeMovement: string;
+      };
+      stops: string;
+      stopsDescription: string;
+      through: string;
+      time: string;
+      timeBarSettings: string;
+      timeExtent: string;
+      timeUnitOptions: {
+          day: string;
+          hour: string;
+          millisecond: string;
+          minute: string;
+          month: string;
+          second: string;
+          week: string;
+          year: string;
+      };
+      timeZone: string;
+      timeZoneDescription: string;
+      unit: string;
+      unitPrompt: string;
+      units: string;
+      unlockTimeWindow: string;
+  } | undefined;
+  /**
+   * Defines how and when popovers are displayed for the slider's thumb or range.
+   * When `none`, popovers are not displayed.
+   * When `auto`, popovers are displayed automatically when interacting with a thumb or the slider's range.
+   * When `always`, popovers are always displayed. If the slider is in `time-window` mode, popovers are displayed for the slider range otherwise the thumb.
+   *
+   * @default "none"
+   */
+  accessor popoverDisplay: PopoverDisplay;
+  /**
+   * When `true`, the `arcgis-time-bar-slider` will display a button to toggle the value of the `lockTimeWindow` property.
+   * The button will appear depressed when `lockTimeWindow` is `true`.
+   * The button will appear disabled when the mode is not `time-window`.
+   *
+   * @default false
+   */
+  accessor showLockTimeWindow: boolean;
+  /**
+   * When `true`, displays a label for the end date of the slider.
+   * The contents of this label can be customized by providing a slotted element in the "max" slot.
+   *
+   * @default false
+   */
+  accessor showMax: boolean;
+  /**
+   * When `true`, displays a label for the start date of the slider.
+   * The contents of this label can be customized by providing a slotted element in the "min" slot.
+   *
+   * @default false
+   */
+  accessor showMin: boolean;
+  /**
+   * When `true`, displays tick marks and labels beneath the slider.
+   *
+   * @default false
+   */
+  accessor showTicks: boolean;
+  /**
+   * The view model for the time bar slider.
+   *
+   * @internal
+   */
+  accessor viewModel: TimeBarViewModel | undefined;
+  /** Permanently destroy the component. */
+  destroy(): Promise<void>;
+}

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

@@ -0,0 +1,191 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+import { c as d } from "../../chunks/runtime.js";
+import { css as m, html as r } from "lit";
+import { ref as u } from "lit/directives/ref.js";
+import l from "@arcgis/core/time/TimeExtent.js";
+import { LitElement as h, nothing as v, safeClassMap as g } from "@arcgis/lumina";
+const w = m`: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;--arcgis-internal-time-bar-slider-tick-gap: 100}.root{align-items:center;block-size:100%;display:flex;inline-size:100%}slot[name=max],slot[name=min]{display:flex}.slider{padding-inline:var(--calcite-spacing-md);--labels-container-width: 100%}.slider-container{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%;arcgis-ticks,>slot::slotted(arcgis-ticks){inset:0;position:absolute;white-space:nowrap;--arcgis-ticks-font-weight: var(--calcite-font-weight-normal);--arcgis-ticks-label-width: auto;--arcgis-ticks-tick-transform: unset;--arcgis-ticks-tick-width: var(--calcite-size-px)}}.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 f extends h {
+  constructor() {
+    super(...arguments), this.#t = new ResizeObserver(([e]) => {
+      this._sliderWidth = e.contentRect.width;
+    }), this.#a = 100, this.#r = 100, this.autoDestroyDisabled = !1, this.lockTimeWindow = !1, this.popoverDisplay = "none", this.showLockTimeWindow = !1, this.showMax = !1, this.showMin = !1, this.showTicks = !1;
+  }
+  static {
+    this.properties = { _activeValue: 16, _sliderFillPlacement: 16, _sliderWidth: 16, _timeExtentEpochValues: 16, activeValue: 32, autoDestroyDisabled: 5, lockTimeWindow: 5, messages: 0, popoverDisplay: 1, showLockTimeWindow: 5, showMax: 5, showMin: 5, showTicks: 5, viewModel: 0 };
+  }
+  static {
+    this.styles = w;
+  }
+  #t;
+  #i;
+  #s;
+  #e;
+  #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 { fullTimeExtent: i } = e;
+    if (!i)
+      return;
+    const { start: t, end: s } = i;
+    if (!t || !s)
+      return;
+    const { timeExtent: a } = e;
+    if (!a)
+      switch (e.mode) {
+        case "cumulative-from-end":
+        case "instant":
+          return [t.getTime()];
+        case "cumulative-from-start":
+          return [s.getTime()];
+        case "time-window":
+          return [t.getTime(), s.getTime()];
+      }
+    const { start: o, end: n } = a;
+    switch (e.mode) {
+      case "cumulative-from-end":
+      case "instant":
+        return o ? o.getTime() < t.getTime() ? [t.getTime()] : o.getTime() > s.getTime() ? [s.getTime()] : [o.getTime()] : void 0;
+      case "cumulative-from-start":
+        return n ? n.getTime() < t.getTime() ? [t.getTime()] : n.getTime() > s.getTime() ? [s.getTime()] : [n.getTime()] : void 0;
+      case "time-window":
+        return o && n ? [o.getTime(), n.getTime()] : void 0;
+    }
+  }
+  get activeValue() {
+    switch (this.popoverDisplay) {
+      case "none":
+        return;
+      case "always":
+        return this.viewModel?.timeExtent;
+      case "auto":
+        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();
+  }
+  #n() {
+    return (e) => {
+      if (e) {
+        this.#e = e, this.#t.observe(e);
+        return;
+      }
+      this.#e && (this.#t.unobserve(this.#e), this.#e = void 0);
+    };
+  }
+  #o() {
+    const e = Number.parseInt(window.getComputedStyle(this.el).getPropertyValue("--arcgis-internal-time-bar-slider-tick-gap"), 10);
+    return Number.isFinite(e) && e > 0 ? e : this.#a;
+  }
+  #l(e, i) {
+    const { viewModel: t } = this, { start: s, end: a } = e;
+    if (!t || !s || !a)
+      return;
+    const n = (a.getTime() - s.getTime()) / i;
+    return t.tickFormats.find(({ duration: c }) => c > this.#o() * n) ?? t.tickFormats.at(-1);
+  }
+  #c() {
+    this.lockTimeWindow = !this.lockTimeWindow;
+  }
+  #d(e) {
+    this._activeValue = e.target.activeValue;
+  }
+  #m(e) {
+    const { viewModel: i } = this, t = i?.mode;
+    t && (i.timeExtent = this.#u(e.target.values, t), this._activeValue = e.target.activeValue);
+  }
+  #u([e, i], t) {
+    switch (t) {
+      case "cumulative-from-end":
+        return new l({ start: new Date(e), end: null });
+      case "cumulative-from-start":
+        return new l({ start: null, end: new Date(e) });
+      case "instant":
+        return new l({ start: new Date(e), end: new Date(e) });
+      case "time-window":
+        return new l({ start: new Date(e), end: new Date(i ?? e) });
+    }
+  }
+  #h() {
+    const { messages: e, showLockTimeWindow: i, viewModel: t } = this;
+    if (!e || !i || !t)
+      return null;
+    const s = this.lockTimeWindow ? "lock" : "unlock", a = this.lockTimeWindow ? e.unlockTimeWindow : e.lockTimeWindow;
+    return r`<calcite-action .active=${this.lockTimeWindow} .disabled=${t.disabled || t.mode !== "time-window"} .icon=${s} @click=${this.#c} .text=${a} title=${a ?? v}></calcite-action>`;
+  }
+  #v() {
+    const e = this.viewModel?.fullTimeExtent?.end;
+    return this.showMax && e ? r`<slot name=max><arcgis-time-bar-date .autoDestroyDisabled=${this.autoDestroyDisabled} class="max-date" .date=${e} .viewModel=${this.viewModel}></arcgis-time-bar-date></slot>` : r`<div class="hidden"></div>`;
+  }
+  #g() {
+    const e = this.viewModel?.fullTimeExtent?.start;
+    return this.showMin && e ? r`<slot name=min><arcgis-time-bar-date .autoDestroyDisabled=${this.autoDestroyDisabled} class="min-date" .date=${e} .viewModel=${this.viewModel}></arcgis-time-bar-date></slot>` : r`<div class="hidden"></div>`;
+  }
+  #w() {
+    return this.popoverDisplay !== "none" ? r`<div class="popover" slot=popover><slot name=popover>${this.#f()}</slot></div>` : null;
+  }
+  #f() {
+    const { activeValue: e, messages: i, viewModel: t } = this;
+    if (!e || !i || !t)
+      return null;
+    switch (t.mode) {
+      case "cumulative-from-end":
+      case "instant":
+        const s = t.timeExtent?.start;
+        return s ? r`<arcgis-time-bar-date .autoDestroyDisabled=${this.autoDestroyDisabled} .date=${s} .viewModel=${t}></arcgis-time-bar-date>` : null;
+      case "cumulative-from-start":
+        const a = t.timeExtent?.end;
+        return a ? r`<arcgis-time-bar-date .autoDestroyDisabled=${this.autoDestroyDisabled} .date=${a} .viewModel=${t}></arcgis-time-bar-date>` : null;
+      case "time-window":
+        return e instanceof Date ? r`<arcgis-time-bar-date .autoDestroyDisabled=${this.autoDestroyDisabled} .date=${e} .viewModel=${t}></arcgis-time-bar-date>` : r`<arcgis-time-bar-extent .autoDestroyDisabled=${this.autoDestroyDisabled} .messages=${i} .viewModel=${t}></arcgis-time-bar-extent>`;
+    }
+  }
+  #p() {
+    const { messages: e, viewModel: i } = this;
+    if (!i?.fullTimeExtent?.start || !i?.fullTimeExtent?.end || !e)
+      return null;
+    const t = this.#l(i.fullTimeExtent, this._sliderWidth ?? this.#r);
+    if (!t)
+      return null;
+    (!this.#i || !this.#s || this.#i !== t) && (this.#i = t, this.#s = i.getTickValues(t.timeInterval), i.tickFormat = t.format);
+    const s = i.fullTimeExtent.start.getTime(), a = i.fullTimeExtent.end.getTime();
+    return r`<div class="slider-container" ${u(this.#n())}><arcgis-slider allow-values-overlap .autoDestroyDisabled=${this.autoDestroyDisabled} class=${g({
+      slider: !0,
+      "slider--has-ticks": this.showTicks,
+      "slider--out-of-range": i.isOutOfRange
+    })} .disabled=${!i.interactive} .fillPlacement=${this._sliderFillPlacement} .max=${a} .min=${s} @arcgisActiveValueChange=${this.#d} @arcgisInput=${this.#m} .popoverLabel=${e.timeExtent} .popoverDisplay=${this.popoverDisplay === "none" ? "auto" : this.popoverDisplay} precision=0 .steps=${i.effectiveStopsEpoch} .values=${this._timeExtentEpochValues}>${this.#w()}${this.#T(i, s, a)}</arcgis-slider></div>`;
+  }
+  #T(e, i, t) {
+    return this.showTicks ? r`<div slot=content-end class="ticks-container"><slot name=content-end><arcgis-ticks .autoDestroyDisabled=${this.autoDestroyDisabled} .labelFormatter=${e.tickFormatter} .max=${t} .min=${i} mode=value show-labels .values=${this.#s}></arcgis-ticks></slot></div>` : null;
+  }
+  render() {
+    return r`<div class="root">${this.#h()}${this.#g()}${this.#p()}${this.#v()}</div>`;
+  }
+}
+d("arcgis-time-bar-slider", f);
+export {
+  f 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,6 @@
+import "@esri/calcite-components/components/calcite-action";
+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

@@ -86,10 +86,19 @@ 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;
   /**
-   * When true, the component is visually withdrawn and cannot receive user interaction.
+   * When true, the component is visually de-emphasized and does not accept user interaction.
    *
    * @default false
    * @example
@@ -188,9 +197,9 @@ 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.avif"> |
-   * 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.avif"> |
-   * 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.avif"> |
+   * 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"
@@ -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
@@ -493,7 +502,7 @@ export abstract class ArcgisTimeSlider extends LitElement {
   };
   /** 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: "effectiveStops" | "fullTimeExtent" | "timeExtent" | "state"; }>;
-  /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
+  /** Emitted when the component associated with a map or scene view is ready for user interaction. */
   readonly arcgisReady: import("@arcgis/lumina").TargetedEvent<this, void>;
   /** Emitted when an action is triggered on the component. */
   readonly arcgisTriggerAction: import("@arcgis/lumina").TargetedEvent<this, TimeSliderViewModelTriggerActionEvent>;

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

@@ -1,7 +1,7 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
 import { c as i } from "../../chunks/runtime.js";
 import { usePropertyChange as r } from "@arcgis/lumina/controllers";
-import { reEmitEvent as t } from "@arcgis/lumina/controllers/accessor";
+import { reEmitEvent as t } from "@arcgis/lumina-toolkit/reEmitEvent";
 import o from "@arcgis/core/widgets/TimeSlider.js";
 import { LitElement as s, createEvent as a } from "@arcgis/lumina";
 import { m as l } from "../../chunks/useWidget.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";