@arcgis/map-components 5.2.0-next.87 → 5.2.0-next.89

package/dist/components/arcgis-layer-list-next/customElement.d.ts

@@ -11,16 +11,19 @@ import type { ArcgisReferenceElement, HeadingLevel, IconName } from "../types.js
 import type { CatalogLayerListParams, FlowLayer, TableListParams } from "./types.js";
 import type { ArcgisCatalogLayerListNext } from "../arcgis-catalog-layer-list-next/customElement.js";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
-import type { MapViewOrSceneView } from "@arcgis/core/views/MapViewOrSceneView.js";
 import type { ItemModifier, State } from "@arcgis/core/layers/list/types.js";
 import type { List as List } from "@esri/calcite-components/components/calcite-list";
+import type { MapViewOrSceneView } from "@arcgis/core/views/MapViewOrSceneView.js";
 
 /**
  * > [!WARNING]
- * > The Layer List (next) component is the successor to the Layer List component, provided to you early for testing and feedback. In version 6.0, the implementation of [arcgis-layer-list](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list/) will be updated under the hood to that of [arcgis-layer-list-next](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/), and this component will be removed. There is a breaking change in how events for [catalogLayerList](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#catalogLayerList) and [tableList](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#tableList) are handled compared to Layer List. To update at version 6.0, simply remove `-next` from the component name.
+ * > The Layer List (next) component is the successor to the Layer List component, provided to you early for testing and feedback.
+ * In version 6.0, the implementation of [arcgis-layer-list](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list/) will be updated under the hood to that of [arcgis-layer-list-next](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/),
+ * and this component will be removed. There is a breaking change in the name of the events for [catalogLayerList](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#catalogLayerList) and
+ * [tableList](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#tableList) compared to [arcgis-layer-list](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list/). To update at version 6.0, simply remove `-next` from the component name.
  *
  * The Layer List (next) provides a way to display a list of layers and switch on/off their visibility.
- * The [listItemCreatedFunction](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#listItemCreatedFunction) and the [ListItem](https://developers.arcgis.com/javascript/latest/references/core/widgets/LayerList/ListItem/) API provides access to each layer's properties, allows
+ * The [listItemCreatedFunction](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#listItemCreatedFunction) and the [Item](https://developers.arcgis.com/javascript/latest/references/core/layers/list/Item/) API provides access to each layer's properties, allows
  * the developer to configure actions related to the layer, and allows the developer to add content to the item related to the layer.
  *
  * > **Notes**
@@ -46,15 +49,22 @@ export abstract class ArcgisLayerListNext extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-layer-list-next auto-destroy-disabled></arcgis-layer-list-next>
+   * ```
+   *
+   * ```js
+   * layerListNextElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**
-   * The CatalogLayerList that displays a catalog layer's [dynamic group layer](https://developers.arcgis.com/javascript/latest/references/core/layers/CatalogLayer/#dynamicGroupLayer).
-   * The catalog layer list will be displayed as an expandable ListItem in the root of the layer list when a CatalogLayer is present in the map.
-   * This property is set when a catalog layer's dynamic group layer is expanded in the LayerList. Otherwise, it is `null`.
-   * This property is useful for listening to the [arcgisTriggerAction](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-catalog-layer-list/#event-arcgisTriggerAction) event and managing selections in catalog layers.
-   *
-   * ![CatalogLayerList](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/catalog-layer-list.avif)
+   * The [arcgis-catalog-layer-list-next](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-catalog-layer-list-next/) that displays a catalog layer's [dynamic group layer](https://developers.arcgis.com/javascript/latest/references/core/layers/CatalogLayer/#dynamicGroupLayer).
+   * The catalog layer list will be displayed as an expandable [Item](https://developers.arcgis.com/javascript/latest/references/core/layers/list/Item/) in the root of the layer list when a CatalogLayer is present in the map.
+   * This property is set when a catalog layer's dynamic group layer is expanded in the layer list. Otherwise, it is `null`.
+   * This property is useful for listening to the [arcgis-catalog-layer-list-next.@arcgisTriggerAction](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-catalog-layer-list-next/#event-arcgisTriggerAction) event and managing selections in catalog layers.
    *
    * @example
    * ```js
@@ -92,15 +102,16 @@ export abstract class ArcgisLayerListNext extends LitElement {
    * );
    * layerListHandles.push(catalogSelectionWatchHandle);
    * ```
+   * @see [arcgis-catalog-layer-list-next](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-catalog-layer-list-next/)
+   * @see [catalogOptions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#catalogOptions)
    */
   get catalogLayerList(): ArcgisCatalogLayerListNext | undefined;
   /**
    * [CatalogLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/CatalogLayer/) specific properties.
-   * Catalog layers will display their [CatalogLayer#dynamicGroupLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/CatalogLayer/#dynamicGroupLayer) as an expandable [arcgis-catalog-layer-list](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-catalog-layer-list/) in the Layer List component.
+   * Catalog layers will display their [CatalogLayer#dynamicGroupLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/CatalogLayer/#dynamicGroupLayer) as an expandable [arcgis-catalog-layer-list-next](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-catalog-layer-list-next/) in the arcgis-layer-list-next component.
    * This list item will only be displayed when catalog layers with dynamic group layers are loaded in the map.
-   * These are the properties that are used to configure the [arcgis-catalog-layer-list](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-catalog-layer-list/).
+   * These are the properties that are used to configure the [arcgis-catalog-layer-list-next](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-catalog-layer-list-next/).
    *
-   * @see [arcgis-catalog-layer-list](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-catalog-layer-list/) for more details on the catalog layer list and its properties.
    * @example
    * ```js
    * layerListElement.catalogOptions = {
@@ -108,122 +119,181 @@ export abstract class ArcgisLayerListNext extends LitElement {
    *       const { item } = event;
    *       item.actionsSections = [
    *         [
-   *           {
+   *           new ActionToggle({
    *             title: "Add layer to map",
    *             icon: "add-layer",
    *             id: "add-layer"
-   *           }
+   *           });
    *         ]
    *       ];
    *     },
    *     selectionMode: "single"
    *   };
    * ```
+   * @see [arcgis-catalog-layer-list-next](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-catalog-layer-list-next/)
+   * @see [catalogLayerList](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#catalogLayerList)
    */
   accessor catalogOptions: CatalogLayerListParams | undefined;
   /**
    * Indicates whether a component is closed. When `true`, the component will be hidden.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-layer-list-next closed></arcgis-layer-list-next>
+   * ```
+   *
+   * ```js
+   * layerListNextElement.closed = true;
+   * ```
+   * 
    */
   accessor closed: boolean;
   /**
-   * Indicates whether the component is collapsed.
-   * When collapsed, only the collapse button and heading are displayed.
+   * Indicates whether the component is collapsed. When collapsed, only the collapse button and heading are displayed.
    *
    * @default false
-   * @see [showCollapseButton](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#showCollapseButton)
    * @example
+   * ```html
+   * <arcgis-layer-list-next collapsed></arcgis-layer-list-next>
+   * ```
+   *
    * ```js
-   * layerListElement.collapsed = true;
+   * layerListNextElement.collapsed = true;
    * ```
+   * 
    */
   accessor collapsed: boolean;
   /**
-   * Indicates whether [list items](https://developers.arcgis.com/javascript/latest/references/core/widgets/LayerList/ListItem/) may be reordered within the list by dragging and dropping.
-   * MapImageLayer [MapImageLayer#sublayers](https://developers.arcgis.com/javascript/latest/references/core/layers/MapImageLayer/#sublayers) can be reordered only within their parent MapImageLayer and can not be dragged out as a separate layer.
-   * Drag won't be enabled until the number of list items is equal to or greater than than the value set set in [minDragEnabledItems](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#minDragEnabledItems).
+   * Indicates whether [items](https://developers.arcgis.com/javascript/latest/references/core/layers/list/Item/) may be reordered within the list by dragging and dropping. MapImageLayer [MapImageLayer#sublayers](https://developers.arcgis.com/javascript/latest/references/core/layers/MapImageLayer/#sublayers) can be reordered only within their parent MapImageLayer and can not be dragged out as a separate layer. Drag and drop won't be enabled until the number of list items is equal to or greater than than the value set set in [minDragEnabledItems](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#minDragEnabledItems).
    *
    * @default false
-   * @see [minDragEnabledItems](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#minDragEnabledItems)
    * @example
+   * ```html
+   * <arcgis-layer-list-next drag-enabled></arcgis-layer-list-next>
+   * ```
+   *
    * ```js
-   * layerListElement.dragEnabled = true;
+   * layerListNextElement.dragEnabled = true;
    * ```
+   * 
    */
   accessor dragEnabled: boolean;
   /**
-   * Placeholder text used in the filter input if [showFilter](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#showFilter) is true.
+   * Placeholder text used in the filter input when filtering is enabled.
    *
    * @default ""
-   * @see [showFilter](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#showFilter)
    * @example
+   * ```html
+   * <arcgis-layer-list-next filter-placeholder="Search..."></arcgis-layer-list-next>
+   * ```
+   *
    * ```js
-   * layerListElement.filterPlaceholder = "Filter layers";
+   * layerListNextElement.filterPlaceholder = "Search...";
    * ```
+   * 
    */
   accessor filterPlaceholder: string;
   /**
-   * Specifies a function to handle filtering [list items](https://developers.arcgis.com/javascript/latest/references/core/widgets/LayerList/ListItem/).
+   * Specifies a function to determine whether a list item should be included in filter results.
    *
    * @example
+   * 
    * ```js
-   * layerListElement.filterPredicate = (item) => item.title.toLowerCase().includes("streets");
+   * layerListNextElement.filterPredicate = (item) => item.title.toLowerCase().includes("streets");
    * ```
+   * 
    */
   accessor filterPredicate: ((item: Item | TableItem) => boolean) | undefined;
   /**
-   * The value of the filter input if [showFilter](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#showFilter) is true.
+   * The value of the filter input text string when filtering is enabled.
    *
    * @default ""
-   * @see [showFilter](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#showFilter)
    * @example
+   * 
    * ```js
    * reactiveUtils.watch(
-   *   () => layerListElement.filterText,
+   *   () => layerListNextElement.filterText,
    *   (filterText) => console.log(filterText)
    * );
    * ```
+   * 
    */
   accessor filterText: string;
   /**
-   * Indicates the heading level to use for the heading of the component.
-   * By default, the heading is rendered as a level 2 heading (e.g., `<h2>Layer List</h2>`).
-   * Depending on the component's placement in your app, you may need to adjust this heading for proper semantics.
-   * This is important for meeting accessibility standards.
+   * Indicates the heading level to use for the heading of the component. By default, the heading is rendered as a `<h2>`. Depending on the component's placement in your app, you may need to adjust this heading for proper semantics. This is important for meeting accessibility standards.
    *
    * @default 2
-   * @see [showHeading](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#showHeading)
+   * @see [HTML heading elements](https://developer.mozilla.org/docs/Web/HTML/Element/Heading_Elements)
    * @example
+   * ```html
+   * <arcgis-layer-list-next heading-level="2"></arcgis-layer-list-next>
+   * ```
+   *
    * ```js
-   * layerListElement.headingLevel = 3;
+   * layerListNextElement.headingLevel = 2;
    * ```
+   * 
    */
   accessor headingLevel: HeadingLevel;
   /**
-   * This property provides the ability to show or hide the catalog layer list.
+   * Indicates whether to hide the catalog layer list in the component.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-layer-list-next hide-catalog-layer-list></arcgis-layer-list-next>
+   * ```
+   *
+   * ```js
+   * layerListNextElement.hideCatalogLayerList = true;
+   * ```
+   * 
    */
   accessor hideCatalogLayerList: boolean;
   /**
-   * This property provides the ability to show or hide the no items to display notice when there are no filter results.
+   * Indicates whether to hide the notice that appears when no results are found after filtering.
    *
    * @default false
-   * @since 5.2
+   * @example
+   * ```html
+   * <arcgis-layer-list-next hide-no-filter-results-notice></arcgis-layer-list-next>
+   * ```
+   *
+   * ```js
+   * layerListNextElement.hideNoFilterResultsNotice = true;
+   * ```
+   * 
    */
   accessor hideNoFilterResultsNotice: boolean;
   /**
-   * This property provides the ability to show or hide the no items to display notice.
+   * Indicates whether to hide the notice that appears when there are no items to display.
    *
    * @default false
-   * @since 5.2
+   * @example
+   * ```html
+   * <arcgis-layer-list-next hide-no-items-notice></arcgis-layer-list-next>
+   * ```
+   *
+   * ```js
+   * layerListNextElement.hideNoItemsNotice = true;
+   * ```
+   * 
    */
   accessor hideNoItemsNotice: boolean;
   /**
-   * This property provides the ability to show or hide status indicators.
+   * Indicates whether to hide status indicators in the component.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-layer-list-next hide-status-indicators></arcgis-layer-list-next>
+   * ```
+   *
+   * ```js
+   * layerListNextElement.hideStatusIndicators = true;
+   * ```
+   * 
    */
   accessor hideStatusIndicators: boolean;
   /**
@@ -262,7 +332,7 @@ export abstract class ArcgisLayerListNext extends LitElement {
    *         }
    *       ]
    *     ];
-   *   },
+   *   }
    *   minFilterItems: 1
    * }
    * ```
@@ -277,57 +347,34 @@ export abstract class ArcgisLayerListNext extends LitElement {
   /** @internal */
   accessor listItemCanReceiveFunction: CanSortFunction | undefined;
   /**
-   * A function that executes each time a [ListItem](https://developers.arcgis.com/javascript/latest/references/core/widgets/LayerList/ListItem/) is created.
-   * Use this function to add actions and panels to list items, and to override
-   * the default settings of a list item. Actions can be added to list items
-   * using the [ListItem#actionsSections](https://developers.arcgis.com/javascript/latest/references/core/widgets/LayerList/ListItem/#actionsSections)
-   * property.
+   * A function that executes each time a list item is created. Use this function to configure the list item, including its title, actions, and panels.
    *
-   * @see [Sample - LayerList component with actions](https://developers.arcgis.com/javascript/latest/sample-code/layer-list-actions/)
    * @example
+   * 
    * ```js
-   * layerListElement.listItemCreatedFunction = async function (event) {
-   *   // The event object contains an item property.
-   *   // It is a ListItem referencing the associated layer
-   *   // and other properties. You can control the visibility of the
-   *   // item, its title, and actions using this object.
-   *   const item = event.item;
+   * layerListNextElement.listItemCreatedFunction = async (event) => {
+   *   // Destructure the item from the event object
+   *   const {item} = event;
    *
+   *   // Wait for the layer to load and the item title to become available
    *   await item.layer.when();
-   *
+   *   
+   *   // If the item's title matches "US Demographics", customize the list item
    *   if (item.title === "US Demographics") {
-   *     // An array of objects defining actions to place in the LayerList.
-   *     // By making this array two-dimensional, you can separate similar
-   *     // actions into separate groups with a breaking line.
-   *     item.actionsSections = [
-   *       [
-   *         {
-   *           title: "Go to full extent",
-   *           icon: "zoom-out-fixed",
-   *           id: "full-extent",
-   *         },
-   *         {
-   *           title: "Layer information",
-   *           icon: "information",
-   *           id: "information",
-   *         },
-   *       ],
-   *       [
-   *         {
-   *           title: "Increase opacity",
-   *           icon: "chevron-up",
-   *           id: "increase-opacity",
-   *         },
-   *         {
-   *           title: "Decrease opacity",
-   *           icon: "chevron-down",
-   *           id: "decrease-opacity",
-   *         },
-   *       ],
-   *     ];
+   *     // open the list item in the LayerList component
+   *     item.open = true;
+   *     // change the title to something more descriptive
+   *     item.title = "Population by county";
+   *     // set an action for zooming to the full extent of the layer
+   *     item.actionsSections = [[{
+   *       title: "Go to full extent",
+   *       icon: "zoom-out-fixed",
+   *       id: "full-extent"
+   *     }]];
    *   }
-   * }
+   * };
    * ```
+   * 
    */
   accessor listItemCreatedFunction: ItemModifier | null | undefined;
   /**
@@ -336,12 +383,21 @@ export abstract class ArcgisLayerListNext extends LitElement {
    * @default false
    * @see [listMode](https://developers.arcgis.com/javascript/latest/references/core/layers/Layer/#listMode)
    * @since 5.2
+   * @example
+   * ```html
+   * <arcgis-layer-list-next list-mode-disabled></arcgis-layer-list-next>
+   * ```
+   *
+   * ```js
+   * layerListNextElement.listModeDisabled = true;
+   * ```
+   * 
    */
   accessor listModeDisabled: boolean;
   /**
-   * Overwrite localized strings for this component
+   * Replace localized message strings with your own strings.
    *
-   * @internal
+   * _**Note**: Individual message keys may change between releases._
    */
   accessor messageOverrides: NonNullable<ArcgisCatalogLayerListNext["messageOverrides"]> & NonNullable<ArcgisTableListNext["messageOverrides"]> & {
       componentLabel?: string | undefined;
@@ -425,36 +481,40 @@ export abstract class ArcgisLayerListNext extends LitElement {
       paused: string;
   }>;
   /**
-   * The minimum number of list items required to enable drag and drop reordering with [dragEnabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#dragEnabled).
+   * The minimum number of list items required to enable drag and drop reordering.
    *
    * @default 2
-   * @see [dragEnabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#dragEnabled)
    * @example
+   * ```html
+   * <arcgis-layer-list-next min-drag-enabled-items="5"></arcgis-layer-list-next>
+   * ```
+   *
    * ```js
-   * layerListElement.dragEnabled = true;
-   * layerListElement.minDragEnabledItems = 5;
+   * layerListNextElement.minDragEnabledItems = 5;
    * ```
+   * 
    */
   accessor minDragEnabledItems: number;
   /**
-   * The minimum number of list items required to display the [showFilter](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#showFilter) input box.
+   * The minimum number of list items required to display the filter input box.
    *
    * @default 10
-   * @see [showFilter](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#showFilter)
    * @example
+   * ```html
+   * <arcgis-layer-list-next min-filter-items="3"></arcgis-layer-list-next>
+   * ```
+   *
    * ```js
-   * layerListElement.showFilter = true;
-   * layerListElement.minFilterItems = 5;
+   * layerListNextElement.minFilterItems = 3;
    * ```
+   * 
    */
   accessor minFilterItems: number;
   /**
-   * A collection of [Layer](https://developers.arcgis.com/javascript/latest/references/core/layers/Layer/)s that are opened
+   * A collection of [layers](https://developers.arcgis.com/javascript/latest/references/core/layers/Layer/) that are opened
    * in a [catalogLayerList](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#catalogLayerList) or [tableList](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#tableList) flow item.
-   * This property is useful for backing out of the catalog layer list or table list
-   * programmatically to the parent layer list.
+   * This property is useful for backing out of the catalog layer list or table list programmatically to the parent layer list.
    *
-   * @default []
    * @see [catalogLayerList](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#catalogLayerList)
    * @see [tableList](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#tableList)
    * @example
@@ -464,7 +524,14 @@ export abstract class ArcgisLayerListNext extends LitElement {
    * ```
    */
   get openedLayers(): Collection<FlowLayer>;
-  /** A collection of [ListItem](https://developers.arcgis.com/javascript/latest/references/core/widgets/LayerList/ListItem/)s representing the operational layers in the layer list. */
+  /**
+   * A collection of [items](https://developers.arcgis.com/javascript/latest/references/core/layers/list/Item/) representing the operational layers in the layer list.
+   *
+   * @example
+   * ```js
+   * layerListElement.operationalItems.forEach(item => console.log(item.title));
+   * ```
+   */
   get operationalItems(): Collection<Item>;
   /**
    * 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.
@@ -473,15 +540,22 @@ export abstract class ArcgisLayerListNext extends LitElement {
    */
   accessor referenceElement: ArcgisReferenceElement | string | undefined;
   /**
-   * A collection of selected [ListItem](https://developers.arcgis.com/javascript/latest/references/core/widgets/LayerList/ListItem/)s representing operational layers
-   * selected by the user in the layer list.
+   * A collection of selected [items](https://developers.arcgis.com/javascript/latest/references/core/layers/list/Item/) in the list. This collection is updated when the user changes selection and is only populated when [selectionMode](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#selectionMode) is not set to `"none"`.
    *
    * @see [selectionMode](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#selectionMode)
+   * @example
+   * ```js
+   * reactiveUtils.watch(
+   *   () => layerListNext.selectedItems?.at(0)?.layer,
+   *   (layer) => {
+   *     layer && handleLayerSelection(layer);
+   *   },
+   * );
+   * ```
    */
   accessor selectedItems: Collection<Item>;
   /**
-   * Specifies the selection mode.
-   * Selected items are available in the [selectedItems](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#selectedItems) property.
+   * Specifies the selection mode. Selected items are available in the [selectedItems](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#selectedItems) property.
    *
    * | Value | Description |
    * | ----- | ----------- |
@@ -493,52 +567,107 @@ export abstract class ArcgisLayerListNext extends LitElement {
    * @default "none"
    * @see [selectedItems](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#selectedItems)
    * @example
+   * ```html
+   * <arcgis-layer-list-next selection-mode="multiple"></arcgis-layer-list-next>
+   * ```
+   *
    * ```js
-   * layerListElement.selectionMode = "multiple";
+   * layerListNextElement.selectionMode = "multiple";
    * ```
+   * 
    */
   accessor selectionMode: List["selectionMode"];
   /**
    * This property provides the ability to show or hide the close button.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-layer-list-next show-close-button></arcgis-layer-list-next>
+   * ```
+   *
+   * ```js
+   * layerListNextElement.showCloseButton = true;
+   * ```
+   * 
    */
   accessor showCloseButton: boolean;
   /**
    * This property provides the ability to show or hide the collapse button.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-layer-list-next show-collapse-button></arcgis-layer-list-next>
+   * ```
+   *
+   * ```js
+   * layerListNextElement.showCollapseButton = true;
+   * ```
+   * 
    */
   accessor showCollapseButton: boolean;
   /**
-   * This property provides the ability to show or hide error indicators.
+   * This property provides the ability to show or hide layer error indicators.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-layer-list-next show-errors></arcgis-layer-list-next>
+   * ```
+   *
+   * ```js
+   * layerListNextElement.showErrors = true;
+   * ```
+   * 
    */
   accessor showErrors: boolean;
   /**
-   * This property provides the ability to show or hide the filter input.
+   * This property provides the ability to show or hide the filter input box when then number of list items is equal to or greater than the value set in [minFilterItems](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#minFilterItems), allowing users to filter layers by their title.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-layer-list-next show-filter></arcgis-layer-list-next>
+   * ```
+   *
+   * ```js
+   * layerListNextElement.showFilter = true;
+   * ```
+   * 
    */
   accessor showFilter: boolean;
   /**
    * This property provides the ability to show or hide the heading.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-layer-list-next show-heading></arcgis-layer-list-next>
+   * ```
+   *
+   * ```js
+   * layerListNextElement.showHeading = true;
+   * ```
+   * 
    */
   accessor showHeading: boolean;
   /**
-   * This property provides the ability to show or hide temporary layer indicators.
+   * This property provides the ability to show or hide the temporary layer indicators for layers with [Layer#persistenceEnabled](https://developers.arcgis.com/javascript/latest/references/core/layers/Layer/#persistenceEnabled) set to `false`. A [temporary icon](https://developers.arcgis.com/calcite-design-system/icons/?icon=temporary&library=Calcite%20UI&query=temporary) will be displayed on the near side of the layer title.
    *
    * @default false
-   */
-  accessor showTemporaryLayerIndicators: boolean;
-  /**
-   * The current state of the component.
+   * @example
+   * ```html
+   * <arcgis-layer-list-next show-temporary-layer-indicators></arcgis-layer-list-next>
+   * ```
    *
-   * @default "disabled"
+   * ```js
+   * layerListNextElement.showTemporaryLayerIndicators = true;
+   * ```
+   * 
    */
+  accessor showTemporaryLayerIndicators: boolean;
+  /** The current state of the component. */
   get state(): State;
   /**
    * The [arcgis-table-list-next](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-table-list-next/) component instance that displays the tables associated with a [KnowledgeGraphLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/KnowledgeGraphLayer/).
@@ -552,6 +681,7 @@ export abstract class ArcgisLayerListNext extends LitElement {
    *
    * @see [knowledgeGraphOptions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#knowledgeGraphOptions) for configuring the table list and its items.
    * @example
+   * ```js
    * // Use reactiveUtils to respond to the layerListElement.tableList "arcgisTriggerAction" event
    * const tableListActionHandle = reactiveUtils.on(
    *   () => layerListElement.tableList,
@@ -573,6 +703,7 @@ export abstract class ArcgisLayerListNext extends LitElement {
    *   },
    * );
    * layerListHandles.push(tableSelectionWatchHandle);
+   * ```
    */
   get tableList(): ArcgisTableListNext | undefined;
   /**
@@ -582,32 +713,37 @@ export abstract class ArcgisLayerListNext extends LitElement {
   accessor view: MapViewOrSceneView | null | undefined;
   /**
    * Determines the icons used to indicate visibility.
-   *
    * | Value | Description | Example |
    * | ----- | ----------- | ------- |
    * | default | Displays view icons on the far side. Icons are hidden except on hover or if they have keyboard focus. See [view-visible](https://developers.arcgis.com/calcite-design-system/icons/?icon=view-visible&library=Calcite%20UI&query=view) and [view-hide](https://developers.arcgis.com/calcite-design-system/icons/?icon=view-hide&library=Calcite%20UI&query=view) calcite icons. | ![visibilityAppearance-default](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/layer-list/visibilityAppearance-default.avif) |
    * | checkbox | Displays checkbox icons on the near side. See [check-square-f](https://developers.arcgis.com/calcite-design-system/icons/?icon=check-square-f&library=Calcite%20UI&query=check) and [square](https://developers.arcgis.com/calcite-design-system/icons/?icon=square&library=Calcite%20UI&query=square) calcite icons. | ![visibilityAppearance-checkbox](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/layer-list/visibilityAppearance-checkbox.avif) |
+   * 
    *
    * @default "default"
    * @example
+   * ```html
+   * <arcgis-layer-list-next visibility-appearance="checkbox"></arcgis-layer-list-next>
+   * ```
+   *
    * ```js
-   * layerListElement.visibilityAppearance = "checkbox";
+   * layerListNextElement.visibilityAppearance = "checkbox";
    * ```
+   * 
    */
   accessor visibilityAppearance: VisibilityAppearance;
   /** Permanently destroy the component. */
   destroy(): Promise<void>;
   /** Emitted when the component's close button is clicked. */
   readonly arcgisClose: import("@arcgis/lumina").TargetedEvent<this, void>;
-  /** Emits when the list filter input value changes. */
+  /** Emitted when the value of the [filterText](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#filterText) input changes. */
   readonly arcgisFilterChange: import("@arcgis/lumina").TargetedEvent<this, void>;
-  /** Emits when opened layer flow state changes. */
+  /** Emitted when the collection of [openedLayers](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#openedLayers) changes. */
   readonly arcgisOpenedLayersChange: import("@arcgis/lumina").TargetedEvent<this, void>;
   /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
   readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "state"; }>;
   /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
   readonly arcgisReady: import("@arcgis/lumina").TargetedEvent<this, void>;
-  /** Emits when selected items state changes. */
+  /** Emitted when the collection of [selectedItems](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list-next/#selectedItems) changes. */
   readonly arcgisSelectedItemsChange: import("@arcgis/lumina").TargetedEvent<this, void>;
   /** Emitted when an action is triggered on the component. */
   readonly arcgisTriggerAction: import("@arcgis/lumina").TargetedEvent<this, LayerItemCollectionEvents["trigger-action"]>;