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

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

@@ -4,18 +4,15 @@ import type Collection from "@arcgis/core/core/Collection.js";
 import type SceneView from "@arcgis/core/views/SceneView";
 import type MapView from "@arcgis/core/views/MapView";
 import type { ReadonlyArrayOrCollection } from "@arcgis/core/core/Collection.js";
-import type { ArcgisReferenceElement } from "../../utils/component-utils.js";
-import type { BookmarkOptions, BookmarkEditEvent, BookmarkSelectEvent } from "./types.js";
-import type { HeadingLevel } from "../../support/heading.js";
-import type { IconName } from "../../utils/action-utils.js";
-import type { GoToOverride } from "../support/goTo.js";
+import type { ArcgisReferenceElement, IconName, HeadingLevel, GoToOverride } from "../types.js";
+import type { BookmarkOptions, BookmarkEditEvent, BookmarkSelectEvent, BookmarksState } from "./types.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
 
 /**
  * The Bookmarks component allows end users to quickly navigate to a particular area of interest.
- * It displays a list of [bookmarks](https://developers.arcgis.com/javascript/latest/api-reference/esri-webmap-Bookmark.html),
- * which are typically defined inside the [WebMap](https://developers.arcgis.com/javascript/latest/api-reference/esri-WebMap.html#bookmarks).
+ * It displays a list of [bookmarks](https://developers.arcgis.com/javascript/latest/references/core/webmap/Bookmark/),
+ * which are typically defined inside the [WebMap](https://developers.arcgis.com/javascript/latest/references/core/WebMap/#bookmarks).
  *
  * Each bookmark may contain the following properties: `name`, `thumbnail`, `viewpoint` (defines rotation, scale, and target geometry), and `timeExtent`.
  * When a bookmark with a timeExtent is selected, the [arcgis-map.timeExtent](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#timeExtent) of the Map will be set to the timeExtent of the selected bookmark.
@@ -25,7 +22,7 @@ import type { T9nMeta } from "@arcgis/lumina/controllers";
  * To enable these features, set the following properties to `true`:
  * [showAddBookmarkButton](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-bookmarks/#showAddBookmarkButton), [showEditBookmarkButton](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-bookmarks/#showEditBookmarkButton), and [dragEnabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-bookmarks/#dragEnabled).
  *
- * **Note:** Bookmarks are supported in a 3D [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/) only if they come from a [WebMap](https://developers.arcgis.com/javascript/latest/api-reference/esri-WebMap.html#bookmarks) or are [provided manually](#bookmarks). [Presentation](https://developers.arcgis.com/javascript/latest/api-reference/esri-webscene-Presentation.html) provides a similar experience for [WebScenes](https://developers.arcgis.com/javascript/latest/api-reference/esri-webscene-Presentation.html).
+ * **Note:** Bookmarks are supported in a 3D [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/) only if they come from a [WebMap](https://developers.arcgis.com/javascript/latest/references/core/WebMap/#bookmarks) or are [provided manually](#bookmarks). [Presentation](https://developers.arcgis.com/javascript/latest/references/core/webscene/Presentation/) provides a similar experience for [WebScenes](https://developers.arcgis.com/javascript/latest/references/core/webscene/Presentation/).
  *
  * @since 4.28
  * @see [Sample - Bookmarks component](https://developers.arcgis.com/javascript/latest/sample-code/bookmarks/)
@@ -42,7 +39,7 @@ export abstract class ArcgisBookmarks extends LitElement {
    */
   accessor autoDestroyDisabled: boolean;
   /**
-   * A collection of [Bookmark](https://developers.arcgis.com/javascript/latest/api-reference/esri-webmap-Bookmark.html)s. These are typically defined inside of a [WebMap](https://developers.arcgis.com/javascript/latest/api-reference/esri-WebMap.html#bookmarks), but can also be defined manually, as shown in the code snippet below.
+   * A collection of [Bookmark](https://developers.arcgis.com/javascript/latest/references/core/webmap/Bookmark/)s. These are typically defined inside of a [WebMap](https://developers.arcgis.com/javascript/latest/references/core/WebMap/#bookmarks), but can also be defined manually, as shown in the code snippet below.
    *
    * @example
    * ```js
@@ -123,7 +120,7 @@ export abstract class ArcgisBookmarks extends LitElement {
   get defaultEditOptions(): BookmarkOptions;
   set defaultEditOptions(value: Partial<BookmarkOptions>);
   /**
-   * When true, the component is visually withdrawn and cannot be interacted with.
+   * When true, the component is visually withdrawn and cannot receive user interaction.
    *
    * @default false
    */
@@ -383,7 +380,7 @@ export abstract class ArcgisBookmarks extends LitElement {
     defaultEditOptions?: Partial<BookmarkOptions>;
   };
   /**
-   * Fires when a [Bookmark](https://developers.arcgis.com/javascript/latest/api-reference/esri-webmap-Bookmark.html) is edited.
+   * Fires when a [Bookmark](https://developers.arcgis.com/javascript/latest/references/core/webmap/Bookmark/) is edited.
    *
    * @since 4.34
    * @example
@@ -397,7 +394,7 @@ export abstract class ArcgisBookmarks extends LitElement {
    */
   readonly arcgisBookmarkEdit: import("@arcgis/lumina").TargetedEvent<this, BookmarkEditEvent>;
   /**
-   * Fires when a [Bookmark](https://developers.arcgis.com/javascript/latest/api-reference/esri-webmap-Bookmark.html) is selected.
+   * Fires when a [Bookmark](https://developers.arcgis.com/javascript/latest/references/core/webmap/Bookmark/) is selected.
    *
    * @since 4.34
    * @example
@@ -432,6 +429,4 @@ export abstract class ArcgisBookmarks extends LitElement {
     arcgisPropertyChange: ArcgisBookmarks["arcgisPropertyChange"]["detail"];
     arcgisReady: ArcgisBookmarks["arcgisReady"]["detail"];
   };
-}
-
-export type BookmarksState = "loading" | "ready";
+}

package/dist/components/arcgis-bookmarks/types.d.ts

@@ -1,6 +1,13 @@
 import type Bookmark from "@arcgis/core/webmap/Bookmark.js";
 import type { UserSettings } from "@arcgis/core/views/types";
 
+/**
+ * Specifies the state of the Bookmarks component.
+ *
+ * @since 5.0
+ */
+export type BookmarksState = "loading" | "ready";
+
 /**
  * Specifies how bookmarks will be created or modified.
  *
@@ -8,32 +15,32 @@ import type { UserSettings } from "@arcgis/core/views/types";
  */
 export type BookmarkOptions = {
   /**
-   * Indicates whether the rotation of the current view will be saved in the [Bookmark#viewpoint](https://developers.arcgis.com/javascript/latest/api-reference/esri-webmap-Bookmark.html#viewpoint) of a newly created or modified bookmark. Default is `true`.
+   * Indicates whether the rotation of the current view will be saved in the [Bookmark#viewpoint](https://developers.arcgis.com/javascript/latest/references/core/webmap/Bookmark/#viewpoint) of a newly created or modified bookmark. Default is `true`.
    *
    * @since 5.0
    */
   captureRotation?: boolean;
   /**
-   * Indicates whether the scale of the current view will be saved in the [Bookmark#viewpoint](https://developers.arcgis.com/javascript/latest/api-reference/esri-webmap-Bookmark.html#viewpoint) of a newly created or modified bookmark. Default is `true`.
+   * Indicates whether the scale of the current view will be saved in the [Bookmark#viewpoint](https://developers.arcgis.com/javascript/latest/references/core/webmap/Bookmark/#viewpoint) of a newly created or modified bookmark. Default is `true`.
    *
    * @since 5.0
    */
   captureScale?: boolean;
   /**
-   * Indicates whether the time extent of the current view will be saved in the [Bookmark#timeExtent](https://developers.arcgis.com/javascript/latest/api-reference/esri-webmap-Bookmark.html#timeExtent) of a newly created or modified bookmark. Default is `true`.
+   * Indicates whether the time extent of the current view will be saved in the [Bookmark#timeExtent](https://developers.arcgis.com/javascript/latest/references/core/webmap/Bookmark/#timeExtent) of a newly created or modified bookmark. Default is `true`.
    *
    * @since 5.0
    */
   captureTimeExtent?: boolean;
   /**
-   * Indicates whether the viewpoint of the current view will become the [Bookmark#viewpoint](https://developers.arcgis.com/javascript/latest/api-reference/esri-webmap-Bookmark.html#viewpoint) of a newly created or modified bookmark. Default is `true`.
+   * Indicates whether the viewpoint of the current view will become the [Bookmark#viewpoint](https://developers.arcgis.com/javascript/latest/references/core/webmap/Bookmark/#viewpoint) of a newly created or modified bookmark. Default is `true`.
    *
    * @since 5.0
    */
   captureViewpoint?: boolean;
   /**
    * An object that specifies the settings of the screenshot that will be used to create the bookmark's
-   * [Bookmark#thumbnail](https://developers.arcgis.com/javascript/latest/api-reference/esri-webmap-Bookmark.html#thumbnail).
+   * [Bookmark#thumbnail](https://developers.arcgis.com/javascript/latest/references/core/webmap/Bookmark/#thumbnail).
    *  The default screenshot size is 128px x 128px.
    *
    * @since 5.0
@@ -41,7 +48,7 @@ export type BookmarkOptions = {
   screenshotSettings?: Partial<UserSettings>;
   /**
    * Indicates whether a screenshot is taken when a new bookmark is created.
-   * The screenshot will be set as the [Bookmark#thumbnail](https://developers.arcgis.com/javascript/latest/api-reference/esri-webmap-Bookmark.html#thumbnail) in the newly created bookmark. Default is `true`.
+   * The screenshot will be set as the [Bookmark#thumbnail](https://developers.arcgis.com/javascript/latest/references/core/webmap/Bookmark/#thumbnail) in the newly created bookmark. Default is `true`.
    *
    * @since 5.0
    */

package/dist/components/arcgis-building-explorer/customElement.d.ts

@@ -2,34 +2,30 @@
 import type SceneView from "@arcgis/core/views/SceneView.js";
 import type BuildingSceneLayer from "@arcgis/core/layers/BuildingSceneLayer.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
-import type { ArcgisReferenceElement } from "../../utils/component-utils.js";
-import type { IconName } from "../../utils/action-utils.js";
-import type { HeadingLevel } from "../../support/heading.js";
+import type { ArcgisReferenceElement, IconName, HeadingLevel } from "../types.js";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
 
-export type Messages = ReturnType<typeof messages>;
-
 /**
- * The Building Explorer component is used to filter and explore the various building elements of [BuildingSceneLayers](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-BuildingSceneLayer.html). BuildingSceneLayers are complex digital models of buildings and interiors and can contain thousands of building elements grouped in sublayers. Using the Building Explorer component, buildings can be filtered by [level](#level), [construction phase](#phase) or by disciplines and categories.
+ * The Building Explorer component is used to filter and explore the various building elements of [BuildingSceneLayers](https://developers.arcgis.com/javascript/latest/references/core/layers/BuildingSceneLayer/). BuildingSceneLayers are complex digital models of buildings and interiors and can contain thousands of building elements grouped in sublayers. Using the Building Explorer component, buildings can be filtered by [level](#level), [construction phase](#phase) or by disciplines and categories.
  * The visibility of these elements can be configured using the component's [hideLevels](#hideLevels), [hidePhases](#hidePhases) and [hideDisciplines](#hideDisciplines) properties.
  *
  * [![building-explorer](https://developers.arcgis.com/javascript/latest/assets/img/components/building-explorer/building-explorer.png)](https://developers.arcgis.com/javascript/latest/sample-code/building-scene-layer-filter/)
  *
- * The [BuildingSceneLayers](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-BuildingSceneLayer.html) to be explored have to be set on the [layers](#layers) property of the component. When setting multiple layers, the filters set by the Building Explorer component will be applied on all layers. The component doesn't allow the user to select between multiple layers present in a scene.
+ * The [BuildingSceneLayers](https://developers.arcgis.com/javascript/latest/references/core/layers/BuildingSceneLayer/) to be explored have to be set on the [layers](#layers) property of the component. When setting multiple layers, the filters set by the Building Explorer component will be applied on all layers. The component doesn't allow the user to select between multiple layers present in a scene.
  *
- * Often, [BuildingSceneLayers](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-BuildingSceneLayer.html) contain an _Overview_ [BuildingComponentSublayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-buildingSublayers-BuildingComponentSublayer.html) that serves as an exterior shell and views the building model as a single feature. When a layer is added to the Building Explorer component, the visibility of the _Overview_ layer is turned off, so that the user can directly interact with the individual features in the _Full Model_ [BuildingGroupSublayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-buildingSublayers-BuildingGroupSublayer.html).
+ * Often, [BuildingSceneLayers](https://developers.arcgis.com/javascript/latest/references/core/layers/BuildingSceneLayer/) contain an _Overview_ [BuildingComponentSublayer](https://developers.arcgis.com/javascript/latest/references/core/layers/buildingSublayers/BuildingComponentSublayer/) that serves as an exterior shell and views the building model as a single feature. When a layer is added to the Building Explorer component, the visibility of the _Overview_ layer is turned off, so that the user can directly interact with the individual features in the _Full Model_ [BuildingGroupSublayer](https://developers.arcgis.com/javascript/latest/references/core/layers/buildingSublayers/BuildingGroupSublayer/).
  *
  * The Level element of the Building Explorer component allows to select a single level in one or several buildings. When selecting a level, the levels above it are hidden and the levels below it become semi-transparent for added visual context.
  *
- * Some [BuildingSceneLayers](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-BuildingSceneLayer.html) include information indicating the phase in which building elements, such as doors or pipes, were created and, optionally, when they were demolished. If a layer has multiple construction phases, these will be displayed in the Construction phases element. When selecting a construction phase, all the building elements created during or before the phase are selected. Demolished building elements aren't displayed.
+ * Some [BuildingSceneLayers](https://developers.arcgis.com/javascript/latest/references/core/layers/BuildingSceneLayer/) include information indicating the phase in which building elements, such as doors or pipes, were created and, optionally, when they were demolished. If a layer has multiple construction phases, these will be displayed in the Construction phases element. When selecting a construction phase, all the building elements created during or before the phase are selected. Demolished building elements aren't displayed.
  *
- * Discipline layers are [group layers](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-buildingSublayers-BuildingGroupSublayer.html) that organize the [BuildingSceneLayers](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-BuildingSceneLayer.html) content into architectural, structural, mechanical, or electrical groups. These layers contain a number of Category layers such as walls, windows, furniture, and lighting fixtures. These layers can be turned on and off in the Disciplines and Categories list.
+ * Discipline layers are [group layers](https://developers.arcgis.com/javascript/latest/references/core/layers/buildingSublayers/BuildingGroupSublayer/) that organize the [BuildingSceneLayers](https://developers.arcgis.com/javascript/latest/references/core/layers/BuildingSceneLayer/) content into architectural, structural, mechanical, or electrical groups. These layers contain a number of Category layers such as walls, windows, furniture, and lighting fixtures. These layers can be turned on and off in the Disciplines and Categories list.
  *
  * The Building Explorer component can only display filters set by the component itself. Filters set by other applications will be ignored.
  *
  * **Known limitations**
  *
- * Building Explorer is only supported in a 3D [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/) component.
+ * Building Explorer is only supported in a 3D [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/) component.
  *
  * **See also**
  *
@@ -88,7 +84,7 @@ export abstract class ArcgisBuildingExplorer extends LitElement {
   /** The component's default label. */
   accessor label: string | undefined;
   /**
-   * A list of layers of type [BuildingSceneLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-BuildingSceneLayer.html) that are added to the component for exploration.
+   * A list of layers of type [BuildingSceneLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/BuildingSceneLayer/) that are added to the component for exploration.
    *
    * The component UI is only displayed when this property is set. In case of multiple layers, the component will display and apply the filters on all layers.
    *
@@ -96,14 +92,14 @@ export abstract class ArcgisBuildingExplorer extends LitElement {
    */
   accessor layers: BuildingSceneLayer[];
   /**
-   * The currently selected building level.
+   * The currently selected value for the building level filter.
    *
    * @since 5.0
    */
   get level(): number;
   set level(value: number | undefined);
   /**
-   * Indicates whether the level picker and filter is disabled. If `true`, the filters expression won't be used to filter a [BuildingSceneLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-BuildingSceneLayer.html).
+   * Indicates whether the level picker and filter is disabled. If `true`, the filters expression won't be used to filter a [BuildingSceneLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/BuildingSceneLayer/).
    *
    * @default false
    * @since 5.0
@@ -173,14 +169,15 @@ export abstract class ArcgisBuildingExplorer extends LitElement {
       loading: string;
   }>;
   /**
-   * The currently selected construction phase.
+   * The currently selected value for the construction phase filter.
+   * Construction phases are used to track site development for a [BuildingSceneLayers](https://developers.arcgis.com/javascript/latest/references/core/layers/BuildingSceneLayer/). Setting a construction phase in the Building Explorer selects everything in the layer which is already constructed at that phase (created phase <= selected phase) but not yet demolished (demolished phase > selected phase). The goal is to display what the building or construction site looks like at that selected phase.
    *
    * @since 5.0
    */
   get phase(): number;
   set phase(value: number | undefined);
   /**
-   * Indicates whether the phase picker and filter is disabled. If `true`, the filters expression won't be used to filter a [BuildingSceneLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-BuildingSceneLayer.html).
+   * Indicates whether the phase picker and filter is disabled. If `true`, the filters expression won't be used to filter a [BuildingSceneLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/BuildingSceneLayer/).
    *
    * @default false
    * @since 5.0
@@ -231,60 +228,4 @@ export abstract class ArcgisBuildingExplorer extends LitElement {
     arcgisBuildingPhaseChange: ArcgisBuildingExplorer["arcgisBuildingPhaseChange"]["detail"];
     arcgisReady: ArcgisBuildingExplorer["arcgisReady"]["detail"];
   };
-}
-
-export const messages: (value: {
-    level: {
-        title: string;
-        selectLevel: string;
-        clearLevel: string;
-        nextLevel: string;
-        previousLevel: string;
-        currentLevel: string;
-    };
-    phase: {
-        title: string;
-        nextPhase: string;
-        previousPhase: string;
-        currentPhase: string;
-    };
-    disciplines: {
-        title: string;
-        expand: string;
-        collapse: string;
-        hideSublayer: string;
-        showSublayer: string;
-    };
-    failed: string;
-    unsupported: string;
-    noData: string;
-    componentLabel: string;
-    loading: string;
-}) => {
-    level: {
-        title: string;
-        selectLevel: string;
-        clearLevel: string;
-        nextLevel: string;
-        previousLevel: string;
-        currentLevel: string;
-    };
-    phase: {
-        title: string;
-        nextPhase: string;
-        previousPhase: string;
-        currentPhase: string;
-    };
-    disciplines: {
-        title: string;
-        expand: string;
-        collapse: string;
-        hideSublayer: string;
-        showSublayer: string;
-    };
-    failed: string;
-    unsupported: string;
-    noData: string;
-    componentLabel: string;
-    loading: string;
-};
+}

package/dist/components/arcgis-building-explorer/customElement.js

@@ -124,7 +124,7 @@ let n = class extends z {
   }
   /**
    * Whether the filter is disabled. If true, the filter's expression won't be
-   * used to filter a [BuildingSceneLayer](https://next.gha.afd.arcgis.com/javascript/latest/api-reference/esri-layers-BuildingSceneLayer.html).
+   * used to filter a [BuildingSceneLayer](https://next.gha.afd.arcgis.com/javascript/latest/references/core/layers/BuildingSceneLayer/).
    *
    * @default true
    */
@@ -549,10 +549,10 @@ class we extends J {
     e == null ? this.#t.allowedValues = null : this.#t.allowedValues = e;
   }
   get levelDisabled() {
-    return this.#e?.disabled;
+    return this.#e.disabled;
   }
   get phaseDisabled() {
-    return this.#t?.disabled;
+    return this.#t.disabled;
   }
   async destroy() {
     await this.manager.destroy();

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

@@ -5,8 +5,7 @@ import type CatalogLayer from "@arcgis/core/layers/CatalogLayer.js";
 import type Collection2 from "@arcgis/core/core/Collection.js";
 import type ListItem2 from "@arcgis/core/widgets/LayerList/ListItem.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
-import type { ArcgisReferenceElement } from "../../utils/component-utils.js";
-import type { IconName } from "../../utils/action-utils.js";
+import type { ArcgisReferenceElement, IconName } from "../types.js";
 import type { LayerListViewModelTriggerActionEvent } from "@arcgis/core/widgets/LayerList/LayerListViewModel";
 import type { MapViewOrSceneView } from "@arcgis/core/views/MapViewOrSceneView.js";
 import type { FilterPredicate, ListItemModifier, VisibilityAppearance } from "@arcgis/core/widgets/LayerList/types.js";
@@ -15,9 +14,54 @@ import type { Icon } from "@esri/calcite-components/components/calcite-icon";
 import type { CatalogLayerListState } from "@arcgis/core/widgets/CatalogLayerList/types.js";
 
 /**
- * The Catalog Layer List component provides a way to display and interact with CatalogLayers.
+ * The Catalog Layer List provides a way to display and interact with [CatalogLayers](https://developers.arcgis.com/javascript/latest/references/core/layers/CatalogLayer/).
+ * The component displays a list of layers in the [dynamicGroupLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/CatalogLayer/#dynamicGroupLayer)
+ * and allows you to toggle their visibility.
+ *
+ * The [ListItem](https://developers.arcgis.com/javascript/latest/references/core/widgets/LayerList/ListItem/) 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.
  *
  * @since 4.31
+ * @example
+ * ```js
+ * const catalogLayerListElement = document.createElement("arcgis-catalog-layer-list");
+ * catalogLayerListElement.referenceElement = viewElement;
+ * catalogLayerListElement.slot = "top-right";
+ * viewElement.appendChild(catalogLayerListElement);
+ *
+ * catalogLayerListElement.listItemCreatedFunction = (event) => {
+ *   const { item } = event;
+ *   const { layer } = item;
+ *
+ *   if (isLayerFromCatalog(layer)) {
+ *     item.actionsSections = [
+ *       [
+ *         {
+ *           title: "Add layer to map",
+ *           icon: "add-layer",
+ *           id: "add-layer"
+ *         }
+ *       ]
+ *     ];
+ *   }
+ * }
+ *
+ * // Listen for the arcgisTriggerAction event on the CatalogLayerList
+ * // and add layers from the catalog to the map when the "add-layer" action is triggered.
+ * // To correctly add a layer to the map, you must create a footprint from the layer
+ * // and then create a new layer from the footprint.
+ * catalogLayerList.addEventListener("arcgisTriggerAction", async (event) => {
+ *   const { id } = event.action;
+ *   const { layer } = event.item;
+ *
+ *   if (id === "add-layer") {
+ *     const parentCatalogLayer = catalogUtils.getCatalogLayerForLayer(layer);
+ *     const footprint = parentCatalogLayer.createFootprintFromLayer(layer);
+ *     const layerFromFootprint = await parentCatalogLayer.createLayerFromFootprint(footprint);
+ *     viewElement.map.add(layerFromFootprint);
+ *   }
+ * });
+ * ```
  */
 export abstract class ArcgisCatalogLayerList extends LitElement {
   /**
@@ -30,12 +74,15 @@ export abstract class ArcgisCatalogLayerList extends LitElement {
    * @default false
    */
   accessor autoDestroyDisabled: boolean;
-  /** A collection of ListItems representing the catalogLayers dynamicGroupLayer. */
+  /** A collection of ListItems representing the CatalogLayer's [dynamicGroupLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/CatalogLayer/#dynamicGroupLayer). */
   get catalogItems(): Collection<ListItem>;
   /**
-   * The [CatalogLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-CatalogLayer.html) to display in the component.
+   * The [CatalogLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/CatalogLayer/) to display in the component.
    *
-   * @example catalogLayerList.catalogLayer = new CatalogLayer({ url });
+   * @example
+   * ```js
+   * catalogLayerListElement.catalogLayer = new CatalogLayer({ url });
+   * ```
    */
   accessor catalogLayer: CatalogLayer | null | undefined;
   /**
@@ -51,34 +98,45 @@ export abstract class ArcgisCatalogLayerList extends LitElement {
    *
    * @default false
    * @see [showCollapseButton](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-catalog-layer-list/#showCollapseButton)
-   * @example catalogLayerList.collapsed = true;
+   * @example
+   * ```js
+   * catalogLayerListElement.collapsed = true;
+   * ```
    */
   accessor collapsed: boolean;
   /**
-   * Placeholder text used in the filter input if [visibleElements.filter](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-CatalogLayerList.html#visibleElements) is true.
+   * Placeholder text used in the filter input if [showFilter](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-catalog-layer-list/#showFilter) is true.
    *
    * @default ""
    * @see [showFilter](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-catalog-layer-list/#showFilter)
-   * @example catalogLayerList.filterPlaceholder = "Filter layers";
+   * @example
+   * ```js
+   * catalogLayerListElement.filterPlaceholder = "Filter layers";
+   * ```
    */
   accessor filterPlaceholder: string;
   /**
-   * Specifies a function to handle filtering [list items](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList-ListItem.html).
+   * Specifies a function to handle filtering [list items](https://developers.arcgis.com/javascript/latest/references/core/widgets/LayerList/ListItem/).
    *
    * @since 4.32
-   * @example layerList.filterPredicate = (item) => item.title.toLowerCase().includes("streets");
+   * @example
+   * ```js
+   * catalogLayerListElement.filterPredicate = (item) => item.title.toLowerCase().includes("streets");
+   * ```
    */
   accessor filterPredicate: FilterPredicate | null | undefined;
   /**
-   * The value of the filter input if [visibleElements.filter](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-CatalogLayerList.html#visibleElements) is true.
+   * The value of the filter input if [showFilter](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-catalog-layer-list/#showFilter) is true.
    *
    * @default ""
    * @see [showFilter](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-catalog-layer-list/#showFilter)
    * @example
+   * ```js
    * reactiveUtils.watch(
-   *   () => catalogLayerList.filterText,
+   *   () => catalogLayerListElement.filterText,
    *   (filterText) => console.log(filterText)
    * );
+   * ```
    */
   accessor filterText: string;
   /**
@@ -89,7 +147,10 @@ export abstract class ArcgisCatalogLayerList extends LitElement {
    *
    * @default 2
    * @see [showHeading](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-catalog-layer-list/#showHeading)
-   * @example catalogLayerList.headingLevel = 3;
+   * @example
+   * ```js
+   * catalogLayerListElement.headingLevel = 3;
+   * ```
    */
   accessor headingLevel: HeadingLevel;
   /**
@@ -116,60 +177,42 @@ export abstract class ArcgisCatalogLayerList extends LitElement {
    */
   accessor label: string;
   /**
-   * A function that executes each time a [ListItem](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList-ListItem.html) is created.
+   * 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/api-reference/esri-widgets-LayerList-ListItem.html#actionsSections).
+   * using the [ListItem#actionsSections](https://developers.arcgis.com/javascript/latest/references/core/widgets/LayerList/ListItem/#actionsSections).
    *
    * @example
-   * // Create a new CatalogLayerList with a listItemCreatedFunction
-   * // that adds an "add-layer" action to each catalog layer list item
-   * const catalogLayerList = new CatalogLayerList({
-   *  catalogLayer,
-   *  listItemCreatedFunction: (event) => {
-   *    const { item } = event;
-   *    const { layer } = item;
-   *
-   *    if (isLayerFromCatalog(layer)) {
-   *      item.actionsSections = [
-   *        [
-   *          {
-   *            title: "Add layer to map",
-   *            icon: "add-layer",
-   *            id: "add-layer"
-   *          }
-   *        ]
-   *      ];
-   *    }
-   *  },
-   *  view
-   * });
+   * ```js
+   * catalogLayerListElement.listItemCreatedFunction = (event) => {
+   *   const { item } = event;
+   *   const { layer } = item;
    *
-   * // Listen for the trigger-action event on the CatalogLayerListViewModel
-   * // and add layers from the catalog to the map when the "add-layer" action is triggered.
-   * // To correctly add a layer to the map, you must create a footprint from the layer
-   * // and then create a new layer from the footprint.
-   * catalogLayerList.on("trigger-action", async (event) => {
-   *   const { id } = event.action;
-   *   const { layer } = event.item;
-   *
-   *   if (id === "add-layer") {
-   *     const parentCatalogLayer = catalogUtils.getCatalogLayerForLayer(layer);
-   *     const footprint = parentCatalogLayer.createFootprintFromLayer(layer);
-   *     const layerFromFootprint = await parentCatalogLayer.createLayerFromFootprint(footprint);
-   *     map.add(layerFromFootprint);
+   *   if (isLayerFromCatalog(layer)) {
+   *     item.actionsSections = [
+   *       [
+   *         {
+   *           title: "Add layer to map",
+   *           icon: "add-layer",
+   *           id: "add-layer"
+   *         }
+   *       ]
+   *     ];
    *   }
-   * });
+   * }
+   * ```
    */
   accessor listItemCreatedFunction: ListItemModifier | null | undefined;
   /**
-   * The minimum number of list items required to display the [visibleElements.filter](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-CatalogLayerList-CatalogLayerListVisibleElements.html) input box.
+   * The minimum number of list items required to display the [showFilter](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-catalog-layer-list/#showFilter) input box.
    *
    * @default 10
    * @see [showFilter](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-catalog-layer-list/#showFilter)
    * @example
-   * layerList.showFilter = true;
-   * layerList.minFilterItems = 5;
+   * ```js
+   * catalogLayerListElement.showFilter = true;
+   * catalogLayerListElement.minFilterItems = 5;
+   * ```
    */
   accessor minFilterItems: number;
   /**
@@ -179,16 +222,16 @@ export abstract class ArcgisCatalogLayerList extends LitElement {
    */
   accessor referenceElement: ArcgisReferenceElement | string | undefined;
   /**
-   * A collection of selected [ListItems](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList-ListItem.html) representing [catalogItems](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-CatalogLayerList.html#catalogItems)
+   * A collection of selected [ListItems](https://developers.arcgis.com/javascript/latest/references/core/widgets/LayerList/ListItem/) representing [catalogItems](https://developers.arcgis.com/javascript/latest/references/core/widgets/CatalogLayerList/#catalogItems)
    * selected by the user.
    *
-   * @see [selectionMode](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-CatalogLayerList.html#selectionMode)
-   * @see [catalogItems](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-CatalogLayerList.html#catalogItems)
+   * @see [selectionMode](https://developers.arcgis.com/javascript/latest/references/core/widgets/CatalogLayerList/#selectionMode)
+   * @see [catalogItems](https://developers.arcgis.com/javascript/latest/references/core/widgets/CatalogLayerList/#catalogItems)
    */
   accessor selectedItems: Collection2<ListItem2>;
   /**
    * Specifies the selection mode.
-   * Selected items are available in the [selectedItems](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-CatalogLayerList.html#selectedItems) property.
+   * Selected items are available in the [selectedItems](https://developers.arcgis.com/javascript/latest/references/core/widgets/CatalogLayerList/#selectedItems) property.
    *
    * | Value | Description |
    * | ----- | ----------- |
@@ -198,10 +241,13 @@ export abstract class ArcgisCatalogLayerList extends LitElement {
    * | 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"
-   * @see [selectedItems](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-CatalogLayerList.html#selectedItems)
-   * @example catalogLayerList.selectionMode = "multiple";
+   * @see [selectedItems](https://developers.arcgis.com/javascript/latest/references/core/widgets/CatalogLayerList/#selectedItems)
+   * @example
+   * ```js
+   * catalogLayerListElement.selectionMode = "multiple";
+   * ```
    */
-  accessor selectionMode: "none" | "multiple" | "single" | "single-persist";
+  accessor selectionMode: "multiple" | "single" | "none" | "single-persist";
   /**
    * Indicates whether to display a close button in the header.
    *
@@ -224,21 +270,21 @@ export abstract class ArcgisCatalogLayerList extends LitElement {
    */
   accessor showErrors: boolean;
   /**
-   * Indicates whether to display a filter input box when then number of list items is equal to or greater than the value set in [CatalogLayerList#minFilterItems](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-CatalogLayerList.html#minFilterItems), allowing users to filter layers by their title.
+   * Indicates whether to display a filter input box when then number of list items is equal to or greater than the value set in [CatalogLayerList#minFilterItems](https://developers.arcgis.com/javascript/latest/references/core/widgets/CatalogLayerList/#minFilterItems), allowing users to filter layers by their title.
    *
    * @default false
    * @since 5.0
    */
   accessor showFilter: boolean;
   /**
-   * Indicates whether to display the component's heading. The heading text is "Layer List". The heading level can be set with the [CatalogLayerList#headingLevel](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-CatalogLayerList.html#headingLevel).
+   * Indicates whether to display the component's heading. The heading text is "Layer List". The heading level can be set with the [CatalogLayerList#headingLevel](https://developers.arcgis.com/javascript/latest/references/core/widgets/CatalogLayerList/#headingLevel).
    *
    * @default false
    * @since 5.0
    */
   accessor showHeading: boolean;
   /**
-   * Indicates whether temporary layer indicators will be displayed for layers 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 layer title.
+   * Indicates whether temporary layer indicators will be displayed 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
    * @since 5.0
@@ -264,7 +310,10 @@ export abstract class ArcgisCatalogLayerList extends LitElement {
    * | 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/img/apiref/widgets/layer-list/visibilityAppearance-checkbox.png) |
    *
    * @default "default"
-   * @example catalogLayerList.visibilityAppearance = "checkbox";
+   * @example
+   * ```js
+   * catalogLayerListElement.visibilityAppearance = "checkbox";
+   * ```
    */
   accessor visibilityAppearance: VisibilityAppearance;
   /** Permanently destroy the component. */