@arcgis/core 5.2.0-next.112 → 5.2.0-next.114

package/layers/list/CatalogItemCollection.d.ts

@@ -3,41 +3,47 @@ import type CatalogLayer from "../CatalogLayer.js";
 import type Item from "./Item.js";
 import type { EventedAccessor } from "../../core/Evented.js";
 import type { LayerItemCollectionEvents } from "./LayerItemCollection.js";
-import type { Action, ItemModifier, State } from "./types.js";
+import type { Action, ItemModifier, State, ItemProperties } from "./types.js";
 import type { MapViewOrSceneView } from "../../views/MapViewOrSceneView.js";
-import type { ItemProperties } from "./Item.js";
 import type { ReadonlyArrayOrCollection } from "../../core/Collection.js";
 
+/** @internal */
 export interface CatalogItemCollectionProperties extends Partial<Pick<CatalogItemCollection, "catalogLayer" | "checkPublishStatusEnabled" | "listItemCreatedFunction" | "listModeDisabled" | "view">> {
   /**
    * The collection of [Items](https://developers.arcgis.com/javascript/latest/references/core/layers/list/Item/) representing the
    * catalog layer's dynamic-group layers.
+   *
+   * @internal
    */
   catalogItems?: ReadonlyArrayOrCollection<ItemProperties>;
 }
 
+/** @internal */
 export interface CatalogItemCollectionEvents extends LayerItemCollectionEvents {}
 
 /**
  * Provides list orchestration logic for catalog-layer list workflows.
  *
- * @since 5.2
+ * @internal
  */
 export default class CatalogItemCollection extends EventedAccessor {
-  /**
-   * @deprecated
-   * Do not directly reference this property.
-   * Use EventNames and EventTypes helpers from \@arcgis/core/Evented
-   */
+  /** @internal */
   "@eventTypes": CatalogItemCollectionEvents;
+  /** @internal */
   constructor(properties?: CatalogItemCollectionProperties);
   /**
    * The collection of [Items](https://developers.arcgis.com/javascript/latest/references/core/layers/list/Item/) representing the
    * catalog layer's dynamic-group layers.
+   *
+   * @internal
    */
   get catalogItems(): Collection<Item>;
   set catalogItems(value: ReadonlyArrayOrCollection<ItemProperties>);
-  /** The [CatalogLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/CatalogLayer/) to display in the list. */
+  /**
+   * The [CatalogLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/CatalogLayer/) to display in the list.
+   *
+   * @internal
+   */
   accessor catalogLayer: CatalogLayer | null | undefined;
   /**
    * Whether to provide an indication if a layer is being published.
@@ -45,14 +51,20 @@ export default class CatalogItemCollection extends EventedAccessor {
    * is `false` if `checkPublishStatusEnabled` is `false`.
    *
    * @default false
+   * @internal
    */
   accessor checkPublishStatusEnabled: boolean;
-  /** A function that executes each time a [Item](https://developers.arcgis.com/javascript/latest/references/core/layers/list/Item/) is created. */
+  /**
+   * A function that executes each time a [Item](https://developers.arcgis.com/javascript/latest/references/core/layers/list/Item/) is created.
+   *
+   * @internal
+   */
   accessor listItemCreatedFunction: ItemModifier | null | undefined;
   /**
    * Specifies whether to ignore the [Layer.listMode](https://developers.arcgis.com/javascript/latest/references/core/layers/Layer/#listMode) property to display all layers.
    *
    * @default false
+   * @internal
    * @since 5.2
    * @see [Layer.listMode](https://developers.arcgis.com/javascript/latest/references/core/layers/Layer/#listMode)
    */
@@ -61,9 +73,14 @@ export default class CatalogItemCollection extends EventedAccessor {
    * The view model's state.
    *
    * @default "disabled"
+   * @internal
    */
   get state(): State;
-  /** The view context for this view model. */
+  /**
+   * The view context for this view model.
+   *
+   * @internal
+   */
   accessor view: MapViewOrSceneView | null | undefined;
   /**
    * Triggers the `trigger-action` event and executes
@@ -71,6 +88,7 @@ export default class CatalogItemCollection extends EventedAccessor {
    *
    * @param action - The action to execute.
    * @param item - An item associated with the action.
+   * @internal
    */
   triggerAction(action: Action, item: Item): void;
 }

package/layers/list/CatalogItemCollection.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{__decorate as t}from"tslib";import e from"../../core/Collection.js";import{EventedAccessor as s}from"../../core/Evented.js";import{watch as i,initial as o,on as l}from"../../core/reactiveUtils.js";import{property as a,subclass as r}from"../../core/accessorSupport/decorators.js";import d from"./Item.js";import{findLayerListMode as c}from"./support/layerListUtils.js";const n={layerListMode:"layer-list-mode"},m="hide",h=e.ofType(d);let y=class extends s{constructor(t){super(t),this.catalogItems=new h,this.checkPublishStatusEnabled=!1,this.catalogLayer=null,this.listItemCreatedFunction=null,this.listModeDisabled=!1,this.view=null}initialize(){this.addHandles([i(()=>[this.catalogLayer?.loaded,this.view?.ready],()=>this._compileList(),o),l(()=>this.catalogLayer?.dynamicGroupLayer.layers,"change",()=>this._compileList()),i(()=>[this.listItemCreatedFunction,this.checkPublishStatusEnabled,this.listModeDisabled],()=>this._recompileList())])}destroy(){this.view=null,this._removeAllItems()}get state(){const{view:t,catalogLayer:e}=this;return t?.ready&&e?.loaded?"ready":t&&e?"loading":"disabled"}get totalItems(){return this.catalogItems.flatten(t=>t.children).length}triggerAction(t,e){t&&!t.disabled&&this.emit("trigger-action",{action:t,item:e})}_createItem(t){const{view:e,listItemCreatedFunction:s,checkPublishStatusEnabled:i,listModeDisabled:o}=this;return new d({checkPublishStatusEnabled:i,listModeDisabled:o,layer:t,listItemCreatedFunction:s,view:e})}_removeAllItems(){this.catalogItems.destroyAll()}_getViewableLayers(t){return t?this.listModeDisabled?t:t.filter(t=>c(t)!==m):void 0}_watchLayersListMode(t){this.removeHandles(n.layerListMode),t&&!this.listModeDisabled&&this.addHandles(i(()=>t.filter(t=>"listMode"in t).map(t=>t.listMode).toArray(),()=>this._compileList()),n.layerListMode)}_compileList(){const{catalogLayer:t}=this;if(!t?.loaded)return;const e=t.dynamicGroupLayer.layers;this._watchLayersListMode(e);const s=this._getViewableLayers(e);s?.length?(this._createNewItems(s),this._removeItems(s),this._sortItems(s)):this._removeAllItems()}_createNewItems(t){const{catalogItems:e}=this;t.forEach(t=>{e.some(e=>e.layer===t)||e.add(this._createItem(t))})}_removeItems(t){const{catalogItems:e}=this,s=[];e.forEach(e=>{e&&t?.includes(e.layer)||s.push(e)}),e.destroyMany(s)}_sortItems(t){const{catalogItems:e}=this;e.sort((e,s)=>{const i=t.indexOf(e.layer),o=t.indexOf(s.layer);return i>o?-1:i<o?1:0})}_recompileList(){this._removeAllItems(),this._compileList()}};t([a({type:h})],y.prototype,"catalogItems",void 0),t([a()],y.prototype,"checkPublishStatusEnabled",void 0),t([a()],y.prototype,"catalogLayer",void 0),t([a()],y.prototype,"listItemCreatedFunction",void 0),t([a({nonNullable:!0})],y.prototype,"listModeDisabled",void 0),t([a({readOnly:!0})],y.prototype,"state",null),t([a()],y.prototype,"totalItems",null),t([a()],y.prototype,"view",void 0),y=t([r("esri.layers.list.CatalogItemCollection")],y);const p=y;export{p as default};
+import{__decorate as t}from"tslib";import e from"../../core/Collection.js";import{EventedAccessor as s}from"../../core/Evented.js";import{watch as i,initial as o,on as l}from"../../core/reactiveUtils.js";import{property as a,subclass as r}from"../../core/accessorSupport/decorators.js";import d from"./Item.js";import{findLayerListMode as c}from"./support/layerListUtils.js";const n={layerListMode:"layer-list-mode"},m="hide",h=e.ofType(d);let y=class extends s{constructor(t){super(t),this.catalogItems=new h,this.catalogLayer=null,this.checkPublishStatusEnabled=!1,this.listItemCreatedFunction=null,this.listModeDisabled=!1,this.view=null}initialize(){this.addHandles([i(()=>[this.catalogLayer?.loaded,this.view?.ready],()=>this._compileList(),o),l(()=>this.catalogLayer?.dynamicGroupLayer.layers,"change",()=>this._compileList()),i(()=>[this.listItemCreatedFunction,this.checkPublishStatusEnabled,this.listModeDisabled],()=>this._recompileList())])}destroy(){this.view=null,this._removeAllItems()}get state(){const{view:t,catalogLayer:e}=this;return t?.ready&&e?.loaded?"ready":t&&e?"loading":"disabled"}get totalItems(){return this.catalogItems.flatten(t=>t.children).length}triggerAction(t,e){t&&!t.disabled&&this.emit("trigger-action",{action:t,item:e})}_compileList(){const{catalogLayer:t}=this;if(!t?.loaded)return;const e=t.dynamicGroupLayer.layers;this._watchLayersListMode(e);const s=this._getViewableLayers(e);s?.length?(this._createNewItems(s),this._removeItems(s),this._sortItems(s)):this._removeAllItems()}_createItem(t){const{view:e,listItemCreatedFunction:s,checkPublishStatusEnabled:i,listModeDisabled:o}=this;return new d({checkPublishStatusEnabled:i,layer:t,listItemCreatedFunction:s,listModeDisabled:o,view:e})}_createNewItems(t){const{catalogItems:e}=this;t.forEach(t=>{e.some(e=>e.layer===t)||e.add(this._createItem(t))})}_getViewableLayers(t){return t?this.listModeDisabled?t:t.filter(t=>c(t)!==m):void 0}_recompileList(){this._removeAllItems(),this._compileList()}_removeAllItems(){this.catalogItems.destroyAll()}_removeItems(t){const{catalogItems:e}=this,s=[];e.forEach(e=>{e&&t?.includes(e.layer)||s.push(e)}),e.destroyMany(s)}_sortItems(t){const{catalogItems:e}=this;e.sort((e,s)=>{const i=t.indexOf(e.layer),o=t.indexOf(s.layer);return i>o?-1:i<o?1:0})}_watchLayersListMode(t){this.removeHandles(n.layerListMode),t&&!this.listModeDisabled&&this.addHandles(i(()=>t.filter(t=>"listMode"in t).map(t=>t.listMode).toArray(),()=>this._compileList()),n.layerListMode)}};t([a({type:h})],y.prototype,"catalogItems",void 0),t([a()],y.prototype,"catalogLayer",void 0),t([a()],y.prototype,"checkPublishStatusEnabled",void 0),t([a()],y.prototype,"listItemCreatedFunction",void 0),t([a({nonNullable:!0})],y.prototype,"listModeDisabled",void 0),t([a({readOnly:!0})],y.prototype,"state",null),t([a()],y.prototype,"totalItems",null),t([a()],y.prototype,"view",void 0),y=t([r("esri.layers.list.CatalogItemCollection")],y);const p=y;export{p as default};

package/layers/list/Item.d.ts

@@ -7,262 +7,206 @@ import type ItemPanel from "./ItemPanel.js";
 import type Sublayer from "../support/Sublayer.js";
 import type SubtypeSublayer from "../support/SubtypeSublayer.js";
 import type LayerView from "../../views/layers/LayerView.js";
-import type { IdentifiableMixin, IdentifiableMixinProperties } from "../../core/Identifiable.js";
-import type { Action, ItemContent, State } from "./types.js";
+import type { IdentifiableMixin } from "../../core/Identifiable.js";
+import type { Action, ConnectedLayerView, ItemContent, ItemModifier, ItemProperties, ItemVisibilityMode, SpatiallyReferencedLayerView, State, ItemPanelProperties } from "./types.js";
 import type { MapViewOrSceneView } from "../../views/MapViewOrSceneView.js";
-import type { StreamLayerViewConnectionStatus } from "../../views/layers/StreamLayerView.js";
 import type { ActionToggleProperties } from "../../support/actions/ActionToggle.js";
 import type { ActionButtonProperties } from "../../support/actions/ActionButton.js";
 import type { ReadonlyArrayOrCollection } from "../../core/Collection.js";
-import type { ItemPanelProperties } from "./ItemPanel.js";
-
-export interface ItemProperties extends IdentifiableMixinProperties, Partial<Pick<Item, "actionsExpanded" | "actionsOpen" | "checkPublishStatusEnabled" | "childrenSortable" | "content" | "expanded" | "hidden" | "layer" | "listModeDisabled" | "open" | "parent" | "sortable" | "view" | "visible">> {
-  /** A nested 2-dimensional collection of actions that could be triggered on the item. */
-  actionsSections?: ReadonlyArrayOrCollection<ReadonlyArrayOrCollection<((ActionButtonProperties & { type: "button" }) | (ActionToggleProperties & { type: "toggle" }))>>;
-  /** The child layer, track info, and telemetry display items belonging to this item. */
-  children?: ReadonlyArrayOrCollection<ItemProperties>;
-  /**
-   * Additional panel state associated with this list item.
-   *
-   * @since 5.2
-   */
-  panel?: ItemPanelProperties;
-  /** The title of the layer. */
-  title?: string | null;
-}
-
-/**
- * Represents a layer view that supports spatial referencing. Used to indicate whether the
- * associated layer view can operate with a spatial reference in the current view context.
- *
- * @since 5.2
- * @see [layerView](https://developers.arcgis.com/javascript/latest/references/core/layers/list/Item/#layerView)
- */
-export interface SpatiallyReferencedLayerView extends LayerView {
-  /**
-   * Indicates if the layer view supports the current spatial reference.
-   *
-   * @since 5.2
-   */
-  spatialReferenceSupported: boolean;
-}
-
-/**
- * Represents a layer view for stream layers that provides connection status information.
- * Used to determine the current connection state of a stream layer in the view.
- *
- * @since 5.2
- * @see [connectionStatus](https://developers.arcgis.com/javascript/latest/references/core/layers/list/Item/#connectionStatus)
- */
-export interface ConnectedLayerView extends LayerView {
-  /**
-   * The current connection status of the stream layer view.
-   *
-   * @since 5.2
-   */
-  connectionStatus: StreamLayerViewConnectionStatus;
-}
 
 /**
- * Defines how the visibility of child layers is managed within a list item.
+ * Represents the state of one entry in a layer-list workflow.
  *
- * - `independent`: Each child layer's visibility is controlled separately.
- * - `inherited`: Child layers inherit the visibility from their parent layer.
- * - `exclusive`: Only one child layer can be visible at a time.
- *
- * @see [visibilityMode](https://developers.arcgis.com/javascript/latest/references/core/layers/list/Item/#visibilityMode)
- */
-export type ItemVisibilityMode = "independent" | "inherited" | "exclusive";
-
-/**
- * Represents state for a single layer entry in a list-oriented workflow.
- *
- * This class provides access to associated layer properties, supports nested child items,
- * and stores action and panel state that can be consumed by separate UI components.
+ * An item can represent a layer, a track-info part, or a video telemetry-display element.
+ * It exposes associated layer and layer-view state, supports nested child items, and stores
+ * action and panel state for consumer UIs.
  *
  * To hide a layer entry based on layer configuration, set [Layer.listMode](https://developers.arcgis.com/javascript/latest/references/core/layers/Layer/#listMode)
  * to `hide` on the corresponding layer.
  *
+ * @beta
  * @since 5.2
  * @see [ItemPanel](https://developers.arcgis.com/javascript/latest/references/core/layers/list/ItemPanel/)
  */
 export default class Item extends ItemSuperclass {
   constructor(properties?: ItemProperties);
   /**
-   * Whether the actions state is expanded.
+   * Indicates whether the item's action sections are expanded in a consumer UI.
    *
    * @default false
    */
   accessor actionsExpanded: boolean;
   /** Backward-compatible alias of [actionsExpanded](https://developers.arcgis.com/javascript/latest/references/core/layers/list/Item/#actionsExpanded). */
   accessor actionsOpen: boolean;
-  /** A nested 2-dimensional collection of actions that could be triggered on the item. */
+  /**
+   * A collection of action sections that can be triggered on the item.
+   * Each section is rendered as a separate group by consumer UIs.
+   */
   get actionsSections(): Collection<Collection<Action>>;
   set actionsSections(value: ReadonlyArrayOrCollection<ReadonlyArrayOrCollection<((ActionButtonProperties & { type: "button" }) | (ActionToggleProperties & { type: "toggle" }))>>);
   /**
    * Enables publish-status checks used by [publishing](https://developers.arcgis.com/javascript/latest/references/core/layers/list/Item/#publishing).
+   * When enabled, the item observes the associated layer's publishing status.
    *
    * @default false
-   * @since 5.2
    */
   accessor checkPublishStatusEnabled: boolean;
-  /** The child layer, track info, and telemetry display items belonging to this item. */
+  /**
+   * The child items belonging to this item.
+   * Children can represent nested layers, track-info parts, or telemetry-display elements.
+   */
   get children(): Collection<Item>;
   set children(value: ReadonlyArrayOrCollection<ItemProperties>);
   /**
-   * Indicates if the children of a list item (or sublayers in a GroupLayer) can be sorted or moved/reordered.
+   * Indicates whether the item's child layers can be sorted or moved within their parent collection.
+   * This does not affect track-info or telemetry-display children.
    *
    * @default true
-   * @since 5.2
    * @example
    * // disables the children of a parent list item from being sorted
    * listItem.childrenSortable = false;
    */
   accessor childrenSortable: boolean;
   /**
-   * Only valid when the list item represents a [StreamLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/StreamLayer/). Indicates
-   * the [StreamLayerView.connectionStatus](https://developers.arcgis.com/javascript/latest/references/core/views/layers/StreamLayerView/#connectionStatus) of the stream layer connection.
-   * This overrides [updating](https://developers.arcgis.com/javascript/latest/references/core/layers/list/Item/#updating).
-   *
-   * @since 5.2
+   * The connection status of the associated [StreamLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/StreamLayer/) when its layer view exposes
+   * [StreamLayerView.connectionStatus](https://developers.arcgis.com/javascript/latest/references/core/views/layers/StreamLayerView/#connectionStatus). This status takes precedence over
+   * [updating](https://developers.arcgis.com/javascript/latest/references/core/layers/list/Item/#updating) for stream layers.
    */
   get connectionStatus(): ConnectedLayerView["connectionStatus"] | null | undefined;
-  /**
-   * The content represented by this item.
-   *
-   * @beta
-   * @since 5.2
-   */
+  /** Identifies the content represented by this item: a layer, a track-info part, or a telemetry-display element. */
   accessor content: ItemContent;
-  /** The Error object returned if an error occurred. */
+  /** The error reported while loading the associated layer, if any. */
   get error(): EsriError | null | undefined;
   /**
-   * Whether this list item's details are expanded.
+   * Indicates whether this item's details are expanded in a consumer UI.
    *
    * @default false
    */
   accessor expanded: boolean;
   /**
-   * When `true`, marks this list item as hidden for consumer UIs.
+   * Indicates whether consumer UIs should hide this item.
    *
    * This is an alternative to [Layer.listMode](https://developers.arcgis.com/javascript/latest/references/core/layers/Layer/#listMode), which hides a layer
    * based on layer configuration.
    *
    * @default false
-   * @since 5.2
    */
   accessor hidden: boolean;
   /**
-   * Whether the layer is unsupported by the view.
+   * Indicates whether the associated layer view does not support the current view's spatial reference.
    *
    * @default false
-   * @since 5.2
    */
   get incompatible(): boolean;
-  /** The layer associated with the triggered action. */
+  /** The layer represented by this item. */
   accessor layer: Layer | Sublayer | SubtypeSublayer | SubtypeGroupLayer | null;
   /**
-   * The [LayerView](https://developers.arcgis.com/javascript/latest/references/core/views/layers/LayerView/) displaying data for the
-   * associated [layer](https://developers.arcgis.com/javascript/latest/references/core/layers/list/Item/#layer).
+   * The [LayerView](https://developers.arcgis.com/javascript/latest/references/core/views/layers/LayerView/) displaying the associated [layer](https://developers.arcgis.com/javascript/latest/references/core/layers/list/Item/#layer), if available.
+   * Subtype and sublayer items resolve to the layer view of their root layer where applicable.
    */
   get layerView(): LayerView | SpatiallyReferencedLayerView | ConnectedLayerView | null | undefined;
   /**
-   * Specifies whether to ignore the [Layer.listMode](https://developers.arcgis.com/javascript/latest/references/core/layers/Layer/#listMode) property of the child layers in the list item.
-   * Use this when child inclusion should be controlled externally instead of by each child's
-   * `listMode` value.
+   * A function called when the item is created.
+   * Use the callback to customize supported item properties or add actions and panel state.
+   *
+   * @param event - The event containing the item being created.
+   */
+  accessor listItemCreatedFunction: ItemModifier | null | undefined;
+  /**
+   * Indicates whether to ignore the [Layer.listMode](https://developers.arcgis.com/javascript/latest/references/core/layers/Layer/#listMode) property of child layers.
+   * When `true`, child inclusion is controlled externally instead of by each child's `listMode` value.
    *
    * @default false
-   * @since 5.2
    * @see [Layer.listMode](https://developers.arcgis.com/javascript/latest/references/core/layers/Layer/#listMode)
    */
   accessor listModeDisabled: boolean;
   /** Backward-compatible alias of [expanded](https://developers.arcgis.com/javascript/latest/references/core/layers/list/Item/#expanded). */
   accessor open: boolean;
   /**
-   * Additional panel state associated with this list item.
-   *
-   * @since 5.2
+   * Additional panel state associated with this item.
+   * The panel is stored as state and can be rendered by a separate consumer UI.
    */
   get panel(): ItemPanel;
   set panel(value: ItemPanelProperties);
-  /**
-   * The parent of this item
-   *
-   * @since 5.2
-   */
+  /** The parent item, if this item is nested. */
   accessor parent: Item | null | undefined;
   /**
-   * Value is `true` when [layer](https://developers.arcgis.com/javascript/latest/references/core/layers/list/Item/#layer) is being published.
-   * Value is `false` when the layer is not publishing or
+   * Indicates whether [layer](https://developers.arcgis.com/javascript/latest/references/core/layers/list/Item/#layer) is being published.
+   * The value is `false` when the layer is not publishing or
    * [checkPublishStatusEnabled](https://developers.arcgis.com/javascript/latest/references/core/layers/list/Item/#checkPublishStatusEnabled) is `false`.
    *
    * @default false
-   * @since 5.2
    */
   get publishing(): boolean;
   /**
-   * Indicates if the list item (or layer in the map) can be sorted or moved/reordered.
+   * Indicates whether this item can be sorted or moved within its parent collection.
+   * Items that represent track-info or telemetry-display content are not sortable.
    *
    * @default true
-   * @since 5.2
    * @example
    * // disables the list item from being sorted
    * listItem.sortable = false;
    */
   accessor sortable: boolean;
   /**
-   * Overall state of this item for consumer UIs.
-   *
-   * @since 5.2
+   * The overall state of this item for consumer UIs.
+   * Returns `disabled` when the item has no layer, is hidden, or is incompatible with the view;
+   * `loading` while the layer or layer view is updating; and `ready` otherwise.
    */
   get state(): State;
-  /** The title of the layer. */
+  /**
+   * The title displayed for this item.
+   * Layer items use the associated layer title, while display items use a consumer-defined title.
+   */
   get title(): string;
   set title(value: string | null | undefined);
   /**
-   * Value is `true` when the layer is updating; for example, if it is in the process of fetching data.
+   * Indicates whether the layer or its layer view is updating, for example while data is being fetched.
+   * Publishing and stream connection status take precedence over the layer's updating state.
    *
    * @default false
    */
   get updating(): boolean;
-  /** The view context for this list item. */
+  /** The map or scene view that provides context for this item and its layer view. */
   accessor view: MapViewOrSceneView | null | undefined;
-  /** Indicates how to manage the visibility of the children layers. */
+  /** Specifies how visibility is managed for this item's child layers. */
   get visibilityMode(): ItemVisibilityMode;
   /**
-   * Indicates if the Item is visible.
+   * Indicates whether this item is visible.
+   * For layer items, this controls the associated layer. For track-info and telemetry-display items,
+   * it controls the represented display element.
    *
    * @default true
    */
   accessor visible: boolean;
   /**
-   * Whether the layer is visible at the current scale or not.
+   * Indicates whether the associated layer is visible at the current view scale.
    *
    * @default true
    */
   get visibleAtCurrentScale(): boolean;
   /**
-   * Whether the layer is visible at the current time extent or not.
+   * Indicates whether the associated layer is visible at the current time extent.
    *
    * @default true
-   * @since 5.2
    */
   get visibleAtCurrentTimeExtent(): boolean;
   /**
-   * Creates a deep clone of this object.
+   * Creates a deep clone of this item, including its child items and action sections.
    *
    * @returns A clone of the new [Item](https://developers.arcgis.com/javascript/latest/references/core/layers/list/Item/) instance.
    */
   clone(): Item;
   /**
-   * Toggles the visibility state of the associated layer.
+   * Sets or toggles the visibility of the represented content.
+   * For layer items, this updates the associated layer. For track-info and telemetry-display items,
+   * it updates the represented display element.
    *
    * If `value` is provided, visibility is set to that value.
    * Otherwise, visibility is inverted.
    *
    * @param value - Optional target visibility value.
    * @returns The resulting visibility value.
-   * @since 5.2
    */
   toggleVisibility(value?: boolean): boolean;
 }

package/layers/list/Item.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{__decorate as t}from"tslib";import e from"../../core/Accessor.js";import{isSome as i}from"../../core/arrayUtils.js";import n from"../../core/Collection.js";import{IdentifiableMixin as r}from"../../core/Identifiable.js";import{watch as s,initial as l}from"../../core/reactiveUtils.js";import{property as o,cast as a,subclass as h}from"../../core/accessorSupport/decorators.js";import{ensureType as d}from"../../core/accessorSupport/ensureType.js";import{get as p}from"../../core/accessorSupport/get.js";import c from"./ItemPanel.js";import{isLayerOutsideScaleRange as y,findLayerVisibilityMode as u,findLayerListMode as m,canDisplayLayer as b,getNormalizedChildLayerProperty as f}from"./support/layerListUtils.js";import{telemetryDisplayPropertyNames as v}from"../support/telemetryDisplayUtils.js";import{trackInfoPartPropertyNames as g}from"../support/trackInfoUtils.js";import C from"../../support/actions/ActionBase.js";import _ from"../../support/actions/ActionButton.js";import w from"../../support/actions/ActionToggle.js";var S;const k=n.ofType({key:"type",defaultKeyValue:"button",base:C,typeMap:{button:_,toggle:w}}),I=n.ofType(k);function M(t){return"csv"===t?.type||"feature"===t?.type||"geojson"===t?.type||"ogc-feature"===t?.type||"stream"===t?.type}function x(t){return"video"===t?.type}const O="layer",P="child-list-mode",E="hide";let D=S=class extends(r(e)){constructor(t){super(t),this.actionsSections=new I,this.actionsExpanded=!1,this.checkPublishStatusEnabled=!1,this.children=new(n.ofType(S)),this.childrenSortable=!0,this.content={type:"layer"},this.hidden=!1,this.layer=null,this.listItemCreatedFunction=null,this.listModeDisabled=!1,this.expanded=!1,this.parent=null,this.view=null}initialize(){if(this.addHandles([s(()=>[this.layer,this.layer?.listMode,this.listModeDisabled],()=>this._watchLayerProperties(this.layer),l),s(()=>this.checkPublishStatusEnabled,t=>this._updateChildrenPublishing(t),l),s(()=>this.view,t=>this._updateChildrenView(t),l),s(()=>this.panel,t=>this._setItemOnPanel(t),l),s(()=>{const t=this.layer,e=M(t)?t.trackInfo:null;return[t,e,e?.enabled]},()=>this._compileTrackInfoChildren(),l),s(()=>{const t=this.layer;return[t,x(t)?t.telemetryDisplay:null]},()=>this._compileTelemetryDisplayChildren(),l)]),"function"==typeof this.listItemCreatedFunction){const t={item:this};this.listItemCreatedFunction.call(null,t)}}destroy(){this.panel?.destroy(),this.children.destroyAll(),this.view=null}get actionsOpen(){return this.actionsExpanded}set actionsOpen(t){this.actionsExpanded=t}get connectionStatus(){const{layerView:t,publishing:e}=this;if(!e&&t&&"connectionStatus"in t)return t.connectionStatus}get error(){return this.layer?.loadError}get incompatible(){const{layerView:t}=this;return!(!t||!("spatialReferenceSupported"in t))&&!t.spatialReferenceSupported}get layerView(){const{layer:t,view:e}=this;if(!t||!e||"sublayer"===t.type)return null;const i="subtype-sublayer"===t.type?t.parent:t;return e.allLayerViews.find(t=>t.layer===i)??null}get open(){return this.expanded}set open(t){this.expanded=t}set panel(t){const e=this._get("panel");t!==e&&t&&e?.destroy(),this._set("panel",t)}castPanel(t){return this.expanded&&!t.hasOwnProperty("open")&&(t.open=!0),d(c,t)}get sortable(){return"layer"===this.content.type&&"knowledge-graph-sublayer"!==this.layer?.type&&this._get("sortable")}set sortable(t){this._set("sortable",t)}get state(){return!this.layer||this.hidden||this.incompatible?"disabled":this.updating?"loading":"ready"}get title(){if("layer"!==this.content.type)return this._get("title")||"";const t=p(this,"layer.layer");return(!t||t&&p(this,"layer.layer.loaded"))&&p(this,"layer.title")||p(this,"layer.attributes.title")||""}set title(t){this._override("title",t)}get publishing(){const{layer:t,checkPublishStatusEnabled:e}=this;return!!(e&&t&&"publishingInfo"in t&&"publishing"===t.publishingInfo?.status)}get updating(){const{layerView:t,connectionStatus:e,layer:i,publishing:n}=this;return!n&&!e&&(t?t.updating:"loading"===i?.loadStatus||!1)}get visible(){const{content:t,layer:e}=this;return"track-info"===t.type?this._getTrackPart(t.name)?.visible??!1:"telemetry-display"===t.type?!(!x(e)||!e.telemetryDisplay)&&e.telemetryDisplay[t.name]:!!e?.visible}set visible(t){const{content:e,layer:i}=this;if("track-info"===e.type){const i=this._getTrackPart(e.name);return void(i&&(i.visible=t))}"telemetry-display"!==e.type?i&&(i.visible=t):x(i)&&i.telemetryDisplay&&(i.telemetryDisplay[e.name]=t)}get visibleAtCurrentScale(){return this.layerView?.visibleAtCurrentScale??!y(this.layer,this.view?.scale)}get visibleAtCurrentTimeExtent(){return this.layerView?.visibleAtCurrentTimeExtent??!0}get visibilityMode(){return u(this.layer)}clone(){return new S({actionsExpanded:this.actionsExpanded,actionsSections:this.actionsSections.clone(),checkPublishStatusEnabled:this.checkPublishStatusEnabled,children:this.children.clone(),childrenSortable:this.childrenSortable,content:{...this.content},expanded:this.expanded,hidden:this.hidden,layer:this.layer,listItemCreatedFunction:this.listItemCreatedFunction,listModeDisabled:this.listModeDisabled,panel:this.panel,parent:this.parent,sortable:this.sortable,title:this.title,view:this.view,visible:this.visible})}toggleVisibility(t){if(!this.layer)return!1;const e=t??!this.visible;return this.visible=e,this.visible}_getTrackPart(t){const{layer:e}=this;return M(e)?e.trackInfo?.[t]??null:null}_setItemOnPanel(t){t&&(t.listItem=this)}_compileTrackInfoChildren(){const t=this.layer,e=this.children.filter(t=>"track-info"===t.content.type);if("layer"===this.content.type&&M(t)&&t.trackInfo?.enabled){e.some(e=>e.layer!==t)&&this.children.destroyMany(e.toArray());for(const e of g)this.children.some(t=>"track-info"===t.content.type&&t.content.name===e)||this.children.add(new S({content:{type:"track-info",name:e},layer:t,listItemCreatedFunction:this.listItemCreatedFunction,parent:this}))}else this.children.destroyMany(e.toArray())}_compileTelemetryDisplayChildren(){const t=this.layer,e=this.children.filter(t=>"telemetry-display"===t.content.type);if("layer"===this.content.type&&x(t)&&t.telemetryDisplay){e.some(e=>e.layer!==t)&&this.children.destroyMany(e.toArray());for(const e of v)this.children.some(t=>"telemetry-display"===t.content.type&&t.content.name===e)||this.children.add(new S({content:{type:"telemetry-display",name:e},layer:t,listItemCreatedFunction:this.listItemCreatedFunction,parent:this}))}else this.children.destroyMany(e.toArray())}_updateChildrenPublishing(t){this.children?.forEach(e=>e.checkPublishStatusEnabled=t)}_updateChildrenView(t){const e=this.children;e&&e.forEach(e=>e.view=t)}_createChildren(t){const{listModeDisabled:e,children:i}=this,n=t.filter(t=>!i.some(e=>"layer"===e.content.type&&e.layer===t));i.addMany(this._createChildItems(n,e).toArray())}_destroyChildren(t){const{children:e}=this,i=e.filter(e=>"layer"===e.content.type&&!!e.layer&&!t.includes(e.layer));e.destroyMany(i.toArray())}_sortChildren(t){this.children.sort((e,i)=>{const n="layer"!==e.content.type,r="layer"!==i.content.type;return n||r?n?r?"track-info"===e.content.type&&"track-info"===i.content.type?g.indexOf(e.content.name)-g.indexOf(i.content.name):"telemetry-display"===e.content.type&&"telemetry-display"===i.content.type?v.indexOf(e.content.name)-v.indexOf(i.content.name):"track-info"===e.content.type?-1:1:1:-1:t.indexOf(i.layer)-t.indexOf(e.layer)})}_destroyLayerChildren(){this.removeHandles(P),this.children.destroyMany(this.children.filter(t=>"layer"===t.content.type).toArray())}_watchChildLayerListMode(t){this.removeHandles(P),this.listModeDisabled||this.addHandles(t.toArray().map(e=>s(()=>e.listMode,()=>this._compileChildren(t))),P)}_compileChildren(t){const e=this.listModeDisabled?t:t?.filter(t=>m(t)!==E);t?.length?(this._createChildren(e),this._destroyChildren(e),this._sortChildren(e),this._watchChildLayerListMode(t)):this._destroyLayerChildren()}_watchSublayerChanges(t){t&&this.addHandles(t.on("change",()=>this._compileChildren(t)),O)}_initializeChildLayers(t){this._compileChildren(t),this._watchSublayerChanges(t)}_createChildItems(t,e){return t.reverse().map(t=>e||b(t)?new S({layer:t,checkPublishStatusEnabled:this.checkPublishStatusEnabled,listItemCreatedFunction:this.listItemCreatedFunction,listModeDisabled:this.listModeDisabled,parent:this,view:this.view}):null).filter(i)}_watchLayerProperties(t){if(this.removeHandles(O),this.removeHandles(P),!t||"layer"!==this.content.type)return;if("hide-children"===(!this.listModeDisabled&&m(t)))return void this._destroyLayerChildren();const e=f(t);e&&this.addHandles(s(()=>t[e],i=>{const n=i;t.hasOwnProperty(e)&&n&&this._initializeChildLayers(n)},l),O)}};t([o({type:I})],D.prototype,"actionsSections",void 0),t([o()],D.prototype,"actionsExpanded",void 0),t([o()],D.prototype,"actionsOpen",null),t([o()],D.prototype,"checkPublishStatusEnabled",void 0),t([o({type:n.ofType(S)})],D.prototype,"children",void 0),t([o()],D.prototype,"childrenSortable",void 0),t([o({nonNullable:!0})],D.prototype,"content",void 0),t([o({readOnly:!0})],D.prototype,"connectionStatus",null),t([o({readOnly:!0})],D.prototype,"error",null),t([o()],D.prototype,"hidden",void 0),t([o({readOnly:!0})],D.prototype,"incompatible",null),t([o()],D.prototype,"layer",void 0),t([o({readOnly:!0})],D.prototype,"layerView",null),t([o()],D.prototype,"listItemCreatedFunction",void 0),t([o({nonNullable:!0})],D.prototype,"listModeDisabled",void 0),t([o()],D.prototype,"expanded",void 0),t([o()],D.prototype,"open",null),t([o({type:c})],D.prototype,"panel",null),t([a("panel")],D.prototype,"castPanel",null),t([o()],D.prototype,"parent",void 0),t([o({value:!0})],D.prototype,"sortable",null),t([o({readOnly:!0})],D.prototype,"state",null),t([o()],D.prototype,"title",null),t([o({readOnly:!0})],D.prototype,"publishing",null),t([o({readOnly:!0})],D.prototype,"updating",null),t([o()],D.prototype,"view",void 0),t([o()],D.prototype,"visible",null),t([o({readOnly:!0})],D.prototype,"visibleAtCurrentScale",null),t([o({readOnly:!0})],D.prototype,"visibleAtCurrentTimeExtent",null),t([o({readOnly:!0})],D.prototype,"visibilityMode",null),D=S=t([h("esri.layers.list.Item")],D);const A=D;export{A as default};
+import{__decorate as t}from"tslib";import e from"../../core/Accessor.js";import{isSome as i}from"../../core/arrayUtils.js";import n from"../../core/Collection.js";import{IdentifiableMixin as r}from"../../core/Identifiable.js";import{watch as s,initial as l}from"../../core/reactiveUtils.js";import{property as o,cast as a,subclass as h}from"../../core/accessorSupport/decorators.js";import{ensureType as d}from"../../core/accessorSupport/ensureType.js";import{get as p}from"../../core/accessorSupport/get.js";import c from"./ItemPanel.js";import{isLayerOutsideScaleRange as y,findLayerVisibilityMode as u,findLayerListMode as m,canDisplayLayer as b,getNormalizedChildLayerProperty as f}from"./support/layerListUtils.js";import{telemetryDisplayPropertyNames as v}from"../support/telemetryDisplayUtils.js";import{trackInfoPartPropertyNames as g}from"../support/trackInfoUtils.js";import C from"../../support/actions/ActionBase.js";import _ from"../../support/actions/ActionButton.js";import w from"../../support/actions/ActionToggle.js";var S;const k=n.ofType({key:"type",defaultKeyValue:"button",base:C,typeMap:{button:_,toggle:w}}),I=n.ofType(k);function M(t){return"csv"===t?.type||"feature"===t?.type||"geojson"===t?.type||"ogc-feature"===t?.type||"stream"===t?.type}function x(t){return"video"===t?.type}const O="layer",P="child-list-mode",E="hide";let D=S=class extends(r(e)){constructor(t){super(t),this.actionsExpanded=!1,this.actionsSections=new I,this.checkPublishStatusEnabled=!1,this.children=new(n.ofType(S)),this.childrenSortable=!0,this.content={type:"layer"},this.expanded=!1,this.hidden=!1,this.layer=null,this.listItemCreatedFunction=null,this.listModeDisabled=!1,this.parent=null,this.view=null}initialize(){if(this.addHandles([s(()=>[this.layer,this.layer?.listMode,this.listModeDisabled],()=>this._watchLayerProperties(this.layer),l),s(()=>this.checkPublishStatusEnabled,t=>this._updateChildrenPublishing(t),l),s(()=>this.view,t=>this._updateChildrenView(t),l),s(()=>this.panel,t=>this._setItemOnPanel(t),l),s(()=>{const t=this.layer,e=M(t)?t.trackInfo:null;return[t,e,e?.enabled]},()=>this._compileTrackInfoChildren(),l),s(()=>{const t=this.layer;return[t,x(t)?t.telemetryDisplay:null]},()=>this._compileTelemetryDisplayChildren(),l)]),"function"==typeof this.listItemCreatedFunction){const t={item:this};this.listItemCreatedFunction.call(null,t)}}destroy(){this.panel?.destroy(),this.children.destroyAll(),this.view=null}get actionsOpen(){return this.actionsExpanded}set actionsOpen(t){this.actionsExpanded=t}get connectionStatus(){const{layerView:t,publishing:e}=this;if(!e&&t&&"connectionStatus"in t)return t.connectionStatus}get error(){return this.layer?.loadError}get incompatible(){const{layerView:t}=this;return!(!t||!("spatialReferenceSupported"in t))&&!t.spatialReferenceSupported}get layerView(){const{layer:t,view:e}=this;if(!t||!e||"sublayer"===t.type)return null;const i="subtype-sublayer"===t.type?t.parent:t;return e.allLayerViews.find(t=>t.layer===i)??null}get open(){return this.expanded}set open(t){this.expanded=t}set panel(t){const e=this._get("panel");t!==e&&t&&e?.destroy(),this._set("panel",t)}castPanel(t){return this.expanded&&!t.hasOwnProperty("open")&&(t.open=!0),d(c,t)}get publishing(){const{layer:t,checkPublishStatusEnabled:e}=this;return!!(e&&t&&"publishingInfo"in t&&"publishing"===t.publishingInfo?.status)}get sortable(){return"layer"===this.content.type&&"knowledge-graph-sublayer"!==this.layer?.type&&this._get("sortable")}set sortable(t){this._set("sortable",t)}get state(){return!this.layer||this.hidden||this.incompatible?"disabled":this.updating?"loading":"ready"}get title(){if("layer"!==this.content.type)return this._get("title")||"";const t=p(this,"layer.layer");return(!t||t&&p(this,"layer.layer.loaded"))&&p(this,"layer.title")||p(this,"layer.attributes.title")||""}set title(t){this._override("title",t)}get updating(){const{layerView:t,connectionStatus:e,layer:i,publishing:n}=this;return!n&&!e&&(t?t.updating:"loading"===i?.loadStatus||!1)}get visible(){const{content:t,layer:e}=this;return"track-info"===t.type?this._getTrackPart(t.name)?.visible??!1:"telemetry-display"===t.type?!(!x(e)||!e.telemetryDisplay)&&e.telemetryDisplay[t.name]:!!e?.visible}set visible(t){const{content:e,layer:i}=this;if("track-info"===e.type){const i=this._getTrackPart(e.name);return void(i&&(i.visible=t))}"telemetry-display"!==e.type?i&&(i.visible=t):x(i)&&i.telemetryDisplay&&(i.telemetryDisplay[e.name]=t)}get visibleAtCurrentScale(){return this.layerView?.visibleAtCurrentScale??!y(this.layer,this.view?.scale)}get visibleAtCurrentTimeExtent(){return this.layerView?.visibleAtCurrentTimeExtent??!0}get visibilityMode(){return u(this.layer)}clone(){return new S({actionsExpanded:this.actionsExpanded,actionsSections:this.actionsSections.clone(),checkPublishStatusEnabled:this.checkPublishStatusEnabled,children:this.children.clone(),childrenSortable:this.childrenSortable,content:{...this.content},expanded:this.expanded,hidden:this.hidden,layer:this.layer,listItemCreatedFunction:this.listItemCreatedFunction,listModeDisabled:this.listModeDisabled,panel:this.panel,parent:this.parent,sortable:this.sortable,title:this.title,view:this.view,visible:this.visible})}toggleVisibility(t){if(!this.layer)return!1;const e=t??!this.visible;return this.visible=e,this.visible}_compileChildren(t){const e=this.listModeDisabled?t:t?.filter(t=>m(t)!==E);t?.length?(this._createChildren(e),this._destroyChildren(e),this._sortChildren(e),this._watchChildLayerListMode(t)):this._destroyLayerChildren()}_compileTelemetryDisplayChildren(){const t=this.layer,e=this.children.filter(t=>"telemetry-display"===t.content.type);if("layer"===this.content.type&&x(t)&&t.telemetryDisplay){e.some(e=>e.layer!==t)&&this.children.destroyMany(e.toArray());for(const e of v)this.children.some(t=>"telemetry-display"===t.content.type&&t.content.name===e)||this.children.add(new S({content:{type:"telemetry-display",name:e},layer:t,listItemCreatedFunction:this.listItemCreatedFunction,parent:this}))}else this.children.destroyMany(e.toArray())}_compileTrackInfoChildren(){const t=this.layer,e=this.children.filter(t=>"track-info"===t.content.type);if("layer"===this.content.type&&M(t)&&t.trackInfo?.enabled){e.some(e=>e.layer!==t)&&this.children.destroyMany(e.toArray());for(const e of g)this.children.some(t=>"track-info"===t.content.type&&t.content.name===e)||this.children.add(new S({content:{type:"track-info",name:e},layer:t,listItemCreatedFunction:this.listItemCreatedFunction,parent:this}))}else this.children.destroyMany(e.toArray())}_createChildItems(t,e){return t.reverse().map(t=>e||b(t)?new S({checkPublishStatusEnabled:this.checkPublishStatusEnabled,layer:t,listItemCreatedFunction:this.listItemCreatedFunction,listModeDisabled:this.listModeDisabled,parent:this,view:this.view}):null).filter(i)}_createChildren(t){const{listModeDisabled:e,children:i}=this,n=t.filter(t=>!i.some(e=>"layer"===e.content.type&&e.layer===t));i.addMany(this._createChildItems(n,e).toArray())}_destroyChildren(t){const{children:e}=this,i=e.filter(e=>"layer"===e.content.type&&!!e.layer&&!t.includes(e.layer));e.destroyMany(i.toArray())}_destroyLayerChildren(){this.removeHandles(P),this.children.destroyMany(this.children.filter(t=>"layer"===t.content.type).toArray())}_getTrackPart(t){const{layer:e}=this;return M(e)?e.trackInfo?.[t]??null:null}_initializeChildLayers(t){this._compileChildren(t),this._watchSublayerChanges(t)}_setItemOnPanel(t){t&&(t.listItem=this)}_sortChildren(t){this.children.sort((e,i)=>{const n="layer"!==e.content.type,r="layer"!==i.content.type;return n||r?n?r?"track-info"===e.content.type&&"track-info"===i.content.type?g.indexOf(e.content.name)-g.indexOf(i.content.name):"telemetry-display"===e.content.type&&"telemetry-display"===i.content.type?v.indexOf(e.content.name)-v.indexOf(i.content.name):"track-info"===e.content.type?-1:1:1:-1:t.indexOf(i.layer)-t.indexOf(e.layer)})}_updateChildrenPublishing(t){this.children?.forEach(e=>e.checkPublishStatusEnabled=t)}_updateChildrenView(t){const e=this.children;e&&e.forEach(e=>e.view=t)}_watchChildLayerListMode(t){this.removeHandles(P),this.listModeDisabled||this.addHandles(t.toArray().map(e=>s(()=>e.listMode,()=>this._compileChildren(t))),P)}_watchLayerProperties(t){if(this.removeHandles(O),this.removeHandles(P),!t||"layer"!==this.content.type)return;if("hide-children"===(!this.listModeDisabled&&m(t)))return void this._destroyLayerChildren();const e=f(t);e&&this.addHandles(s(()=>t[e],i=>{const n=i;t.hasOwnProperty(e)&&n&&this._initializeChildLayers(n)},l),O)}_watchSublayerChanges(t){t&&this.addHandles(t.on("change",()=>this._compileChildren(t)),O)}};t([o()],D.prototype,"actionsExpanded",void 0),t([o()],D.prototype,"actionsOpen",null),t([o({type:I})],D.prototype,"actionsSections",void 0),t([o()],D.prototype,"checkPublishStatusEnabled",void 0),t([o({type:n.ofType(S)})],D.prototype,"children",void 0),t([o()],D.prototype,"childrenSortable",void 0),t([o({readOnly:!0})],D.prototype,"connectionStatus",null),t([o({nonNullable:!0})],D.prototype,"content",void 0),t([o({readOnly:!0})],D.prototype,"error",null),t([o()],D.prototype,"expanded",void 0),t([o()],D.prototype,"hidden",void 0),t([o({readOnly:!0})],D.prototype,"incompatible",null),t([o()],D.prototype,"layer",void 0),t([o({readOnly:!0})],D.prototype,"layerView",null),t([o()],D.prototype,"listItemCreatedFunction",void 0),t([o({nonNullable:!0})],D.prototype,"listModeDisabled",void 0),t([o()],D.prototype,"open",null),t([o({type:c})],D.prototype,"panel",null),t([a("panel")],D.prototype,"castPanel",null),t([o()],D.prototype,"parent",void 0),t([o({readOnly:!0})],D.prototype,"publishing",null),t([o({value:!0})],D.prototype,"sortable",null),t([o({readOnly:!0})],D.prototype,"state",null),t([o()],D.prototype,"title",null),t([o({readOnly:!0})],D.prototype,"updating",null),t([o()],D.prototype,"view",void 0),t([o()],D.prototype,"visible",null),t([o({readOnly:!0})],D.prototype,"visibleAtCurrentScale",null),t([o({readOnly:!0})],D.prototype,"visibleAtCurrentTimeExtent",null),t([o({readOnly:!0})],D.prototype,"visibilityMode",null),D=S=t([h("esri.layers.list.Item")],D);const A=D;export{A as default};

package/layers/list/ItemPanel.d.ts

@@ -1,72 +1,61 @@
 import type Accessor from "../../core/Accessor.js";
 import type Item from "./Item.js";
-import type { IdentifiableMixin, IdentifiableMixinProperties } from "../../core/Identifiable.js";
-
-export interface ItemPanelProperties extends IdentifiableMixinProperties, Partial<Pick<ItemPanel, "content" | "disabled" | "flowEnabled" | "icon" | "image" | "listItem" | "open" | "title" | "visible">> {}
-
-/**
- * Arbitrary data associated with the panel.
- *
- * @see [content](https://developers.arcgis.com/javascript/latest/references/core/layers/list/ItemPanel/#content)
- */
-export type ItemPanelContent = "legend" | HTMLElement | string;
-
-/**
- * Defines one or more panel content values.
- *
- * @see [content](https://developers.arcgis.com/javascript/latest/references/core/layers/list/ItemPanel/#content)
- */
-export type ItemPanelContents = ItemPanelContent | ItemPanelContent[];
+import type { IdentifiableMixin } from "../../core/Identifiable.js";
+import type { ItemPanelContents, ItemPanelProperties } from "./types.js";
 
 /**
- * Generic state container for additional list item details.
+ * Stores state for additional content associated with a layer-list item.
  *
- * This class does not render UI. It stores panel state that can be consumed by separate view components.
+ * This class does not render UI. Consumer components use its content, presentation, and interaction state
+ * to render a panel associated with an [Item](https://developers.arcgis.com/javascript/latest/references/core/layers/list/Item/).
  *
+ * @beta
  * @since 5.2
  */
 export default class ItemPanel extends ItemPanelSuperclass {
   constructor(properties?: ItemPanelProperties);
-  /** Arbitrary content metadata for the panel. */
+  /**
+   * The content to display in the panel.
+   * Content may be a string, an `HTMLElement`, the `"legend"` keyword, or an array of content values.
+   */
   accessor content: ItemPanelContents | null | undefined;
   /**
-   * If `true`, panel interactions are disabled.
+   * Indicates whether the panel cannot be opened or interacted with.
    *
    * @default false
-   * @since 5.2
    */
   accessor disabled: boolean;
   /**
-   * Indicates if panel content should be shown in a drill-in flow by a consumer UI.
+   * Indicates whether a consumer UI should display the panel in a drill-in flow.
+   * When `true`, the panel can be rendered as a separate flow step instead of inline content.
    *
    * @default false
-   * @since 5.2
    */
   accessor flowEnabled: boolean;
-  /**
-   * Identifier for an icon to represent this panel.
-   *
-   * @since 5.2
-   */
+  /** The icon identifier used by a consumer UI to represent this panel. */
   accessor icon: string | null | undefined;
-  /** URL or data URI used by consumer UIs to represent the panel. */
+  /** A URL or data URI for an image used by a consumer UI to represent this panel. */
   accessor image: string | null | undefined;
-  /** The list item associated with this panel. */
+  /**
+   * The list item that owns this panel.
+   * This association is set automatically when the panel is assigned to an item.
+   */
   accessor listItem: Item | null | undefined;
   /**
-   * Indicates if the panel is open.
+   * Indicates whether the panel is open in a consumer UI.
    *
    * @default false
    */
   accessor open: boolean;
   /**
-   * The title of the panel.
+   * The title displayed by a consumer UI for this panel.
    *
    * @default ""
    */
   accessor title: string;
   /**
-   * Indicates whether consumer UIs should show this panel.
+   * Indicates whether a consumer UI should display this panel.
+   * Set to `false` to hide the panel while preserving its content and state.
    *
    * @default true
    */