@arcgis/map-components 5.0.0-next.12 → 5.0.0-next.121

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

@@ -1,4 +1,3 @@
-/// <reference types="@arcgis/core/interfaces.d.ts" />
 /// <reference path="../../index.d.ts" />
 import { default as SwipeViewModel } from '@arcgis/core/widgets/Swipe/SwipeViewModel.js';
 import { JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
@@ -11,7 +10,7 @@ declare const useSwipeViewModel: (component: LitElement & Pick<SwipeViewModel, n
  * on top of a map. Layers can be swiped vertically or horizontally to easily
  * compare two layers or see what is underneath a layer.
  *
- * To use the Swipe component, set the `leadingLayers` and `trailingLayers`
+ * To use the Swipe component, set the `startLayers` and `endLayers`
  * properties to determine what will be compared on either side of the component. If one of these properties
  * is not set, then the Swipe component will overlay the existing map.
  *
@@ -22,13 +21,15 @@ declare const useSwipeViewModel: (component: LitElement & Pick<SwipeViewModel, n
  * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-swipe/)
  *
  * @since 4.31
+ * @see [Sample - Swipe component](https://developers.arcgis.com/javascript/latest/sample-code/swipe/)
+ * @see [Sample - Swipe component with scroll](https://developers.arcgis.com/javascript/latest/sample-code/swipe-scroll/)
  */
 export declare class ArcgisSwipe extends LitElement {
     /**
      * The view associated with the component.
-     *   > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the ArcgisSwipe component will be associated with a map or scene component rather than using the `view` property.
+     *   > **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 Swipe component will be associated with a map or scene component rather than using the `view` property.
      */
-    view?: __esri.MapView | nullish;
+    view?: import('@arcgis/core/views/MapView').default | 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
@@ -46,13 +47,19 @@ export declare class ArcgisSwipe extends LitElement {
      *
      * @default "horizontal"
      */
-    direction: "horizontal" | "vertical";
+    direction: import('@arcgis/core/widgets/Swipe/types').Direction;
     /**
      * When `true`, sets the component to a disabled state so the user cannot interact with it.
      *
      * @default false
      */
     disabled: boolean;
+    /**
+     * A collection of layers that will show on the right or bottom side of the Swipe component.
+     *
+     * @see [trailingLayers](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Swipe-SwipeViewModel.html#trailingLayers)
+     */
+    endLayers: import('@arcgis/core/core/Collection').default<import('@arcgis/core/layers/Layer').default>;
     /**
      * When `true`, the divider between the leading and trailing layers will be hidden.
      *
@@ -69,8 +76,8 @@ export declare class ArcgisSwipe extends LitElement {
      * Icon which represents the component.
      * Typically used when the component is controlled by another component (e.g. by the Expand component).
      *
-     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
      * @default "compare"
+     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
      */
     icon?: string;
     /**
@@ -79,23 +86,42 @@ export declare class ArcgisSwipe extends LitElement {
      * @default "Swipe"
      */
     label?: string;
-    /** A collection of layers that will show on the left or top side of the Swipe component. */
-    leadingLayers: __esri.Collection<__esri.Layer>;
+    /**
+     * A collection of layers that will show on the left or top side of the Swipe component.
+     *
+     * @deprecated since 5.0, use `startLayers` instead.
+     * @see [leadingLayers](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Swipe-SwipeViewModel.html#leadingLayers)
+     */
+    get leadingLayers(): typeof this.viewModel.leadingLayers;
+    set leadingLayers(value: typeof this.viewModel.leadingLayers);
     /**
      * Replace localized message strings with your own strings.
      *
      * _**Note**: Individual message keys may change between releases._
      */
     messageOverrides?: typeof this.messages._overrides;
-    /** @deprecated since 4.34, use `slot` instead. */
-    position?: __esri.UIPosition;
     /**
      * The position of the Swipe component. This determines what percentage
-     * of the view will be taken up by the [leadingLayers](#leadingLayers).
+     * of the view will be taken up by the [startLayers](#startLayers).
      *
      * @default 25
      */
-    swipePosition: number;
+    position: number;
+    /**
+     * A collection of layers that will show on the left or top side of the Swipe component.
+     *
+     * @see [leadingLayers](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Swipe-SwipeViewModel.html#leadingLayers)
+     */
+    startLayers: import('@arcgis/core/core/Collection').default<import('@arcgis/core/layers/Layer').default>;
+    /**
+     * The position of the Swipe component. This determines what percentage
+     * of the view will be taken up by the [startLayers](#startLayers).
+     *
+     * @deprecated since 5.0, use `position` instead.
+     * @default 25
+     */
+    get swipePosition(): number;
+    set swipePosition(value: number);
     /**
      * 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.
      *
@@ -107,9 +133,15 @@ export declare class ArcgisSwipe extends LitElement {
      *
      * @default "disabled"
      */
-    readonly state: "ready" | "disabled";
-    /** A collection of layers that will show on the right or bottom side of the Swipe component. */
-    trailingLayers: __esri.Collection<__esri.Layer>;
+    readonly state: import('@arcgis/core/widgets/Swipe/types').State;
+    /**
+     * A collection of layers that will show on the right or bottom side of the Swipe component.
+     *
+     * @deprecated since 5.0, use `endLayers` instead.
+     * @see [trailingLayers](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Swipe-SwipeViewModel.html#trailingLayers)
+     */
+    get trailingLayers(): typeof this.viewModel.trailingLayers;
+    set trailingLayers(value: typeof this.viewModel.trailingLayers);
     /** Permanently destroy the component. */
     destroy(): Promise<void>;
     /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
@@ -123,7 +155,6 @@ export declare class ArcgisSwipe extends LitElement {
      *
      * **Note:** To constantly listen to changes while dragging, use the `arcgisSwipeInput` event instead.
      *
-     * @event
      * @since 4.34
      */
     readonly arcgisSwipeChange: TargetedEvent<this, void>;
@@ -131,7 +162,6 @@ export declare class ArcgisSwipe extends LitElement {
      * Fires when the swipe position is updated.
      * This event is fired continuously while dragging the handle.
      *
-     * @event
      * @since 4.34
      */
     readonly arcgisSwipeInput: TargetedEvent<this, void>;
@@ -142,5 +172,11 @@ export declare class ArcgisSwipe extends LitElement {
         componentLabel: string;
         dragLabel: string;
     }>;
+    "@eventTypes": {
+        "arcgisPropertyChange": ArcgisSwipe["arcgisPropertyChange"]["detail"];
+        "arcgisReady": ArcgisSwipe["arcgisReady"]["detail"];
+        "arcgisSwipeChange": ArcgisSwipe["arcgisSwipeChange"]["detail"];
+        "arcgisSwipeInput": ArcgisSwipe["arcgisSwipeInput"]["detail"];
+    };
 }
 export {};

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

@@ -1,18 +1,18 @@
 import { c as $ } from "../../chunks/runtime.js";
-import { css as P, html as g } from "lit";
+import { css as C, html as g } from "lit";
 import { classes as u } from "@arcgis/toolkit/dom";
-import C from "@arcgis/core/widgets/Swipe/SwipeViewModel.js";
-import { LitElement as D, createEvent as f, safeClassMap as h, safeStyleMap as m, nothing as M } from "@arcgis/lumina";
-import { usePropertyChange as K } from "@arcgis/lumina/controllers";
-import { createRef as z, ref as L } from "lit/directives/ref.js";
+import D from "@arcgis/core/widgets/Swipe/SwipeViewModel.js";
+import { LitElement as L, createEvent as f, safeClassMap as h, safeStyleMap as m, nothing as P } from "@arcgis/lumina";
+import { usePropertyChange as M } from "@arcgis/lumina/controllers";
+import { createRef as K, ref as z } from "lit/directives/ref.js";
 import { u as A } from "../../chunks/useT9n.js";
 import { m as S } from "../../chunks/useViewModel.js";
 import { g as b } from "../../chunks/globalCss.js";
 import { l as y } from "../../chunks/legacyIcon.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/5.0/esri/copyright.txt for details.
-v5.0.0-next.12 */
-const k = P`:host{position:absolute;margin:0;background:transparent!important;padding:0;width:100%;height:100%;overflow:hidden;user-select:none;--arcgis-internal-swipe-handle-color-background: var(--calcite-color-background);--arcgis-internal-swipe-divider-color-background: var(--calcite-color-background)}.arcgis-swipe{width:100%;height:100%;overflow:hidden;user-select:none}.arcgis-swipe,.arcgis-ui .arcgis-swipe{pointer-events:none!important}.arcgis-swipe__container{position:absolute;z-index:1;margin:0;outline:0;border:0;padding:0;overflow:hidden;pointer-events:auto;touch-action:none;outline-color:transparent}.arcgis-swipe--horizontal .arcgis-swipe__container{margin-left:calc(var(--calcite-spacing-xxxl) / 2 * -1);cursor:col-resize;height:100%}.arcgis-swipe--vertical .arcgis-swipe__container{margin-top:calc(var(--calcite-spacing-xxxl) / 2 * -1);cursor:row-resize;width:100%}.arcgis-swipe--disabled .arcgis-swipe__container{cursor:default;pointer-events:none}.arcgis-swipe__divider{position:absolute;background-color:var(--arcgis-internal-swipe-divider-color-background)}.arcgis-swipe--horizontal .arcgis-swipe__divider{top:0;left:calc(var(--calcite-spacing-xxxl) / 2);margin-left:calc(var(--calcite-border-width-lg) * .5 * -1);border-right:var(--calcite-border-width-sm) solid var(--calcite-color-border-1);border-left:var(--calcite-border-width-sm) solid var(--calcite-color-border-1);width:var(--calcite-border-width-lg);height:100%}.arcgis-swipe--vertical .arcgis-swipe__divider{top:calc(var(--calcite-spacing-xxxl) / 2);left:0;margin-top:calc(var(--calcite-border-width-lg) * .5 * -1);border-top:var(--calcite-border-width-sm) solid var(--calcite-color-border-1);border-bottom:var(--calcite-border-width-sm) solid var(--calcite-color-border-1);width:100%;height:var(--calcite-border-width-lg)}.arcgis-swipe__handle{display:flex;position:relative;align-items:center;justify-content:center;border:var(--calcite-border-width-sm) solid var(--calcite-color-border-1);border-radius:var(--calcite-corner-radius-round);background-color:var(--arcgis-internal-swipe-handle-color-background);width:var(--calcite-spacing-xxxl);height:var(--calcite-spacing-xxxl);color:var(--calcite-color-border-1)}.arcgis-swipe__handle--hidden{visibility:hidden}.arcgis-swipe--vertical .arcgis-swipe__handle{rotate:90deg}.arcgis-swipe__handle-icon{position:relative;z-index:2}.arcgis-swipe__handle-icon:before{content:"|||";color:inherit}.arcgis-swipe--horizontal .arcgis-swipe__handle{top:calc(50% - calc(var(--calcite-spacing-xxxl) / 2))}.arcgis-swipe--vertical .arcgis-swipe__handle{left:calc(50% - calc(var(--calcite-spacing-xxxl) / 2))}.arcgis-swipe__container:focus .arcgis-swipe__handle,.arcgis-swipe__container:focus .arcgis-swipe__divider{outline:inset 2px var(--calcite-color-focus, var(--calcite-ui-focus-color, var(--calcite-color-brand)))}.arcgis-swipe__container:focus .arcgis-swipe__handle{outline-offset:calc(-2px*(1 - (2*clamp(0,var(--calcite-offset-invert-focus),1))))}`, l = "arcgis-swipe", n = {
+v5.0.0-next.121 */
+const k = C`:host{position:absolute;margin:0;background:transparent!important;padding:0;width:100%;height:100%;overflow:hidden;user-select:none;--arcgis-internal-swipe-handle-color-background: var(--calcite-color-background);--arcgis-internal-swipe-divider-color-background: var(--calcite-color-background)}.arcgis-swipe{width:100%;height:100%;overflow:hidden;user-select:none}.arcgis-swipe,.arcgis-ui .arcgis-swipe{pointer-events:none!important}.arcgis-swipe__container{position:absolute;z-index:1;margin:0;outline:0;border:0;padding:0;overflow:hidden;pointer-events:auto;touch-action:none;outline-color:transparent}.arcgis-swipe--horizontal .arcgis-swipe__container{margin-left:calc(var(--calcite-spacing-xxxl) / 2 * -1);cursor:col-resize;height:100%}.arcgis-swipe--vertical .arcgis-swipe__container{margin-top:calc(var(--calcite-spacing-xxxl) / 2 * -1);cursor:row-resize;width:100%}.arcgis-swipe--disabled .arcgis-swipe__container{cursor:default;pointer-events:none}.arcgis-swipe__divider{position:absolute;background-color:var(--arcgis-internal-swipe-divider-color-background)}.arcgis-swipe--horizontal .arcgis-swipe__divider{top:0;left:calc(var(--calcite-spacing-xxxl) / 2);margin-left:calc(var(--calcite-border-width-lg) * .5 * -1);border-right:var(--calcite-border-width-sm) solid var(--calcite-color-border-1);border-left:var(--calcite-border-width-sm) solid var(--calcite-color-border-1);width:var(--calcite-border-width-lg);height:100%}.arcgis-swipe--vertical .arcgis-swipe__divider{top:calc(var(--calcite-spacing-xxxl) / 2);left:0;margin-top:calc(var(--calcite-border-width-lg) * .5 * -1);border-top:var(--calcite-border-width-sm) solid var(--calcite-color-border-1);border-bottom:var(--calcite-border-width-sm) solid var(--calcite-color-border-1);width:100%;height:var(--calcite-border-width-lg)}.arcgis-swipe__handle{display:flex;position:relative;align-items:center;justify-content:center;border:var(--calcite-border-width-sm) solid var(--calcite-color-border-1);border-radius:var(--calcite-corner-radius-round);background-color:var(--arcgis-internal-swipe-handle-color-background);width:var(--calcite-spacing-xxxl);height:var(--calcite-spacing-xxxl);color:var(--calcite-color-text-3)}.arcgis-swipe__handle--hidden{visibility:hidden}.arcgis-swipe--vertical .arcgis-swipe__handle{rotate:90deg}.arcgis-swipe__handle-icon{position:relative;z-index:2}.arcgis-swipe__handle-icon:before{content:"|||";color:inherit}.arcgis-swipe--horizontal .arcgis-swipe__handle{top:calc(50% - calc(var(--calcite-spacing-xxxl) / 2))}.arcgis-swipe--vertical .arcgis-swipe__handle{left:calc(50% - calc(var(--calcite-spacing-xxxl) / 2))}.arcgis-swipe__container:focus .arcgis-swipe__handle,.arcgis-swipe__container:focus .arcgis-swipe__divider{outline:inset 2px var(--calcite-color-focus, var(--calcite-color-focus, var(--calcite-color-brand)))}.arcgis-swipe__container:focus .arcgis-swipe__handle{outline-offset:calc(-2px*(1 - (2*clamp(0,var(--calcite-offset-invert-focus),1))))}`, l = "arcgis-swipe", n = {
   base: l,
   baseDisabled: `${l}--disabled`,
   vertical: `${l}--vertical`,
@@ -22,21 +22,39 @@ const k = P`:host{position:absolute;margin:0;background:transparent!important;pa
   handle: `${l}__handle`,
   handleHidden: `${l}__handle--hidden`,
   handleIcon: `${l}__handle-icon`
-}, H = S(C);
-class V extends D {
+}, H = S(D);
+class V extends L {
   constructor() {
-    super(...arguments), this._container = null, this._containerRef = z(), this._swiping = !1, this._swipePositionChanged = !1, this.messages = A({}), this._pointerOffset = 0, this.viewModel = H(this), this._onContainerPointerDown = (i) => {
+    super(...arguments), this._container = null, this._containerRef = K(), this._swiping = !1, this._positionChanged = !1, this.messages = A({}), this._pointerOffset = 0, this.viewModel = H(this), this._onContainerPointerDown = (i) => {
       i.preventDefault();
       const { _container: e } = this;
       e && document.activeElement !== this.el && e.focus(), this._swiping = !0, this._calculatePointerOffset(i);
-    }, this.view = this.viewModel.view, this.autoDestroyDisabled = !1, this.direction = this.viewModel.direction, this.disabled = !1, this.hideDivider = !1, this.hideHandle = !1, this.icon = "compare", this.label = this.messages.componentLabel, this.leadingLayers = this.viewModel.leadingLayers, this.swipePosition = this.viewModel.position, this.state = this.viewModel.state, this.trailingLayers = this.viewModel.trailingLayers, this.arcgisPropertyChange = K()("state"), this.arcgisReady = f(), this.arcgisSwipeChange = f(), this.arcgisSwipeInput = f();
+    }, this.view = this.viewModel.view, this.autoDestroyDisabled = !1, this.direction = this.viewModel.direction, this.disabled = !1, this.endLayers = this.viewModel.trailingLayers, this.hideDivider = !1, this.hideHandle = !1, this.icon = "compare", this.label = this.messages.componentLabel, this.position = this.viewModel.position, this.startLayers = this.viewModel.leadingLayers, this.state = this.viewModel.state, this.arcgisPropertyChange = M()("state"), this.arcgisReady = f(), this.arcgisSwipeChange = f(), this.arcgisSwipeInput = f();
   }
   static {
-    this.properties = { view: 0, autoDestroyDisabled: 5, direction: 3, disabled: 7, hideDivider: 7, hideHandle: 7, icon: 1, label: 1, leadingLayers: 0, messageOverrides: 0, position: 3, swipePosition: 9, referenceElement: 1, state: 3, trailingLayers: 0 };
+    this.properties = { view: 0, autoDestroyDisabled: 5, direction: 3, disabled: 7, endLayers: 0, hideDivider: 7, hideHandle: 7, icon: 1, label: 1, leadingLayers: 0, messageOverrides: 0, position: 9, startLayers: 0, swipePosition: 9, referenceElement: 1, state: 32, trailingLayers: 0 };
   }
   static {
     this.styles = k;
   }
+  get leadingLayers() {
+    return this.startLayers;
+  }
+  set leadingLayers(i) {
+    this.startLayers = i;
+  }
+  get swipePosition() {
+    return this.position;
+  }
+  set swipePosition(i) {
+    this.position = i;
+  }
+  get trailingLayers() {
+    return this.endLayers;
+  }
+  set trailingLayers(i) {
+    this.endLayers = i;
+  }
   async destroy() {
     await this.manager.destroy();
   }
@@ -44,34 +62,34 @@ class V extends D {
     this.listenOn(document, "pointermove", this._onContainerPointerMove), this.listenOn(document, "pointerup", this._onContainerPointerUp);
   }
   _calculatePointerOffset(i) {
-    const { direction: e } = this, t = this._containerRef.value, r = (e === "vertical" ? t.clientHeight : t.clientWidth) / 2, s = t.getBoundingClientRect(), o = i.clientX - s.left, d = i.clientY - s.top;
-    this._pointerOffset = e === "vertical" ? d - r : o - r;
+    const { direction: e } = this, t = this._containerRef.value, r = (e === "vertical" ? t.clientHeight : t.clientWidth) / 2, s = t.getBoundingClientRect(), a = i.clientX - s.left, d = i.clientY - s.top;
+    this._pointerOffset = e === "vertical" ? d - r : a - r;
   }
   _onContainerPointerUp(i) {
-    this._swiping && (i.preventDefault(), this._swipePositionChanged && (this.arcgisSwipeChange.emit(), this._swipePositionChanged = !1), this._swiping = !1);
+    this._swiping && (i.preventDefault(), this._positionChanged && (this.arcgisSwipeChange.emit(), this._positionChanged = !1), this._swiping = !1);
   }
   _onContainerPointerMove(i) {
     if (!this._swiping)
       return;
     i.preventDefault();
-    const { _pointerOffset: e, el: t, direction: r } = this, { clientX: s, clientY: o } = i, { top: d, left: a, width: c, height: p } = t.getBoundingClientRect(), _ = r === "vertical" ? p : c, w = (r === "vertical" ? o - d - e : s - a - e) / _ * 100;
-    this.swipePosition !== w && (this.swipePosition = w, this._swipePositionChanged = !0, this.arcgisSwipeInput.emit());
+    const { _pointerOffset: e, el: t, direction: r } = this, { clientX: s, clientY: a } = i, { top: d, left: o, width: c, height: p } = t.getBoundingClientRect(), _ = r === "vertical" ? p : c, w = (r === "vertical" ? a - d - e : s - o - e) / _ * 100;
+    this.position !== w && (this.position = w, this._positionChanged = !0, this.arcgisSwipeInput.emit());
   }
   _getKeyPosition(i) {
-    const { key: e } = i, { swipePosition: t } = this, { max: r, min: s, step: o, stepMultiplier: d, direction: a } = this.viewModel, c = o * d;
-    if (["ArrowUp", "ArrowDown", "ArrowLeft", "ArrowRight", "Home", "End", "PageUp", "PageDown"].includes(e) && (i.preventDefault(), i.stopPropagation()), a === "vertical" ? e === "ArrowDown" || e === "ArrowRight" : e === "ArrowUp" || e === "ArrowRight") {
-      const v = i.shiftKey ? c : o;
+    const { key: e } = i, { position: t } = this, { max: r, min: s, step: a, stepMultiplier: d, direction: o } = this.viewModel, c = a * d;
+    if (["ArrowUp", "ArrowDown", "ArrowLeft", "ArrowRight", "Home", "End", "PageUp", "PageDown"].includes(e) && (i.preventDefault(), i.stopPropagation()), o === "vertical" ? e === "ArrowDown" || e === "ArrowRight" : e === "ArrowUp" || e === "ArrowRight") {
+      const v = i.shiftKey ? c : a;
       return t + v;
     }
-    if (a === "vertical" ? e === "ArrowUp" || e === "ArrowLeft" : e === "ArrowDown" || e === "ArrowLeft") {
-      const v = i.shiftKey ? c : o;
+    if (o === "vertical" ? e === "ArrowUp" || e === "ArrowLeft" : e === "ArrowDown" || e === "ArrowLeft") {
+      const v = i.shiftKey ? c : a;
       return t - v;
     }
-    return e === "Home" ? s : e === "End" ? r : (a === "vertical" ? e === "PageDown" : e === "PageUp") ? t + c : (a === "vertical" ? e === "PageUp" : e === "PageDown") ? t - c : null;
+    return e === "Home" ? s : e === "End" ? r : (o === "vertical" ? e === "PageDown" : e === "PageUp") ? t + c : (o === "vertical" ? e === "PageUp" : e === "PageDown") ? t - c : null;
   }
   _onContainerKeyDown(i) {
     const e = this._getKeyPosition(i);
-    typeof e == "number" && this.swipePosition !== e && (this.swipePosition = e, this.arcgisSwipeInput.emit(), this.arcgisSwipeChange.emit());
+    typeof e == "number" && this.position !== e && (this.position = e, this.arcgisSwipeInput.emit(), this.arcgisSwipeChange.emit());
   }
   render() {
     const { state: i, direction: e } = this.viewModel, t = i === "disabled" || this.disabled, r = {
@@ -96,11 +114,11 @@ class V extends D {
     return [this._renderDivider(), this._renderHandle()];
   }
   _renderContainer() {
-    const { disabled: i, viewModel: e } = this, { max: t, min: r, direction: s, position: o } = e, d = this.label ?? this.messages.dragLabel ?? "", a = `${o}%`, c = {
-      top: s === "vertical" ? a : void 0,
-      left: s === "vertical" ? void 0 : a
+    const { disabled: i, viewModel: e } = this, { max: t, min: r, direction: s, position: a } = e, d = this.label ?? this.messages.dragLabel ?? "", o = `${a}%`, c = {
+      top: s === "vertical" ? o : void 0,
+      left: s === "vertical" ? void 0 : o
     }, p = this._renderContent();
-    return i ? g`<div class=${h(n.container)} role=presentation style=${m(c)}>${p}</div>` : g`<div @pointerdown=${this._onContainerPointerDown} .ariaLabel=${d} .ariaOrientation=${s} .ariaValueMax=${`${t}`} .ariaValueMin=${`${r}`} .ariaValueNow=${`${o}`} .ariaValueText=${a} class=${h(n.container)} @keydown=${this._onContainerKeyDown} role=slider style=${m(c)} tabindex=0 title=${d ?? M} touch-action=none ${L(this._containerRef)}>${p}</div>`;
+    return i ? g`<div class=${h(n.container)} role=presentation style=${m(c)}>${p}</div>` : g`<div @pointerdown=${this._onContainerPointerDown} .ariaLabel=${d} .ariaOrientation=${s} .ariaValueMax=${`${t}`} .ariaValueMin=${`${r}`} .ariaValueNow=${`${a}`} .ariaValueText=${o} class=${h(n.container)} @keydown=${this._onContainerKeyDown} role=slider style=${m(c)} tabindex=0 title=${d ?? P} touch-action=none ${z(this._containerRef)}>${p}</div>`;
   }
 }
 $("arcgis-swipe", V);

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

@@ -4,15 +4,15 @@ import { Use } from '@arcgis/lumina/controllers';
 import { default as TableList } from '@arcgis/core/widgets/TableList.js';
 import { PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { ArcgisReferenceElement } from '../../utils/component-utils';
+import { IconName } from '../../utils/action-utils';
 
-declare const useTableListWidget: (component: LitElement & Pick<TableList, "label" | "viewModel" | "icon" | "collapsed" | "dragEnabled" | "filterPlaceholder" | "filterPredicate" | "filterText" | "selectionMode" | "minFilterItems" | "selectedItems" | "listItemCreatedFunction" | "minDragEnabledItems"> & {
+declare const useTableListWidget: (component: LitElement & Pick<TableList, "label" | "viewModel" | "icon" | "collapsed" | "dragEnabled" | "filterPlaceholder" | "minFilterItems" | "selectedItems" | "selectionMode" | "filterText" | "filterPredicate" | "listItemCreatedFunction" | "minDragEnabledItems"> & {
     state?: unknown;
-    viewModel?: __esri.TableListViewModel | undefined;
+    viewModel?: import('@arcgis/core/widgets/TableList/TableListViewModel').default | undefined;
     closed?: boolean;
     icon: import('@arcgis/toolkit/type').nil | string;
     label: import('@arcgis/toolkit/type').nil | string;
     referenceElement?: ArcgisReferenceElement | string;
-    position?: __esri.UIPosition;
     arcgisReady: import('@arcgis/lumina').EventEmitter;
     arcgisPropertyChange: import('@arcgis/lumina').EventEmitter<{
         name: string;
@@ -53,80 +53,150 @@ export declare class ArcgisTableList extends LitElement {
     /**
      * Indicates whether a component is closed. When `true`, the component will be hidden.
      *
-     * @since 4.33
      * @default false
+     * @since 4.33
      */
     closed: boolean;
     /**
-     * Indicates whether the widget is collapsed.
+     * Indicates whether the component is collapsed.
+     * When collapsed, only the collapse button and heading are displayed.
      *
      * @default false
+     * @since 4.29
+     * @see [showCollapseButton](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-table-list/#showCollapseButton)
+     * @example tableList.collapsed = true;
      */
     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).
      *
      * @default false
+     * @since 4.29
+     * @see [minDragEnabledItems](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TableList.html#minDragEnabledItems)
+     * @example tableList.dragEnabled = true;
      */
     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.
      *
      * @default ""
+     * @since 4.29
+     * @see [showFilter](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-table-list/#showFilter)
+     * @example tableList.filterPlaceholder = "Filter layers";
      */
     filterPlaceholder: string;
     /**
      * Specifies a function to handle filtering [list items](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TableList-ListItem.html).
      *
-     * @default null
+     * @since 4.32
+     * @example layerList.filterPredicate = (item) => item.title.toLowerCase().includes("streets");
      */
-    filterPredicate: nullish | __esri.TableListFilterPredicate;
+    filterPredicate: import('@arcgis/core/widgets/TableList.js').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.
      *
      * @default ""
+     * @since 4.29
+     * @see [visibleElements.filter](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TableList.html#visibleElements)
+     * @example
+     * reactiveUtils.watch(
+     *   () => tableList.filterText,
+     *   (filterText) => console.log(filterText)
+     * );
      */
     filterText: string;
     /**
-     * Icon which represents the component.
-     * Typically used when the component is controlled by another component (e.g. by the Expand component).
+     * Icon which represents the widget. It is typically used when the widget is controlled by another
+     * one (e.g. in the Expand widget).
      *
-     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
      * @default "table"
+     * @since 4.27
+     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
      */
-    icon: string;
+    get icon(): typeof this.widget.icon;
+    set icon(value: IconName);
     /**
      * The widget's default label.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TableList.html#label)
+     * @since 4.11
      */
     label: string;
     /**
      * Specifies a function that accesses each [ListItem](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TableList-ListItem.html).
+     * 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)
+     * property of the ListItem.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TableList.html#listItemCreatedFunction)
+     * @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"
+     *         }
+     *       ]
+     *     ];
+     *    }
+     * });
      */
-    listItemCreatedFunction: nullish | __esri.TableListListItemCreatedHandler;
+    listItemCreatedFunction: import('@arcgis/core/widgets/TableList/types').ListItemModifier | null | undefined;
     /**
-     * A reference to a [map](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html) containing the tables.
+     * A reference to a [Map](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html) 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);
+     *     }
+     *   });
+     * });
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TableList.html#map)
+     * const tableList = new TableList({
+     *   map: map //  map contains tables collection
+     * });
      */
-    map: nullish | __esri.Map | __esri.WebMap;
+    map: import('@arcgis/core/WebScene').default | import('@arcgis/core/WebMap').default | 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).
      *
      * @default 2
+     * @since 4.29
+     * @see [dragEnabled](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TableList.html#dragEnabled)
+     * @example
+     * tableList.dragEnabled = true;
+     * tableList.minDragEnabledItems = 5;
      */
     minDragEnabledItems: number;
     /**
-     * The minimum number of list items required to display the visibleElements.filter input box.
+     * 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.
      *
      * @default 10
+     * @since 4.29
+     * @see [showFilter](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-table-list/#showFilter)
+     * @example
+     * tableList.showFilter = true;
+     * tableList.minFilterItems = 5;
      */
     minFilterItems: number;
-    /** @deprecated since 4.34, use [`slot`](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/slot) instead. */
-    position?: __esri.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.
      *
@@ -137,42 +207,93 @@ export declare class ArcgisTableList extends LitElement {
      * A collection of selected [ListItem](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TableList-ListItem.html)s representing table list items
      * selected by the user.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TableList.html#selectedItems)
+     * @see [selectionMode](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TableList.html#selectionMode)
      */
-    selectedItems: __esri.Collection<__esri.TableListListItem>;
+    selectedItems: import('@arcgis/core/core/Collection').default<import('@arcgis/core/widgets/TableList/ListItem').default>;
     /**
      * 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.
+     *
+     * | Value | Description |
+     * | ----- | ----------- |
+     * | multiple | Allows any number of items to be selected at once. This is useful when you want to apply an operation to multiple items at the same time. |
+     * | none | Disables selection. Use this when you want to prevent selecting items. |
+     * | single | Allows only one item to be selected at a time. If another item is selected, the previous selection is cleared. This is useful when you want to ensure that a maximum of one item is selected at a time. |
+     * | single-persist | Allows only one item to be selected at a time and prevents de-selection. Once an item is selected, it remains selected until another item is selected. This is useful when you want to ensure that there is always exactly one selected item. |
      *
      * @default "none"
+     * @since 4.29
+     * @see [selectedItems](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TableList.html#selectedItems)
+     * @example tableList.selectionMode = "multiple";
      */
-    selectionMode: "multiple" | "single" | "none" | "single-persist";
+    selectionMode: "none" | "multiple" | "single" | "single-persist";
     /**
      * The current state of the component.
      *
      * @default "disabled"
      */
-    readonly state: "ready" | "loading" | "disabled";
+    readonly state: import('@arcgis/core/widgets/TableList/types').State;
     /** The collection of table ListItems displayed within the component. */
     get tableItems(): __esri.Collection<__esri.TableListListItem>;
-    /** @default false */
+    /**
+     * Indicates whether to display a close button in the header.
+     *
+     * @default false
+     * @since 5.0
+     */
     showCloseButton: boolean;
-    /** @default false */
+    /**
+     * Indicates whether to display a collapse button in the header.
+     *
+     * @default false
+     * @since 5.0
+     */
     showCollapseButton: boolean;
-    /** @default false */
+    /**
+     * Indicates whether to display layers with load errors.
+     *
+     * @default false
+     * @since 5.0
+     */
     showErrors: boolean;
-    /** @default false */
+    /**
+     * 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.
+     *
+     * @default false
+     * @since 5.0
+     */
     showFilter: boolean;
-    /** @default false */
+    /**
+     * Determines whether the table list should be shown within its built-in [flow component](https://developers.arcgis.com/calcite-design-system/components/flow/) or if the flow component should be excluded. The table list will be displayed within its original flow component if set to `true`. The flow component will be omitted from the table list if set to `false`. To place the table list into an existing Calcite flow component, set this property to `false`.
+     *
+     * @default false
+     * @since 5.0
+     */
     hideFlow: boolean;
-    /** @default false */
+    /**
+     * 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).
+     *
+     * @default false
+     * @since 5.0
+     */
     showHeading: boolean;
-    /** @default false */
+    /**
+     * Indicates whether the status indicators will be displayed.
+     *
+     * @default false
+     * @since 5.0
+     */
     hideStatusIndicators: boolean;
-    /** @default false */
+    /**
+     * 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.
+     *
+     * @default false
+     * @since 5.0
+     */
     showTemporaryTableIndicators: 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 ArcgisTableList component will be associated with a map or scene component rather than using the `view` property.
+     *   > **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 Table List component will be associated with a map or scene component rather than using the `view` property.
      */
     view?: __esri.LinkChartView | __esri.MapView | __esri.SceneView;
     /** Permanently destroy the component. */
@@ -184,6 +305,16 @@ export declare class ArcgisTableList extends LitElement {
     /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
     readonly arcgisReady: TargetedEvent<this, void>;
     /** Emitted when an action is triggered on the component. */
-    readonly arcgisTriggerAction: TargetedEvent<this, __esri.TableListTriggerActionEvent>;
+    readonly arcgisTriggerAction: TargetedEvent<this, import('@arcgis/core/widgets/TableList/TableListViewModel').TableListViewModelTriggerActionEvent>;
+    private widget: TableList;
+    readonly _setterTypes: {
+        icon?: IconName;
+    };
+    "@eventTypes": {
+        "arcgisClose": ArcgisTableList["arcgisClose"]["detail"];
+        "arcgisPropertyChange": ArcgisTableList["arcgisPropertyChange"]["detail"];
+        "arcgisReady": ArcgisTableList["arcgisReady"]["detail"];
+        "arcgisTriggerAction": ArcgisTableList["arcgisTriggerAction"]["detail"];
+    };
 }
 export {};