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

package/dist/components/arcgis-print-template-select/customElement.js

@@ -1,37 +1,40 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import { c as s } from "../../chunks/runtime.js";
-import { css as i, html as l } from "lit";
-import { watch as a } from "@arcgis/core/core/reactiveUtils.js";
-import { LitElement as c } from "@arcgis/lumina";
-import { u as o } from "../../chunks/useHandles.js";
-import { g as r, a as n, b as m } from "../../chunks/utils3.js";
-import { useDirection as p } from "@arcgis/lumina/controllers";
-const d = i`.template-select-container{border:1px solid var(--calcite-color-border-1);cursor:pointer}.template-select-container .template-select-error,.template-select-container .template-select-arrow{display:flex;align-self:center;margin-right:var(--calcite-spacing-md)}`;
-class h extends c {
+import { c } from "../../chunks/runtime.js";
+import { css as o, html as a } from "lit";
+import { watch as s } from "@arcgis/core/core/reactiveUtils.js";
+import { LitElement as r } from "@arcgis/lumina";
+import { g as n, a as m, b as p } from "../../chunks/utils5.js";
+import { useDirection as d } from "@arcgis/lumina/controllers";
+const h = o`.template-select-container{border:1px solid var(--calcite-color-border-1);cursor:pointer}.template-select-container .template-select-error,.template-select-container .template-select-arrow{display:flex;align-self:center;margin-right:var(--calcite-spacing-md)}`;
+class g extends r {
   constructor() {
-    super(...arguments), this._handles = o("disconnect"), this._direction = p(), this._templateState = "not-loaded";
+    super(...arguments), this._direction = d(), this._templateState = "not-loaded";
   }
   static {
     this.properties = { _selectedTemplate: 16, _templateState: 16, viewModel: 0, messages: 0, showTemplateSelector: 0 };
   }
   static {
-    this.styles = d;
+    this.styles = h;
   }
   loaded() {
-    this.manager.onLifecycle(() => [
-      a(() => this.viewModel.templateOptions.id, (e) => {
-        this._handles.removeHandles("template-handle"), this._selectedTemplate = e ? this.viewModel.getLayoutTemplateById(e) ?? void 0 : void 0, this._handles.addHandles(a(() => this._selectedTemplate?.state, (t) => this._templateState = t ?? "not-loaded", { initial: !0 }), "template-handle");
-      }, { initial: !0 })
-    ]);
+    this.manager.onLifecycle(() => {
+      let e;
+      const t = s(() => this.viewModel.templateOptions.id, (l) => {
+        e?.remove(), this._selectedTemplate = l ? this.viewModel.getLayoutTemplateById(l) ?? void 0 : void 0, e = s(() => this._selectedTemplate?.state, (i) => this._templateState = i ?? "not-loaded", { initial: !0 });
+      }, { initial: !0 });
+      return () => {
+        t.remove(), e?.remove();
+      };
+    });
   }
   render() {
-    const e = this._selectedTemplate ? r(this._selectedTemplate, this.messages) : this.messages.selectTemplate;
-    return l`<calcite-block class="template-select-container" .description=${n(this._selectedTemplate)} .heading=${e} .label=${e} .loading=${this._templateState === "loading"} @click=${this.showTemplateSelector} @keydown=${(t) => {
+    const e = this._selectedTemplate ? n(this._selectedTemplate, this.messages) : this.messages.selectTemplate;
+    return a`<calcite-block class="template-select-container" .description=${m(this._selectedTemplate)} .heading=${e} .label=${e} .loading=${this._templateState === "loading"} @click=${this.showTemplateSelector} @keydown=${(t) => {
       (t.key === "Enter" || t.key === " ") && this.showTemplateSelector();
-    }} tabindex=0><calcite-icon .icon=${(this._selectedTemplate?.layout ? m(this._selectedTemplate.layout) : null) || "custom-print"} scale=l slot=content-start></calcite-icon>${this._templateState === "error" ? l`<calcite-icon class="template-select-error" icon=exclamation-mark-circle scale=s slot=actions-end></calcite-icon>` : null}<calcite-icon class="template-select-arrow" .icon=${this._direction === "rtl" ? "chevron-left" : "chevron-right"} scale=s slot=actions-end></calcite-icon></calcite-block>`;
+    }} tabindex=0><calcite-icon .icon=${(this._selectedTemplate?.layout ? p(this._selectedTemplate.layout) : null) || "custom-print"} scale=l slot=content-start></calcite-icon>${this._templateState === "error" ? a`<calcite-icon class="template-select-error" icon=exclamation-mark-circle scale=s slot=actions-end></calcite-icon>` : null}<calcite-icon class="template-select-arrow" .icon=${this._direction === "rtl" ? "chevron-left" : "chevron-right"} scale=s slot=actions-end></calcite-icon></calcite-block>`;
   }
 }
-s("arcgis-print-template-select", h);
+c("arcgis-print-template-select", g);
 export {
-  h as PrintTemplateSelect
+  g as PrintTemplateSelect
 };

package/dist/components/arcgis-print-template-selector/customElement.js

@@ -3,25 +3,25 @@ import { c as m } from "../../chunks/runtime.js";
 import { css as p, html as l } from "lit";
 import { watch as c } from "@arcgis/core/core/reactiveUtils.js";
 import { LitElement as u, nothing as h } from "@arcgis/lumina";
-import { i as o, r as g, a as v, g as f, b as T } from "../../chunks/utils3.js";
-import { u as w } from "../../chunks/useHandles.js";
-const $ = p`:host{overflow-y:hidden;display:flex;flex:1 0}.template-select-flow-item-container{display:flex;flex-direction:column;justify-content:space-between;overflow-y:hidden;flex-grow:1}.template-select-flow-item-container .template-select-flow-item-content{display:flex;flex-direction:column;overflow-y:auto;flex:1 0}.template-select-flow-item-container .template-select-flow-item-content .template-select-flow-item-list-heading{display:flex;gap:var(--calcite-spacing-xs);align-items:center;padding:var(--calcite-spacing-md) var(--calcite-spacing-lg);background-color:var(--calcite-color-foreground-2);border-bottom:1px solid var(--calcite-color-border-3);font-weight:var(--calcite-font-weight-semibold)}.template-button-container{padding:var(--calcite-spacing-md)}.template-done-button{width:100%}`;
-class y extends u {
-  constructor() {
-    super(...arguments), this._handles = w("disconnect");
-  }
+import { i as o, r as g, a as v, g as f, b as T } from "../../chunks/utils5.js";
+const w = p`:host{overflow-y:hidden;display:flex;flex:1 0}.template-select-flow-item-container{display:flex;flex-direction:column;justify-content:space-between;overflow-y:hidden;flex-grow:1}.template-select-flow-item-container .template-select-flow-item-content{display:flex;flex-direction:column;overflow-y:auto;flex:1 0}.template-select-flow-item-container .template-select-flow-item-content .template-select-flow-item-list-heading{display:flex;gap:var(--calcite-spacing-xs);align-items:center;justify-content:space-between;padding:var(--calcite-spacing-md) var(--calcite-spacing-lg);background-color:var(--calcite-color-foreground-2);border-bottom:1px solid var(--calcite-color-border-3);font-weight:var(--calcite-font-weight-semibold)}.template-button-container{padding:var(--calcite-spacing-md)}.template-done-button{width:100%}`;
+class $ extends u {
   static {
     this.properties = { _selectedTemplate: 16, excludeOrganizationTemplates: 5, viewModel: 0, messages: 0, hideTemplateSelector: 0 };
   }
   static {
-    this.styles = $;
+    this.styles = w;
   }
   loaded() {
-    this.manager.onLifecycle(() => [
-      c(() => this.viewModel.templateOptions.id, (e) => {
-        this._handles.removeHandles("template-handle"), this._selectedTemplate = e ? this.viewModel.getLayoutTemplateById(e) ?? void 0 : void 0, this._handles.addHandles(c(() => this._selectedTemplate?.state, () => this.requestUpdate(), { initial: !0 }), "template-handle");
-      }, { initial: !0 })
-    ]);
+    this.manager.onLifecycle(() => {
+      let e;
+      const i = c(() => this.viewModel.templateOptions.id, (t) => {
+        e?.remove(), this._selectedTemplate = t ? this.viewModel.getLayoutTemplateById(t) ?? void 0 : void 0, e = c(() => this._selectedTemplate?.state, () => this.requestUpdate(), { initial: !0 });
+      }, { initial: !0 });
+      return () => {
+        i.remove(), e?.remove();
+      };
+    });
   }
   _getPortalTemplates() {
     return this.viewModel.includeDefaultTemplates && !this.excludeOrganizationTemplates ? this.viewModel.defaultTemplates.toArray().filter(({ layout: e, layoutItem: i }) => !o(e) && !!i?.id) : [];
@@ -40,7 +40,7 @@ class y extends u {
     return e.map((t) => l`<calcite-list-item .description=${v(t)} .label=${f(t, this.messages)} .selected=${t.id === this.viewModel.templateOptions.id} title=${t.description ?? "" ?? h} .value=${t}><calcite-icon .icon=${(t.layout ? T(t.layout) : null) || "custom-print"} slot=content-start></calcite-icon>${t.state === "loading" ? l`<calcite-loader inline label=loading scale=s slot=content-end></calcite-loader>` : null}${t?.state === "error" ? l`<calcite-icon class="template-select-error" icon=exclamation-mark-circle scale=s slot=content-end></calcite-icon>` : null}${i ? l`<calcite-action icon=trash @click=${() => this.viewModel.removePortalTemplate(t)} slot=actions-end text=delete></calcite-action>` : null}</calcite-list-item>`);
   }
 }
-m("arcgis-print-template-selector", y);
+m("arcgis-print-template-selector", $);
 export {
-  y as PrintTemplateSelector
+  $ as PrintTemplateSelector
 };

package/dist/components/arcgis-reverse-geocode-list/customElement.js

@@ -72,7 +72,7 @@ class w extends v {
   }
   _renderMoreResults(e) {
     const { messages: t } = this;
-    return !this._abortController && e?.length ? r`<calcite-block collapsible scale=s .headingLevel=${this.headingLevel} .heading=${$(t?.showMoreResults ?? "", { count: e.length })}><calcite-list scale=s display-mode=flat interaction-mode=static selection-mode=none .label=${t?.moreResults ?? ""}>${e?.map((s) => this._renderItem(s))}</calcite-list></calcite-block>` : null;
+    return !this._abortController && e?.length ? r`<calcite-block expandable scale=s .headingLevel=${this.headingLevel} .heading=${$(t?.showMoreResults ?? "", { count: e.length })}><calcite-list scale=s display-mode=flat interaction-mode=static selection-mode=none .label=${t?.moreResults ?? ""}>${e?.map((s) => this._renderItem(s))}</calcite-list></calcite-block>` : null;
   }
   _renderCopyAction({ text: e, value: t }) {
     return r`<calcite-action .text=${e} title=${e ?? C} slot=actions-end icon=copy @click=${() => this._copyTextToClipboard(t)}></calcite-action>`;

package/dist/components/arcgis-scale-bar/customElement.d.ts

@@ -29,6 +29,15 @@ export abstract class ArcgisScaleBar extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-scale-bar auto-destroy-disabled></arcgis-scale-bar>
+   * ```
+   *
+   * ```js
+   * scaleBarElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**
@@ -70,13 +79,13 @@ export abstract class ArcgisScaleBar extends LitElement {
    */
   accessor unit: ScaleBarUnit | 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-scale-bar 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-scale-bar component will be associated with a map or scene component rather than using the `view` property.
    */
   accessor view: MapView | null | undefined;
   /** Permanently destroy the component. */
   destroy(): Promise<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": {
     arcgisReady: ArcgisScaleBar["arcgisReady"]["detail"];

package/dist/components/arcgis-scale-range-slider/customElement.d.ts

@@ -27,10 +27,19 @@ export abstract class ArcgisScaleRangeSlider extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-scale-range-slider auto-destroy-disabled></arcgis-scale-range-slider>
+   * ```
+   *
+   * ```js
+   * scaleRangeSliderElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**
-   * 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
    */
@@ -129,8 +138,8 @@ export abstract class ArcgisScaleRangeSlider extends LitElement {
    */
   get state(): ScaleRangeSliderViewModelState;
   /**
-   * 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-scale-range-slider 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-scale-range-slider component will be associated with a map or scene component rather than using the `view` property.
    */
   accessor view: MapViewOrSceneView | null | undefined;
   /** Permanently destroy the component. */
@@ -140,7 +149,7 @@ export abstract class ArcgisScaleRangeSlider extends LitElement {
   };
   /** 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" | "minScale" | "maxScale"; }>;
-  /** 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": {
     arcgisPropertyChange: ArcgisScaleRangeSlider["arcgisPropertyChange"]["detail"];

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

@@ -36,12 +36,31 @@ import type { AnalysisView3DFor } from "@arcgis/core/views/3d/analysis/types.js"
 import type { LayerView3DFor } from "@arcgis/core/views/3d/types.js";
 import type { DoubleTapDragEvent, VerticalTwoFingerDragEvent, PointerUpEvent, PointerMoveEvent, PointerLeaveEvent, PointerEnterEvent, PointerDownEvent, ViewMouseWheelEvent, LayerViewDestroyEvent, LayerViewCreateErrorEvent, LayerViewCreateEvent, KeyUpEvent, KeyDownEvent, ImmediateDoubleClickEvent, ImmediateClickEvent, HoldEvent, DragEvent, DoubleClickEvent, ClickEvent } from "@arcgis/core/views/input/types.js";
 import type { AnalysisViewDestroyEvent, AnalysisViewCreateErrorEvent, AnalysisViewCreateEvent, HitTestOptions3D, Screenshot, UserSettings, SceneViewHitTestResult, GoToOptions3D, GoToTarget3D } from "@arcgis/core/views/types.js";
-import type { ScreenPoint, ScreenRect } from "@arcgis/core/core/types.js";
+import type { ScreenPoint, ScreenRect, ScreenPolygon } from "@arcgis/core/core/types.js";
 import type { FetchPopupFeaturesOptions, ViewPopupOpenOptions } from "@arcgis/core/views/PopupView.js";
 import type { ReadonlyCollection } from "@arcgis/core/core/Collection.js";
 import type { ViewPadding } from "@arcgis/core/views/ui/types.js";
 import type { SlotGroupRefs } from "../../support/slots.js";
 
+declare module "@arcgis/lumina" {
+export interface DeclareCssProperties {
+  /** _Since 4.34_ Specifies the top padding for the layout. */
+  "--arcgis-layout-overlay-space-top": "*";
+  /** _Since 4.34_ Specifies the bottom padding for the layout. */
+  "--arcgis-layout-overlay-space-bottom": "*";
+  /** _Since 4.34_ Specifies the left padding for the layout. */
+  "--arcgis-layout-overlay-space-left": "*";
+  /** _Since 4.34_ Specifies the right padding for the layout. */
+  "--arcgis-layout-overlay-space-right": "*";
+  /** _Since 5.0_ Specifies the focus outline color for the view. */
+  "--arcgis-view-color-focus": "*";
+  /** _Since 5.1_ Specifies the background color for table rows. */
+  "--arcgis-table-row-background-color": "*";
+  /** _Since 5.1_ Specifies the background color for alternate table rows. */
+  "--arcgis-table-row-alt-background-color": "*";
+}
+}
+
 /**
  * The ArcGIS Scene component is used to add 3D maps to web applications. For 2D maps, use the
  * [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/).
@@ -91,13 +110,6 @@ import type { SlotGroupRefs } from "../../support/slots.js";
  * - [Get started](https://developers.arcgis.com/javascript/latest/get-started/)
  * - [Programming patterns](https://developers.arcgis.com/javascript/latest/programming-patterns/)
  *
- * @cssproperty [--arcgis-layout-overlay-space-top] - _Since 4.34_ Specifies the top padding for the layout.
- * @cssproperty [--arcgis-layout-overlay-space-bottom] - _Since 4.34_ Specifies the bottom padding for the layout.
- * @cssproperty [--arcgis-layout-overlay-space-left] - _Since 4.34_ Specifies the left padding for the layout.
- * @cssproperty [--arcgis-layout-overlay-space-right] - _Since 4.34_ Specifies the right padding for the layout.
- * @cssproperty [--arcgis-view-color-focus] - _Since 5.0_ Specifies the focus outline color for the view.
- * @cssproperty [--arcgis-table-row-background-color] - _Since 5.1_ Specifies the background color for table rows.
- * @cssproperty [--arcgis-table-row-alt-background-color] - _Since 5.1_ Specifies the background color for alternate table rows.
  * @slot  - Default slot for adding components to the scene. User is responsible for positioning the content via CSS.
  * @slot [top-left] - Slot for components positioned in the top-left corner.
  * @slot [top-right] - Slot for components positioned in the top-right corner.
@@ -182,13 +194,15 @@ export abstract class ArcgisScene extends LitElement {
    */
   get attributionItems(): SceneView["attributionItems"];
   /**
-   * The light or dark mode used to display the attribution.
-   * By default, the mode is inherited from the [Calcite's mode](https://developers.arcgis.com/calcite-design-system/core-concepts/#modes).
-   * You can override the value to style the attribution alongside the map or scene content.
+   * The display mode used for the attribution. Defaults to null.
+   *
+   * Set this property to "auto" to automatically synchronize the attribution with the nearest [Calcite mode](https://developers.arcgis.com/calcite-design-system/core-concepts/#modes). If no Calcite mode is detected, the attribution defaults to light mode. **The "auto" mode was added in version 5.2.**
+   *
+   * Set this property to "light" or "dark" to explicitly use that mode without synchronization.
    *
    * @since 5.0
    */
-  accessor attributionMode: "dark" | "light" | null | undefined;
+  accessor attributionMode: AttributionMode;
   /**
    * 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
@@ -197,6 +211,15 @@ export abstract class ArcgisScene extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-scene auto-destroy-disabled></arcgis-scene>
+   * ```
+   *
+   * ```js
+   * sceneElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**
@@ -311,7 +334,7 @@ export abstract class ArcgisScene extends LitElement {
   accessor constraints: Constraints;
   /**
    * Indicates whether a layer's `displayFilter` is honored when rendering layers in the view.
-   * If `false`, the display filters are ignored and all features are rendered.
+   * If `true`, the display filters are ignored and all features are rendered.
    *
    * @default false
    */
@@ -529,7 +552,7 @@ export abstract class ArcgisScene extends LitElement {
    * @example
    * // Override the default highlights collection
    *
-   * const view = new MapView({
+   * const view = new SceneView({
    *   map: map,
    *   container: "viewDiv",
    *
@@ -555,7 +578,7 @@ export abstract class ArcgisScene extends LitElement {
    */
   accessor highlights: Collection<HighlightOptions>;
   /**
-   * Indication whether the view is being interacted with (for example when panning or by an interactive tool).
+   * Indicates whether the view is being interacted with (for example when panning or by an interactive tool).
    *
    * @default false
    */
@@ -590,7 +613,7 @@ export abstract class ArcgisScene extends LitElement {
   /** An instance of a [Map](https://developers.arcgis.com/javascript/latest/references/core/Map/) object to display in the view. */
   accessor map: Map | null | undefined;
   /**
-   * Indication whether the view is being navigated (for example when panning).
+   * Indicates whether the view is being navigated (for example when panning).
    *
    * @default false
    */
@@ -603,7 +626,7 @@ export abstract class ArcgisScene extends LitElement {
    * @since 4.9
    * @example
    * // Disable the gamepad usage, single touch panning, panning momentum and mouse wheel zooming.
-   * const view = new MapView({
+   * const view = new SceneView({
    *   container: "viewDiv",
    *   map: new Map({
    *     basemap: "satellite"
@@ -644,6 +667,7 @@ export abstract class ArcgisScene extends LitElement {
    *
    * By default, the `popup` property is an empty object that allows you to set the popup options. A [Popup](https://developers.arcgis.com/javascript/latest/references/core/widgets/Popup/) instance is automatically created and assigned to the view's [popup](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#popup) when the user clicks on the view and [popupEnabled](https://developers.arcgis.com/javascript/latest/references/core/views/PopupView/#popupEnabled) is `true`, when the [openPopup()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#openPopup) method is called, or when some widgets need the popup, such as [Search](https://developers.arcgis.com/javascript/latest/references/core/widgets/Search/). If [popup](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#popup) is `null`, the popup instance will not be created.
    *
+   * @deprecated since 5.2, use [popupElement](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#popupElement) instead. Set the [popupComponentEnabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#popupComponentEnabled) property to `true` to enable the popup component.
    * @see [popupElement](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#popupElement)
    * @see [popupDisabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#popupDisabled)
    * @see [openPopup()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#openPopup)
@@ -778,7 +802,7 @@ export abstract class ArcgisScene extends LitElement {
    */
   accessor spatialReference: SpatialReference;
   /**
-   * Indication whether the view is animating, being navigated with or resizing.
+   * Indicates whether the view is animating, being navigated with or resizing.
    *
    * @default false
    */
@@ -824,7 +848,7 @@ export abstract class ArcgisScene extends LitElement {
    * });
    *
    * // Create a mapview showing sales for the last week of March 2019 only.
-   * const view = new MapView({
+   * const view = new SceneView({
    *   map: map,
    *   container: "viewDiv",
    *   timeExtent: {
@@ -834,6 +858,39 @@ export abstract class ArcgisScene extends LitElement {
    * });
    */
   accessor timeExtent: TimeExtent | null | undefined;
+  /**
+   * Defines the time zone of the view.
+   * The time zone property determines how dates and times are represented to the user,
+   * but the underlying data is unchanged.
+   *
+   * > [!IMPORTANT]
+   * >
+   * > This property does not apply to the [arcgis-daylight](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-daylight/) or
+   * > [arcgis-shadow-cast](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-shadow-cast/) components. They use their own `utcOffset` properties. Support for using the
+   * > scene's time zone in these components is planned for a future release.
+   *
+   * The time zone can be set to one of the following values:
+   *
+   * **Possible Values**
+   *
+   * | Value | Description |
+   * | ----- | ----------- |
+   * | system | Dates and times will be displayed in the time zone of the device or browser. |
+   * | unknown | Dates and times will be displayed based on the time zone that has been defined for the layer. No adjustments are made to the display of date info. The [arcgis-time-bar](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-time-bar/) component is disabled. |
+   * | Specified IANA time zone | Dates and times will be displayed in the specified IANA time zone. See [wikipedia - List of tz database time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). |
+   *
+   * @default "system"
+   * @since 5.2
+   * @see [SceneView.timeZone](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/#timeZone)
+   * @see [wikipedia - List of tz database time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)
+   * @example
+   * ```js
+   * // Date and time will be displayed in Pacific/Auckland (NZ) time zone
+   * const viewElement = document.querySelector("arcgis-scene");
+   * viewElement.timeZone = "Pacific/Auckland";
+   * ```
+   */
+  accessor timeZone: string;
   /**
    * Indicates whether the view is being updated by additional data requests to the network,
    * or by processing received data.
@@ -896,6 +953,8 @@ export abstract class ArcgisScene extends LitElement {
   destroy(): Promise<void>;
   /**
    * Use this method to query for features at a given screen location. These features come from origins (layers and sublayers) configured with a [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/) and have its [FeatureLayer.popupEnabled](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#popupEnabled) set. One example could be a custom side panel that displays feature-specific information based on an end user's click location. This method allows a developer to control how the input location is handled, and then subsequently, what to do with the results.
+   * > [!WARNING]
+   * > Using [ScreenRect](https://developers.arcgis.com/javascript/latest/references/core/core/types/#ScreenRect) as the hit target is considered **[beta](https://developers.arcgis.com/javascript/latest/faq/#what-does-the-beta-tag-mean)** functionality.
    *
    * @param hitTarget
    * @param options
@@ -957,8 +1016,9 @@ export abstract class ArcgisScene extends LitElement {
    *
    * @param hitTarget
    * @param options
+   * @see [Sample - Hit test by screen rectangle in 3D](https://developers.arcgis.com/javascript/latest/sample-code/scene-hittest-screen-rectangle/)
    */
-  hitTest(hitTarget: MouseEvent | ScreenPoint | ScreenRect, options?: HitTestOptions3D): Promise<SceneViewHitTestResult>;
+  hitTest(hitTarget: MouseEvent | ScreenPoint | ScreenPolygon | ScreenRect, options?: HitTestOptions3D): Promise<SceneViewHitTestResult>;
   /**
    * Opens the popup based on input options.
    *
@@ -1265,4 +1325,6 @@ export abstract class ArcgisScene extends LitElement {
     arcgisViewReadyError: ArcgisScene["arcgisViewReadyError"]["detail"];
     arcgisViewVerticalTwoFingerDrag: ArcgisScene["arcgisViewVerticalTwoFingerDrag"]["detail"];
   };
-}
+}
+
+export type AttributionMode = SceneView["attributionMode"] | "auto";

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

@@ -7,25 +7,25 @@ import v from "@arcgis/core/geometry/Point.js";
 import u from "@arcgis/core/views/SceneView.js";
 import g from "@arcgis/core/WebScene.js";
 import { LitElement as d, createEvent as r, safeClassMap as n } from "@arcgis/lumina";
-import { reEmitEvent as t, reCreateAccessor as y, makeAccessorController as w } from "@arcgis/lumina/controllers/accessor";
+import { makeAccessorController as w, reEmitEvent as t, reCreateAccessor as y } from "@arcgis/lumina/controllers/accessor";
 import { createRef as o, ref as h } from "lit/directives/ref.js";
-import { U as f, u as b, a as V } from "../../chunks/useArcgisViewReadyError.js";
-import { s as C } from "../../chunks/esri-main.js";
+import { U as f, u as b, a as V, b as C } from "../../chunks/useArcgisViewReadyError.js";
+import { s as _ } from "../../chunks/esri-main.js";
 import { s as E } from "../../chunks/slots.js";
 import { C as c } from "../../chunks/resources.js";
-import { b as _, c as P, p as A, i as R } from "../../chunks/component-utils.js";
-const D = w(g, {}), I = w(u, {});
-class M extends d {
+import { d as P, e as A, b as M, c as R, p as D, i as I } from "../../chunks/component-utils.js";
+const k = w(g, {}), L = w(u, {});
+class S extends d {
   constructor() {
-    super(), this._containerRef = o(), this._mapRef = o(), this._uiController = new f(this), this._cameraProperties = {}, this.arcgisLoadError = b(this), this.arcgisViewReadyError = V(this), this._map = D(this), this.view = I(this), this.allLayerViews = this.view.allLayerViews, this.alphaCompositingEnabled = this.view.alphaCompositingEnabled, this.analyses = this.view.analyses, this.animationsDisabled = this.view.animationsEnabled, this.attributionMode = this.view.attributionMode, this.autoDestroyDisabled = !1, this.basemap = this._map.basemap, this.basemapView = this.view.basemapView, this.canZoomIn = this.view.canZoomIn, this.canZoomOut = this.view.canZoomOut, this.clippingArea = this.view.clippingArea, this.constraints = this.view.constraints, this.displayFilterDisabled = this.view.displayFilterEnabled, this.environment = this.view.environment, this.fatalError = this.view.fatalError, this.floors = this.view.floors, this.graphics = this.view.graphics, this.ground = this._map.ground, this.groundView = this.view.groundView, this.highlights = this.view.highlights, this.layerViews = this.view.layerViews, this.magnifier = this.view.magnifier, this.map = this.view.map, this.navigation = this.view.navigation, this.padding = this.view.padding, this.popup = this.view.popup, this.popupDisabled = this.view.popupEnabled, this.popupComponentEnabled = !1, this.qualityProfile = this.view.qualityProfile, this.ready = this.view.ready, this.selectionManager = this.view.selectionManager, this.slotGroupRefs = this._uiController.slotGroupRefs, this.spatialReference = this.view.spatialReference, this.suspended = this.view.suspended, this.theme = this.view.theme, this.timeExtent = this.view.timeExtent, this.updating = this.view.updating, this.viewingMode = this.view.viewingMode, this.visibleArea = this.view.visibleArea, this.arcgisViewAnalysisViewCreate = t(() => this.view, "analysis-view-create"), this.arcgisViewAnalysisViewCreateError = t(() => this.view, "analysis-view-create-error"), this.arcgisViewAnalysisViewDestroy = t(() => this.view, "analysis-view-destroy"), this.arcgisViewChange = r(), this.arcgisViewClick = t(() => this.view, "click"), this.arcgisViewDoubleClick = t(() => this.view, "double-click"), this.arcgisViewDoubleTapDrag = t(() => this.view, "double-tap-drag"), this.arcgisViewDrag = t(() => this.view, "drag"), this.arcgisViewHold = t(() => this.view, "hold"), this.arcgisViewImmediateClick = t(() => this.view, "immediate-click"), this.arcgisViewImmediateDoubleClick = t(() => this.view, "immediate-double-click"), this.arcgisViewKeyDown = t(() => this.view, "key-down"), this.arcgisViewKeyUp = t(() => this.view, "key-up"), this.arcgisViewLayerviewCreate = t(() => this.view, "layerview-create"), this.arcgisViewLayerviewCreateError = t(() => this.view, "layerview-create-error"), this.arcgisViewLayerviewDestroy = t(() => this.view, "layerview-destroy"), this.arcgisViewMouseWheel = t(() => this.view, "mouse-wheel"), this.arcgisViewPointerDown = t(() => this.view, "pointer-down"), this.arcgisViewPointerEnter = t(() => this.view, "pointer-enter"), this.arcgisViewPointerLeave = t(() => this.view, "pointer-leave"), this.arcgisViewPointerMove = t(() => this.view, "pointer-move"), this.arcgisViewPointerUp = t(() => this.view, "pointer-up"), this.arcgisViewReadyChange = r(), this.arcgisViewVerticalTwoFingerDrag = t(() => this.view, "vertical-two-finger-drag"), this.view.ui = {
+    super(), this._attributionMode = null, this._containerRef = o(), this._mapRef = o(), this._uiController = new f(this), this._cameraProperties = {}, this.arcgisLoadError = b(this), this.arcgisViewReadyError = V(this), this._map = k(this), this.view = L(this), this.allLayerViews = this.view.allLayerViews, this.alphaCompositingEnabled = this.view.alphaCompositingEnabled, this.analyses = this.view.analyses, this.animationsDisabled = this.view.animationsEnabled, this.autoDestroyDisabled = !1, this.basemap = this._map.basemap, this.basemapView = this.view.basemapView, this.canZoomIn = this.view.canZoomIn, this.canZoomOut = this.view.canZoomOut, this.clippingArea = this.view.clippingArea, this.constraints = this.view.constraints, this.displayFilterDisabled = this.view.displayFilterEnabled, this.environment = this.view.environment, this.fatalError = this.view.fatalError, this.floors = this.view.floors, this.graphics = this.view.graphics, this.ground = this._map.ground, this.groundView = this.view.groundView, this.highlights = this.view.highlights, this.layerViews = this.view.layerViews, this.magnifier = this.view.magnifier, this.map = this.view.map, this.navigation = this.view.navigation, this.padding = this.view.padding, this.popup = this.view.popup, this.popupDisabled = this.view.popupEnabled, this.popupComponentEnabled = !1, this.qualityProfile = this.view.qualityProfile, this.ready = this.view.ready, this.selectionManager = this.view.selectionManager, this.slotGroupRefs = this._uiController.slotGroupRefs, this.spatialReference = this.view.spatialReference, this.suspended = this.view.suspended, this.theme = this.view.theme, this.timeExtent = this.view.timeExtent, this.timeZone = this.view.timeZone, this.updating = this.view.updating, this.viewingMode = this.view.viewingMode, this.visibleArea = this.view.visibleArea, this.arcgisViewAnalysisViewCreate = t(() => this.view, "analysis-view-create"), this.arcgisViewAnalysisViewCreateError = t(() => this.view, "analysis-view-create-error"), this.arcgisViewAnalysisViewDestroy = t(() => this.view, "analysis-view-destroy"), this.arcgisViewChange = r(), this.arcgisViewClick = t(() => this.view, "click"), this.arcgisViewDoubleClick = t(() => this.view, "double-click"), this.arcgisViewDoubleTapDrag = t(() => this.view, "double-tap-drag"), this.arcgisViewDrag = t(() => this.view, "drag"), this.arcgisViewHold = t(() => this.view, "hold"), this.arcgisViewImmediateClick = t(() => this.view, "immediate-click"), this.arcgisViewImmediateDoubleClick = t(() => this.view, "immediate-double-click"), this.arcgisViewKeyDown = t(() => this.view, "key-down"), this.arcgisViewKeyUp = t(() => this.view, "key-up"), this.arcgisViewLayerviewCreate = t(() => this.view, "layerview-create"), this.arcgisViewLayerviewCreateError = t(() => this.view, "layerview-create-error"), this.arcgisViewLayerviewDestroy = t(() => this.view, "layerview-destroy"), this.arcgisViewMouseWheel = t(() => this.view, "mouse-wheel"), this.arcgisViewPointerDown = t(() => this.view, "pointer-down"), this.arcgisViewPointerEnter = t(() => this.view, "pointer-enter"), this.arcgisViewPointerLeave = t(() => this.view, "pointer-leave"), this.arcgisViewPointerMove = t(() => this.view, "pointer-move"), this.arcgisViewPointerUp = t(() => this.view, "pointer-up"), this.arcgisViewReadyChange = r(), this.arcgisViewVerticalTwoFingerDrag = t(() => this.view, "vertical-two-finger-drag"), C(this), this.view.ui = {
       components: []
     };
   }
   static {
-    this.properties = { _map: 16, aria: 0, view: 32, allLayerViews: 32, alphaCompositingEnabled: 5, analyses: 0, animationsDisabled: 5, attributionItems: 32, attributionMode: 1, autoDestroyDisabled: 5, basemap: 1, basemapView: 0, camera: 0, cameraFov: 9, cameraHeading: 9, cameraPosition: 1, cameraTilt: 9, canZoomIn: 36, canZoomOut: 36, center: 1, clippingArea: 0, constraints: 0, displayFilterDisabled: 5, environment: 0, extent: 0, fatalError: 0, floors: 0, focusAreas: 0, gamepad: 32, graphics: 0, ground: 1, groundView: 32, hideAttribution: 5, highlights: 0, interacting: 32, itemId: 3, layerViews: 32, magnifier: 32, map: 0, navigating: 32, navigation: 0, padding: 0, performanceInfo: 32, popup: 0, popupElement: 32, popupDisabled: 5, popupComponentEnabled: 5, qualityProfile: 1, ready: 36, resolution: 32, selectionManager: 32, scale: 9, slotGroupRefs: 32, spatialReference: 0, stationary: 32, suspended: 39, theme: 0, timeExtent: 0, updating: 36, viewingMode: 1, viewpoint: 0, visibleArea: 32, zoom: 9, loadErrorSources: 0 };
+    this.properties = { _map: 16, aria: 0, view: 32, allLayerViews: 32, alphaCompositingEnabled: 5, analyses: 0, animationsDisabled: 5, attributionItems: 32, attributionMode: 1, autoDestroyDisabled: 5, basemap: 1, basemapView: 0, camera: 0, cameraFov: 9, cameraHeading: 9, cameraPosition: 1, cameraTilt: 9, canZoomIn: 36, canZoomOut: 36, center: 1, clippingArea: 0, constraints: 0, displayFilterDisabled: 5, environment: 0, extent: 0, fatalError: 0, floors: 0, focusAreas: 0, gamepad: 32, graphics: 0, ground: 1, groundView: 32, hideAttribution: 5, highlights: 0, interacting: 32, itemId: 3, layerViews: 32, magnifier: 32, map: 0, navigating: 32, navigation: 0, padding: 0, performanceInfo: 32, popup: 0, popupElement: 32, popupDisabled: 5, popupComponentEnabled: 5, qualityProfile: 1, ready: 36, resolution: 32, selectionManager: 32, scale: 9, slotGroupRefs: 32, spatialReference: 0, stationary: 32, suspended: 39, theme: 0, timeExtent: 0, timeZone: 1, updating: 36, viewingMode: 1, viewpoint: 0, visibleArea: 32, zoom: 9, loadErrorSources: 0 };
   }
   static {
-    this.styles = [C, E];
+    this.styles = [_, E];
   }
   get aria() {
     return this.view?.aria ?? null;
@@ -36,11 +36,17 @@ class M extends d {
   get attributionItems() {
     return this.view?.attributionItems ?? [];
   }
+  get attributionMode() {
+    return this._attributionMode;
+  }
+  set attributionMode(i) {
+    this._attributionMode = i, i !== "auto" && (this.view.attributionMode = i);
+  }
   get camera() {
     return this.view.camera;
   }
   set camera(i) {
-    _(this.camera, i) || (this.view.camera = i);
+    P(this.camera, i) || (this.view.camera = i);
   }
   get cameraFov() {
     const { view: i } = this;
@@ -68,7 +74,7 @@ class M extends d {
     return e ? new v(e) : void 0;
   }
   set cameraPosition(i) {
-    const e = P(this.view.camera?.position, i);
+    const e = A(this.view.camera?.position, i);
     e && this._mutateCamera((m) => {
       m.position = e;
     });
@@ -86,7 +92,10 @@ class M extends d {
     return this.view.center;
   }
   set center(i) {
-    const e = A(i, this.view);
+    if (M(i, this._center))
+      return;
+    this._center = R(i);
+    const e = D(i, this.view);
     e && (this.view.center = e);
   }
   get extent() {
@@ -147,7 +156,7 @@ class M extends d {
     return this.view.viewpoint;
   }
   set viewpoint(i) {
-    R(this.viewpoint, i) && (this.view.viewpoint = i);
+    I(this.viewpoint, i) && (this.view.viewpoint = i);
   }
   get zoom() {
     return this.view.zoom;
@@ -158,12 +167,12 @@ class M extends d {
   async closePopup() {
     this._uiController.closePopup();
   }
-  async fetchPopupFeatures(i, e) {
-    return this.view.fetchPopupFeatures(i, e);
-  }
   async destroy() {
     await this.manager.destroy();
   }
+  async fetchPopupFeatures(i, e) {
+    return this.view.fetchPopupFeatures(i, e);
+  }
   async goTo(i, e) {
     return await this.view.goTo(i, e);
   }
@@ -230,7 +239,7 @@ class M extends d {
     return a`${this.renderMain()}<section class=${n(c.containerUI)} ${h(this._containerRef)}>${this._uiController.render()}</section>`;
   }
 }
-p("arcgis-scene", M);
+p("arcgis-scene", S);
 export {
-  M as ArcgisScene
+  S as ArcgisScene
 };