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

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

@@ -3,8 +3,7 @@ import type Graphic from "@arcgis/core/Graphic.js";
 import type Collection from "@arcgis/core/core/Collection.js";
 import type AttachmentInfo from "@arcgis/core/rest/query/support/AttachmentInfo.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 { AttachmentsCapabilities, AttachmentsDisplay } from "@arcgis/core/widgets/Attachments/types.js";
 import type { Icon } from "@esri/calcite-components/components/calcite-icon";
 import type { AttachmentsViewModelState } from "@arcgis/core/widgets/Attachments/AttachmentsViewModel.js";
@@ -12,7 +11,7 @@ import type { AttachmentsViewModelState } from "@arcgis/core/widgets/Attachments
 /** @internal */
 export abstract class ArcgisAttachments extends LitElement {
   /**
-   * A collection of [AttachmentInfo](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-query-support-AttachmentInfo.html) defined on a feature.
+   * A collection of [AttachmentInfo](https://developers.arcgis.com/javascript/latest/references/core/rest/query/support/AttachmentInfo/) defined on a feature.
    *
    * @see [ArcGIS REST API - Attachment Infos (Feature Service)](https://developers.arcgis.com/rest/services-reference/attachment-infos-feature-service-.htm)
    */
@@ -20,7 +19,7 @@ export abstract class ArcgisAttachments extends LitElement {
   /** An array of strings used to identify attachment(s). When attachments are displayed, this property is used to query attachments using an exact match on the keywords provided. */
   accessor attachmentKeywords: Array<string> | null | undefined;
   /** An array of strings representing MIME types. When attachments are displayed, this property is used to query attachments based on MIME type. Valid values: application, audio, image, model, text, and video. */
-  accessor attachmentTypes: Array<"audio" | "video" | "image" | "model" | "text" | "application"> | null | undefined;
+  accessor attachmentTypes: Array<"image" | "model" | "text" | "video" | "application" | "audio"> | null | undefined;
   /**
    * If true, the component will not be destroyed automatically when it is
    * disconnected from the document. This is useful when you want to move the
@@ -38,11 +37,11 @@ export abstract class ArcgisAttachments extends LitElement {
    */
   accessor capabilities: AttachmentsCapabilities;
   /**
-   * String indicating how to [display](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Attachments.html#displayType) the attachments.
+   * String indicating how to [display](https://developers.arcgis.com/javascript/latest/references/core/widgets/Attachments/#displayType) the attachments.
    *
    * | Value    | Description |
    * | ------ | ----------- |
-   * | auto     | Default value. If a feature layer's capabilities supports [resizing attachments](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html#capabilities), the popup will display attachments in `preview` mode.|
+   * | auto     | Default value. If a feature layer's capabilities supports [resizing attachments](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#capabilities), the popup will display attachments in `preview` mode.|
    * | preview  | Shows a thumbnail image of the attachment.|
    * | list     | Shows a list of attachment links. |
    *

package/dist/components/arcgis-basemap-gallery/customElement.d.ts

@@ -2,8 +2,7 @@
 import type LocalBasemapsSource from "@arcgis/core/widgets/BasemapGallery/support/LocalBasemapsSource.js";
 import type PortalBasemapsSource from "@arcgis/core/widgets/BasemapGallery/support/PortalBasemapsSource.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
-import type { HeadingLevel } from "../../support/heading.js";
-import type { ArcgisReferenceElement } from "../../utils/component-utils.js";
+import type { ArcgisReferenceElement, HeadingLevel } from "../types.js";
 import type { BasemapProperties } from "@arcgis/core/Basemap";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
 import type { MapViewOrSceneView } from "@arcgis/core/views/MapViewOrSceneView.js";
@@ -15,7 +14,7 @@ import type { BasemapGalleryViewModelState } from "@arcgis/core/widgets/BasemapG
  * @since 4.28
  */
 export abstract class ArcgisBasemapGallery extends LitElement {
-  /** The map's current [basemap](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html#basemap). */
+  /** The map's current [basemap](https://developers.arcgis.com/javascript/latest/references/core/Map/#basemap). */
   accessor activeBasemap: BasemapProperties | string | undefined;
   /**
    * If true, the component will not be destroyed automatically when it is
@@ -28,7 +27,7 @@ export abstract class ArcgisBasemapGallery extends LitElement {
    */
   accessor autoDestroyDisabled: boolean;
   /**
-   * When `true`, sets the component to a disabled state so the user cannot interact with it.
+   * When true, the component is visually withdrawn and cannot receive user interaction.
    *
    * @default false
    */

package/dist/components/arcgis-basemap-gallery-item/customElement.js

@@ -3,17 +3,17 @@ import { g as x, c as w } from "../../chunks/runtime.js";
 import { classes as k } from "@arcgis/toolkit/dom";
 import { watch as l } from "@arcgis/core/core/reactiveUtils.js";
 import { LitElement as $, nothing as a, safeClassMap as p } from "@arcgis/lumina";
-import { css as _, html as i } from "lit";
-import { g as B } from "../../chunks/globalCss.js";
-import { g as I } from "../../chunks/component-utils.js";
+import { css as B, html as i } from "lit";
+import { g as I } from "../../chunks/globalCss.js";
+import { g as _ } from "../../chunks/component-utils.js";
 function A(t) {
   return t.portalItem?.type === "Web Scene" || t.referenceLayers.some((e) => e.type === "scene");
 }
-function z(t) {
-  return !!t?.portalItem?.tags?.some((e) => e.toLowerCase() === "beta");
+function C(t) {
+  return !!t?.portalItem?.tags?.some((e) => e.toLowerCase() === "beta") || !!t?.portalItem?.categories?.includes("/Categories/Status/Beta");
 }
-const C = _`@keyframes esri-basemap-slide{0%{opacity:0;margin-top:0;margin-left:0}75%{opacity:0;margin-top:0;margin-left:0}to{opacity:1;margin-top:5px;margin-left:5px}}@keyframes esri-docking-animation{0%{opacity:0}25%{opacity:0}to{opacity:1}}@keyframes popup-intro-animation-down{0%{opacity:0;transform:translateY(-5px)}to{opacity:1;transform:translate(0)}}@keyframes popup-intro-animation-up{0%{opacity:0;transform:translateY(5px)}to{opacity:1;transform:translate(0)}}@supports (-ms-ime-align: auto){.esri-slider__anchor:focus{outline:1px dotted #000}}@keyframes esri-spinner--start-animation{0%{opacity:0;transform:scale(0)}to{opacity:1;transform:scale(1)}}@keyframes esri-spinner--finish-animation{0%{opacity:1;transform:scale(1)}to{opacity:0;transform:scale(0)}}@keyframes esri-spinner--rotate-animation{0%{transform:rotate(0)}to{transform:rotate(360deg)}}@media(prefers-reduced-motion){.esri-utility-network-trace__reset-prompt{animation:none!important}}@media(prefers-reduced-motion){.esri-popup--aligned-top-center,.esri-popup--aligned-top-left,.esri-popup--aligned-top-right,.esri-popup--aligned-bottom-center,.esri-popup--aligned-bottom-left,.esri-popup--aligned-bottom-right,.esri-popup--is-docked{animation:none!important}}@media(prefers-reduced-motion:reduce){.esri-fov-overlay{animation:none!important}}@keyframes esri-fade-in-down{0%{opacity:0;transform:translateY(-5px)}25%{opacity:0;transform:translateY(-5px)}to{opacity:1;transform:translate(0)}}@keyframes esri-fade-in-up{0%{opacity:0;transform:translateY(5px)}25%{opacity:0;transform:translateY(5px)}to{opacity:1;transform:translate(0)}}@keyframes esri-fade-in{0%{opacity:0}25%{opacity:0}to{opacity:1}}@keyframes esri-fade-in-scale{0%{opacity:0;transform:scale(.95)}to{opacity:1;transform:scale(1)}}@keyframes looping-progresss-bar-ani{0%{width:0;left:0}20%{width:20%;left:0}80%{width:20%;left:80%}to{width:0;left:100%}}@keyframes esri-rotate{0%{transform:rotate(0)}to{transform:rotate(360deg)}}@keyframes panel-advance{0%{opacity:0;transform:translate(50px) scale(.99)}to{opacity:1;transform:translate(0) scale(1)}}@keyframes panel-retreat{0%{opacity:0;transform:translate(-50px) scale(.99)}to{opacity:1;transform:translate(0) scale(1)}}@keyframes panel-advance--rtl{0%{opacity:0;transform:translate(-50px) scale(.99)}to{opacity:1;transform:translate(0) scale(1)}}@keyframes panel-retreat--rtl{0%{opacity:0;transform:translate(50px) scale(.99)}to{opacity:1;transform:translate(0) scale(1)}}:host{container-type:inline-size}.empty-message{padding:12px 15px;animation:.5s ease-in-out esri-fade-in}.item{box-sizing:border-box;cursor:pointer;border:1px solid var(--calcite-color-background);flex-direction:row;width:100%;transition:background-color .25s ease-in-out,border-color .25s ease-in-out;animation:.5s ease-in-out esri-fade-in;display:flex;position:relative}.item:hover{background-color:var(--calcite-color-foreground-3);border-color:var(--calcite-color-background-inverse)}.item:hover .item-title{color:var(--calcite-color-text-1)}.item:focus{outline:none}.is-error{opacity:var(--calcite-opacity-light);background-color:var(--calcite-color-transparent)!important;border-color:var(--calcite-color-transparent)!important;cursor:auto}.item-thumbnail{aspect-ratio:1.5;border-inline-end:1px solid var(--calcite-color-border-1);flex-shrink:0;width:120px;min-width:120px;transition:background-color .25s ease-in-out,border-color .25s ease-in-out}.item-title{color:var(--calcite-color-text-3);justify-content:flex-start;align-items:center;width:100%;height:100%;font-size:var(--calcite-font-size-sm);transition:color .25s ease-in-out,font-weight .25s ease-in-out;display:flex}.item-title span{text-align:start;text-overflow:ellipsis;word-wrap:break-word;word-break:break-word;hyphens:auto;-webkit-line-clamp:2;line-clamp:2;-webkit-box-orient:vertical;width:100%;display:-webkit-box;overflow:hidden}.is-selected,.is-selected:hover,.is-selected:focus{cursor:auto;background-color:color-mix(in srgb,var(--calcite-color-brand-underline),70% transparent);border-color:var(--calcite-color-status-info)!important}.is-selected .item-title,.item.is-selected:hover .item-title,.item.is-selected:focus .item-title{color:var(--calcite-color-text-1);font-weight:var(--calcite-font-weight-medium)}.item-content{flex-direction:column;gap:var(--calcite-spacing-md);min-width:0;padding-block:var(--calcite-spacing-base);padding-inline:var(--calcite-spacing-md);display:flex}.item-tags{flex-direction:row;gap:var(--calcite-spacing-base);display:flex}.item-tags calcite-chip{--calcite-font-size--2: var(--calcite-font-size--3);cursor:inherit}@supports (object-fit: cover){.item-thumbnail{object-fit:cover}}@container (width>=200px) and (width <= 300px){.item{align-items:center}.item:not(.is-selected,:hover){border-color:var(--calcite-color-transparent)}}@container (width>=200px) and (width <= 278px){.item-thumbnail{aspect-ratio:1;width:80px;min-width:80px}}@container (width<200px) or (width>=350px){.item{text-align:center;flex-flow:column wrap}.item:not(.is-selected,:hover){border-color:var(--calcite-color-border-1)}.item-thumbnail{border-block-end:1px solid var(--calcite-color-border-1);border-inline-end:none;width:100%;min-width:0;height:auto}.item-content{height:32px;padding-block:var(--calcite-spacing-xxs);padding-inline:var(--calcite-spacing-xs);position:relative}.item-tags{position:absolute;inset-block-end:45px;inset-inline-end:5px}}`;
-class Y extends $ {
+const z = B`@keyframes esri-basemap-slide{0%{opacity:0;margin-top:0;margin-left:0}75%{opacity:0;margin-top:0;margin-left:0}to{opacity:1;margin-top:5px;margin-left:5px}}@keyframes esri-docking-animation{0%{opacity:0}25%{opacity:0}to{opacity:1}}@keyframes popup-intro-animation-down{0%{opacity:0;transform:translateY(-5px)}to{opacity:1;transform:translate(0)}}@keyframes popup-intro-animation-up{0%{opacity:0;transform:translateY(5px)}to{opacity:1;transform:translate(0)}}@supports (-ms-ime-align: auto){.esri-slider__anchor:focus{outline:1px dotted #000}}@keyframes esri-spinner--start-animation{0%{opacity:0;transform:scale(0)}to{opacity:1;transform:scale(1)}}@keyframes esri-spinner--finish-animation{0%{opacity:1;transform:scale(1)}to{opacity:0;transform:scale(0)}}@keyframes esri-spinner--rotate-animation{0%{transform:rotate(0)}to{transform:rotate(360deg)}}@media(prefers-reduced-motion){.esri-utility-network-trace__reset-prompt{animation:none!important}}@media(prefers-reduced-motion){.esri-popup--aligned-top-center,.esri-popup--aligned-top-left,.esri-popup--aligned-top-right,.esri-popup--aligned-bottom-center,.esri-popup--aligned-bottom-left,.esri-popup--aligned-bottom-right,.esri-popup--is-docked{animation:none!important}}@media(prefers-reduced-motion:reduce){.esri-fov-overlay{animation:none!important}}@keyframes esri-fade-in-down{0%{opacity:0;transform:translateY(-5px)}25%{opacity:0;transform:translateY(-5px)}to{opacity:1;transform:translate(0)}}@keyframes esri-fade-in-up{0%{opacity:0;transform:translateY(5px)}25%{opacity:0;transform:translateY(5px)}to{opacity:1;transform:translate(0)}}@keyframes esri-fade-in{0%{opacity:0}25%{opacity:0}to{opacity:1}}@keyframes esri-fade-in-scale{0%{opacity:0;transform:scale(.95)}to{opacity:1;transform:scale(1)}}@keyframes looping-progresss-bar-ani{0%{width:0;left:0}20%{width:20%;left:0}80%{width:20%;left:80%}to{width:0;left:100%}}@keyframes esri-rotate{0%{transform:rotate(0)}to{transform:rotate(360deg)}}@keyframes panel-advance{0%{opacity:0;transform:translate(50px) scale(.99)}to{opacity:1;transform:translate(0) scale(1)}}@keyframes panel-retreat{0%{opacity:0;transform:translate(-50px) scale(.99)}to{opacity:1;transform:translate(0) scale(1)}}@keyframes panel-advance--rtl{0%{opacity:0;transform:translate(-50px) scale(.99)}to{opacity:1;transform:translate(0) scale(1)}}@keyframes panel-retreat--rtl{0%{opacity:0;transform:translate(50px) scale(.99)}to{opacity:1;transform:translate(0) scale(1)}}:host{container-type:inline-size}.empty-message{padding:12px 15px;animation:.5s ease-in-out esri-fade-in}.item{box-sizing:border-box;cursor:pointer;border:1px solid var(--calcite-color-background);flex-direction:row;width:100%;transition:background-color .25s ease-in-out,border-color .25s ease-in-out;animation:.5s ease-in-out esri-fade-in;display:flex;position:relative}.item:hover{background-color:var(--calcite-color-foreground-3);border-color:var(--calcite-color-background-inverse)}.item:hover .item-title{color:var(--calcite-color-text-1)}.item:focus{outline:none}.is-error{opacity:var(--calcite-opacity-light);background-color:var(--calcite-color-transparent)!important;border-color:var(--calcite-color-transparent)!important;cursor:auto}.item-thumbnail{aspect-ratio:1.5;border-inline-end:1px solid var(--calcite-color-border-1);flex-shrink:0;width:120px;min-width:120px;transition:background-color .25s ease-in-out,border-color .25s ease-in-out}.item-title{color:var(--calcite-color-text-3);justify-content:flex-start;align-items:center;width:100%;height:100%;font-size:var(--calcite-font-size-sm);transition:color .25s ease-in-out,font-weight .25s ease-in-out;display:flex}.item-title span{text-align:start;text-overflow:ellipsis;word-wrap:break-word;word-break:break-word;hyphens:auto;-webkit-line-clamp:2;line-clamp:2;-webkit-box-orient:vertical;width:100%;display:-webkit-box;overflow:hidden}.is-selected,.is-selected:hover,.is-selected:focus{cursor:auto;background-color:color-mix(in srgb,var(--calcite-color-brand-underline),70% transparent);border-color:var(--calcite-color-status-info)!important}.is-selected .item-title,.item.is-selected:hover .item-title,.item.is-selected:focus .item-title{color:var(--calcite-color-text-1);font-weight:var(--calcite-font-weight-medium)}.item-content{flex-direction:column;gap:var(--calcite-spacing-md);min-width:0;padding-block:var(--calcite-spacing-base);padding-inline:var(--calcite-spacing-md);display:flex}.item-tags{flex-direction:row;gap:var(--calcite-spacing-base);display:flex}.item-tags calcite-chip{--calcite-font-size--2: var(--calcite-font-size--3);cursor:inherit}@supports (object-fit: cover){.item-thumbnail{object-fit:cover}}@container (width>=200px) and (width <= 300px){.item{align-items:center}.item:not(.is-selected,:hover){border-color:var(--calcite-color-transparent)}}@container (width>=200px) and (width <= 278px){.item-thumbnail{aspect-ratio:1;width:80px;min-width:80px}}@container (width<200px) or (width>=350px){.item{text-align:center;flex-flow:column wrap}.item:not(.is-selected,:hover){border-color:var(--calcite-color-border-1)}.item-thumbnail{border-block-end:1px solid var(--calcite-color-border-1);border-inline-end:none;width:100%;min-width:0;height:auto}.item-content{height:32px;padding-block:var(--calcite-spacing-xxs);padding-inline:var(--calcite-spacing-xs);position:relative}.item-tags{position:absolute;inset-block-end:45px;inset-inline-end:5px}}`;
+class S extends $ {
   constructor() {
     super(...arguments), this._itemState = "loading", this._isActive = !1;
   }
@@ -21,7 +21,7 @@ class Y extends $ {
     this.properties = { _itemState: 16, _isActive: 16, disabled: 5, item: 0, itemIndex: 9, viewModel: 0, messages: 0 };
   }
   static {
-    this.styles = C;
+    this.styles = z;
   }
   loaded() {
     this.manager.onLifecycle(() => [
@@ -29,7 +29,7 @@ class Y extends $ {
         this._itemState = e;
       }, { sync: !0 }),
       l(() => this.viewModel.activeBasemap, (e) => {
-        this._isActive = this.item.basemap.id === e?.id, this._isActive && (I(this)?.focus(), this.el.scrollIntoView({ block: "nearest" }));
+        this._isActive = this.item.basemap.id === e?.id, this._isActive && (_(this)?.focus(), this.el.scrollIntoView({ block: "nearest" }));
       }, { initial: !0, sync: !0 })
     ]);
   }
@@ -43,19 +43,19 @@ class Y extends $ {
     }, c = `basemapgallery-item-${e.uid}`;
     return i`<div .ariaChecked=${r} .ariaDisabled=${h} aria-labelledby=${c ?? a} class=${p(k("item", v))} role=radio tabindex=${y ?? a} title=${g ?? a} @click=${() => {
       e.state === "ready" && (m.activeBasemap = e.basemap);
-    }}><img alt class="item-thumbnail" src=${f ?? a}><div class="item-content"><div class="item-title"><span id=${c ?? a}>${s}</span></div>${A(e.basemap) ? D(e.basemap, d) : null}</div>${e.state !== "loading" ? null : i`<calcite-scrim><span aria-hidden=true class=${p(B.loaderAnimation)} role=presentation></span></calcite-scrim>`}</div>`;
+    }}><img alt class="item-thumbnail" src=${f ?? a}><div class="item-content"><div class="item-title"><span id=${c ?? a}>${s}</span></div>${A(e.basemap) ? Y(e.basemap, d) : null}</div>${e.state !== "loading" ? null : i`<calcite-scrim><span aria-hidden=true class=${p(I.loaderAnimation)} role=presentation></span></calcite-scrim>`}</div>`;
   }
 }
-function D(t, e) {
-  return i`<div class="item-tags">${M(e)}${z(t) ? S(e) : null}</div>`;
+function Y(t, e) {
+  return i`<div class="item-tags">${D(e)}${C(t) ? M(e) : null}</div>`;
 }
-function M(t) {
+function D(t) {
   return i`<calcite-chip scale=s .label=${t.tag3D}>${t.tag3D}</calcite-chip>`;
 }
-function S(t) {
+function M(t) {
   return i`<calcite-chip appearance=outline-fill scale=s .label=${t.tagBeta}>${t.tagBeta}</calcite-chip>`;
 }
-w("arcgis-basemap-gallery-item", Y);
+w("arcgis-basemap-gallery-item", S);
 export {
-  Y as ArcgisBasemapGalleryItem
+  S as ArcgisBasemapGalleryItem
 };

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

@@ -5,8 +5,7 @@ import type CatalogLayerList from "@arcgis/core/widgets/CatalogLayerList";
 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";
@@ -16,7 +15,7 @@ import type { Icon } from "@esri/calcite-components/components/calcite-icon";
 import type { BasemapLayerListState } from "@arcgis/core/widgets/BasemapLayerList/types.js";
 
 /**
- * The Basemap Layer List component provides a way to display a list of [Basemap](https://developers.arcgis.com/javascript/latest/api-reference/esri-Basemap.html) layers and switch on/off their visibility. [Base layers](https://developers.arcgis.com/javascript/latest/api-reference/esri-Basemap.html#baseLayers) and [reference layers](https://developers.arcgis.com/javascript/latest/api-reference/esri-Basemap.html#referenceLayers) are divided into separate sections. When editing is enabled, layers can be reordered by dragging and dropping between the lists and the title can be edited.
+ * The Basemap Layer List component provides a way to display a list of [Basemap](https://developers.arcgis.com/javascript/latest/references/core/Basemap/) layers and switch on/off their visibility. [Base layers](https://developers.arcgis.com/javascript/latest/references/core/Basemap/#baseLayers) and [reference layers](https://developers.arcgis.com/javascript/latest/references/core/Basemap/#referenceLayers) are divided into separate sections. When editing is enabled, layers can be reordered by dragging and dropping between the lists and the title can be edited.
  *
  * @since 4.28
  */
@@ -32,83 +31,91 @@ export abstract class ArcgisBasemapLayerList extends LitElement {
    */
   accessor autoDestroyDisabled: boolean;
   /**
-   * Specifies a function to handle filtering base layer [list items](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList-ListItem.html).
+   * Specifies a function to handle filtering base layer [list items](https://developers.arcgis.com/javascript/latest/references/core/widgets/LayerList/ListItem/).
    *
    * @since 4.32
-   * @example layerList.baseFilterPredicate = (item) => item.title.toLowerCase().includes("streets");
+   * @example
+   * ```js
+   * basemapLayerListElement.baseFilterPredicate = (item) => item.title.toLowerCase().includes("streets");
+   * ```
    */
   accessor baseFilterPredicate: FilterPredicate | null | undefined;
   /**
-   * The value of the filter input text string if [visibleElements.filter](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-BasemapLayerList.html#visibleElements) is true.
+   * The value of the filter input text string if [showFilter](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-basemap-layer-list/#showFilter) is true.
    *
    * @default ""
    * @since 4.29
    * @see [showFilter](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-basemap-layer-list/#showFilter)
    * @example
+   * ```js
    * reactiveUtils.watch(
-   *   () => basemapLayerList.baseFilterText,
+   *   () => basemapLayerListElement.baseFilterText,
    *   (baseFilterText) => console.log(baseFilterText)
    * );
+   * ```
    */
   accessor baseFilterText: string;
   /** A collection of ListItems representing the baseLayers. */
   get baseItems(): Collection<ListItem>;
   /**
-   * Specifies a function that accesses each [ListItem](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList-ListItem.html) representing a base layer.
+   * Specifies a function that accesses each [ListItem](https://developers.arcgis.com/javascript/latest/references/core/widgets/LayerList/ListItem/) representing a base layer.
    * Each list item's modifiable properties can be updated within. 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)
    * property of the ListItem.
    *
    * @example
-   * const bmLayerList = new BasemapLayerList({
-   *   view: view,
-   *   baseListItemCreatedFunction: (event) => {
-   *     const baseListItem = event.item;
-   *     if(baseListItem.title === "World Imagery_01"){
-   *       // clean up title
-   *       baseListItem.title = "World Imagery";
-   *       // open the baseList item
-   *       baseListItem.open = true;
-   *     }
+   * ```js
+   * basemapLayerListElement.baseListItemCreatedFunction = (event) => {
+   *   const baseListItem = event.item;
+   *   if(baseListItem.title === "World Imagery_01"){
+   *     // clean up title
+   *     baseListItem.title = "World Imagery";
+   *     // open the baseList item
+   *     baseListItem.open = true;
    *   }
-   * })
+   * }
+   * ```
    */
   accessor baseListItemCreatedFunction: ListItemModifier | null | undefined;
   /** The current basemap's title. */
   accessor basemapTitle: string | null | undefined;
-  /** The CatalogLayerList that displays a catalog layer's dynamic group layer. */
+  /**
+   * The CatalogLayerList that displays a catalog layer's dynamic group layer.
+   *
+   * @see [arcgis-catalog-layer-list](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-catalog-layer-list/)
+   * @see [catalogOptions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-basemap-layer-list/#catalogOptions)
+   */
   get catalogLayerList(): CatalogLayerList | null | undefined;
   /**
-   * [CatalogLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-CatalogLayer.html) specific properties.
-   * Catalog layers will display their [dynamicGroupLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-CatalogLayer.html#dynamicGroupLayer) as an expandable [catalogLayerList](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-BasemapLayerList.html#catalogLayerList) in the BasemapLayerList widget.
+   * [CatalogLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/CatalogLayer/) specific properties.
+   * Catalog layers will display their [dynamicGroupLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/CatalogLayer/#dynamicGroupLayer) as an expandable [catalogLayerList](https://developers.arcgis.com/javascript/latest/references/core/widgets/BasemapLayerList/#catalogLayerList) in the BasemapLayerList widget.
    * 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 [catalogLayerList](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-BasemapLayerList.html#catalogLayerList).
+   * These are the properties that are used to configure the [catalogLayerList](https://developers.arcgis.com/javascript/latest/references/core/widgets/BasemapLayerList/#catalogLayerList).
    *
    * @since 4.30
-   * @see [catalogLayerList](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-BasemapLayerList.html#catalogLayerList)
+   * @see [catalogLayerList](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-basemap-layer-list/#catalogLayerList)
    * @example
-   * const basemapLayerList = new BasemapLayerList({
-   *   catalogOptions: {
-   *     listItemCreatedFunction: (event) => {
-   *       const { item } = event;
-   *       item.actionsSections = [
-   *         [
-   *           {
-   *             title: "Add layer to map",
-   *             icon: "add-layer",
-   *             id: "add-layer"
-   *           }
-   *         ]
-   *       ];
-   *     },
-   *     selectionMode: "single",
-   *     visibleElements: {
-   *       filter: true
-   *       temporaryLayerIndicators: true
-   *     }
+   * ```js
+   * basemapLayerListElement.catalogOptions = {
+   *   listItemCreatedFunction: (event) => {
+   *     const { item } = event;
+   *     item.actionsSections = [
+   *       [
+   *         {
+   *           title: "Add layer to map",
+   *           icon: "add-layer",
+   *           id: "add-layer"
+   *         }
+   *       ]
+   *     ];
    *   },
-   *   view,
-   * });
+   *   selectionMode: "single",
+   *   visibleElements: {
+   *     filter: true
+   *     temporaryLayerIndicators: true
+   *   }
+   * };
+   * ```
    */
   accessor catalogOptions: CatalogLayerListProperties | null | undefined;
   /**
@@ -125,16 +132,22 @@ export abstract class ArcgisBasemapLayerList extends LitElement {
    * @default false
    * @since 4.29
    * @see [showCollapseButton](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-basemap-layer-list/#showCollapseButton)
-   * @example basemapLayerList.collapsed = true;
+   * @example
+   * ```js
+   * basemapLayerListElement.collapsed = true;
+   * ```
    */
   accessor collapsed: boolean;
   /**
-   * Indicates whether [list items](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList-ListItem.html) may be reordered within the list by dragging and dropping.
-   * MapImageLayer [sublayers](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-MapImageLayer.html#sublayers) can be reordered only within their parent MapImageLayer and can not be dragged out as a separate layer.
+   * 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 [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.
    *
    * @default false
    * @since 4.29
-   * @example basemapLayerList.dragEnabled = true;
+   * @example
+   * ```js
+   * basemapLayerListElement.dragEnabled = true;
+   * ```
    */
   accessor dragEnabled: boolean;
   /**
@@ -144,22 +157,28 @@ export abstract class ArcgisBasemapLayerList extends LitElement {
    * @default false
    * @since 4.29
    * @see [showEditTitleButton](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-basemap-layer-list/#showEditTitleButton)
-   * @example basemapLayerList.editingTitle = true;
+   * @example
+   * ```js
+   * basemapLayerListElement.editingTitle = true;
+   * ```
    */
   accessor editingTitle: boolean;
   /**
-   * Placeholder text used in the filter input if [visibleElements.filter](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-BasemapLayerList.html#visibleElements) is true.
+   * Placeholder text used in the filter input if [showFilter](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-basemap-layer-list/#showFilter) is true.
    *
    * @default ""
    * @since 4.29
    * @see [showFilter](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-basemap-layer-list/#showFilter)
-   * @example basemapLayerList.filterPlaceholder = "Filter layers";
+   * @example
+   * ```js
+   * basemapLayerListElement.filterPlaceholder = "Filter layers";
+   * ```
    */
   accessor filterPlaceholder: string;
   /**
-   * Indicates the heading level to use for the widget title (i.e. "Navigation").
+   * Indicates the heading level to use for the component's title (i.e. "Navigation").
    * By default, the basemap's title is rendered
-   * as a level 2 heading (e.g. `<h2>Navigation</h2>`). Depending on the widget's placement
+   * as a level 2 heading (e.g. `<h2>Navigation</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.
    *
@@ -167,8 +186,10 @@ export abstract class ArcgisBasemapLayerList extends LitElement {
    * @since 4.20
    * @see [Heading Elements](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Heading_Elements)
    * @example
+   * ```js
    * // the component title will render as an <h3>
-   * basemapLayerList.headingLevel = 3;
+   * basemapLayerListElement.headingLevel = 3;
+   * ```
    */
   accessor headingLevel: HeadingLevel;
   /**
@@ -179,7 +200,7 @@ export abstract class ArcgisBasemapLayerList extends LitElement {
    */
   accessor hideBaseLayers: boolean;
   /**
-   * Indicates whether the basemap layer list displays a heading. The heading text is the title of the basemap. The heading level can be set with the [BasemapLayerList#headingLevel](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-BasemapLayerList.html#headingLevel).
+   * Indicates whether the basemap layer list displays a heading. The heading text is the title of the basemap. The heading level can be set with the [BasemapLayerList#headingLevel](https://developers.arcgis.com/javascript/latest/references/core/widgets/BasemapLayerList/#headingLevel).
    *
    * @default false
    * @since 5.0
@@ -209,21 +230,19 @@ export abstract class ArcgisBasemapLayerList extends LitElement {
    */
   get icon(): Icon["icon"];
   set icon(value: IconName);
-  /**
-   * The component's default label.
-   *
-   * @since 4.11
-   */
+  /** The component's default label. */
   accessor label: string;
   /**
-   * The minimum number of list items required to display the [visibleElements.filter](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-BasemapLayerList-BasemapLayerListVisibleElements.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-basemap-layer-list/#showFilter) input box.
    *
    * @default 10
    * @since 4.29
    * @see [showFilter](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-basemap-layer-list/#showFilter)
    * @example
-   * basemapLayerList.showFilter = true;
-   * basemapLayerList.minFilterItems = 5;
+   * ```js
+   * basemapLayerListElement.showFilter = true;
+   * basemapLayerListElement.minFilterItems = 5;
+   * ```
    */
   accessor minFilterItems: number;
   /**
@@ -233,57 +252,61 @@ export abstract class ArcgisBasemapLayerList extends LitElement {
    */
   accessor referenceElement: ArcgisReferenceElement | string | undefined;
   /**
-   * Specifies a function to handle filtering reference layer [list items](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList-ListItem.html).
+   * Specifies a function to handle filtering reference layer [list items](https://developers.arcgis.com/javascript/latest/references/core/widgets/LayerList/ListItem/).
    *
    * @since 4.32
-   * @example layerList.referenceFilterPredicate = (item) => item.title.toLowerCase().includes("streets");
+   * @example
+   * ```js
+   * layerList.referenceFilterPredicate = (item) => item.title.toLowerCase().includes("streets");
+   * ```
    */
   accessor referenceFilterPredicate: FilterPredicate | null | undefined;
   /**
-   * The value of the filter input text string if [visibleElements.filter](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-BasemapLayerList.html#visibleElements) is true.
+   * The value of the filter input text string if [showFilter](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-basemap-layer-list/#showFilter) is true.
    *
    * @default ""
    * @since 4.29
    * @see [showFilter](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-basemap-layer-list/#showFilter)
    * @example
+   * ```js
    * reactiveUtils.watch(
-   *   () => basemapLayerList.referenceFilterText,
+   *   () => basemapLayerListElement.referenceFilterText,
    *   (referenceFilterText) => console.log(referenceFilterText)
    * );
+   * ```
    */
   accessor referenceFilterText: string;
   /** A collection of ListItems representing the referenceLayers. */
   get referenceItems(): Collection<ListItem>;
   /**
-   * Specifies a function that accesses each [ListItem](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList-ListItem.html) representing a reference layer.
+   * Specifies a function that accesses each [ListItem](https://developers.arcgis.com/javascript/latest/references/core/widgets/LayerList/ListItem/) representing a reference layer.
    * Each list item's modifiable properties can be updated within. 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
-   * let bmLayerList = new BasemapLayerList({
-   *   view: view,
-   *   referenceListItemCreatedFunction: (event) => {
-   *     referenceListItem = event.item;
-   *     if(referenceListItem.title === "World Imagery_01_reference_layer"){
-   *       // clean up title
-   *       referenceListItem.title = "Reference layer";
-   *       // open the baseList item
-   *       referenceListItem.open = true;
-   *     }
+   * ```js
+   * basemapLayerListElement.referenceListItemCreatedFunction = (event) => {
+   *   referenceListItem = event.item;
+   *   if(referenceListItem.title === "World Imagery_01_reference_layer"){
+   *     // clean up title
+   *     referenceListItem.title = "Reference layer";
+   *     // open the baseList item
+   *     referenceListItem.open = true;
    *   }
-   * })
+   * }
+   * ```
    */
   accessor referenceListItemCreatedFunction: ListItemModifier | null | undefined;
   /**
-   * A collection of selected [ListItem](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList-ListItem.html)s representing basemap layers
+   * A collection of selected [ListItem](https://developers.arcgis.com/javascript/latest/references/core/widgets/LayerList/ListItem/)s representing basemap layers
    * selected by the user.
    *
-   * @see [selectionMode](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-BasemapLayerList.html#selectionMode)
+   * @see [selectionMode](https://developers.arcgis.com/javascript/latest/references/core/widgets/BasemapLayerList/#selectionMode)
    */
   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-BasemapLayerList.html#selectedItems) property.
+   * Selected items are available in the [selectedItems](https://developers.arcgis.com/javascript/latest/references/core/widgets/BasemapLayerList/#selectedItems) property.
    *
    * | Value | Description |
    * | ----- | ----------- |
@@ -294,10 +317,13 @@ export abstract class ArcgisBasemapLayerList extends LitElement {
    *
    * @default "none"
    * @since 4.29
-   * @see [selectedItems](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-BasemapLayerList.html#selectedItems)
-   * @example basemapLayerList.selectionMode = "multiple";
+   * @see [selectedItems](https://developers.arcgis.com/javascript/latest/references/core/widgets/BasemapLayerList/#selectedItems)
+   * @example
+   * ```js
+   * basemapLayerListElement.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.
    *
@@ -327,14 +353,14 @@ export abstract class ArcgisBasemapLayerList 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 [BasemapLayerList#minFilterItems](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-BasemapLayerList.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 [BasemapLayerList#minFilterItems](https://developers.arcgis.com/javascript/latest/references/core/widgets/BasemapLayerList/#minFilterItems), allowing users to filter layers by their title.
    *
    * @default false
    * @since 5.0
    */
   accessor showFilter: 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
@@ -361,7 +387,10 @@ export abstract class ArcgisBasemapLayerList extends LitElement {
    *
    * @default "default"
    * @since 4.29
-   * @example basemapLayerList.visibilityAppearance = "checkbox";
+   * @example
+   * ```js
+   * basemapLayerListElement.visibilityAppearance = "checkbox";
+   * ```
    */
   accessor visibilityAppearance: VisibilityAppearance;
   /** Permanently destroy the component. */

package/dist/components/arcgis-basemap-toggle/customElement.d.ts

@@ -1,7 +1,7 @@
 /// <reference path="../../index.d.ts" />
 import type Basemap2 from "@arcgis/core/Basemap.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
-import type { ArcgisReferenceElement } from "../../utils/component-utils.js";
+import type { ArcgisReferenceElement } from "../types.js";
 import type { BasemapProperties } from "@arcgis/core/Basemap";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
 import type { MapViewOrSceneView } from "@arcgis/core/views/MapViewOrSceneView.js";
@@ -15,7 +15,7 @@ import type { BasemapToggleViewModelState } from "@arcgis/core/widgets/BasemapTo
  * @since 4.28
  */
 export abstract class ArcgisBasemapToggle extends LitElement {
-  /** The map's current [basemap](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html#basemap). */
+  /** The map's current [basemap](https://developers.arcgis.com/javascript/latest/references/core/Map/#basemap). */
   get activeBasemap(): Basemap2 | null | undefined;
   /**
    * If true, the component will not be destroyed automatically when it is