@arcgis/map-components 5.2.0-next.3 → 5.2.0-next.30

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

@@ -1,7 +1,4 @@
 /// <reference path="../../index.d.ts" />
-import type Features from "@arcgis/core/popup/Features.js";
-import type ActionButton from "@arcgis/core/support/actions/ActionButton.js";
-import type ActionToggle from "@arcgis/core/support/actions/ActionToggle.js";
 import type Graphic from "@arcgis/core/Graphic.js";
 import type Collection from "@arcgis/core/core/Collection.js";
 import type Point from "@arcgis/core/geometry/Point.js";
@@ -35,7 +32,7 @@ import type { MapViewOrSceneView } from "@arcgis/core/views/MapViewOrSceneView.j
  *
  * The Popup component can also be opened manually at a specific location using the [open](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#open) property.
  * To prevent the popup from opening automatically when clicking on features within view components, set the `popup-disabled` attribute to `true` and add the Popup component to the [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/), [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/), or [arcgis-link-chart](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-link-chart/) using the `popup` slot.
- * Before setting the `open` property to `true`, you must set the [location](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#location) property to specify where the popup should open or call the [fetchFeatures()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#fetchFeatures) method to open the popup template for features at a specific screen location.
+ * Before setting the `open` property to `true`, you must set the [location](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#location) property to specify where the popup should open.
  *
  * Example of opening the popup at a clicked location with custom content:
  *
@@ -59,7 +56,7 @@ import type { MapViewOrSceneView } from "@arcgis/core/views/MapViewOrSceneView.j
  * </script>
  * ```
  *
- * Alternatively, you can call the [fetchFeatures()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#fetchFeatures) method within the view element's click event listener to open the popup with features at the clicked location.
+ * Alternatively, you can call the [arcgis-map.fetchPopupFeatures()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#fetchPopupFeatures) method within the view element's click event listener to open the popup with features at the clicked location.
  * ```html
  * <!-- Set popup-disabled and popup-component-enabled attributes -->
  * <arcgis-map id="06ca49d0ddb447e7817cfc343ca30df9" popup-disabled>
@@ -71,7 +68,12 @@ import type { MapViewOrSceneView } from "@arcgis/core/views/MapViewOrSceneView.j
  * const popupComponent = document.querySelector("arcgis-popup");
  * // Listen for clicks on the view and populate the popup with features at that location.
  * viewElement.addEventListener("arcgisViewClick", async (event) => {
- *   await popupComponent.fetchFeatures(event.detail);
+ *  const generator = await viewElement.fetchPopupFeatures(event.detail.screenPoint, {
+ *    pointerType: event.detail.pointerType,
+ *  });
+ *
+ *  const features = await Array.fromAsync(generator);
+ *  popupComponent.features = features;
  * });
  * // Open the popup when the features property changes.
  * reactiveUtils.watch(
@@ -299,7 +301,13 @@ export abstract class ArcgisPopup extends LitElement {
    * ```
    */
   accessor features: Array<Graphic>;
-  /** @default false */
+  /**
+   * When `true`, this prevents the popup from trapping focus when opened.
+   * Preventing focus trapping can be used in scenarios where interactions are expected within the user interface, such as when the popup resides in a panel.
+   *
+   * @default false
+   * @since 5.1
+   */
   accessor focusTrapDisabled: boolean;
   /**
    * This function provides the ability to override either the [arcgis-map.goTo()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#goTo) or [arcgis-scene.goTo()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#goTo) methods.
@@ -345,7 +353,7 @@ export abstract class ArcgisPopup extends LitElement {
    * important for meeting accessibility standards.
    *
    * @default 2
-   * @see [Heading Elements](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Heading_Elements)
+   * @see [Heading Elements](https://developer.mozilla.org/docs/Web/HTML/Element/Heading_Elements)
    * @see [heading](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#heading)
    * @example
    * ```html
@@ -426,7 +434,7 @@ export abstract class ArcgisPopup extends LitElement {
   accessor label: string | undefined;
   /**
    * Point used to position the popup. This is automatically set when viewing the
-   * popup by selecting a feature or when calling the [fetchFeatures()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#fetchFeatures) method. If using the Popup to display content not related
+   * popup by selecting a feature. If using the Popup to display content not related
    * to features in the map, such as the results from a task, then you must set this
    * property before [open](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#open) the popup.
    *
@@ -505,6 +513,8 @@ export abstract class ArcgisPopup extends LitElement {
    * no pending promises, the value is `null`. When the pending promises are
    * resolved they are removed from this array and the features they return
    * are pushed into the [features](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#features) array.
+   *
+   * @deprecated since 5.1.
    */
   accessor promises: Array<Promise<Array<Graphic>>>;
   /**
@@ -570,25 +580,11 @@ export abstract class ArcgisPopup extends LitElement {
   /**
    * Use this method to return feature(s) at a given screen location. These features are fetched from all of the [LayerViews](https://developers.arcgis.com/javascript/latest/references/core/views/layers/LayerView/) in the [view](https://developers.arcgis.com/javascript/latest/references/core/views/View/). In order to use this, a layer must already have an associated [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/) and have its [popupEnabled](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#popupEnabled). This method allows a developer to control how the input location is handled. For example, you may want to fetch features on a `click` event or on a `pointer-move` event. This method automatically sets the [location](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#location) based on the input event's screen coordinates.
    *
+   * @deprecated since 5.1. Use the `fetchPopupFeatures` method on the [Map](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#fetchPopupFeatures), [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#fetchPopupFeatures), or [Link Chart](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-link-chart/#fetchPopupFeatures) component to fetch features based on a screen location.
    * @param screenPoint
    * @param options
+   * @deprecated
    * @see [open](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#open)
-   * @example
-   * ```js
-   * const viewElement = document.querySelector("arcgis-map");
-   * // Get viewElement's click event
-   * reactiveUtils.on(()=>viewElement, "arcgisViewClick", async (event)=>{
-   *   // Call fetchFeatures on the component and pass in the click event detail
-   *   await component.fetchFeatures(event.detail);
-   * });
-   * // Watch for changes to the features property and open the component when features are available.
-   * reactiveUtils.watch(
-   *   () => component.features,
-   *   () => {
-   *     component.open = component.features ? true : false;
-   *   },
-   * );
-   * ```
    */
   fetchFeatures(screenPoint?: ScreenPoint, options?: FetchFeaturesOptions): Promise<void>;
   /**
@@ -601,22 +597,15 @@ export abstract class ArcgisPopup extends LitElement {
    *
    * @see [selectedFeatureIndex](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#selectedFeatureIndex)
    */
-  next(): Promise<Features>;
+  next(): Promise<void>;
   /**
    * Selects the feature at the previous index in relation to the selected feature.
    *
    * @see [selectedFeatureIndex](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#selectedFeatureIndex)
    */
-  previous(): Promise<Features>;
+  previous(): Promise<void>;
   /** Use this method to give focus to the component if the component is able to be focused. */
   setFocus(): Promise<void>;
-  /**
-   * Triggers the [@arcgisTriggerAction](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#event-arcgisTriggerAction) event and executes the [actions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#actions)
-   * at the specified index in the [actions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#actions) array.
-   *
-   * @param action
-   */
-  triggerAction(action: ActionButton | ActionToggle): Promise<void>;
   /** Emitted when the component's close button is clicked. */
   readonly arcgisClose: import("@arcgis/lumina").TargetedEvent<this, void>;
   readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "active" | "collapsed" | "currentAlignment" | "dockEnabled" | "effectiveHeading" | "featureCount" | "featureMenuOpen" | "features" | "promises" | "selectedDrillInFeature" | "selectedFeature" | "selectedFeatureComponent" | "selectedFeatureIndex" | "state" | "open"; }>;

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

@@ -55,8 +55,8 @@ class j extends L {
   set dockOptions(t) {
     const e = { ...C }, o = this.viewModel?.view?.breakpoints, i = {};
     o && (i.width = o.xsmall, i.height = o.xsmall);
-    const s = { ...e, ...t }, n = { ...e.breakpoint, ...i }, { breakpoint: a } = s;
-    typeof a == "object" ? s.breakpoint = { ...n, ...a } : a && (s.breakpoint = n), this._dockOptions = s;
+    const s = { ...e, ...t }, n = { ...e.breakpoint, ...i }, { breakpoint: r } = s;
+    typeof r == "object" ? s.breakpoint = { ...n, ...r } : r && (s.breakpoint = n), this._dockOptions = s;
   }
   get selectedDrillInFeature() {
     return this._featuresComponent.value?.selectedDrillInFeature ?? null;
@@ -68,26 +68,23 @@ class j extends L {
     return this.viewModel.handleViewClick(t);
   }
   async clear() {
-    return this.viewModel.clear();
+    this.viewModel.clear();
   }
   async destroy() {
     await this.manager.destroy(), this._dockAction.destroy(), this._popupResizeObserver.disconnect();
   }
   async fetchFeatures(t, e) {
-    return await this._featuresComponent.value?.fetchFeatures(t, e);
+    await this._featuresComponent.value?.fetchFeatures(t, e);
   }
   async next() {
-    return this.viewModel.next();
+    this.viewModel.next();
   }
   async previous() {
-    return this.viewModel.previous();
+    this.viewModel.previous();
   }
   async setFocus() {
     this._featuresComponent.value?.setFocus();
   }
-  async triggerAction(t) {
-    return await this._featuresComponent.value?.triggerAction(t);
-  }
   connectedCallback() {
     super.connectedCallback(), this._syncPopupResizeObserver();
   }
@@ -157,7 +154,7 @@ class j extends L {
     const { _mainContainerNode: e, _popupRect: o, viewModel: i } = this, { view: s } = i, { screenLocation: n } = this;
     if (n == null || !s || !o || !e.value)
       return "top-center";
-    const a = window.getComputedStyle(e.value), l = f(a.maxHeight), r = f(a.height), c = this._getPointerSize(), { height: d, width: k } = o, h = k + c, u = Math.max(d, l, r) + c, z = this._isOutsideView({
+    const r = window.getComputedStyle(e.value), l = f(r.maxHeight), a = f(r.height), c = this._getPointerSize(), { height: d, width: k } = o, h = k + c, u = Math.max(d, l, a) + c, z = this._isOutsideView({
       popupHeight: u,
       popupWidth: h,
       screenLocation: n,
@@ -239,35 +236,35 @@ class j extends L {
   _calculateAlignmentPosition(t, e, o, i) {
     if (t < 0 || e < 0 || !o || !i || t > o.width || e > o.height)
       return;
-    const { topLayerDisabled: s } = this, n = s ? t : t + o.x, a = s ? e : e + o.y, { _direction: l, currentAlignment: r } = this, c = this._getPointerSize(), d = c / 2;
-    if (r === "top-left" || r === "top-start" && l === "ltr" || r === "top-end" && l === "rtl")
+    const { topLayerDisabled: s } = this, n = s ? t : t + o.x, r = s ? e : e + o.y, { _direction: l, currentAlignment: a } = this, c = this._getPointerSize(), d = c / 2;
+    if (a === "top-left" || a === "top-start" && l === "ltr" || a === "top-end" && l === "rtl")
       return {
-        top: a - (i.height + d),
+        top: r - (i.height + d),
         left: n - i.width - d
       };
-    if (r === "top-center")
+    if (a === "top-center")
       return {
-        top: a - (i.height + c),
+        top: r - (i.height + c),
         left: n - i.width / 2
       };
-    if (r === "top-right" || r === "top-end" && l === "ltr" || r === "top-start" && l === "rtl")
+    if (a === "top-right" || a === "top-end" && l === "ltr" || a === "top-start" && l === "rtl")
       return {
-        top: a - (i.height + d),
+        top: r - (i.height + d),
         left: n + d
       };
-    if (r === "bottom-left" || r === "bottom-start" && l === "ltr" || r === "bottom-end" && l === "rtl")
+    if (a === "bottom-left" || a === "bottom-start" && l === "ltr" || a === "bottom-end" && l === "rtl")
       return {
-        top: a + d,
+        top: r + d,
         left: n - i.width - d
       };
-    if (r === "bottom-center")
+    if (a === "bottom-center")
       return {
-        top: a + c,
+        top: r + c,
         left: n - i.width / 2
       };
-    if (r === "bottom-right" || r === "bottom-end" && l === "ltr" || r === "bottom-start" && l === "rtl")
+    if (a === "bottom-right" || a === "bottom-end" && l === "ltr" || a === "bottom-start" && l === "rtl")
       return {
-        top: a + d,
+        top: r + d,
         left: n + d
       };
   }
@@ -287,8 +284,8 @@ class j extends L {
       return `inset: ${this._getPositionStyleValue(i.top)} ${this._getPositionStyleValue(i.right)} ${this._getPositionStyleValue(i.bottom)} ${this._getPositionStyleValue(i.left)};`;
   }
   _dockingThresholdCrossed(t, e, o) {
-    const [i, s] = t, [n, a] = e, { width: l = 0, height: r = 0 } = o ?? {};
-    return i <= l && n > l || i > l && n <= l || s <= r && a > r || s > r && a <= r;
+    const [i, s] = t, [n, r] = e, { width: l = 0, height: a = 0 } = o ?? {};
+    return i <= l && n > l || i > l && n <= l || s <= a && r > a || s > a && r <= a;
   }
   _updateDockEnabledForViewSize(t, e) {
     if (!t || !e || !this.viewModel?.view?.ready)
@@ -303,14 +300,14 @@ class j extends L {
     const { width: i, height: s } = o;
     if (Number.isNaN(i) || Number.isNaN(s) || typeof e != "object")
       return !1;
-    const n = typeof e.width == "number" && i <= (e.width ?? 0), a = typeof e.height == "number" && s <= (e.height ?? 0);
-    return n || a;
+    const n = typeof e.width == "number" && i <= (e.width ?? 0), r = typeof e.height == "number" && s <= (e.height ?? 0);
+    return n || r;
   }
   _setDockEnabledForViewSize(t) {
     this.viewModel?.view?.ready && typeof t.breakpoint == "object" && (this.dockEnabled = this._shouldDockAtCurrentViewSize(t));
   }
   render() {
-    const { _direction: t, dockEnabled: e, currentAlignment: o, currentDockPosition: i, positionStyle: s } = this, { active: n, view: a } = this.viewModel, l = n && e, r = n && !e, c = a?.widthBreakpoint, d = a?.heightBreakpoint, k = {
+    const { _direction: t, dockEnabled: e, currentAlignment: o, currentDockPosition: i, positionStyle: s } = this, { active: n, view: r } = this.viewModel, l = n && e, a = n && !e, c = r?.widthBreakpoint, d = r?.heightBreakpoint, k = {
       "aligned-top-center": o === "top-center",
       "aligned-bottom-center": o === "bottom-center",
       "aligned-top-left": o === "top-left" || o === "top-start" && t === "ltr" || o === "top-end" && t === "rtl",
@@ -318,7 +315,7 @@ class j extends L {
       "aligned-top-right": o === "top-right" || o === "top-end" && t === "ltr" || o === "top-start" && t === "rtl",
       "aligned-bottom-right": o === "bottom-right" || o === "bottom-end" && t === "ltr" || o === "bottom-start" && t === "rtl",
       "is-docked": l,
-      shadow: r,
+      shadow: a,
       "is-rtl": this._direction === "rtl",
       "is-docked-top-start": i === "top-start",
       "is-docked-top-end": i === "top-end",

package/dist/components/arcgis-presentation/PresentationViewModel.d.ts

@@ -39,9 +39,12 @@ export default class PresentationViewModel extends Accessor {
   captureArrowKeysForNavigation(event: KeyboardEvent, direction: "ltr" | "rtl"): void;
   destroy(): void;
   /** @param slideId */
+  getSlideBySlideId(slideId: string): Slide | undefined;
+  /** @param slideId */
   getSlideIndexBySlideId(slideId: string | undefined): number;
   initialize(): void;
   /** @param stepSize */
   navigateInPresentation(stepSize: number): void;
-  setSliceAnalysisInteractive(): Promise<void>;
+  /** @param interactive */
+  setSliceAnalysisInteractive(interactive: boolean): Promise<void>;
 }

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

@@ -49,6 +49,13 @@ export abstract class ArcgisPresentation extends LitElement {
    * @default false
    */
   accessor keyboardNavigationEnabled: boolean;
+  /**
+   * Hide the presentation navigation in the UI.
+   * Slide elements will still be shown when a slide is applied to the view.
+   *
+   * @default false
+   */
+  accessor navigationHidden: boolean;
   /**
    * specifies the size of the component
    *
@@ -131,9 +138,27 @@ export abstract class ArcgisPresentation extends LitElement {
   }>;
   /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
   readonly arcgisReady: import("@arcgis/lumina").TargetedEvent<this, void>;
+  /**
+   * Fires after applying a slide to the Scene View has been canceled.
+   * It only fires if the slide cancelled is in the list of slides of the webscene presentation.
+   */
+  readonly arcgisSlideApplyCancel: import("@arcgis/lumina").TargetedEvent<this, { slide: Slide; }>;
+  /**
+   * Fires after applying a slide to the Scene View has been completed.
+   * It only fires if the slide canceled is in the list of slides of the webscene presentation.
+   */
+  readonly arcgisSlideApplyComplete: import("@arcgis/lumina").TargetedEvent<this, { slide: Slide; }>;
+  /**
+   * Fires after a slide has been applied to the Scene View.
+   * It only fires if the slide applied is in the list of slides of the webscene presentation.
+   */
+  readonly arcgisSlideApplyStart: import("@arcgis/lumina").TargetedEvent<this, { slide: Slide; }>;
   readonly "@eventTypes": {
     arcgisPopupFeatureNotFound: ArcgisPresentation["arcgisPopupFeatureNotFound"]["detail"];
     arcgisPopupFeaturesRetrieved: ArcgisPresentation["arcgisPopupFeaturesRetrieved"]["detail"];
     arcgisReady: ArcgisPresentation["arcgisReady"]["detail"];
+    arcgisSlideApplyCancel: ArcgisPresentation["arcgisSlideApplyCancel"]["detail"];
+    arcgisSlideApplyComplete: ArcgisPresentation["arcgisSlideApplyComplete"]["detail"];
+    arcgisSlideApplyStart: ArcgisPresentation["arcgisSlideApplyStart"]["detail"];
   };
 }