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

package/dist/components/arcgis-table-list/customElement.d.ts

@@ -4,22 +4,58 @@ import type MapView from "@arcgis/core/views/MapView";
 import type LinkChartView from "@arcgis/core/views/LinkChartView";
 import type TableListListItem from "@arcgis/core/widgets/TableList/ListItem";
 import type Collection from "@arcgis/core/core/Collection";
-import type WebScene from "@arcgis/core/WebScene.js";
 import type WebMap from "@arcgis/core/WebMap.js";
+import type WebScene from "@arcgis/core/WebScene.js";
 import type Collection2 from "@arcgis/core/core/Collection.js";
 import type ListItem from "@arcgis/core/widgets/TableList/ListItem.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
-import type { ArcgisReferenceElement } from "../../utils/component-utils.js";
-import type { IconName } from "../../utils/action-utils.js";
+import type { ArcgisReferenceElement, IconName } from "../types.js";
 import type { TableListViewModelTriggerActionEvent } from "@arcgis/core/widgets/TableList/TableListViewModel";
 import type { FilterPredicate } from "@arcgis/core/widgets/TableList.js";
 import type { Icon } from "@esri/calcite-components/components/calcite-icon";
 import type { ListItemModifier, State } from "@arcgis/core/widgets/TableList/types.js";
 
 /**
- * The Table List component provides a way to display a list of tables associated with a [Map](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html).
+ * The Table List component provides a way to display a list of tables associated with a [Map](https://developers.arcgis.com/javascript/latest/references/core/Map/).
+ * It is meant to be used with [feature layer](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/) tables.
+ *
+ * If a map contains feature layer tables, they will display within the component. Tables can also be added to the Map's
+ * [tables](https://developers.arcgis.com/javascript/latest/references/core/Map/#tables) collection. Any tables referenced in the [map](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-table-list/#map)
+ * property will display in the component. If unsure of whether the layer is a table, check the feature layer's
+ * [isTable](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#isTable) property.
+ *
+ * The [ListItem](https://developers.arcgis.com/javascript/latest/references/core/widgets/TableList/ListItem/) API provides access to each table, allows
+ * the developer to configure actions related to the table, and allows the developer to add content to the item related to the table.
+ *
+ *
+ * **Known Limitations**
+ * * The TableList component is not supported with [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/).
  *
  * @since 4.28
+ * @example
+ * ```js
+ *
+ * const tableListElement = document.createElement("arcgis-table-list");
+ * tableListElement.referenceElement = viewElement;
+ * tableListElement.slot = "top-left";
+ * viewElement.appendChild(tableListElement);
+ *
+ * const layer = Layer.fromPortalItem({
+ *   // Loads a layer (table) from a portal item
+ *   portalItem: {
+ *     id: "add portal item id"
+ *   }
+ * });
+ *
+ * // Wait for the layer to load
+ * await layer.load()
+ *
+ * // Check if the layer is a table
+ * if (layer.isTable) {
+ *  // Add the table to the map's tables collection
+ *   viewElement.map.tables.add(layer);
+ * }
+ * ```
  */
 export abstract class ArcgisTableList extends LitElement {
   /**
@@ -46,46 +82,60 @@ export abstract class ArcgisTableList extends LitElement {
    * @default false
    * @since 4.29
    * @see [showCollapseButton](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-table-list/#showCollapseButton)
-   * @example tableList.collapsed = true;
+   * @example
+   * ```js
+   * tableListElement.collapsed = true;
+   * ```
    */
   accessor collapsed: boolean;
   /**
-   * Indicates whether [list items](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TableList-ListItem.html) may be reordered within the list by dragging and dropping.
-   * Drag won't be enabled until the number of list items is equal to or greater than than the value set set in [minDragEnabledItems](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TableList.html#minDragEnabledItems).
+   * Indicates whether [list items](https://developers.arcgis.com/javascript/latest/references/core/widgets/TableList/ListItem/) may be reordered within the list by dragging and dropping.
+   * Drag won't be enabled until the number of list items is equal to or greater than than the value set set in [minDragEnabledItems](https://developers.arcgis.com/javascript/latest/references/core/widgets/TableList/#minDragEnabledItems).
    *
    * @default false
    * @since 4.29
-   * @see [minDragEnabledItems](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TableList.html#minDragEnabledItems)
-   * @example tableList.dragEnabled = true;
+   * @see [minDragEnabledItems](https://developers.arcgis.com/javascript/latest/references/core/widgets/TableList/#minDragEnabledItems)
+   * @example
+   * ```js
+   * tableListElement.dragEnabled = true;
+   * ```
    */
   accessor dragEnabled: boolean;
   /**
-   * Placeholder text used in the filter input if [visibleElements.filter](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TableList.html#visibleElements) is true.
+   * Placeholder text used in the filter input if [showFilter](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-table-list/#showFilter) is true.
    *
    * @default ""
    * @since 4.29
    * @see [showFilter](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-table-list/#showFilter)
-   * @example tableList.filterPlaceholder = "Filter layers";
+   * @example
+   * ```js
+   * tableListElement.filterPlaceholder = "Filter layers";
+   * ```
    */
   accessor filterPlaceholder: string;
   /**
-   * Specifies a function to handle filtering [list items](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TableList-ListItem.html).
+   * Specifies a function to handle filtering [list items](https://developers.arcgis.com/javascript/latest/references/core/widgets/TableList/ListItem/).
    *
    * @since 4.32
-   * @example layerList.filterPredicate = (item) => item.title.toLowerCase().includes("streets");
+   * @example
+   * ```js
+   * tableListElement.filterPredicate = (item) => item.title.toLowerCase().includes("streets");
+   * ```
    */
   accessor filterPredicate: FilterPredicate | null | undefined;
   /**
-   * The value of the filter input text string if [visibleElements.filter](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TableList.html#visibleElements) is true.
+   * The value of the filter input text string if [showFilter](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-table-list/#showFilter) is true.
    *
    * @default ""
    * @since 4.29
-   * @see [visibleElements.filter](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TableList.html#visibleElements)
+   * @see [showFilter](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-table-list/#showFilter)
    * @example
+   * ```js
    * reactiveUtils.watch(
-   *   () => tableList.filterText,
+   *   () => tableListElement.filterText,
    *   (filterText) => console.log(filterText)
    * );
+   * ```
    */
   accessor filterText: string;
   /**
@@ -112,78 +162,61 @@ export abstract class ArcgisTableList extends LitElement {
    */
   accessor label: string;
   /**
-   * Specifies a function that accesses each [ListItem](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TableList-ListItem.html).
+   * Specifies a function that accesses each [ListItem](https://developers.arcgis.com/javascript/latest/references/core/widgets/TableList/ListItem/).
    * Each list item can be modified according to its modifiable properties. Actions can be added
-   * to list items using the [ListItem#actionsSections](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TableList-ListItem.html#actionsSections)
+   * to list items using the [ListItem#actionsSections](https://developers.arcgis.com/javascript/latest/references/core/widgets/TableList/ListItem/#actionsSections)
    * property of the ListItem.
    *
    * @example
-   * const tableList = new TableList({
-   *   map: map,
-   *   listItemCreatedFunction: (event) => {
-   *     const { item } = event;
-   *     item.actionsSections = [
-   *       [
-   *         {
-   *           title: "Go to full extent",
-   *           icon: "layer-zoom-to",
-   *           id: "full-extent"
-   *         }
-   *       ]
-   *     ];
-   *    }
-   * });
+   * ```js
+   * tableListElement.listItemCreatedFunction = (event) => {
+   *   const { item } = event;
+   *   item.actionsSections = [
+   *     [
+   *       {
+   *         title: "Open in feature table",
+   *         icon: "table",
+   *         id: "open-table"
+   *       }
+   *     ]
+   *   ];
+   *  }
+   * ```
    */
   accessor listItemCreatedFunction: ListItemModifier | null | undefined;
   /**
-   * A reference to a [Map](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html) containing the tables. Set this property
+   * A reference to a [Map](https://developers.arcgis.com/javascript/latest/references/core/Map/) containing the tables. Set this property
    * to access the underlying tables within the map.
    *
    * @since 4.34
-   * @see [Map#tables](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html#tables)
-   * @see [WebMap#tables](https://developers.arcgis.com/javascript/latest/api-reference/esri-WebMap.html#tables)
-   * @example
-   * Layer.fromPortalItem({
-   *   // Loads a layer (table) from a portal item
-   *   portalItem: { // autocasts new PortalItem()
-   *     id: "add portal item id"
-   *   }
-   * }).then(function(layer) {
-   *   // Load the layer
-   *   layer.load().then(function() {
-   *     // Check if the layer is a table
-   *     if (layer.isTable) {
-   *       map.tables.add(layer);
-   *       console.log(map.tables);
-   *     }
-   *   });
-   * });
-   *
-   * const tableList = new TableList({
-   *   map: map //  map contains tables collection
-   * });
+   * @see [Map#tables](https://developers.arcgis.com/javascript/latest/references/core/Map/#tables)
+   * @see [WebMap#tables](https://developers.arcgis.com/javascript/latest/references/core/WebMap/#tables)
    */
-  accessor map: WebScene | WebMap | null | undefined;
+  accessor map: WebMap | WebScene | null | undefined;
   /**
-   * The minimum number of list items required to enable drag and drop reordering with [dragEnabled](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TableList.html#dragEnabled).
+   * The minimum number of list items required to enable drag and drop reordering with [dragEnabled](https://developers.arcgis.com/javascript/latest/references/core/widgets/TableList/#dragEnabled).
    *
    * @default 2
    * @since 4.29
-   * @see [dragEnabled](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TableList.html#dragEnabled)
+   * @see [dragEnabled](https://developers.arcgis.com/javascript/latest/references/core/widgets/TableList/#dragEnabled)
    * @example
-   * tableList.dragEnabled = true;
-   * tableList.minDragEnabledItems = 5;
+   * ```js
+   * tableListElement.dragEnabled = true;
+   * tableListElement.minDragEnabledItems = 5;
+   * ```
    */
   accessor minDragEnabledItems: number;
   /**
-   * The minimum number of list items required to display the [visibleElements.filter](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TableList-TableListVisibleElements.html) input box.
+   * The minimum number of list items required to display the [showFilter](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-table-list/#showFilter) input box.
    *
    * @default 10
    * @since 4.29
    * @see [showFilter](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-table-list/#showFilter)
    * @example
-   * tableList.showFilter = true;
-   * tableList.minFilterItems = 5;
+   * ```js
+   * tableListElement.showFilter = true;
+   * tableListElement.minFilterItems = 5;
+   * ```
    */
   accessor minFilterItems: number;
   /**
@@ -193,15 +226,15 @@ export abstract class ArcgisTableList extends LitElement {
    */
   accessor referenceElement: ArcgisReferenceElement | string | undefined;
   /**
-   * A collection of selected [ListItem](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TableList-ListItem.html)s representing table list items
+   * A collection of selected [ListItem](https://developers.arcgis.com/javascript/latest/references/core/widgets/TableList/ListItem/)s representing table list items
    * selected by the user.
    *
-   * @see [selectionMode](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TableList.html#selectionMode)
+   * @see [selectionMode](https://developers.arcgis.com/javascript/latest/references/core/widgets/TableList/#selectionMode)
    */
   accessor selectedItems: Collection2<ListItem>;
   /**
    * Specifies the selection mode.
-   * Selected items are available in the [selectedItems](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TableList.html#selectedItems) property.
+   * Selected items are available in the [selectedItems](https://developers.arcgis.com/javascript/latest/references/core/widgets/TableList/#selectedItems) property.
    *
    * | Value | Description |
    * | ----- | ----------- |
@@ -212,10 +245,13 @@ export abstract class ArcgisTableList extends LitElement {
    *
    * @default "none"
    * @since 4.29
-   * @see [selectedItems](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TableList.html#selectedItems)
-   * @example tableList.selectionMode = "multiple";
+   * @see [selectedItems](https://developers.arcgis.com/javascript/latest/references/core/widgets/TableList/#selectedItems)
+   * @example
+   * ```js
+   * tableListElement.selectionMode = "multiple";
+   * ```
    */
-  accessor selectionMode: "none" | "multiple" | "single" | "single-persist";
+  accessor selectionMode: "multiple" | "single" | "none" | "single-persist";
   /**
    * Indicates whether to display a close button in the header.
    *
@@ -238,21 +274,21 @@ export abstract class ArcgisTableList extends LitElement {
    */
   accessor showErrors: boolean;
   /**
-   * Indicates whether to display a filter input box when then number of list items is equal to or greater than the value set in [TableList#minFilterItems](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TableList.html#minFilterItems), allowing users to filter tables by their title.
+   * Indicates whether to display a filter input box when then number of list items is equal to or greater than the value set in [TableList#minFilterItems](https://developers.arcgis.com/javascript/latest/references/core/widgets/TableList/#minFilterItems), allowing users to filter tables by their title.
    *
    * @default false
    * @since 5.0
    */
   accessor showFilter: boolean;
   /**
-   * Indicates whether to display the table list heading. The heading text is "Table List". The heading level can be set with the [TableList#headingLevel](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TableList.html#headingLevel).
+   * Indicates whether to display the table list heading. The heading text is "Table List". The heading level can be set with the [TableList#headingLevel](https://developers.arcgis.com/javascript/latest/references/core/widgets/TableList/#headingLevel).
    *
    * @default false
    * @since 5.0
    */
   accessor showHeading: boolean;
   /**
-   * Indicates whether temporary table indicators will be displayed for tables with [Layer#persistenceEnabled](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-Layer.html#persistenceEnabled) set to `false`. A [temporary icon](https://developers.arcgis.com/calcite-design-system/icons/?icon=temporary&library=Calcite%20UI&query=temporary) will be displayed on the near side of the table title.
+   * Indicates whether temporary table indicators will be displayed for tables with [Layer#persistenceEnabled](https://developers.arcgis.com/javascript/latest/references/core/layers/Layer/#persistenceEnabled) set to `false`. A [temporary icon](https://developers.arcgis.com/calcite-design-system/icons/?icon=temporary&library=Calcite%20UI&query=temporary) will be displayed on the near side of the table title.
    *
    * @default false
    * @since 5.0

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

@@ -55,4 +55,5 @@ export abstract class ArcgisTimeOfDaySlider extends LitElement {
   };
 }
 
+/** @internal */
 export type Mode = "range" | "single";

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

@@ -5,7 +5,7 @@ import { substitute as T } from "@arcgis/core/intl.js";
 import { LitElement as v, createEvent as f, safeClassMap as _ } from "@arcgis/lumina";
 import { css as F, html as d } from "lit";
 import { u as L } from "../../chunks/useT9n.js";
-import { c as s } from "../../chunks/time-utils.js";
+import { c as i } from "../../chunks/time-utils.js";
 const w = F`:host{display:block}arcgis-slider{--arcgis-slider-handle-size: .875rem;--ticks-font-size: .625rem;--label-font-size: .75rem;--label-padding-block-start: 3px;--label-padding-block-end: var(--calcite-spacing-lg);--calcite-font-size-sm: var(--label-font-size);display:block;margin-block-start:var(--padding-block-start, -.5rem);padding-block-end:var(--padding-block-end, .3rem);&.wrap-labels{padding-block-end:var(--wrapped-padding, .875rem)}}:host([visual-scale="s"]) arcgis-slider{--arcgis-slider-handle-size: .625rem;--ticks-font-size: .625rem;--label-font-size: .625rem;--label-padding-block-end: 1rem;--padding-block-end: .5rem;--wrapped-padding: 1.1rem}:host([visual-scale="l"]) arcgis-slider{--arcgis-slider-handle-size: 1rem;--ticks-font-size: .75rem;--label-font-size: .875rem;--label-padding-block-end: .94rem;--padding-block-end: .4rem;--wrapped-padding: 1.1rem}.ticks-container{width:100%;position:relative}.time-range-label{position:relative;width:100%;padding-block-start:var(--label-padding-block-start);padding-block-end:var(--label-padding-block-end);font-size:var(--label-font-size);font-variant-numeric:tabular-nums;line-height:1em;text-align:center}.main-ticks,.secondary-ticks{position:absolute;inset:0}.main-ticks{--arcgis-ticks-label-width: min-content;--arcgis-ticks-label-text-align: center;--arcgis-ticks-font-size: var(--ticks-font-size);white-space:nowrap;word-break:auto-phrase;font-variant-numeric:tabular-nums}.wrap-labels .main-ticks{white-space:normal}.secondary-ticks{--arcgis-ticks-tick-length: 3px;--arcgis-ticks-gap: 16px}`;
 class z extends v {
   constructor() {
@@ -23,7 +23,7 @@ class z extends v {
   _getSliderLabelFormatter(e) {
     const t = new Intl.DateTimeFormat(e, h);
     return (a) => {
-      const n = s(a, "minutes", "milliseconds"), m = new Date(n);
+      const n = i(a, "minutes", "milliseconds"), m = new Date(n);
       let r = t.format(m);
       return n !== 0 && r === "00:00" && (r = "24:00"), r;
     };
@@ -31,14 +31,14 @@ class z extends v {
   _getTickLabelFormatter(e) {
     const t = new Intl.DateTimeFormat(e, h), a = new Intl.DateTimeFormat(e, y);
     return (n) => {
-      const m = Math.round(s(n, "minutes", "hours")), r = s(m, "hours", "milliseconds"), c = new Date(r);
-      let i = t.format(c);
-      if (i.includes(" ")) {
-        i = a.format(c), i = i.replace(":00", "");
+      const m = Math.round(i(n, "minutes", "hours")), r = i(m, "hours", "milliseconds"), c = new Date(r);
+      let s = t.format(c);
+      if (s.includes(" ")) {
+        s = a.format(c), s = s.replace(":00", "");
         const b = "⁠";
-        i = i.split(" ").map((p) => Array.from(p).join(b)).join(" ");
+        s = s.split(" ").map((p) => Array.from(p).join(b)).join(" ");
       }
-      return i;
+      return s;
     };
   }
   _setStartTime(e) {
@@ -53,7 +53,7 @@ class z extends v {
   }
   render() {
     const e = this.mode === "single" && !this.disabled;
-    return k(this.messages._lang, d`<arcgis-slider .ariaLabel=${this.label} class=${_({ "wrap-labels": this._shouldWrapLabels })} .disabled=${this.disabled} fill-placement=none .labelFormatter=${this._sliderLabelFormatter} layout=horizontal min=0 .max=${o} .steps=${this.steps ?? 1} .valueLabelsDisplay=${this.mode === "range" ? "hidden" : "always"} value-labels-placement=leading .values=${this._values} @arcgisInput=${({ currentTarget: { values: t } }) => {
+    return k(this.messages._lang, d`<arcgis-slider .ariaLabel=${this.label} class=${_({ "wrap-labels": this._shouldWrapLabels })} .disabled=${this.disabled} fill-placement=none .labelFormatter=${this._sliderLabelFormatter} layout=horizontal min=0 .max=${o} .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=${o} mode=value show-labels .values=${g} @arcgisTickClick=${(t) => this._setStartTime(t.detail.value)}></arcgis-ticks><arcgis-ticks class="secondary-ticks" layout=horizontal min=0 .max=${o} mode=value .values=${$} @arcgisTickClick=${(t) => this._setStartTime(t.detail.value)}></arcgis-ticks></div></arcgis-slider>`);
   }
@@ -62,9 +62,9 @@ class z extends v {
     return d`<div class="time-range-label" aria-live=polite slot=content-start>${T(a ?? "{start} — {end}", { start: e, end: t })}</div>`;
   }
 }
-const o = s(24, "hours", "minutes") - 1, g = [0, 6, 12, 18].map((l) => s(l, "hours", "minutes"));
+const o = i(24, "hours", "minutes") - 1, g = [0, 6, 12, 18].map((l) => i(l, "hours", "minutes"));
 g.push(o);
-const $ = [2, 4, 8, 10, 14, 16, 20, 22].map((l) => s(l, "hours", "minutes")), h = {
+const $ = [2, 4, 8, 10, 14, 16, 20, 22].map((l) => i(l, "hours", "minutes")), h = {
   hour: "numeric",
   minute: "numeric",
   timeZone: "UTC"

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

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

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

@@ -1,13 +1,12 @@
 /// <reference path="../../index.d.ts" />
 import type MapView from "@arcgis/core/views/MapView";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
-import type { ArcgisReferenceElement } from "../../utils/component-utils.js";
-import type { UIPosition } from "@arcgis/core/views/ui/types";
+import type { ArcgisReferenceElement } from "../types.js";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
 import type { Icon as Icon } from "@esri/calcite-components/components/calcite-icon";
 
 /**
- * Time Zone Label is a component for displaying the current [time zone](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/#timeZone) of a [Map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/).
+ * Time Zone Label is a component for displaying the current [time zone](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#timeZone) of a [Map](https://developers.arcgis.com/javascript/latest/references/map-components/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.
@@ -27,7 +26,7 @@ export abstract class ArcgisTimeZoneLabel extends LitElement {
       noAdjustment: string;
   }>;
   /**
-   * When `true`, sets the component to a disabled state so the user cannot interact with it.
+   * When true, the component is visually withdrawn and cannot receive user interaction.
    *
    * @default false
    */
@@ -35,8 +34,12 @@ export abstract class ArcgisTimeZoneLabel extends LitElement {
   /**
    * 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.
+   * By default, the component will expand inward if assigned to a slotted corner. If the component is positioned manually,
+   * the component will expand towards the "end" which is equivalent to right in a left-to-right application.
+   *
+   * > [!WARNING]
+   * >
+   * > This setting may be ignored if due to the component's position within the map, there is insufficient space to expand in the requested direction.
    */
   get expandDirection(): ExpandDirection;
   set expandDirection(value: ExpandDirection | undefined);
@@ -66,11 +69,18 @@ export abstract class ArcgisTimeZoneLabel extends LitElement {
       componentLabel?: string | undefined;
       noAdjustment?: string | undefined;
   };
-  /** @default "top-left" */
-  accessor position: UIPosition;
+  /**
+   * By assigning the `id` attribute of the Map or Scene component to this property, you can position a child component anywhere in the DOM while still maintaining a connection to the Map or Scene.
+   *
+   * @see [Associate components with a Map or Scene component](https://developers.arcgis.com/javascript/latest/programming-patterns/#associate-components-with-a-map-or-scene-component)
+   */
   accessor referenceElement: ArcgisReferenceElement | string | undefined;
   /** The state of the component. */
   get state(): State;
+  /**
+   * The view associated with the component. 
+   *   > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the arcgis-time-zone-label component will be associated with a map or scene component rather than using the `view` property.
+   */
   accessor view: MapView | undefined;
   "@setterTypes": {
     expandDirection?: ExpandDirection | undefined;