@arcgis/map-components 5.2.0-next.11 → 5.2.0-next.111

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

@@ -1,10 +1,8 @@
 /// <reference path="../../index.d.ts" />
 import type Bookmark from "@arcgis/core/webmap/Bookmark.js";
 import type Collection from "@arcgis/core/core/Collection.js";
-import type SceneView from "@arcgis/core/views/SceneView.js";
-import type MapView from "@arcgis/core/views/MapView.js";
 import type { ReadonlyArrayOrCollection } from "@arcgis/core/core/Collection.js";
-import type { ArcgisReferenceElement, IconName, HeadingLevel, GoToOverride } from "../types.js";
+import type { ArcGISView, ArcgisReferenceElement, IconName, HeadingLevel, GoToOverride } from "../types.js";
 import type { BookmarkOptions, BookmarkEditEvent, BookmarkSelectEvent, BookmarksState } from "./types.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
@@ -39,6 +37,15 @@ export abstract class ArcgisBookmarks extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-bookmarks auto-destroy-disabled></arcgis-bookmarks>
+   * ```
+   *
+   * ```js
+   * bookmarksElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**
@@ -88,6 +95,15 @@ export abstract class ArcgisBookmarks extends LitElement {
    * Indicates whether a component is closed. When `true`, the component will be hidden.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-bookmarks closed></arcgis-bookmarks>
+   * ```
+   *
+   * ```js
+   * bookmarksElement.closed = true;
+   * ```
+   * 
    */
   accessor closed: boolean;
   /**
@@ -123,7 +139,7 @@ export abstract class ArcgisBookmarks extends LitElement {
   get defaultEditOptions(): BookmarkOptions;
   set defaultEditOptions(value: Partial<BookmarkOptions>);
   /**
-   * When true, the component is visually withdrawn and cannot receive user interaction.
+   * When true, the component is visually de-emphasized and does not accept user interaction.
    *
    * @default false
    */
@@ -367,10 +383,10 @@ export abstract class ArcgisBookmarks extends LitElement {
    */
   accessor timeDisabled: boolean;
   /**
-   * The view associated with the component. 
-   *   > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the arcgis-bookmarks component will be associated with a map or scene component rather than using the `view` property.
+   * The view associated with the component.
+   * > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the arcgis-bookmarks component will be associated with a map or scene component rather than using the `view` property.
    */
-  accessor view: MapView | SceneView | undefined;
+  accessor view: ArcGISView | undefined;
   /** Permanently destroy the component. */
   destroy(): Promise<void>;
   /**
@@ -426,7 +442,7 @@ export abstract class ArcgisBookmarks extends LitElement {
   readonly arcgisClose: import("@arcgis/lumina").TargetedEvent<this, void>;
   /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
   readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "state"; }>;
-  /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
+  /** Emitted when the component associated with a map or scene view is ready for user interaction. */
   readonly arcgisReady: import("@arcgis/lumina").TargetedEvent<this, void>;
   readonly "@eventTypes": {
     arcgisBookmarkEdit: ArcgisBookmarks["arcgisBookmarkEdit"]["detail"];

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

@@ -8,7 +8,6 @@ import T from "@arcgis/core/core/Collection.js";
 import v from "@arcgis/core/core/Error.js";
 import A from "@arcgis/core/webdoc/support/SlideThumbnail.js";
 import O from "@arcgis/core/Viewpoint.js";
-import "@arcgis/core/WebMap.js";
 import { LitElement as z, createEvent as B, nothing as x, safeClassMap as L } from "@arcgis/lumina";
 import { H as N } from "../../chunks/heading.js";
 import V from "@arcgis/core/core/Accessor.js";

package/dist/components/arcgis-building-discipline-tree/customElement.js

@@ -5,9 +5,9 @@ import { LitElement as S, nothing as V } from "@arcgis/lumina";
 import y from "@arcgis/core/core/Collection.js";
 import m from "@arcgis/core/core/Accessor.js";
 import { property as a, subclass as v } from "@arcgis/core/core/accessorSupport/decorators.js";
-import { c as O, f as $ } from "../../chunks/building-layer-utils.js";
+import { c as O, f as $ } from "../../chunks/layer-utils2.js";
 import { watch as b, on as E } from "@arcgis/core/core/reactiveUtils.js";
-import { i as A } from "../../chunks/async-utils.js";
+import { a as A } from "../../chunks/async-utils.js";
 var D = Object.defineProperty, M = Object.getOwnPropertyDescriptor, d = (e, t, i, l) => {
   for (var s = l > 1 ? void 0 : l ? M(t, i) : t, r = e.length - 1, o; r >= 0; r--)
     (o = e[r]) && (s = (l ? o(t, i, s) : o(s)) || s);

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

@@ -15,7 +15,7 @@ import type { T9nMeta } from "@arcgis/lumina/controllers";
  *
  * Often, [BuildingSceneLayers](https://developers.arcgis.com/javascript/latest/references/core/layers/BuildingSceneLayer/) contain an _Overview_ [BuildingComponentSublayer](https://developers.arcgis.com/javascript/latest/references/core/layers/buildingSublayers/BuildingComponentSublayer/) that serves as an exterior shell and views the building model as a single feature. When a layer is added to the Building Explorer component, the visibility of the _Overview_ layer is turned off, so that the user can directly interact with the individual features in the _Full Model_ [BuildingGroupSublayer](https://developers.arcgis.com/javascript/latest/references/core/layers/buildingSublayers/BuildingGroupSublayer/).
  *
- * The Level element of the Building Explorer component allows to select a single level in one or several buildings. When selecting a level, the levels above it are hidden and the levels below it become semi-transparent for added visual context.
+ * The Level element of the Building Explorer component allows users to select a single level in one or several buildings. When selecting a level, the levels above it are hidden and the levels below it become semi-transparent for added visual context.
  *
  * Some [BuildingSceneLayers](https://developers.arcgis.com/javascript/latest/references/core/layers/BuildingSceneLayer/) include information indicating the phase in which building elements, such as doors or pipes, were created and, optionally, when they were demolished. If a layer has multiple construction phases, these will be displayed in the Construction phases element. When selecting a construction phase, all the building elements created during or before the phase are selected. Demolished building elements aren't displayed.
  *
@@ -43,6 +43,15 @@ export abstract class ArcgisBuildingExplorer extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-building-explorer auto-destroy-disabled></arcgis-building-explorer>
+   * ```
+   *
+   * ```js
+   * buildingExplorerElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**
@@ -197,8 +206,8 @@ export abstract class ArcgisBuildingExplorer extends LitElement {
    */
   accessor referenceElement: ArcgisReferenceElement | string | undefined;
   /**
-   * The view associated with the component. 
-   *   > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the arcgis-building-explorer component will be associated with a map or scene component rather than using the `view` property.
+   * The view associated with the component.
+   * > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the arcgis-building-explorer component will be associated with a map or scene component rather than using the `view` property.
    */
   accessor view: SceneView | undefined;
   /** Permanently destroy the component. */
@@ -221,7 +230,7 @@ export abstract class ArcgisBuildingExplorer extends LitElement {
    * @since 5.0
    */
   readonly arcgisBuildingPhaseChange: import("@arcgis/lumina").TargetedEvent<this, void>;
-  /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
+  /** Emitted when the component associated with a map or scene view is ready for user interaction. */
   readonly arcgisReady: import("@arcgis/lumina").TargetedEvent<this, void>;
   readonly "@eventTypes": {
     arcgisBuildingLevelChange: ArcgisBuildingExplorer["arcgisBuildingLevelChange"]["detail"];

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

@@ -9,7 +9,7 @@ import { u as G } from "../../chunks/useT9n.js";
 import { watch as M } from "@arcgis/core/core/reactiveUtils.js";
 import z from "@arcgis/core/core/Accessor.js";
 import { property as o, subclass as E } from "@arcgis/core/core/accessorSupport/decorators.js";
-import { c as X, a as I } from "../../chunks/building-layer-utils.js";
+import { c as X, a as I } from "../../chunks/layer-utils2.js";
 import { signal as N } from "@arcgis/core/applications/Components/reactiveUtils.js";
 import { isAbortError as Z } from "@arcgis/core/core/promiseUtils.js";
 import q from "@arcgis/core/layers/support/BuildingFilter.js";

package/dist/components/arcgis-building-level-picker/customElement.js

@@ -4,7 +4,7 @@ import { repeat as b } from "lit/directives/repeat.js";
 import { css as L, html as o } from "lit";
 import { keyed as x } from "lit/directives/keyed.js";
 import { LitElement as P, createEvent as $, safeClassMap as a, nothing as h, safeStyleMap as m } from "@arcgis/lumina";
-import { l as w, a as H, b as y, c as M, d as C, e as k, f as z, g as W, h as E, i as v, j as d } from "../../chunks/constants.js";
+import { l as w, a as H, b as y, c as M, d as C, e as k, f as z, g as v, h as W, i as E, j as d } from "../../chunks/constants.js";
 import { clamp as c } from "@arcgis/toolkit/number";
 import { queryAll as O } from "lit/decorators.js";
 import { createRef as A, ref as B } from "lit/directives/ref.js";

package/dist/components/arcgis-building-phase-picker/customElement.js

@@ -24,19 +24,6 @@ class x extends d {
   #i;
   #e;
   #t;
-  #r() {
-    const e = this.renderRoot.querySelector("button.current");
-    e && (this.#e && (e.scrollIntoView({ block: "nearest", inline: "center" }), this.#e = !1), this.#t && (e.focus(), this.#t = !1));
-  }
-  #a() {
-    this.phase && (this.phase.next(), this.arcgisBuildingPhaseChange.emit());
-  }
-  #s() {
-    this.phase && (this.phase.previous(), this.arcgisBuildingPhaseChange.emit());
-  }
-  #c(e) {
-    this.phase != null && this.phase?.value !== e && (this.phase?.select(e), this.arcgisBuildingPhaseChange.emit());
-  }
   get numberOfPhases() {
     return this.phases.length;
   }
@@ -67,6 +54,19 @@ class x extends d {
       })
     ]);
   }
+  #r() {
+    const e = this.renderRoot.querySelector("button.current");
+    e && (this.#e && (e.scrollIntoView({ block: "nearest", inline: "center" }), this.#e = !1), this.#t && (e.focus(), this.#t = !1));
+  }
+  #a() {
+    this.phase && (this.phase.next(), this.arcgisBuildingPhaseChange.emit());
+  }
+  #s() {
+    this.phase && (this.phase.previous(), this.arcgisBuildingPhaseChange.emit());
+  }
+  #c(e) {
+    this.phase != null && this.phase?.value !== e && (this.phase?.select(e), this.arcgisBuildingPhaseChange.emit());
+  }
   render() {
     const e = this.phase, r = this.messages;
     return !r || e == null ? null : a`<div class="phase-picker">${c({ className: "arrow-left", disabled: !1, icon: this.#i === "rtl" ? "chevron-right" : "chevron-left", onClick: () => this.#s(), text: r.previousPhase })}<div class="phases-container">${this.phases.map((i, n) => a`${n > 0 && a`<span class=${s({

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

@@ -20,6 +20,9 @@ import type { CatalogLayerListState } from "@arcgis/core/widgets/CatalogLayerLis
  * The [ListItem](https://developers.arcgis.com/javascript/latest/references/core/widgets/LayerList/ListItem/) API provides access to each layer's properties, allows
  * the developer to configure actions related to the layer, and allows the developer to add content to the item related to the layer.
  *
+ * > [!WARNING]
+ * > In version 6.0, the implementation of [arcgis-catalog-layer-list](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-catalog-layer-list/) will be updated under the hood to that of [arcgis-catalog-layer-list-next](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-catalog-layer-list-next/). We encourage using the [arcgis-catalog-layer-list-next](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-catalog-layer-list-next/) component and providing feedback.
+ *
  * @since 4.31
  * @example
  * ```js
@@ -71,6 +74,15 @@ export abstract class ArcgisCatalogLayerList extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-catalog-layer-list auto-destroy-disabled></arcgis-catalog-layer-list>
+   * ```
+   *
+   * ```js
+   * catalogLayerListElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /** A collection of ListItems representing the CatalogLayer's [dynamicGroupLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/CatalogLayer/#dynamicGroupLayer). */
@@ -89,6 +101,15 @@ export abstract class ArcgisCatalogLayerList extends LitElement {
    *
    * @default false
    * @since 4.33
+   * @example
+   * ```html
+   * <arcgis-catalog-layer-list closed></arcgis-catalog-layer-list>
+   * ```
+   *
+   * ```js
+   * catalogLayerListElement.closed = true;
+   * ```
+   * 
    */
   accessor closed: boolean;
   /**
@@ -252,7 +273,7 @@ export abstract class ArcgisCatalogLayerList extends LitElement {
    * catalogLayerListElement.selectionMode = "multiple";
    * ```
    */
-  accessor selectionMode: "multiple" | "single" | "none" | "single-persist";
+  accessor selectionMode: "none" | "single-persist" | "multiple" | "single";
   /**
    * Indicates whether to display a close button in the header.
    *
@@ -275,7 +296,7 @@ export abstract class ArcgisCatalogLayerList extends LitElement {
    */
   accessor showErrors: boolean;
   /**
-   * Indicates whether to display a filter input box when then number of list items is equal to or greater than the value set in [CatalogLayerList#minFilterItems](https://developers.arcgis.com/javascript/latest/references/core/widgets/CatalogLayerList/#minFilterItems), allowing users to filter layers by their title.
+   * Indicates whether to display a filter input box when the number of list items is equal to or greater than the value set in [CatalogLayerList#minFilterItems](https://developers.arcgis.com/javascript/latest/references/core/widgets/CatalogLayerList/#minFilterItems), allowing users to filter layers by their title.
    *
    * @default false
    * @since 5.0
@@ -302,8 +323,8 @@ export abstract class ArcgisCatalogLayerList extends LitElement {
    */
   get state(): CatalogLayerListState;
   /**
-   * The view associated with the component. 
-   *   > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the arcgis-catalog-layer-list component will be associated with a map or scene component rather than using the `view` property.
+   * The view associated with the component.
+   * > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the arcgis-catalog-layer-list component will be associated with a map or scene component rather than using the `view` property.
    */
   accessor view: MapViewOrSceneView | null | undefined;
   /**
@@ -334,7 +355,7 @@ export abstract class ArcgisCatalogLayerList extends LitElement {
   readonly arcgisClose: import("@arcgis/lumina").TargetedEvent<this, void>;
   /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
   readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "state"; }>;
-  /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
+  /** Emitted when the component associated with a map or scene view is ready for user interaction. */
   readonly arcgisReady: import("@arcgis/lumina").TargetedEvent<this, void>;
   /** Emitted when an action is triggered on the component. */
   readonly arcgisTriggerAction: import("@arcgis/lumina").TargetedEvent<this, LayerListViewModelTriggerActionEvent>;