@arcgis/map-components 5.0.0-next.13 → 5.0.0-next.131

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

@@ -4,11 +4,10 @@ import { default as FeaturesViewModel } from '@arcgis/core/widgets/Features/Feat
 import { ArcgisReferenceElement } from '../../utils/component-utils';
 import { HeadingLevel } from '../../support/heading';
 import { Use } from '@arcgis/lumina/controllers';
-import { Alignment, DockOptions, PopupPositionResult, PopupPositionStyle, FetchFeaturesOptions } from './interfaces';
+import { Alignment, DockOptions, PopupPositionResult, PopupPositionStyle, FetchFeaturesOptions } from './types';
 import { JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { nil } from '@arcgis/toolkit/type';
 import { ArcgisFeature } from '../arcgis-feature/customElement.js';
-import { default as ActionButton } from '@arcgis/core/support/actions/ActionButton.js';
 declare const useFeaturesViewModel: (component: LitElement & Pick<FeaturesViewModel, never> & import('../../controllers/useViewModel').ViewModelControllerUses<FeaturesViewModel>) => FeaturesViewModel;
 
 /**
@@ -18,30 +17,28 @@ declare const useFeaturesViewModel: (component: LitElement & Pick<FeaturesViewMo
  * They play an important role in relaying information to the user, which improves the storytelling capabilities of the application.
  *
  * The [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/), [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/), and [arcgis-link-chart](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-link-chart/) components currently use the [Popup widget](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Popup.html) by default.
- * To enable the Popup component, first disable the popup widget via the `popup-disabled` attribute on Map, Scene, or LinkChart, then add the Popup component.
- * Once added, there are two ways to open the Popup component: automatically when features are clicked, or manually by calling the popup component's [open()](#open) method.
- *
- * ### Automatically open Popup when features are clicked
- * The Popup component can be opened automatically to display the selected feature's popup template when features in the Map, Scene, or Link Chart are clicked.
- * To configure this, add the Popup component to the `popup` slot of the [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/), [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/), or [arcgis-link-chart](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-link-chart/) components.
+ * To use the Popup component, add it to the [arcgis-map.popup](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/#popup), [arcgis-scene.popup](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#popup), or [arcgis-link-chart.popup](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-link-chart/#popup) component using the `popup` slot.
+ * The Popup component will be opened automatically to display the selected feature's popup template when features in the Map, Scene, or Link Chart are clicked.
  *
  * ```html
- * <arcgis-map id="06ca49d0ddb447e7817cfc343ca30df9" popup-disabled>
+ * <arcgis-map id="06ca49d0ddb447e7817cfc343ca30df9">
+ *   <!-- Add the popup component to the popup slot. -->
  *   <arcgis-popup slot="popup"></arcgis-popup>
  * </arcgis-map>
  * ```
- * ### Manually open Popup
- * The Popup component can also be opened manually by adding it to the [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/), [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/), or [arcgis-link-chart](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-link-chart/)'s default slot.
- * First, set the `popup-disabled` attribute to `true` on the Map, Scene, or Link Chart, then call the popup component's [open()](#open) method and pass in a location.
- * When the Map, Scene, or Link Chart is clicked, the Popup component will open with specified content at the clicked location.
+ * The Popup component can also be opened manually at a specific location with custom content specified in the method parameters using the `open()` method.
+ * To prevent the popup from opening automatically when clicking on features within view components, set the `popup-disabled` attribute to `true`.
  *
  * ```html
+ * <!-- Set popup-disabled attribute -->
  * <arcgis-map id="06ca49d0ddb447e7817cfc343ca30df9" popup-disabled>
- *   <arcgis-popup></arcgis-popup>
+ *   <!-- Add the popup component to the popup slot. -->
+ *   <arcgis-popup slot="popup"></arcgis-popup>
  * </arcgis-map>
  * <script>
  * const viewElement = document.querySelector("arcgis-map");
  * const popupComponent = document.querySelector("arcgis-popup");
+ * // Listen for clicks on the view and open the popup at the clicked location with custom content.
  * viewElement.addEventListener("arcgisViewClick", (event) => {
  *   const { mapPoint } = event.detail;
  *   popupComponent.open({
@@ -107,7 +104,6 @@ export declare class ArcgisPopup extends LitElement {
      *
      * The [arcgisTriggerAction](#arcgisTriggerAction) event fires each time an action is clicked.
      *
-     * @autocast { "value": "Object[]", "typedCollection": true, "byTypeProperty": true }
      * @see [arcgisTriggerAction](#arcgisTriggerAction)
      * @example
      * ```js
@@ -125,7 +121,7 @@ export declare class ArcgisPopup extends LitElement {
      * popupComponent.actions.push(zoomOutAction);
      * ```
      */
-    actions: __esri.Collection<ActionButton | __esri.ActionToggle>;
+    actions: import('@arcgis/core/core/Collection').default<import('@arcgis/core/widgets/Popup/types').PopupAction>;
     /**
      * Indicates if the component is active when it is visible and is not [waiting](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Popup-PopupViewModel.html#waitingForResult).
      *
@@ -138,12 +134,12 @@ export declare class ArcgisPopup extends LitElement {
      * to explicitly control where the popup displays in relation to the feature, choose
      * an option besides `auto`.
      *
+     * @default "auto"
      * @example
      * ```js
      * // Popup will display on the bottom-right of the selected feature regardless of where that feature is located
      * popupComponent.alignment = "bottom-right";
      * ```
-     * @default "auto"
      */
     alignment: Alignment;
     /**
@@ -174,15 +170,15 @@ export declare class ArcgisPopup extends LitElement {
      * for the content based on field or attribute names, see
      * [PopupTemplate.content](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html#content).
      *
-     * @noautocast
      * @example
      * ```js
      * // This sets generic instructions in the popup that will always be displayed
      * // unless it is overridden by a PopupTemplate
      * popupComponent.content = "Click a feature on the map to view its attributes";
      * ```
+     * @see [Sample - Popup Docking](https://developers.arcgis.com/javascript/latest/sample-code/popup-docking-position/)
      */
-    content: string | HTMLElement | nullish | __esri.Widget;
+    content: string | HTMLElement | import('@arcgis/core/widgets/Widget').default<any> | null | undefined;
     /** Dock position in the [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/), [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/), or [arcgis-link-chart](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-link-chart/) component. */
     get currentDockPosition(): nil | PopupPositionResult;
     /**
@@ -223,6 +219,7 @@ export declare class ArcgisPopup extends LitElement {
      *
      * See [dockOptions](#dockOptions) to override default options related to docking the popup.
      *
+     * @default false
      * @example
      * ```html
      * <!-- Setting this property in HTML -->
@@ -234,7 +231,6 @@ export declare class ArcgisPopup extends LitElement {
      * // The popup will automatically be dockEnabled when made visible
      * popupComponent.dockEnabled = true;
      * ```
-     * @default false
      */
     dockEnabled: boolean;
     /**
@@ -273,6 +269,7 @@ export declare class ArcgisPopup extends LitElement {
      * This value will only be honored if [`initialDisplayMode`](#initialDisplayMode) is set to "feature".
      *
      * @default false
+     * @since 4.32
      */
     featureMenuOpen: boolean;
     /**
@@ -289,7 +286,6 @@ export declare class ArcgisPopup extends LitElement {
      *
      * This value is `null` if no features are associated with the popup.
      *
-     * @noautocast
      * @example
      * ```js
      * // When setting the features property, the graphics pushed to this property
@@ -306,7 +302,7 @@ export declare class ArcgisPopup extends LitElement {
      * popupComponent.features = graphics;
      * ```
      */
-    features: __esri.Graphic[];
+    features: import('@arcgis/core/Graphic').default[];
     /**
      * This function provides the ability to override either the [arcgis-map.goTo](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/#goTo) or [arcgis-scene.goTo](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#goTo) methods.
      *
@@ -319,8 +315,11 @@ export declare class ArcgisPopup extends LitElement {
      *   return viewElement.goTo(goToParams.target, goToParams.options);
      * };
      * ```
+     * @since 4.8
+     * @see [MapView#goTo()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#goTo)
+     * @see [SceneView#goTo()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#goTo)
      */
-    goToOverride: nullish | __esri.GoToOverride;
+    goToOverride: import('@arcgis/core/widgets/support/types').GoToOverride | null | undefined;
     /**
      * The title of the popup. This can be set generically on the popup no
      * matter the features that are selected. If the [selected feature](#selectedFeature)
@@ -341,7 +340,7 @@ export declare class ArcgisPopup extends LitElement {
      * popupComponent.title = "Population by zip codes in Southern California";
      * ```
      */
-    heading: string | nullish;
+    heading: string | null | undefined;
     /**
      * Indicates the heading level to use for the [heading](#heading) of the popup.
      * By default, the heading is rendered
@@ -349,6 +348,7 @@ export declare class ArcgisPopup extends LitElement {
      * in your app, you may need to adjust this heading for proper semantics. This is
      * important for meeting accessibility standards.
      *
+     * @default 2
      * @see [Heading Elements](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Heading_Elements)
      * @see [heading](#heading)
      * @example
@@ -356,7 +356,6 @@ export declare class ArcgisPopup extends LitElement {
      * <!-- Render the popup heading as a level 3 heading -->
      * <arcgis-popup heading="Popup title" heading-level="3"></arcgis-popup>
      * ```
-     * @default 2
      */
     headingLevel: HeadingLevel;
     /**
@@ -426,7 +425,7 @@ export declare class ArcgisPopup extends LitElement {
      *
      * @default "feature"
      */
-    initialDisplayMode: "list" | "feature";
+    initialDisplayMode: import('@arcgis/core/widgets/Popup/types').InitialDisplayOptions;
     /** The component's default label. */
     label?: string;
     /**
@@ -435,7 +434,6 @@ export declare class ArcgisPopup extends LitElement {
      * to features in the map, such as the results from a task, then you must set this
      * property before making the popup [visible](#visible) to the user.
      *
-     * @autocast { "byTypeProperty": false }
      * @example
      * ```js
      * // Sets the location of the popup to the center of the view
@@ -458,8 +456,9 @@ export declare class ArcgisPopup extends LitElement {
      *   popupComponent.visible = true;
      * });
      * ```
+     * @see [Get started with popups](https://developers.arcgis.com/javascript/latest/sample-code/intro-popup/)
      */
-    location: __esri.Point | nullish;
+    location: import('@arcgis/core/geometry/Point').default | null | undefined;
     /** Overwrite localized strings for this component */
     messageOverrides?: typeof this.messages._overrides;
     /**
@@ -468,7 +467,7 @@ export declare class ArcgisPopup extends LitElement {
      * resolved they are removed from this array and the features they return
      * are pushed into the [features](#features) array.
      */
-    promises: Promise<__esri.Graphic[]>[];
+    promises: Promise<import('@arcgis/core/Graphic').default[]>[];
     /**
      * By assigning the `id` attribute of the Map or Scene component to this property, you can position a child component anywhere in the DOM while still maintaining a connection to the Map or Scene.
      *
@@ -485,7 +484,7 @@ export declare class ArcgisPopup extends LitElement {
      * determined based on the [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) assigned to
      * this feature.
      */
-    readonly selectedFeature: __esri.Graphic | nullish;
+    readonly selectedFeature: import('@arcgis/core/Graphic').default | null;
     /**
      * Returns a reference to the current [arcgis-feature](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-feature/) that the Popup is using.
      * This is useful if needing to get a reference to the component in order to make any changes to it.
@@ -501,22 +500,33 @@ export declare class ArcgisPopup extends LitElement {
      *
      * @default "disabled"
      */
-    readonly state: "ready" | "disabled";
+    readonly state: import('@arcgis/core/widgets/Popup/types').State;
+    /**
+     * When true, disables rendering in the top layer (above overlays and modals).
+     * This can be useful for controlling stacking context in complex UI layouts.
+     *
+     * @default false
+     * @public
+     * @since 5.0
+     */
+    topLayerDisabled: 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 ArcgisPopup component will be associated with a map or scene component rather than using the `view` property.
+     *   > **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 Popup component will be associated with a map or scene component rather than using the `view` property.
      */
-    view?: __esri.MapView | __esri.SceneView | nullish;
+    view?: import('@arcgis/core/views/MapViewOrSceneView').MapViewOrSceneView | null | undefined;
     /**
      * Indicates whether the popup is visible. This property is `true` when the popup is querying for results, even if it is not open.
-     * Use the property to check if the popup is visible and is not.
+     * Use the property to check if the popup is visible.
      *
-     * @name visible
-     * @type {boolean}
      * @default false
+     * @see [active](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html#active)
      */
     visible: boolean;
-    /** @internal */
+    /**
+     * @param event
+     * @internal
+     */
     handleViewClick(event: __esri.ViewClickEvent): Promise<__esri.FeaturesViewModelOpenOptions>;
     /**
      * Removes all [promises](#promises), [features](#features), [content](#content),
@@ -531,6 +541,8 @@ export declare class ArcgisPopup extends LitElement {
      * in the [view](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View.html). In order to use this, a layer must already have an
      * associated [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) and have its [popupEnabled](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html#popupEnabled).
      *
+     * @param screenPoint
+     * @param options
      * @example
      * ```js
      * // Example showing how to use fetchFeatures in an application
@@ -569,6 +581,7 @@ export declare class ArcgisPopup extends LitElement {
      * The popup will only display if the [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/) or [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/) size constraints in [dockOptions](#dockOptions) are met or the [location](#location)
      * property is set to a geometry.
      *
+     * @param options
      * @see [visible](#visible)
      * @example
      * ```js
@@ -617,15 +630,17 @@ export declare class ArcgisPopup extends LitElement {
      * @see [selectedFeatureIndex](#selectedFeatureIndex)
      */
     previous(): Promise<FeaturesViewModel>;
-    /** Use this method to give focus to the Widget if the widget is able to be focused. */
+    /** Use this method to give focus to the component if the component is able to be focused. */
     setFocus(): Promise<void>;
     /**
      * Triggers the [arcgisTriggerAction](#arcgisTriggerAction) event and executes the [action](#actions)
      * at the specified index in the [actions](#actions) array.
+     *
+     * @param action
      */
     triggerAction(action: __esri.ActionButton | __esri.ActionToggle): Promise<void>;
     readonly arcgisPropertyChange: TargetedEvent<this, {
-        name: "state" | "active" | "collapsed" | "featureCount" | "visible" | "selectedFeature" | "featureMenuOpen" | "features" | "promises" | "selectedFeatureIndex" | "selectedDrillInFeature" | "selectedFeatureComponent" | "currentAlignment" | "dockEnabled";
+        name: "active" | "state" | "collapsed" | "featureCount" | "featureMenuOpen" | "features" | "promises" | "selectedDrillInFeature" | "selectedFeature" | "selectedFeatureComponent" | "selectedFeatureIndex" | "visible" | "currentAlignment" | "dockEnabled";
     }>;
     /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
     readonly arcgisReady: TargetedEvent<this, void>;
@@ -674,7 +689,13 @@ export declare class ArcgisPopup extends LitElement {
      * });
      * ```
      */
-    readonly arcgisTriggerAction: TargetedEvent<this, __esri.PopupTriggerActionEvent>;
+    readonly arcgisTriggerAction: TargetedEvent<this, import('@arcgis/core/widgets/Popup/types').ActionEvent>;
     private messages;
+    "@eventTypes": {
+        "arcgisClose": ArcgisPopup["arcgisClose"]["detail"];
+        "arcgisPropertyChange": ArcgisPopup["arcgisPropertyChange"]["detail"];
+        "arcgisReady": ArcgisPopup["arcgisReady"]["detail"];
+        "arcgisTriggerAction": ArcgisPopup["arcgisTriggerAction"]["detail"];
+    };
 }
 export {};