@arcgis/map-components 5.2.0-next.99 → 6.0.0-next.1

package/dist/components/arcgis-features-next/customElement.d.ts

@@ -4,6 +4,7 @@ import type Collection from "@arcgis/core/core/Collection.js";
 import type ActionToggle from "@arcgis/core/support/actions/ActionToggle.js";
 import type Graphic from "@arcgis/core/Graphic.js";
 import type FeatureAbilities from "@arcgis/core/popup/support/FeatureAbilities.js";
+import type Point from "@arcgis/core/geometry/Point.js";
 import type Map from "@arcgis/core/Map.js";
 import type SpatialReference from "@arcgis/core/geometry/SpatialReference.js";
 import type { ActionEvent } from "@arcgis/core/widgets/Popup/types.js";
@@ -12,6 +13,7 @@ import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 import type { ArcgisFeatureNext } from "../arcgis-feature-next/customElement.js";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
 import type { PopupAction, InitialDisplayOptions, State } from "@arcgis/core/popup/types.js";
+import type { FetchPopupFeaturesDiagnostics } from "@arcgis/core/views/PopupView.js";
 import type { GoToOverride } from "@arcgis/core/widgets/support/types.js";
 import type { MapViewOrSceneView } from "@arcgis/core/views/MapViewOrSceneView.js";
 
@@ -36,6 +38,8 @@ import type { MapViewOrSceneView } from "@arcgis/core/views/MapViewOrSceneView.j
  * The Features (next) component should be used if needing to use the Popup functionality outside of the map or scene component. To show a single feature's content without
  * actions, related records, clustering configuration, etc., then use the [arcgis-feature-next](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-next/) component.
  *
+ * @slot [actions-start] - _Since 5.2._ Slot for adding Calcite [actions](https://developers.arcgis.com/calcite-design-system/components/action/) or [action groups](https://developers.arcgis.com/calcite-design-system/components/action-group/) to the start of the action bar. Multiple actions or action groups can be placed in this slot. Slotted actions remain at the start of the action bar and are not automatically grouped if they exceed the available width. To group actions, place them in a Calcite action group. Actions in this slot remain separate from other actions, including default actions (such as "Zoom to" and "Browse features"), [PopupTemplate actions](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/#actions), and [actions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#actions).
+ * @slot [actions-end] - _Since 5.2._ Slot for adding Calcite [actions](https://developers.arcgis.com/calcite-design-system/components/action/) or [action groups](https://developers.arcgis.com/calcite-design-system/components/action-group/) to the end of the action bar. Multiple actions or action groups can be placed in this slot. Slotted actions remain at the end of the action bar and are not automatically grouped if they exceed the available width. To group actions, place them in a Calcite action group. Actions in this slot remain separate from other actions, including default actions (such as "Zoom to" and "Browse features"), [PopupTemplate actions](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/#actions), and [actions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#actions).
  * @see [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/)
  * @see [arcgis-feature-next](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-next/)
  * @see [arcgis-popup](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/)
@@ -54,7 +58,7 @@ export abstract class ArcgisFeaturesNext extends LitElement {
    */
   accessor actions: Collection<PopupAction>;
   /**
-   * Indicates if the component is active when it is visible and is not [waiting](https://developers.arcgis.com/javascript/latest/references/core/popup/FeatureContentCollection/#waitingForResult) for results.
+   * Indicates if the component is active when it is visible and is not [waiting](https://developers.arcgis.com/javascript/latest/references/core/popup/FeaturesModel/#waitingForResult) for results.
    *
    * @default false
    */
@@ -120,6 +124,12 @@ export abstract class ArcgisFeaturesNext extends LitElement {
    * @default false
    */
   accessor defaultPopupTemplateEnabled: boolean;
+  /**
+   * Diagnostics collected while fetching features from a view.
+   *
+   * @since 5.2
+   */
+  accessor diagnostics: FetchPopupFeaturesDiagnostics | null | undefined;
   /**
    * The heading currently displayed for the selected feature. This value resolves to the selected feature's [PopupTemplate title](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/#title) when available, otherwise it falls back to the component's [heading](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#heading).
    *
@@ -384,12 +394,17 @@ export abstract class ArcgisFeaturesNext extends LitElement {
   accessor includeDefaultActionsDisabled: boolean;
   /**
    * Indicates whether to initially display a list of features, or the content for one feature.
-   *
-   * @default "feature"
+   * By default, a list is displayed when the associated view has `focusRegionEnabled` enabled; otherwise, the content for one feature is displayed.
    */
   accessor initialDisplayMode: InitialDisplayOptions;
   /** The component's default label. */
   accessor label: string | undefined;
+  /**
+   * The [Point](https://developers.arcgis.com/javascript/latest/references/core/geometry/Point/) representing the location of the map interaction used to trigger the opening of the component.
+   *
+   * @since 5.2
+   */
+  accessor location: Point | null | undefined;
   /**
    * A map is required when the input [features](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#features) have a popupTemplate that contains [Arcade](https://developers.arcgis.com/arcade) expressions in [ExpressionInfo](https://developers.arcgis.com/javascript/latest/references/core/popup/ExpressionInfo/) or [ExpressionContent](https://developers.arcgis.com/javascript/latest/references/core/popup/content/ExpressionContent/) that may use the `$map` profile variable to access data from layers within a map. Without a map, expressions that use `$map` will throw an error.
    *
@@ -440,8 +455,9 @@ export abstract class ArcgisFeaturesNext extends LitElement {
       returnToInitialFeature?: string | undefined;
       maxRecordCountHeading?: string | undefined;
       maxRecordCountDescriptionWithLayerList?: string | undefined;
+      maxRecordCountDescriptionRefineResults?: string | undefined;
       maxRecordCountDescriptionMultipleLayers?: string | undefined;
-      maxRecordCountDescriptionMaxZoomLevel?: string | undefined;
+      maxRecordCountDescriptionRefineResultsMaxZoomLevel?: string | undefined;
   };
   /** @internal */
   protected messages: Partial<{
@@ -474,8 +490,9 @@ export abstract class ArcgisFeaturesNext extends LitElement {
       returnToInitialFeature: string;
       maxRecordCountHeading: string;
       maxRecordCountDescriptionWithLayerList: string;
+      maxRecordCountDescriptionRefineResults: string;
       maxRecordCountDescriptionMultipleLayers: string;
-      maxRecordCountDescriptionMaxZoomLevel: string;
+      maxRecordCountDescriptionRefineResultsMaxZoomLevel: string;
   }> & T9nMeta<{
       componentLabel: string;
       zoom: string;
@@ -506,8 +523,9 @@ export abstract class ArcgisFeaturesNext extends LitElement {
       returnToInitialFeature: string;
       maxRecordCountHeading: string;
       maxRecordCountDescriptionWithLayerList: string;
+      maxRecordCountDescriptionRefineResults: string;
       maxRecordCountDescriptionMultipleLayers: string;
-      maxRecordCountDescriptionMaxZoomLevel: string;
+      maxRecordCountDescriptionRefineResultsMaxZoomLevel: string;
   }>;
   /**
    * Indicates whether the component is visible. This property is `true` when the component is querying for results, even if it is not open. Use this property to check if the component is visible.
@@ -592,7 +610,7 @@ export abstract class ArcgisFeaturesNext extends LitElement {
    *
    * **Possible Values**
    * - `system`: Dates and times will be displayed in the timezone of the device or browser.
-   * - `unknown`: Dates and time are not adjusted for any timezone.
+   * - `unknown`: Dates and times are not adjusted for any timezone.
    * - `Specified IANA timezone`: 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).
    *
    * @since 5.1
@@ -647,8 +665,8 @@ export abstract class ArcgisFeaturesNext extends LitElement {
   /** Emitted when the component's close button is clicked. */
   readonly arcgisClose: import("@arcgis/lumina").TargetedEvent<this, void>;
   /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
-  readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "active" | "collapsed" | "effectiveHeading" | "featureCount" | "featureMenuOpen" | "features" | "promises" | "selectedDrillInFeature" | "selectedFeature" | "selectedFeatureComponent" | "selectedFeatureIndex" | "state" | "open"; }>;
-  /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
+  readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "active" | "collapsed" | "effectiveHeading" | "featureCount" | "featureMenuOpen" | "features" | "selectedDrillInFeature" | "selectedFeature" | "selectedFeatureComponent" | "selectedFeatureIndex" | "state" | "open"; }>;
+  /** Emitted when the component associated with a map or scene view is ready for user interaction. */
   readonly arcgisReady: import("@arcgis/lumina").TargetedEvent<this, void>;
   /**
    * Fires after the user clicks on an action in the component.