@arcgis/map-components 4.33.0-next.99 → 4.33.1

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

@@ -1,64 +1,85 @@
 /// <reference types="@arcgis/core/interfaces.d.ts" />
 /// <reference types="../../index.d.ts" />
 import { Use } from '@arcgis/lumina/controllers';
-import { Nil } from '@arcgis/components-utils';
 import { default as BasemapToggleViewModel } from '@arcgis/core/widgets/BasemapToggle/BasemapToggleViewModel.js';
 import { JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { ArcgisReferenceElement } from '../../utils/component-utils';
 
-declare const useBasemapToggleViewModel: (component: LitElement & Pick<BasemapToggleViewModel, never> & import('../../controllers/useViewModel').ViewModelControllerUses<BasemapToggleViewModel>, options?: {
-    editConstructorProperties(props: unknown): unknown;
-} | undefined) => BasemapToggleViewModel;
+declare const useBasemapToggleViewModel: (component: LitElement & Pick<BasemapToggleViewModel, never> & import('../../controllers/useViewModel').ViewModelControllerUses<BasemapToggleViewModel>) => BasemapToggleViewModel;
 /**
- * Basemap Toggle component allows an end-user to switch between two basemaps.
+ * The Basemap Toggle component allows an end-user to switch between two basemaps.
  *
  * The basemaps can have different spatial references.
+ *
+ * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-basemap-toggle/)
  */
 export declare 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/api-reference/esri-Map.html#basemap). */
     readonly activeBasemap: nullish | __esri.Basemap;
     /**
-     * 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
-     * temporary hide it. If this is set, make sure to call the
-     * \`destroy\` method when you are done to prevent memory leaks.
+     * 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-basemap-toggle/#destroy) method when you are done to
+     * prevent memory leaks.
+     *
+     * @default false
      */
     autoDestroyDisabled: boolean;
     /**
      * Icon which represents the component.
      * Typically used when the component is controlled by another component (e.g. by the Expand component).
+     *
+     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
+     * @default "layer-basemap"
      */
-    icon: Nil | string;
+    icon?: string;
     /** The component's default label. */
-    label: string | undefined;
-    /** Replace localized message strings with your own strings. */
+    label?: string;
+    /**
+     * 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. */
-    get nextBasemap(): typeof this.viewModel.nextBasemap;
-    set nextBasemap(value: __esri.BasemapProperties | nullish | string);
+    nextBasemap?: __esri.BasemapProperties | string;
+    /** @default "top-left" */
     position: __esri.UIPosition;
-    referenceElement: ArcgisReferenceElement | Nil | string;
-    /** Indicates if the Basemap title is displayed. */
+    /**
+     * 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.
+     *
+     * @default false
+     */
     showTitle: boolean;
     /**
      * The current state of the component.
+     *
+     * @default "disabled"
      */
-    readonly state: "ready" | "disabled" | "loading" | "incompatible-next-basemap";
-    /** Permanently destroy the component */
+    readonly state: "ready" | "loading" | "disabled" | "incompatible-next-basemap";
+    /** Permanently destroy the component. */
     destroy(): Promise<void>;
     /** Toggles to the [next basemap](#nextBasemap). */
     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. */
+    readonly arcgisReady: TargetedEvent<this, void>;
+    private messages: Partial<{
+        componentLabel: string;
+        incompatibleSpatialReference: string;
+    }> & import('@arcgis/lumina/controllers').T9nMeta<{
+        componentLabel: string;
+        incompatibleSpatialReference: string;
     }>;
-    readonly arcgisReady: TargetedEvent<this, undefined>;
-    private messages;
-    private viewModel: BasemapToggleViewModel;
-    readonly _setterTypes: {
-        nextBasemap?: __esri.BasemapProperties | nullish | string;
-    };
 }
 export {};

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

@@ -1,18 +1,18 @@
-import { c as f } from "../../chunks/runtime.js";
+import { c as B } from "../../chunks/runtime.js";
 import { html as l } from "lit-html";
-import { usePropertyChange as B } from "@arcgis/lumina/controllers";
-import { classes as m } from "@arcgis/components-utils";
-import { getBasemapThumbnailUrl as S } from "@arcgis/core/applications/Components/basemapUtils.js";
-import x from "@arcgis/core/widgets/BasemapToggle/BasemapToggleViewModel.js";
-import { LitElement as T, createEvent as M, noShadowRoot as k, safeClassMap as a, nothing as r, safeStyleMap as b } from "@arcgis/lumina";
+import { usePropertyChange as f } 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 { m as C } from "../../chunks/useViewModel.js";
-import { g as u } from "../../chunks/globalCss.js";
+import { g as $ } from "../../chunks/globalCss.js";
 import { css as L } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.99 */
-const A = L`@layer{arcgis-basemap-toggle{display:block}}`, s = "esri-basemap-toggle", o = "esri-basemap-thumbnail", e = {
+v4.33.1 */
+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`,
@@ -20,14 +20,15 @@ const A = L`@layer{arcgis-basemap-toggle{display:block}}`, s = "esri-basemap-tog
   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(x);
+}, D = C(S);
 class E extends T {
   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 = 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 = f()("activeBasemap", "nextBasemap", "state"), this.arcgisReady = M();
   }
   static {
-    this.properties = { activeBasemap: 0, autoDestroyDisabled: 5, icon: 3, label: 1, messageOverrides: 0, nextBasemap: 1, position: 3, referenceElement: 1, showTitle: 5, state: 3 };
+    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;
@@ -35,32 +36,24 @@ class E extends T {
   static {
     this.styles = A;
   }
-  //#endregion
-  //#region Public Methods
-  /** Permanently destroy the component */
   async destroy() {
     await this.manager.destroy();
   }
-  /** Toggles to the [next basemap](#nextBasemap). */
   async toggle() {
     return await this.viewModel.toggle();
   }
-  //#endregion
-  //#region Private Methods
   _getThumbnailStyles(t) {
-    const n = S(t);
+    const n = x(t);
     return n ? { backgroundImage: `url(${n})` } : { backgroundImage: "" };
   }
-  //#endregion
-  //#region Rendering
   render() {
-    const t = this.viewModel, n = t.state === "disabled" ? null : t.activeBasemap, i = t.state === "disabled" ? null : t.nextBasemap, $ = t.state === "loading", d = t.state === "incompatible-next-basemap", c = i?.title ?? "", p = i && i.loadStatus !== "loaded";
+    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 && c, v = d, y = h || v, w = this._getThumbnailStyles(n), _ = this._getThumbnailStyles(i);
-    return y && (g = l`<div class=${a(e.overlay)}>${h ? l`<span class=${a(e.title)} title=${c ?? r}>${c}</span>` : null}${v ? l`<calcite-scrim class=${a(e.overlayScrim)} title=${this.messages.incompatibleSpatialReference ?? r}><calcite-icon icon=exclamation-mark-triangle></calcite-icon></calcite-scrim>` : null}</div>`), l`<div class=${a(m(e.base, u.widget))}><calcite-button appearance=transparent data-basemap-id=${(i ? i.id : "") ?? r} .disabled=${d} kind=neutral .label=${this.label ?? void 0} @click=${() => void this.toggle()} title=${this.label ?? void 0 ?? r}><div class=${a(m(e.container, e.secondaryBasemapImage))}><div class=${a(e.image)} style=${b(w)}></div></div><div class=${a(e.container)}><div class=${a(m(e.image, p ? e.imageLoading : null))} style=${b(_)}>${p || $ ? l`<calcite-scrim><span aria-hidden=true class=${a(u.loaderAnimation)} role=presentation></span></calcite-scrim>` : null}</div>${g}</div></calcite-button></div>`;
+    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>`;
   }
 }
-f("arcgis-basemap-toggle", E);
+B("arcgis-basemap-toggle", E);
 export {
   E as ArcgisBasemapToggle
 };

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

@@ -1,17 +1,17 @@
 /// <reference types="@arcgis/core/interfaces.d.ts" />
 /// <reference types="../../index.d.ts" />
 import { Use } from '@arcgis/lumina/controllers';
-import { Nil } from '@arcgis/components-utils';
 import { default as Bookmarks } from '@arcgis/core/widgets/Bookmarks.js';
 import { PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { ArcgisReferenceElement } from '../../utils/component-utils';
 
-declare const useBookmarksWidget: (component: LitElement & Pick<Bookmarks, never> & {
+declare const useBookmarksWidget: (component: LitElement & Pick<Bookmarks, "icon" | "label" | "viewModel" | "disabled" | "goToOverride" | "dragEnabled" | "filterPlaceholder" | "filterText" | "defaultCreateOptions" | "bookmarks" | "defaultEditOptions"> & {
     state?: unknown;
     viewModel?: __esri.BookmarksViewModel | undefined;
-    icon: Nil | string;
-    label: Nil | string;
-    referenceElement: ArcgisReferenceElement | Nil | string;
+    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<{
@@ -21,60 +21,147 @@ declare const useBookmarksWidget: (component: LitElement & Pick<Bookmarks, never
         childElem?: HTMLElement & {
             ownedBy?: HTMLElement;
         };
-        view?: __esri.MapView | __esri.SceneView | Nil;
+        view?: __esri.LinkChartView | __esri.MapView | __esri.SceneView;
     };
     autoDestroyDisabled: boolean;
     destroy: () => Promise<void>;
-}, options?: {
-    editConstructorProperties(props: __esri.BookmarksProperties | undefined): __esri.BookmarksProperties | Promise<__esri.BookmarksProperties | undefined> | undefined;
-} | undefined) => Bookmarks;
-/** 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).
+}) => Bookmarks;
+/**
+ * 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).
+ *
+ * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-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\` method when you are done to prevent
-     * memory leaks.
+     * 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;
+    /**
+     * A collection of [Bookmark](https://developers.arcgis.com/javascript/latest/api-reference/esri-webmap-Bookmark.html)s.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Bookmarks.html#bookmarks)
+     */
     bookmarks: __esri.Collection<__esri.Bookmark>;
+    /**
+     * 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`.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Bookmarks.html#defaultCreateOptions)
+     */
     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)
+     */
     defaultEditOptions: __esri.BookmarkOptions;
+    /**
+     * When true, the widget is visually withdrawn and cannot be interacted with.
+     *
+     * @default false
+     */
     disabled: boolean;
+    /**
+     * Indicates if a Bookmark is able to be dragged in order to update its position in the list.
+     *
+     * @default false
+     */
     dragEnabled: boolean;
+    /**
+     * Defines the text used as a placeholder when visibleElements.filter is set to `true`.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Bookmarks.html#filterPlaceholder)
+     */
     filterPlaceholder: string;
+    /**
+     * Defines the text used to filter the bookmarks when visibleElements.filter is set to `true`.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Bookmarks.html#filterText)
+     */
     filterText: string;
+    /**
+     * 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
+     */
     goToOverride: nullish | __esri.GoToOverride;
+    /** @default false */
     hideFlow: boolean;
+    /** @default false */
     hideThumbnail: boolean;
+    /** @default false */
     hideTime: boolean;
     /**
      * Icon which represents the component.
      * Typically used when the component is controlled by another component (e.g. by the Expand component).
-     * Search [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/) for possible values.
+     *
+     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
+     * @default "bookmark"
      */
     icon: string;
-    /** The component's default label. */
+    /**
+     * The widget's default label.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Bookmarks.html#label)
+     */
     label: string;
+    /** @default "bottom-left" */
     position: __esri.UIPosition;
-    referenceElement: ArcgisReferenceElement | Nil | string;
+    /**
+     * 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;
+    /** @default false */
     showAddBookmarkButton: boolean;
+    /** @default false */
     showCloseButton: boolean;
+    /** @default false */
     showCollapseButton: boolean;
+    /** @default false */
     showEditBookmarkButton: boolean;
+    /** @default false */
     showFilter: boolean;
+    /** @default false */
     showHeading: boolean;
+    /**
+     * The current state of the component.
+     *
+     * @default "ready"
+     */
     readonly state: "ready" | "loading";
-    /** Permanently destroy the component */
+    /** Permanently destroy the component. */
     destroy(): Promise<void>;
     readonly arcgisEdit: TargetedEvent<this, __esri.BookmarksBookmarkEditEvent>;
+    /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
     readonly arcgisPropertyChange: TargetedEvent<this, {
         name: "state";
     }>;
-    readonly arcgisReady: TargetedEvent<this, undefined>;
+    /** Emitted when the component associated with a map or scene view is is ready to be interacted with. */
+    readonly arcgisReady: TargetedEvent<this, void>;
     readonly arcgisSelect: TargetedEvent<this, __esri.BookmarksBookmarkSelectEvent>;
 }
 export {};

package/dist/components/arcgis-bookmarks/customElement.js

@@ -2,30 +2,27 @@ import { c as i } from "../../chunks/runtime.js";
 import { usePropertyChange as e } from "@arcgis/lumina/controllers";
 import { reEmitEvent as t } from "@arcgis/lumina/controllers/accessor";
 import s from "@arcgis/core/widgets/Bookmarks.js";
-import { LitElement as o, createEvent as a, noShadowRoot as l } from "@arcgis/lumina";
-import { m as r } from "../../chunks/useWidget.js";
-import { css as h } from "@lit/reactive-element/css-tag.js";
+import { LitElement as o, createEvent as l, noShadowRoot as a } from "@arcgis/lumina";
+import { m as h } from "../../chunks/useWidget.js";
+import { css as r } from "@lit/reactive-element/css-tag.js";
 import { c as d } from "../../chunks/createCloseEvent.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.99 */
-const n = h`@layer{arcgis-bookmarks{display:block}}`, m = r(s);
+v4.33.1 */
+const n = r`@layer{arcgis-bookmarks{display:block}}`, m = h(s);
 class g extends o {
   constructor() {
-    super(...arguments), this.widget = m(this), this.viewModel = this.widget.viewModel, this.arcgisClose = d(this), this.autoDestroyDisabled = !1, this.bookmarks = this.widget.bookmarks, this.defaultCreateOptions = this.widget.defaultCreateOptions, this.defaultEditOptions = this.widget.defaultEditOptions, this.disabled = this.widget.disabled, this.dragEnabled = this.widget.dragEnabled, this.filterPlaceholder = this.widget.filterPlaceholder, this.filterText = this.widget.filterText, this.goToOverride = this.widget.goToOverride, this.hideFlow = this.widget.visibleElements.flow, this.hideThumbnail = this.widget.visibleElements.thumbnail, this.hideTime = this.widget.visibleElements.time, this.icon = this.widget.icon, this.label = this.widget.label, this.position = "bottom-left", this.showAddBookmarkButton = this.widget.visibleElements.addBookmarkButton, this.showCloseButton = this.widget.visibleElements.closeButton, this.showCollapseButton = this.widget.visibleElements.collapseButton, this.showEditBookmarkButton = this.widget.visibleElements.editBookmarkButton, this.showFilter = this.widget.visibleElements.filter, this.showHeading = this.widget.visibleElements.heading, this.state = this.viewModel.state, this.arcgisEdit = t(() => this.widget, "bookmark-edit"), this.arcgisPropertyChange = e()("state"), this.arcgisReady = a(), this.arcgisSelect = t(() => this.widget, "bookmark-select");
+    super(...arguments), this.widget = m(this), this.viewModel = this.widget.viewModel, this.arcgisClose = d(this), this.autoDestroyDisabled = !1, this.bookmarks = this.widget.bookmarks, this.closed = !1, this.defaultCreateOptions = this.widget.defaultCreateOptions, this.defaultEditOptions = this.widget.defaultEditOptions, this.disabled = this.widget.disabled, this.dragEnabled = this.widget.dragEnabled, this.filterPlaceholder = this.widget.filterPlaceholder, this.filterText = this.widget.filterText, this.goToOverride = this.widget.goToOverride, this.hideFlow = this.widget.visibleElements.flow, this.hideThumbnail = this.widget.visibleElements.thumbnail, this.hideTime = this.widget.visibleElements.time, this.icon = this.widget.icon, this.label = this.widget.label, this.position = "bottom-left", this.showAddBookmarkButton = this.widget.visibleElements.addBookmarkButton, this.showCloseButton = this.widget.visibleElements.closeButton, this.showCollapseButton = this.widget.visibleElements.collapseButton, this.showEditBookmarkButton = this.widget.visibleElements.editBookmarkButton, this.showFilter = this.widget.visibleElements.filter, this.showHeading = this.widget.visibleElements.heading, this.state = this.viewModel.state, this.arcgisEdit = t(() => this.widget, "bookmark-edit"), this.arcgisPropertyChange = e()("state"), this.arcgisReady = l(), this.arcgisSelect = t(() => this.widget, "bookmark-select");
   }
   static {
-    this.properties = { autoDestroyDisabled: 5, bookmarks: 0, defaultCreateOptions: 0, defaultEditOptions: 0, disabled: 7, dragEnabled: 5, filterPlaceholder: 1, filterText: 1, goToOverride: 0, hideFlow: 5, hideThumbnail: 5, hideTime: 5, icon: 1, label: 1, position: 1, referenceElement: 1, showAddBookmarkButton: 5, showCloseButton: 5, showCollapseButton: 5, showEditBookmarkButton: 5, showFilter: 5, showHeading: 5, state: 3 };
+    this.properties = { autoDestroyDisabled: 5, bookmarks: 0, closed: 5, defaultCreateOptions: 0, defaultEditOptions: 0, disabled: 7, dragEnabled: 5, filterPlaceholder: 1, filterText: 1, goToOverride: 0, hideFlow: 5, hideThumbnail: 5, hideTime: 5, icon: 1, label: 1, position: 1, referenceElement: 1, showAddBookmarkButton: 5, showCloseButton: 5, showCollapseButton: 5, showEditBookmarkButton: 5, showFilter: 5, showHeading: 5, state: 3 };
   }
   static {
-    this.shadowRootOptions = l;
+    this.shadowRootOptions = a;
   }
   static {
     this.styles = n;
   }
-  //#endregion
-  //#region Public Methods
-  /** Permanently destroy the component */
   async destroy() {
     await this.manager.destroy();
   }

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

@@ -1,17 +1,17 @@
 /// <reference types="@arcgis/core/interfaces.d.ts" />
 /// <reference types="../../index.d.ts" />
 import { Use } from '@arcgis/lumina/controllers';
-import { Nil } from '@arcgis/components-utils';
 import { default as BuildingExplorer } from '@arcgis/core/widgets/BuildingExplorer.js';
 import { PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { ArcgisReferenceElement } from '../../utils/component-utils';
 
-declare const useBuildingExplorerWidget: (component: LitElement & Pick<BuildingExplorer, never> & {
+declare const useBuildingExplorerWidget: (component: LitElement & Pick<BuildingExplorer, "icon" | "label" | "viewModel" | "headingLevel" | "layers"> & {
     state?: unknown;
     viewModel?: __esri.BuildingExplorerViewModel | undefined;
-    icon: Nil | string;
-    label: Nil | string;
-    referenceElement: ArcgisReferenceElement | Nil | string;
+    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<{
@@ -21,47 +21,105 @@ declare const useBuildingExplorerWidget: (component: LitElement & Pick<BuildingE
         childElem?: HTMLElement & {
             ownedBy?: HTMLElement;
         };
-        view?: __esri.MapView | __esri.SceneView | Nil;
+        view
+        /** @copyDoc */
+        ?: __esri.LinkChartView | __esri.MapView | __esri.SceneView;
     };
     autoDestroyDisabled: boolean;
     destroy: () => Promise<void>;
-}, options?: {
-    editConstructorProperties(props: __esri.BuildingExplorerProperties | undefined): __esri.BuildingExplorerProperties | Promise<__esri.BuildingExplorerProperties | undefined> | undefined;
-} | undefined) => BuildingExplorer;
-/** BuildingExplorer component is used to filter and explore the various components 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 components grouped in sublayers. Using this component, buildings can be filtered by level, construction phase or by disciplines and categories.
+}) => BuildingExplorer;
+/**
+ * The Building Explorer component is used to filter and explore the various components 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 components grouped in sublayers. Using this component, buildings can be filtered by level, construction phase or by disciplines and categories.
+ *
+ * **Known limitations**
+ *
+ * Building Explorer is only supported in a 3D [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/) component.
+ *
+ * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-building-explorer/)
  */
 export declare class ArcgisBuildingExplorer extends LitElement {
     /**
      * 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\` method when you are done to prevent
-     * memory leaks.
+     * is set, make sure to call the [destroy](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-building-explorer/#destroy) method when you are done to
+     * prevent memory leaks.
+     *
+     * @default false
      */
     autoDestroyDisabled: boolean;
+    /**
+     * Indicates the heading level to use for the component title.
+     *
+     * @default 3
+     */
     headingLevel: number;
+    /** @default false */
     hideDisciplines: boolean | undefined;
+    /** @default false */
     hideLevels: boolean | undefined;
+    /** @default false */
     hidePhases: boolean | undefined;
     /**
-     * Icon which represents the component.
-     * Typically used when the component is controlled by another component (e.g. by the Expand component).
-     * Search [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/) for possible values.
+     * Icon which represents the component. Typically used when the component is controlled by another component (e.g. by the Expand component).
+     *
+     * See also: [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
+     *
+     * @default "organization"
      */
     icon: string;
     /** The component's default label. */
     label: string;
+    /**
+     * A [collection](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-Collection.html)
+     * of layers of type [BuildingSceneLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-BuildingSceneLayer.html)
+     * that are added to the componen for exploration.
+     *
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-BuildingExplorer.html#layers)
+     */
     layers: __esri.Collection<__esri.BuildingSceneLayer>;
+    /**
+     * Contains information about the level filter, such as
+     * the value selected by the user in the Level element
+     * or the minimum and maximum allowed values.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-BuildingExplorer-BuildingExplorerViewModel.html#level)
+     */
     readonly level: __esri.BuildingLevel;
+    /**
+     * Contains information about the construction phase filter, such as
+     * the value selected by the user in the Construction phases element
+     * and the minimum and maximum allowed values.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-BuildingExplorer-BuildingExplorerViewModel.html#phase)
+     */
     readonly phase: __esri.BuildingPhase;
+    /** @default "bottom-left" */
     position: __esri.UIPosition;
-    referenceElement: ArcgisReferenceElement | Nil | string;
-    readonly state: "ready" | "disabled" | "failed" | "loading";
-    /** Permanently destroy the component */
+    /**
+     * 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;
+    /**
+     * The component's state. The values mean the following:
+     *
+     * * `disabled` -  	component is being created
+     * * `loading` - layers and statistics are loading
+     * * `ready` - component is ready
+     * * `failed` - component failed to load data
+     *
+     * @default "disabled"
+     */
+    readonly state: "ready" | "loading" | "disabled" | "failed";
+    /** Permanently destroy the component. */
     destroy(): Promise<void>;
+    /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
     readonly arcgisPropertyChange: TargetedEvent<this, {
         name: "state" | "level" | "phase";
     }>;
-    readonly arcgisReady: TargetedEvent<this, undefined>;
+    /** Emitted when the component associated with a map or scene view is is ready to be interacted with. */
+    readonly arcgisReady: TargetedEvent<this, void>;
 }
 export {};

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

@@ -6,7 +6,7 @@ import { m as h } from "../../chunks/useWidget.js";
 import { css as r } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.99 */
+v4.33.1 */
 const a = r`@layer{arcgis-building-explorer{display:block}}`, d = h(s);
 class n extends t {
   constructor() {
@@ -21,9 +21,6 @@ class n extends t {
   static {
     this.styles = a;
   }
-  //#endregion
-  //#region Public Methods
-  /** Permanently destroy the component */
   async destroy() {
     await this.manager.destroy();
   }