@arcgis/map-components 4.34.0-next.11 → 4.34.0-next.110

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

@@ -1,5 +1,5 @@
 /// <reference types="@arcgis/core/interfaces.d.ts" />
-/// <reference types="../../index.d.ts" />
+/// <reference path="../../index.d.ts" />
 import { Use } from '@arcgis/lumina/controllers';
 import { default as BasemapToggleViewModel } from '@arcgis/core/widgets/BasemapToggle/BasemapToggleViewModel.js';
 import { JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
@@ -36,12 +36,21 @@ export declare class ArcgisBasemapToggle extends LitElement {
     icon?: string;
     /** The component's default label. */
     label?: string;
-    /** Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases. */
+    /**
+     * Replace localized message strings with your own strings.
+     *
+     * _**Note**: Individual message keys may change between releases._
+     */
     messageOverrides?: typeof this.messages._overrides;
     /** The next basemap for toggling. */
     nextBasemap?: __esri.BasemapProperties | string;
-    /** @default "top-left" */
-    position: __esri.UIPosition;
+    /** @deprecated since 4.34, use [`slot`](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/slot) instead. */
+    position?: __esri.UIPosition;
+    /**
+     * By assigning the `id` attribute of the Map or Scene component to this property, you can position a child component anywhere in the DOM while still maintaining a connection to the Map or Scene.
+     *
+     * @see [Associate components with a Map or Scene component](https://developers.arcgis.com/javascript/latest/programming-patterns/#associate-components-with-a-map-or-scene-component)
+     */
     referenceElement?: ArcgisReferenceElement | string;
     /**
      * Indicates if the Basemap title is displayed.
@@ -63,9 +72,9 @@ export declare class ArcgisBasemapToggle extends LitElement {
     toggle(): Promise<any>;
     /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
     readonly arcgisPropertyChange: TargetedEvent<this, {
-        name: "state" | "nextBasemap";
+        name: "state" | "activeBasemap" | "nextBasemap";
     }>;
-    /** Emitted when the component associated with a map or scene view is is ready to be interacted with. */
+    /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
     readonly arcgisReady: TargetedEvent<this, void>;
     private messages: Partial<{
         componentLabel: string;

package/dist/components/arcgis-basemap-toggle/customElement.js

@@ -1,40 +1,36 @@
-import { c as f } from "../../chunks/runtime.js";
-import { html as l } from "lit-html";
-import { usePropertyChange as B } from "@arcgis/lumina/controllers";
-import { classes as r } from "@arcgis/components-utils";
-import { getBasemapThumbnailUrl as x } from "@arcgis/core/applications/Components/basemapUtils.js";
-import S from "@arcgis/core/widgets/BasemapToggle/BasemapToggleViewModel.js";
-import { LitElement as T, createEvent as M, noShadowRoot as k, safeClassMap as a, nothing as c, safeStyleMap as b } from "@arcgis/lumina";
-import { u as I } from "../../chunks/useT9n.js";
+import { c as y } from "../../chunks/runtime.js";
+import { css as k, html as o } from "lit";
+import { usePropertyChange as $ } from "@arcgis/lumina/controllers";
+import { classes as l } from "@arcgis/toolkit/dom";
+import { getBasemapThumbnailUrl as z } from "@arcgis/core/applications/Components/basemapUtils.js";
+import B from "@arcgis/core/widgets/BasemapToggle/BasemapToggleViewModel.js";
+import { LitElement as S, createEvent as T, safeClassMap as i, nothing as c, safeStyleMap as b } from "@arcgis/lumina";
+import { u as M } from "../../chunks/useT9n.js";
 import { m as C } from "../../chunks/useViewModel.js";
-import { g as $ } from "../../chunks/globalCss.js";
-import { css as L } from "@lit/reactive-element/css-tag.js";
+import { g as u } from "../../chunks/globalCss.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.11 */
-const A = L`@layer{arcgis-basemap-toggle{display:block}.esri-basemap-toggle__title-wrap{text-wrap:wrap}}`, s = "esri-basemap-toggle", o = "esri-basemap-thumbnail", e = {
-  base: s,
-  secondaryBasemapImage: `${s}__image--secondary`,
-  container: `${o} ${s}__container`,
-  image: `${o}__image ${s}__image`,
-  imageLoading: `${s}__image--loading`,
-  overlay: `${o}__overlay ${s}__image-overlay`,
-  title: `${o}__title ${s}__title`,
-  titleWrap: `${s}__title-wrap`,
-  overlayScrim: `${o}__overlay-scrim`
-}, D = C(S);
-class E extends T {
+v4.34.0-next.110 */
+const j = k`.esri-widget__heading{color:var(--calcite-color-text-2);margin:0 0 .5rem;font-weight:var(--calcite-font-weight-semibold)}h1.esri-widget__heading{font-size:var(--calcite-font-size-xl)}h2.esri-widget__heading{font-size:var(--calcite-font-size-md)}h3.esri-widget__heading,h4.esri-widget__heading,h5.esri-widget__heading,h6.esri-widget__heading{font-size:var(--calcite-font-size)}.esri-widget{--esri-widget-padding-x: 15px;--esri-widget-padding-y: var(--calcite-spacing-md);--esri-widget-padding: var(--esri-widget-padding-y) var(--esri-widget-padding-x);box-sizing:border-box;color:var(--calcite-color-text-2);background-color:var(--calcite-color-foreground-1);font-size:var(--calcite-font-size);line-height:1.3em}.esri-widget *,.esri-widget :before,.esri-widget :after{box-sizing:inherit}.esri-widget.esri-widget--disabled>*{opacity:.4;pointer-events:none}.esri-widget.esri-widget--compact{--esri-widget-padding-y: 0;--esri-widget-padding-x: 0}.esri-widget__anchor{color:var(--calcite-color-text-2)}.esri-widget__anchor:hover{color:var(--calcite-color-text-3)}.esri-widget__anchor:hover,.esri-widget__anchor:focus{text-decoration:underline}.esri-widget__anchor--disabled{opacity:.4;pointer-events:none}.esri-widget__header{background-color:var(--calcite-color-foreground-1);flex:1 0 100%;justify-content:space-between;align-items:center;width:100%;min-height:48px;padding:12px 0 12px 15px;display:flex}.esri-widget__header .esri-widget__heading{width:calc(100% - 48px);text-align:initial;color:var(--calcite-color-text-1);align-items:center;margin:0;padding:0;display:flex}.esri-widget__header-button{appearance:none;cursor:pointer;color:var(--calcite-color-text-2);background-color:var(--calcite-color-foreground-1);border:none;flex:0 0 48px;justify-content:center;align-self:stretch;align-items:center;width:48px;padding:0;display:flex}.esri-widget__footer{background-color:var(--calcite-color-foreground-1);justify-content:center;align-items:center;width:100%;min-height:48px;display:flex}.esri-widget__footer-pagination{color:var(--calcite-color-text-2);justify-content:space-between;align-items:center;display:flex}.esri-widget__footer-pagination-previous-button,.esri-widget__footer-pagination-next-button{cursor:pointer;background-color:var(--calcite-color-foreground-1);border:0;margin:0 7px;padding:12px 15px;transition:background-color .125s ease-in-out}.esri-widget__footer-pagination-previous-button:hover,.esri-widget__footer-pagination-previous-button:focus,.esri-widget__footer-pagination-next-button:hover,.esri-widget__footer-pagination-next-button:focus{color:var(--calcite-color-text-1);background-color:var(--calcite-color-foreground-1)}.esri-menu{visibility:hidden;z-index:1;background-clip:padding;background-color:var(--calcite-color-foreground-1);background-clip:padding-box;width:100%;max-height:0;margin:2px 0 0;padding:0;font-size:var(--calcite-font-size);line-height:var(--calcite-spacing-xl);position:absolute;top:100%;left:0;overflow:hidden;box-shadow:0 1px 2px #0000004d}.esri-menu .esri-menu__header{color:var(--calcite-color-text-inverse);background-color:var(--calcite-color-inverse);padding:6px 12px}.esri-menu__list{margin:0;padding:0;list-style:none}.esri-menu__list-item{cursor:pointer;border-top:1px solid #adadad4d;border-left:3px solid #0000;padding:.8em 1em}.esri-menu__list-item [class^=esri-icon-],.esri-menu__list-item [class*=" esri-icon-"]{padding-right:2.8px}.esri-menu__list-item:first-child{border-top:none}.esri-menu__list-item--focus,.esri-menu__list-item:hover,.esri-menu__list-item:focus{background-color:#303030}.esri-menu__list-item:active{background-color:#000}.esri-menu__list-item--active,.esri-menu__list-item--active:hover,.esri-menu__list-item--active:focus{background-color:var(--calcite-color-foreground-1);border-left-color:#2493f2}.esri-widget__table{border-collapse:collapse;color:var(--calcite-color-text-1);border:none;width:100%;line-height:1.3em}.esri-widget__table tr:nth-child(odd){background-color:var(--calcite-color-transparent)}.esri-widget__table tr:nth-child(2n){background-color:var(--calcite-color-transparent-press)}.esri-widget__table tr a{color:var(--calcite-color-text-2)}.esri-widget__table tr a:hover,.esri-widget__table tr a:focus{color:var(--calcite-color-text-1)}.esri-widget__table tr td,.esri-widget__table tr th{vertical-align:top;word-break:break-word;padding:.5em .7em;font-size:var(--calcite-font-size-sm);font-weight:var(--calcite-font-weight-regular)}.esri-widget__table tr th{text-align:left;border-right:3px solid #0000000d;width:50%}.esri-widget__table tr td{width:50%}.esri-input{color:var(--calcite-color-text-1);background-color:var(--calcite-color-foreground-1);border:1px solid #959595;font-size:var(--calcite-font-size)}.esri-input::-ms-clear{display:none}.esri-input::placeholder{opacity:1;color:var(--calcite-color-text-2)}.esri-input:placeholder-shown{text-overflow:ellipsis}.esri-input[type=text],.esri-input[type=password],.esri-input[type=number]{height:32px;padding:0 .5em}calcite-combobox.esri-input{border:none}.esri-widget__content--empty{text-align:center;color:var(--calcite-color-border-input);flex-flow:column wrap;align-items:center;padding:18px 22px;display:flex}.esri-widget__content--empty h1.esri-widget__heading,.esri-widget__content--empty h2.esri-widget__heading,.esri-widget__content--empty h3.esri-widget__heading,.esri-widget__content--empty h4.esri-widget__heading,.esri-widget__content--empty h5.esri-widget__heading{font-weight:var(--calcite-font-weight-regular)}.esri-widget__content-illustration--empty{width:128px;padding:1rem 0}.esri-widget__content-icon--empty{width:32px;padding:.5rem 0}.esri-select{appearance:none;cursor:pointer;color:var(--calcite-color-text-2);background:var(--calcite-color-foreground-1) url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='-8 -8 32 32' width='32' height='32'%3E%3Cpath d='M8 11.207l-4-4V5.793l4 4 4-4v1.414z' fill='%23adadad' fillrule='nonzero'/%3E%3C/svg%3E") 100% no-repeat;border:1px solid #959595;border-radius:0;width:100%;height:32px;margin:0;padding:0 .5em;font-family:inherit;font-size:.85em;display:block}.esri-select[disabled]{cursor:auto}.esri-select::-ms-expand{display:none}.esri-disabled a,.esri-disabled [role=menu],.esri-disabled [role=checkbox],.esri-disabled [class^=esri-icon-],.esri-disabled [class*=" esri-icon-"]{color:var(--calcite-color-text-3)}.keynav-mode .esri-widget:focus,.keynav-mode .esri-widget :focus{z-index:1;outline-offset:2px;outline:2px solid #adadad}.esri-widget__loader-animation{border:.15em solid #adadad4d;border-top-color:var(--calcite-color-border-input);border-radius:100%;width:1em;height:1em;font-size:var(--calcite-font-size-md);animation:1.25s linear infinite esri-rotate;display:block;transform:translateZ(0)}:dir(rtl) .esri-widget__table th{text-align:right;border-left:3px solid #0000000d;border-right:none}:dir(rtl) .esri-select{background-position:0}:dir(rtl) .esri-menu__list-item{border-left:none;border-right:3px solid #0000}:dir(rtl) .esri-menu__list-item [class^=esri-icon-],:dir(rtl) .esri-menu__list-item [class*=" esri-icon-"]{padding-left:2px;padding-right:0}:dir(rtl) .esri-menu__list-item--active{border-right-color:var(--calcite-color-brand)}.esri-icon-font-fallback-text{clip:rect(0 0 0 0);width:1px;height:1px;position:absolute;overflow:hidden}.esri-rotating{animation:1.25s linear infinite esri-rotate;transform:translateZ(0)}.esri-clearfix:before,.esri-clearfix:after{content:" ";display:table}.esri-clearfix:after{clear:both}.esri-interactive{cursor:pointer}.esri-hidden{display:none!important}.esri-invisible{visibility:hidden!important}.esri-offscreen{position:absolute;top:-999em;left:-999em}.esri-match-height{flex-direction:column;flex:auto;display:flex;overflow:hidden}.basemap-toggle{box-shadow:none;background-color:var(--calcite-color-transparent)}.basemap-toggle calcite-button{flex-direction:row;justify-content:center;align-items:center;width:69px;height:69px;display:flex;position:relative;overflow:visible}.basemap-toggle__container,.basemap-toggle__image{width:64px;height:64px;position:absolute;top:0;left:0;overflow:hidden}.basemap-toggle__container{box-shadow:0 1px 2px #0000004d}.basemap-toggle__image{background-color:var(--calcite-color-foreground-1);background-image:url(../base/images/basemap-toggle-64.svg);background-position:50%;background-repeat:no-repeat;background-size:cover}.basemap-toggle__image--loading{background-image:unset;justify-content:center;align-items:center;display:flex}.basemap-toggle__image--secondary{margin-top:5px;margin-left:5px;animation:2s ease-in-out esri-basemap-slide;box-shadow:0 1px 2px #0000004d}.basemap-thumbnail__overlay-scrim{--calcite-scrim-background: var(--calcite-color-transparent-scrim);color:var(--calcite-color-text-inverse)}.basemap-toggle__image-overlay{background-color:var(--calcite-color-transparent);justify-content:center;align-items:flex-end;width:100%;height:100%;transition:background-color .125s ease-in-out;display:flex;position:absolute}.basemap-toggle__image-overlay .basemap-toggle:hover{background-color:var(--calcite-color-background)}.basemap-toggle__title{text-align:center;background-color:var(--calcite-color-transparent-tint);flex:1 0 100%;height:auto;padding:.5em;font-size:9px;font-weight:500;line-height:1.3em}.basemap-toggle__title-wrap{text-wrap:wrap}`, a = "basemap-toggle", s = "basemap-thumbnail", e = {
+  base: a,
+  secondaryBasemapImage: `${a}__image--secondary`,
+  container: `${s} ${a}__container`,
+  image: `${s}__image ${a}__image`,
+  imageLoading: `${a}__image--loading`,
+  overlay: `${s}__overlay ${a}__image-overlay`,
+  title: `${s}__title ${a}__title`,
+  titleWrap: `${a}__title-wrap`,
+  overlayScrim: `${s}__overlay-scrim`
+}, E = C(B);
+class I extends S {
   constructor() {
-    super(...arguments), this.messages = I(), this.viewModel = D(this), this.activeBasemap = this.viewModel.activeBasemap, this.autoDestroyDisabled = !1, this.icon = "layer-basemap", this.nextBasemap = this.viewModel.nextBasemap, this.position = "top-left", this.showTitle = !1, this.state = this.viewModel.state, this.arcgisPropertyChange = B()("nextBasemap", "state"), this.arcgisReady = M();
+    super(...arguments), this.messages = M(), this.viewModel = E(this), this.activeBasemap = this.viewModel.activeBasemap, this.autoDestroyDisabled = !1, this.icon = "layer-basemap", this.nextBasemap = this.viewModel.nextBasemap, this.showTitle = !1, this.state = this.viewModel.state, this.arcgisPropertyChange = $()("activeBasemap", "nextBasemap", "state"), this.arcgisReady = T();
   }
   static {
     this.properties = { activeBasemap: 0, autoDestroyDisabled: 5, icon: 1, label: 1, messageOverrides: 0, nextBasemap: 1, position: 3, referenceElement: 1, showTitle: 5, state: 3 };
   }
   static {
-    this.shadowRootOptions = k;
-  }
-  static {
-    this.styles = A;
+    this.styles = j;
   }
   async destroy() {
     await this.manager.destroy();
@@ -43,17 +39,17 @@ class E extends T {
     return await this.viewModel.toggle();
   }
   _getThumbnailStyles(t) {
-    const n = x(t);
+    const n = z(t);
     return n ? { backgroundImage: `url(${n})` } : { backgroundImage: "" };
   }
   render() {
-    const t = this.viewModel, n = t.state === "disabled" ? null : t.activeBasemap, i = t.state === "disabled" ? null : t.nextBasemap, u = t.state === "loading", p = t.state === "incompatible-next-basemap", m = i?.title ?? "", d = i && i.loadStatus !== "loaded";
-    let g;
-    const h = this.showTitle && m, v = p, y = h || v, w = this._getThumbnailStyles(n), _ = this._getThumbnailStyles(i);
-    return y && (g = l`<div class=${a(e.overlay)}>${h ? l`<span class=${a(r(e.title, e.titleWrap))} title=${m ?? c}>${m}</span>` : null}${v ? l`<calcite-scrim class=${a(e.overlayScrim)} title=${this.messages.incompatibleSpatialReference ?? c}><calcite-icon icon=exclamation-mark-triangle></calcite-icon></calcite-scrim>` : null}</div>`), l`<div class=${a(r(e.base, $.widget))}><calcite-button appearance=transparent data-basemap-id=${(i ? i.id : "") ?? c} .disabled=${p} kind=neutral .label=${this.label ?? void 0} @click=${() => void this.toggle()} title=${this.label ?? void 0 ?? c}><div class=${a(r(e.container, e.secondaryBasemapImage))}><div class=${a(e.image)} style=${b(w)}></div></div><div class=${a(e.container)}><div class=${a(r(e.image, d ? e.imageLoading : null))} style=${b(_)}>${d || u ? l`<calcite-scrim><span aria-hidden=true class=${a($.loaderAnimation)} role=presentation></span></calcite-scrim>` : null}</div>${g}</div></calcite-button></div>`;
+    const t = this.viewModel, n = t.state === "disabled" ? null : t.activeBasemap, r = t.state === "disabled" ? null : t.nextBasemap, v = t.state === "loading", g = t.state === "incompatible-next-basemap", d = r?.title ?? "", p = r && r.loadStatus !== "loaded";
+    let m;
+    const h = this.showTitle && d, _ = g, w = h || _, f = this._getThumbnailStyles(n), x = this._getThumbnailStyles(r);
+    return w && (m = o`<div class=${i(e.overlay)}>${h ? o`<span class=${i(l(e.title, e.titleWrap))} title=${d ?? c}>${d}</span>` : null}${_ ? o`<calcite-scrim class=${i(e.overlayScrim)} title=${this.messages.incompatibleSpatialReference ?? c}><calcite-icon icon=exclamation-mark-triangle></calcite-icon></calcite-scrim>` : null}</div>`), o`<div class=${i(l(e.base, u.widget))}><calcite-button appearance=transparent data-basemap-id=${(r ? r.id : "") ?? c} .disabled=${g} kind=neutral .label=${this.label ?? void 0} @click=${() => void this.toggle()} title=${this.label ?? void 0 ?? c}><div class=${i(l(e.container, e.secondaryBasemapImage))}><div class=${i(e.image)} style=${b(f)}></div></div><div class=${i(e.container)}><div class=${i(l(e.image, p ? e.imageLoading : null))} style=${b(x)}>${p || v ? o`<calcite-scrim><span aria-hidden=true class=${i(u.loaderAnimation)} role=presentation></span></calcite-scrim>` : null}</div>${m}</div></calcite-button></div>`;
   }
 }
-f("arcgis-basemap-toggle", E);
+y("arcgis-basemap-toggle", I);
 export {
-  E as ArcgisBasemapToggle
+  I as ArcgisBasemapToggle
 };

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

@@ -0,0 +1,22 @@
+export declare const css: {
+    readonly base: "arcgis-bookmarks";
+    readonly empty: "arcgis-bookmarks__empty";
+    readonly noBookmarksHeader: "arcgis-bookmarks__no-bookmarks-heading";
+    readonly noBookmarksDescription: "arcgis-bookmarks__no-bookmarks-description";
+    readonly form: "arcgis-bookmarks__form";
+    readonly list: "arcgis-bookmarks__list";
+    readonly loader: "arcgis-bookmarks__loader";
+    readonly filterNoResults: "arcgis-bookmarks__filter-no-results";
+    readonly formContent: "arcgis-bookmarks__form-content";
+    readonly addBookmarkButton: "arcgis-bookmarks__add-bookmark-button";
+    readonly editBookmarkInput: "arcgis-bookmarks__edit-bookmark-input";
+    readonly addBookmarkInput: "arcgis-bookmarks__add-bookmark-input";
+    readonly dragEnabled: "arcgis-bookmarks--drag-enabled";
+    readonly bookmarkImage: "arcgis-bookmarks__image";
+    readonly bookmarkImageContainer: "arcgis-bookmarks__bookmark-image-container";
+    readonly bookmarkContent: "arcgis-bookmarks__bookmark-content";
+    readonly bookmarkContentLabel: "arcgis-bookmarks__bookmark-content-label";
+    readonly authoring: "arcgis-bookmarks__authoring";
+    readonly authoringImageContainer: "arcgis-bookmarks__authoring-image-container";
+    readonly authoringRefreshThumbnailButton: "arcgis-bookmarks__authoring-refresh-thumbnail-button";
+};

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

@@ -1,82 +1,131 @@
 /// <reference types="@arcgis/core/interfaces.d.ts" />
-/// <reference types="../../index.d.ts" />
+/// <reference path="../../index.d.ts" />
+import { default as BookmarksViewModel } from '@arcgis/core/widgets/Bookmarks/BookmarksViewModel.js';
+import { JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { Use } from '@arcgis/lumina/controllers';
-import { default as Bookmarks } from '@arcgis/core/widgets/Bookmarks.js';
-import { PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
+import { HeadingLevel } from '../../support/heading';
 import { ArcgisReferenceElement } from '../../utils/component-utils';
 
-declare const useBookmarksWidget: (component: LitElement & Pick<Bookmarks, "icon" | "label" | "viewModel" | "disabled" | "goToOverride" | "dragEnabled" | "filterPlaceholder" | "filterText" | "defaultCreateOptions" | "bookmarks" | "defaultEditOptions"> & {
-    state?: unknown;
-    viewModel?: __esri.BookmarksViewModel | undefined;
-    closed?: boolean;
-    icon: import('@arcgis/components-utils').Nil | string;
-    label: import('@arcgis/components-utils').Nil | string;
-    referenceElement?: ArcgisReferenceElement | string;
-    position: __esri.UIPosition;
-    arcgisReady: import('@arcgis/lumina').EventEmitter;
-    arcgisPropertyChange: import('@arcgis/lumina').EventEmitter<{
-        name: string;
-    }> | undefined;
-    el: HTMLElement & {
-        childElem
-        /** @copyDoc */
-        ? /** @copyDoc */: HTMLElement & {
-            ownedBy?: HTMLElement;
-        };
-        view?: __esri.LinkChartView | __esri.MapView | __esri.SceneView;
-    };
-    autoDestroyDisabled: boolean;
-    destroy: () => Promise<void>;
-}) => Bookmarks;
+declare const useBookmarksViewModel: (component: LitElement & Pick<BookmarksViewModel, never> & import('../../controllers/useViewModel').ViewModelControllerUses<BookmarksViewModel>) => BookmarksViewModel;
 /**
- * The Bookmarks component allow 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).
+ * 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).
+ *
+ * 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/arcgis-map/#timeExtent) of the Map will be set to the timeExtent of the selected bookmark.
+ * To disable time capability in the Bookmarks component, set [timeDisabled](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-bookmarks/#timeDisabled) to `true`.
+ *
+ * The Bookmarks component can be used to create, edit, reorder, and delete bookmarks.
+ * To enable these features, set the following properties to `true`:
+ * [showAddBookmarkButton](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-bookmarks/#showAddBookmarkButton), [showEditBookmarkButton](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-bookmarks/#showEditBookmarkButton), and [dragEnabled](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-bookmarks/#dragEnabled).
+ *
+ * **Note:** Bookmarks are supported in a 3D [Scene](https://developers.arcgis.com/javascript/latest/references/map-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).
  *
  * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-bookmarks/)
+ *
+ * @since 4.28
+ * @see [Sample - Bookmarks component](https://developers.arcgis.com/javascript/latest/sample-code/bookmarks/)
  */
 export declare class ArcgisBookmarks extends LitElement {
     /**
-     * Emitted when the component's close button is clicked.
-     *
-     * @since 4.33
-     */
-    readonly arcgisClose: TargetedEvent<this>;
-    /**
-     * 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
-     * component to a different place on the page, or temporarily hide it. If this
-     * is set, make sure to call the [destroy](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-bookmarks/#destroy) method when you are done to
-     * prevent memory leaks.
+     * 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.
      *
-     * @default false
+     * @see [Associate components with a Map or Scene component](https://developers.arcgis.com/javascript/latest/programming-patterns/#associate-components-with-a-map-or-scene-component)
      */
-    autoDestroyDisabled: boolean;
+    referenceElement?: ArcgisReferenceElement | string;
+    /** @deprecated since 4.34, use [`slot`](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/slot) instead. */
+    position?: __esri.UIPosition;
     /**
-     * A collection of [Bookmark](https://developers.arcgis.com/javascript/latest/api-reference/esri-webmap-Bookmark.html)s.
+     * Icon which represents the component.
+     * Typically used when the component is controlled by another component (e.g. by the Expand component).
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Bookmarks.html#bookmarks)
+     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
+     * @default "bookmark"
      */
-    bookmarks: __esri.Collection<__esri.Bookmark>;
+    icon?: string;
     /**
      * Indicates whether a component is closed. When `true`, the component will be hidden.
      *
-     * @since 4.33
      * @default false
      */
     closed: boolean;
     /**
-     * Specifies how new bookmarks will be created if [visibleElements.addBookmarkButton](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Bookmarks.html#VisibleElements) is set to `true`.
+     * Specifies how new bookmarks will be created if [showAddBookmarkButton](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-bookmarks/#showAddBookmarkButton) is set to `true`.
+     * Can be used to enable or disable taking screenshots or capturing the bookmark's viewpoint based on the current
+     * view when a bookmark is created. See [BookmarkOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Bookmarks-BookmarksViewModel-BookmarkOptions.html)
+     * for the full list of options.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Bookmarks.html#defaultCreateOptions)
+     * @example
+     * ```js
+     * const bookmarksElement = document.querySelector("arcgis-bookmarks");
+     * bookmarksElement.showAddBookmarkButton = true;
+     * bookmarksElement.defaultCreateOptions = {
+     *   // whenever a new bookmark is created, a 100x100 px
+     *   // screenshot of the view will be taken and the rotation, scale, and extent
+     *   // of the view will not be set as the viewpoint of the new bookmark
+     *   takeScreenshot: true,
+     *   captureViewpoint: false,
+     *   captureTimeExtent: false, // the time extent will not be saved in the bookmark
+     *   screenshotSettings: {
+     *     width: 100,
+     *     height: 100
+     *   }
+     * };
+     * ```
      */
     defaultCreateOptions: __esri.BookmarkOptions;
     /**
-     * Specifies how bookmarks will be edited, if [visibleElements.editBookmarkButton](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Bookmarks.html#VisibleElements) is set to `true`.
-     *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Bookmarks.html#defaultEditOptions)
+     * Specifies how bookmarks will be edited, if [showEditBookmarkButton](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-bookmarks/#showEditBookmarkButton) is set to `true`.
+     * Can be used to enable or disable taking screenshots or capturing the bookmark's viewpoint based on the current
+     * view when a bookmark is edited. See [BookmarkOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Bookmarks-BookmarksViewModel-BookmarkOptions.html)
+     * for the full list of options.
      */
     defaultEditOptions: __esri.BookmarkOptions;
     /**
-     * When true, the widget is visually withdrawn and cannot be interacted with.
+     * 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.
+     *
+     * @example
+     * ```js
+     * const bookmarksElement = document.querySelector("arcgis-bookmarks");
+     * // define bookmarks manually
+     * bookmarksElement.bookmarks = [
+     *   new Bookmark({
+     *     name: "Angeles National Forest",
+     *     viewpoint: {
+     *       targetGeometry: {
+     *         type: "extent",
+     *         spatialReference: {
+     *           wkid: 102100
+     *         },
+     *         xmin: -13139131.948889678,
+     *         ymin: 4047767.23531948,
+     *         xmax: -13092887.54677721,
+     *         ymax: 4090610.189673263
+     *       }
+     *     }
+     *   }),
+     *   new Bookmark({
+     *     name: "Crystal Lake",
+     *     viewpoint: {
+     *       targetGeometry: {
+     *         type: "extent",
+     *         spatialReference: {
+     *           wkid: 102100
+     *         },
+     *         xmin: -13125852.551697943,
+     *         ymin: 4066904.1101411926,
+     *         xmax: -13114291.451169826,
+     *         ymax: 4077614.8487296384
+     *       },
+     *       rotation: 90
+     *     }
+     *   })
+     * ];
+     */
+    bookmarks: __esri.Collection<__esri.Bookmark>;
+    /**
+     * When true, the component is visually withdrawn and cannot be interacted with.
      *
      * @default false
      */
@@ -84,65 +133,136 @@ export declare class ArcgisBookmarks extends LitElement {
     /**
      * Indicates if a Bookmark is able to be dragged in order to update its position in the list.
      *
+     * @since 4.29
      * @default false
      */
     dragEnabled: boolean;
     /**
-     * Defines the text used as a placeholder when visibleElements.filter is set to `true`.
+     * Defines the text used as a placeholder when [showFilter](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-bookmarks/#showFilter) is set to `true`.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Bookmarks.html#filterPlaceholder)
+     * @since 4.29
+     * @default ""
      */
     filterPlaceholder: string;
     /**
-     * Defines the text used to filter the bookmarks when visibleElements.filter is set to `true`.
+     * Defines the text used to filter the bookmarks when [showFilter](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-bookmarks/#showFilter) is set to `true`.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Bookmarks.html#filterText)
+     * @since 4.29
+     * @default ""
      */
     filterText: string;
+    /**
+     * Indicates the heading level to use for the message "No bookmarks" when no bookmarks
+     * are available. By default, this message is rendered
+     * as a level 2 heading (e.g. `<h2>No bookmarks</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.
+     *
+     * @see [Heading Elements](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Heading_Elements)
+     * @example
+     * ```js
+     * // "No bookmarks" will render as an <h3>
+     * bookmarksElement.headingLevel = 3;
+     * ```
+     * @default 2
+     */
+    headingLevel: HeadingLevel;
     /**
      * This function provides the ability to override either the
      * [MapView goTo()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#goTo) or
      * [SceneView goTo()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#goTo) methods.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Bookmarks.html#goToOverride)
-     *
-     * @since 4.33
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Bookmarks-BookmarksViewModel.html#goToOverride)
      */
     goToOverride: nullish | __esri.GoToOverride;
-    /** @default false */
-    hideFlow: boolean;
-    /** @default false */
-    hideThumbnail: boolean;
-    /** @default false */
-    hideTime: boolean;
     /**
-     * Icon which represents the widget.
+     * Indicates whether to display the button to add a new bookmark.
      *
-     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
-     * @default "bookmark"
+     * @since 4.30
+     * @default false
      */
-    icon: string;
+    showAddBookmarkButton: boolean;
     /**
-     * The widget's default label.
+     * Indicates whether to display the close button.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Bookmarks.html#label)
+     * @since 4.30
+     * @default false
      */
-    label: string;
-    /** @default "bottom-left" */
-    position: __esri.UIPosition;
-    referenceElement?: ArcgisReferenceElement | string;
-    /** @default false */
-    showAddBookmarkButton: boolean;
-    /** @default false */
     showCloseButton: boolean;
-    /** @default false */
+    /**
+     * Indicates whether to display the collapse button.
+     *
+     * @since 4.30
+     * @default false
+     */
     showCollapseButton: boolean;
-    /** @default false */
+    /**
+     * Indicates whether to display the button to edit a bookmark.
+     *
+     * @since 4.30
+     * @default false
+     */
     showEditBookmarkButton: boolean;
-    /** @default false */
+    /**
+     * Indicates whether to display the bookmark filter.
+     *
+     * @since 4.30
+     * @default false
+     */
     showFilter: boolean;
-    /** @default false */
+    /**
+     * Determines whether the component should be rendered within its built-in [flow component](https://developers.arcgis.com/calcite-design-system/components/flow/).
+     *
+     * @since 4.30
+     * @default false
+     */
+    hideFlow: boolean;
+    /**
+     * Indicates whether to display the heading.
+     *
+     * @since 4.30
+     * @default false
+     */
     showHeading: boolean;
+    /**
+     * Indicates whether the thumbnail associated with the bookmark is hidden.
+     *
+     * @since 4.30
+     * @default false
+     */
+    hideThumbnail: boolean;
+    /**
+     * Indicates whether the time (`h:m:s`) displayed next to the date is hidden if the bookmark has a time extent defined.
+     *
+     * @since 4.30
+     * @default false
+     */
+    hideTime: boolean;
+    /**
+     * Indicates whether to disable the time capability of the Bookmarks component.
+     *
+     * @since 4.34
+     * @default false
+     */
+    timeDisabled: boolean | 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
+     * component to a different place on the page, or temporarily hide it. If this
+     * is set, make sure to call the [destroy](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-bookmarks/#destroy) method when you are done to
+     * prevent memory leaks.
+     *
+     * @default false
+     */
+    autoDestroyDisabled: boolean;
+    /**
+     * Replace localized message strings with your own strings.
+     *
+     * _**Note**: Individual message keys may change between releases._
+     */
+    messageOverrides?: typeof this.messages._overrides;
+    /** The component's default label. */
+    label?: string;
     /**
      * The view model's state.
      *
@@ -153,13 +273,50 @@ export declare class ArcgisBookmarks extends LitElement {
     readonly state: "ready" | "loading";
     /** Permanently destroy the component. */
     destroy(): Promise<void>;
-    readonly arcgisEdit: TargetedEvent<this, __esri.BookmarksBookmarkEditEvent>;
+    /** Zoom to a specific bookmark. */
+    goTo(bookmark: __esri.Bookmark): Promise<void>;
+    /**
+     *
+     * Fires when a [Bookmark](https://developers.arcgis.com/javascript/latest/api-reference/esri-webmap-Bookmark.html) is edited.
+     *
+     * @example
+     * ```js
+     * // once an edit has been made, enable the "Save Webmap" button
+     * //    to allow the user to save their changes
+     * bookmarksElement.addEventListener("arcgisBookmarkEdit", (event) => {
+     *    saveBtn.disabled = false;
+     * });
+     * ```
+     */
+    readonly arcgisBookmarkEdit: TargetedEvent<this, __esri.BookmarksBookmarkEditEvent>;
+    /**
+     * Fires when a [Bookmark](https://developers.arcgis.com/javascript/latest/api-reference/esri-webmap-Bookmark.html) is selected.
+     *
+     * @example
+     * ```html
+     * <arcgis-expand expanded>
+     *  <arcgis-bookmarks></arcgis-bookmarks>
+     * </arcgis-expand>
+     * ```
+     *
+     * ```js
+     * const bookmarksElement = document.querySelector("arcgis-bookmarks");
+     * const expandElement = document.querySelector("arcgis-expand");
+     *
+     * // collapses the associated Expand component
+     * // when a bookmark is selected
+     * bookmarksElement.addEventListener("arcgisBookmarkSelect", (event) => {
+     *   expandElement.expanded = false;
+     * });
+     * ```
+     */
+    readonly arcgisBookmarkSelect: TargetedEvent<this, __esri.BookmarksBookmarkSelectEvent>;
     /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
     readonly arcgisPropertyChange: TargetedEvent<this, {
         name: "state";
     }>;
-    /** Emitted when the component associated with a map or scene view is is ready to be interacted with. */
+    /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
     readonly arcgisReady: TargetedEvent<this, void>;
-    readonly arcgisSelect: TargetedEvent<this, __esri.BookmarksBookmarkSelectEvent>;
+    private messages;
 }
 export {};