@arcgis/map-components 5.1.0-next.6 → 5.1.0-next.61

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

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

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

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

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

@@ -23,7 +23,7 @@ function O(t) {
   const e = typeof t == "string" ? t : t.id;
   return !!e && e.includes(D);
 }
-function A(t, e) {
+function S(t, e) {
   for (const i of t)
     for (const s of i.filters) {
       if (!O(s))
@@ -54,7 +54,7 @@ function te(t, e) {
   return !0;
 }
 function ie(t) {
-  const e = S(t);
+  const e = A(t);
   return e ? {
     filterExpression: e,
     // @ts-expect-error TODO: support autocasting in BuildingFilterBlock?
@@ -62,14 +62,14 @@ function ie(t) {
   } : null;
 }
 function re(t) {
-  const e = S(t);
+  const e = A(t);
   return e ? {
     filterExpression: e,
     // @ts-expect-error TODO: support autocasting in BuildingFilterBlock?
     filterMode: { type: "solid" }
   } : null;
 }
-function S(t) {
+function A(t) {
   return t.filter((e) => !!e).map((e) => `(${e})`).join(" AND ");
 }
 function V(t) {
@@ -124,7 +124,7 @@ let n = class extends z {
   }
   /**
    * Whether the filter is disabled. If true, the filter's expression won't be
-   * used to filter a [BuildingSceneLayer](https://next.gha.afd.arcgis.com/javascript/latest/api-reference/esri-layers-BuildingSceneLayer.html).
+   * used to filter a [BuildingSceneLayer](https://next.gha.afd.arcgis.com/javascript/latest/references/core/layers/BuildingSceneLayer/).
    *
    * @default true
    */
@@ -357,7 +357,7 @@ let f = class extends n {
     this._domainInfo = V(t);
     const e = this._valueBeforeReady;
     this._valueBeforeReady = void 0;
-    const i = e ?? A(this.layers, he(this, k));
+    const i = e ?? S(this.layers, he(this, k));
     i != null ? this.select(i) : (this.disabled = !0, this.value = this._firstValue);
   }
 };
@@ -420,7 +420,7 @@ let g = class extends n {
     this._domainInfo = V(t);
     const e = this._valueBeforeReady;
     if (this._valueBeforeReady = void 0, this.allowedValues.length > 0) {
-      const i = e ?? A(this.layers, this._parseValueFromFilter);
+      const i = e ?? S(this.layers, this._parseValueFromFilter);
       this.select(i ?? this._lastValue);
     } else
       this.clear();
@@ -549,22 +549,27 @@ class we extends J {
     e == null ? this.#t.allowedValues = null : this.#t.allowedValues = e;
   }
   get levelDisabled() {
-    return this.#e?.disabled;
+    return this.#e.disabled;
   }
   get phaseDisabled() {
-    return this.#t?.disabled;
+    return this.#t.disabled;
   }
   async destroy() {
     await this.manager.destroy();
   }
   loaded() {
     this.#e.changeEmitter = () => this.arcgisBuildingLevelChange.emit(), this.#t.changeEmitter = () => this.arcgisBuildingPhaseChange.emit(), this.manager.onLifecycle(() => [
-      M(() => ({ layers: this.#i.toArray(), filter: this.#r.filter }), ({ layers: e, filter: i }) => {
-        ee(e, i);
+      M(() => ({
+        layers: this.#i.toArray(),
+        filter: this.#r.filter,
+        levelState: this.#e.state,
+        phaseState: this.#t.state
+      }), ({ layers: e, filter: i, levelState: s, phaseState: r }) => {
+        s !== "ready" || r !== "ready" || ee(e, i);
       }, { initial: !0 }),
       M(() => this.layers, (e) => {
         this.#r.layers = new p(e);
-      })
+      }, { initial: !0 })
     ]);
   }
   render() {

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

@@ -82,7 +82,7 @@ class x extends d {
   }
 }
 function c(t) {
-  return o(t.className, a`<calcite-action appearance=transparent class=${s(t.className)} .disabled=${t.disabled} .icon=${t.icon} icon-flip-rtl @click=${t.onClick} scale=s .text=${t.text} title=${t.text ?? p}></calcite-action>`);
+  return o(t.className, a`<calcite-action class=${s(t.className)} .disabled=${t.disabled} .icon=${t.icon} icon-flip-rtl @click=${t.onClick} scale=s .text=${t.text} title=${t.text ?? p}></calcite-action>`);
 }
 l("arcgis-building-phase-picker", x);
 export {