@arcgis/core 5.0.0-next.51 → 5.0.0-next.53

package/widgets/Features/FeaturesVisibleElements.d.ts

@@ -0,0 +1,72 @@
+import type Accessor from "../../core/Accessor.js";
+
+export interface FeaturesVisibleElementsProperties extends Partial<Pick<FeaturesVisibleElements, "actionBar" | "closeButton" | "collapseButton" | "featureListLayerTitle" | "featureMenuHeading" | "featureNavigation" | "flow" | "heading" | "spinner">> {}
+
+/**
+ * The visible elements that are displayed within the widget.
+ * This provides the ability to turn individual elements of the widget's display on/off.
+ * Disabling all `visibleElements` on the Features widget allows the look and feel of the [Feature](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Feature.html) widget, while supporting related record browsing and clustering.
+ *
+ * ![popup-visibleElements](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/popup/popup-visible-elements.png)
+ */
+export default abstract class FeaturesVisibleElements extends Accessor {
+  /**
+   * Indicates whether to display the action bar that holds the feature's [FeaturesViewModel#actions](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html#actions) will be displayed.
+   *
+   * @default true
+   */
+  accessor actionBar: boolean;
+  /**
+   * Indicates whether to display a close button on the widget dialog.
+   *
+   * @default true
+   */
+  accessor closeButton: boolean;
+  /**
+   * **Since 4.28.** Indicates whether to display the collapse button on the widget dialog.
+   *
+   * @default false
+   */
+  accessor collapseButton: boolean;
+  /**
+   * **Since 4.30.** Indicates whether to display the group heading for a list of multiple features.
+   *
+   * ![popup-visibleElements-featureListLayerTitle](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/popup/popup-listlayertitle-true2.png)
+   *
+   * @default true
+   */
+  accessor featureListLayerTitle: boolean;
+  /**
+   * **Since 4.32.** Indicates whether to display a heading and description on the widget feature menu list.
+   *
+   * @default true
+   */
+  accessor featureMenuHeading: boolean;
+  /**
+   * Indicates whether pagination for feature navigation will be displayed. This allows the user to scroll through various [selected features](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features.html#features) using pagination arrows.
+   *
+   * @default true
+   */
+  accessor featureNavigation: boolean;
+  /**
+   * **Since 4.29.** Determines whether the widget should be shown within its built-in [flow component](https://developers.arcgis.com/calcite-design-system/components/flow/) or if the flow component should be excluded.
+   * The widget will be displayed within its original flow component if set to `true`.
+   * The flow component will be omitted from the widget if set to `false`.
+   * To place the widget into an existing Calcite flow component, set this property to `false`.
+   *
+   * @default true
+   */
+  accessor flow: boolean;
+  /**
+   * Indicates whether to display the widget heading.
+   *
+   * @default true
+   */
+  accessor heading: boolean;
+  /**
+   * Indicates whether to display the widget's loading spinner.
+   *
+   * @default true
+   */
+  accessor spinner: boolean;
+}

package/widgets/Features.d.ts

@@ -1,4 +1,502 @@
-import "../interfaces";
+import type Graphic from "../Graphic.js";
+import type EsriMap from "../Map.js";
+import type Collection from "../core/Collection.js";
+import type SpatialReference from "../geometry/SpatialReference.js";
+import type ActionBase from "../support/actions/ActionBase.js";
+import type Feature from "./Feature.js";
+import type Widget from "./Widget.js";
+import type FeaturesViewModel from "./Features/FeaturesViewModel.js";
+import type FeaturesVisibleElements from "./Features/FeaturesVisibleElements.js";
+import type { ScreenPoint } from "../core/interfaces.js";
+import type { SpatialReferenceProperties } from "../geometry/SpatialReference.js";
+import type { TimeZone } from "../time/interfaces.js";
+import type { MapViewOrSceneView } from "../views/MapViewOrSceneView.js";
+import type { FetchPopupFeaturesResult } from "../views/interfaces.js";
+import type { WidgetProperties } from "./Widget.js";
+import type { FeatureContentMixin, FeatureContentMixinProperties } from "./Feature/support/FeatureContentMixin.js";
+import type { FeaturesViewModelEvents, FeaturesViewModelProperties } from "./Features/FeaturesViewModel.js";
+import type { PopupOpenOptions, FetchFeaturesOptions, InitialDisplayOptions } from "./Popup/interfaces.js";
+import type { GoToOverride } from "./support/goToUtils.js";
+import type { HeadingLevel } from "./support/Heading.js";
+import type { ActionBaseProperties } from "../support/actions/ActionBase.js";
+import type { ReadonlyArrayOrCollection } from "../core/Collection.js";
+import type { FeaturesVisibleElementsProperties } from "./Features/FeaturesVisibleElements.js";
 
-import Features = __esri.Features;
-export default Features;
+export interface FeaturesProperties extends WidgetProperties, FeatureContentMixinProperties, Partial<Pick<Features, "collapsed" | "content" | "featureNavigationTop" | "features" | "goToOverride" | "headingLevel" | "initialDisplayMode" | "map" | "promises" | "selectedFeatureIndex" | "timeZone" | "title" | "view">> {
+  /**
+   * The actions that are displayed in the header of the widget.
+   *
+   * @since 4.32
+   */
+  headerActions?: ReadonlyArrayOrCollection<ActionBaseProperties>;
+  /**
+   * The widget's default label.
+   *
+   * @since 4.11
+   */
+  label?: string | null;
+  /**
+   * The spatial reference used for [Arcade](https://developers.arcgis.com/arcade) operations.
+   * This property should be set if the Features widget executes Arcade expressions that contain [geometry functions](https://developers.arcgis.com/arcade/function-reference/geometry_functions/).
+   *
+   * Alternatively, the [view](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features.html#view) property can be used to provide the spatial reference instance for this property.
+   *
+   * @since 4.30
+   * @see [Type system](https://developers.arcgis.com/arcade/guide/types/#featuresetcollection)
+   * @see [Arcade Profiles: Popup](https://developers.arcgis.com/arcade/profiles/popup/)
+   */
+  spatialReference?: SpatialReferenceProperties | null;
+  /**
+   * This is a class that contains all the logic
+   * (properties and methods) that controls this widget's behavior. See the
+   * [FeaturesViewModel](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html) class to access
+   * all properties and methods on the widget.
+   */
+  viewModel?: FeaturesViewModelProperties;
+  /**
+   * Indicates whether the widget is visible.
+   *
+   * @example
+   * // Hides the widget in the view
+   * widget.visible = false;
+   */
+  visible?: boolean;
+  /**
+   * The visible elements that are displayed within the widget.
+   * This provides the ability to turn individual elements of the widget's display on/off.
+   */
+  visibleElements?: FeaturesVisibleElementsProperties;
+}
+
+export type FeaturesOpenOptions = Partial<Pick<PopupOpenOptions, "actions" | "collapsed" | "content" | "features" | "fetchFeatures" | "featureMenuOpen" | "featureMenuTitle" | "location" | "promises" | "title" | "updateLocationEnabled">>;
+
+export interface FeaturesEvents extends FeaturesViewModelEvents {}
+
+/**
+ * The Features widget allows users to view a feature's popupTemplate content such as attributes,
+ * actions, related records, etc., without having to be tied to the [View](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View.html).
+ * This widget looks and behaves similarly to the [Popup](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Popup.html) widget,
+ * however unlike Popup, the Features widget can be placed outside of the view.
+ * For example, when features are selected in the [View](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View.html),
+ * the [Popup](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Popup.html) widget opens within the View whether it is docked
+ * or anchored to the selected feature.
+ * With the Features widget, the same information that popup provides is shown in a separate container from the view, such as
+ * a HTML div within a Calcite Design System
+ * [Shell Panel](https://developers.arcgis.com/calcite-design-system/components/shell-panel/).
+ *
+ * [![features-widget-image](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/features-widget.png)](https://developers.arcgis.com/javascript/latest/sample-code/sandbox/?sample=widgets-features)
+ *
+ * In the image above, a Calcite shell panel displays the Features widget along with a MapView in a separate div.
+ * A generic `title` and `content` property can be set directly on the Features widget or
+ * each individual layer's [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) can be displayed (e.g.
+ * the Olympic National Park feature's PopupTemplate that contains text, media, and relationship elements).
+ * The action bar, shown below the title in the image above, displays [actions](https://developers.arcgis.com/javascript/latest/api-reference/esri-support-actions-ActionButton.html) that can be defined either on the widget level within the [open()](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features.html#open) method,
+ * with the [FeaturesViewModel#actions](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html#actions) property, or in the [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) of the layer.
+ * If multiple features are passed into the Features widget, the widget provides buttons to page though the features and a feature menu that allows the
+ * list of features to be displayed so the user can choose which feature content to display in the widget. The widget also respects
+ * feature reduction PopupTemplates for [binning](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-FeatureReductionBinning.html#popupTemplate) and [clustering](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-FeatureReductionCluster.html#popupTemplate).
+ *
+ * The Features widget should be used if needing to use the Popup functionality outside of the View. If wanting to show a single feature's content without
+ * actions, related records, clustering configuration, etc., then use the [Feature](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Feature.html) widget.
+ *
+ * @deprecated since 4.34. Use the [Features component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-features/) instead. For information on widget deprecation, read about [Esri's move to web components](https://developers.arcgis.com/javascript/latest/components-transition-plan/).
+ * @since 4.27
+ * @see [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html)
+ * @see [Guide - Esri Icon Font](https://developers.arcgis.com/javascript/latest/esri-icon-font/)
+ * @see [FeaturesViewModel](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html)
+ * @example
+ * // Create a new instance of Features and set this on the View's
+ * // popup. When features are selected in the map, the Features widget
+ * // will automatically open in its respective container.
+ * const view = new MapView({
+ *   container: "viewDiv",
+ *   map: map,
+ *   popup: new Features({
+ *     container: "features-widget"
+ *   })
+ * });
+ * @example
+ * // Create a new instance of Features and set the view property
+ * // to the View along with the container that holds the widget
+ * // such as a Calcite Shell Panel.
+ * const featuresWidget = new Features({
+ *   view: view,
+ *   container: "features-widget"
+ * });
+ *
+ * // Use reactiveUtils to watch for when the view has a click event
+ * // then open the Features widget in its respective container.
+ * reactiveUtils.on(()=> view, "click",
+ * (event)=>{
+ *   featuresWidget.open({
+ *     location: event.mapPoint,
+ *     fetchFeatures: true
+ *   })
+ * });
+ */
+export default class Features extends FeaturesSuperclass {
+  /**
+   * @deprecated
+   * Do not directly reference this property.
+   * Use EventNames and EventTypes helpers from \@arcgis/core/Evented
+   */
+  "@eventTypes": FeaturesEvents;
+  constructor(properties?: FeaturesProperties);
+  /**
+   * Indicates if the widget is active when it is visible and is not [waiting for results](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html#waitingForResult).
+   *
+   * @default false
+   * @since 4.30
+   */
+  get active(): boolean;
+  /**
+   * Indicates whether the popup displays its content. If `true`, only the header displays.
+   *
+   * @default false
+   */
+  accessor collapsed: boolean;
+  /**
+   * The content of the Features widget. When set directly on the Popup, this content is
+   * static and cannot use fields to set content templates. To set a template
+   * for the content based on field or attribute names, see
+   * [PopupTemplate#content](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html#content).
+   *
+   * @example
+   * // This sets generic instructions in the widget that will always be displayed
+   * // unless it is overridden by a PopupTemplate
+   * featuresWidget.content = "Click a feature on the map to view its attributes";
+   */
+  accessor content: FeaturesViewModel["content"];
+  /**
+   * Indicates whether the feature navigation arrows are displayed at the top of the widget.
+   * By default, the navigation arrows are displayed at the bottom of the widget.
+   *
+   * @default false
+   * @since 4.32
+   */
+  accessor featureNavigationTop: boolean;
+  /**
+   * An array of features associated with the Features widget. Each graphic in this array must
+   * have a valid [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) set. They may share the same
+   * [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) or have unique
+   * [PopupTemplates](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) depending on their attributes.
+   * The [content](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features.html#content) and [title](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features.html#title)
+   * of the widget is set based on the `content` and `title` properties of each graphic's respective
+   * [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html).
+   *
+   * When more than one graphic exists in this array, the current content of the
+   * Features widget is set based on the value of the [selected feature](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features.html#selectedFeature).
+   *
+   * This value is `null` if no features are associated with the widget.
+   *
+   * @example
+   * // When setting the features property, the graphics pushed to this property
+   * // must have a PopupTemplate set.
+   * let g1 = new Graphic();
+   * g1.popupTemplate = new PopupTemplate({
+   *   title: "Results title",
+   *   content: "Results: {ATTRIBUTE_NAME}"
+   * });
+   * // Set the graphics as an array to the Features widget instance. The content and title of
+   * // the widget will be set depending on the PopupTemplate of the graphics.
+   * // Each graphic may share the same PopupTemplate or have a unique PopupTemplate
+   * let graphics = [g1, g2, g3, g4, g5];
+   * const featuresWidget = new Features({
+   *   container: "features-widget",
+   *   features: graphics
+   *   visible: true
+   * });
+   */
+  accessor features: Graphic[];
+  /**
+   * This function provides the ability to override either the
+   * [MapView goTo()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#goTo) or
+   * [SceneView goTo()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#goTo) methods.
+   *
+   * @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)
+   * @example
+   * // The following snippet uses Search but can be applied to any
+   * // widgets that support the goToOverride property.
+   * search.goToOverride = function(view, goToParams) {
+   *   goToParams.options = {
+   *     duration: updatedDuration
+   *   };
+   *   return view.goTo(goToParams.target, goToParams.options);
+   * };
+   */
+  accessor goToOverride: GoToOverride | null | undefined;
+  /**
+   * The actions that are displayed in the header of the widget.
+   *
+   * @since 4.32
+   */
+  get headerActions(): Collection<ActionBase>;
+  set headerActions(value: ReadonlyArrayOrCollection<ActionBaseProperties>);
+  /**
+   * Indicates the heading level to use for the [title](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features.html#title) of the widget.
+   * By default, the title is rendered
+   * as a level 2 heading (e.g. `<h2>Popup title</h2>`). Depending on the widget's placement
+   * in your app, you may need to adjust this heading for proper semantics. This is
+   * important for meeting accessibility standards.
+   *
+   * @default 2
+   */
+  accessor headingLevel: HeadingLevel;
+  /**
+   * Indicates whether to initially display a list of features, or the content for one feature.
+   *
+   * @default "feature"
+   * @since 4.32
+   */
+  accessor initialDisplayMode: InitialDisplayOptions;
+  /**
+   * The widget's default label.
+   *
+   * @since 4.11
+   */
+  get label(): string;
+  set label(value: string | null | undefined);
+  /**
+   * A map is required when the input [features](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features.html#features) have a popupTemplate that contains [Arcade](https://developers.arcgis.com/arcade) expressions in [ExpressionInfo](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-ExpressionInfo.html) or [ExpressionContent](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-ExpressionContent.html) 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.
+   *
+   * Alternatively, the [view](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features.html#view) property can be used to provide the map instance for this property.
+   *
+   * @since 4.30
+   * @see [Type system](https://developers.arcgis.com/arcade/guide/types/#featuresetcollection)
+   * @see [Arcade Profiles: Popup](https://developers.arcgis.com/arcade/profiles/popup/)
+   * @example
+   * // The building footprints represent the buildings that intersect a clicked parcel
+   * let buildingFootprints = Intersects($feature, FeatureSetByName($map, "Building Footprints"));
+   */
+  accessor map: EsriMap | null | undefined;
+  /**
+   * An array of pending Promises that have not yet been fulfilled. If there are
+   * 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/api-reference/esri-widgets-Features.html#features) array.
+   */
+  accessor promises: Promise<Graphic[]>[];
+  /**
+   * The feature that the widget has drilled into.
+   * This feature is either associated with the selected feature in a [relationship element](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-RelationshipContent.html) or [utility network association element](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-UtilityNetworkAssociationsContent.html).
+   *
+   * @since 4.32
+   */
+  get selectedDrillInFeature(): Graphic | null | undefined;
+  /**
+   * The selected feature accessed by the Features widget. The content displayed in the widget is
+   * determined based on the [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) assigned to this feature.
+   */
+  get selectedFeature(): Graphic | null;
+  /**
+   * Index of the feature that is [selected](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features.html#selectedFeature). When [features](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features.html#features) are set,
+   * the first index is automatically selected.
+   */
+  accessor selectedFeatureIndex: number;
+  /**
+   * Returns a reference to the current [Feature](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Feature.html).
+   * This is useful if needing to get a reference to the Feature widget in order to make any changes to it.
+   */
+  get selectedFeatureWidget(): Feature | null;
+  /**
+   * The spatial reference used for [Arcade](https://developers.arcgis.com/arcade) operations.
+   * This property should be set if the Features widget executes Arcade expressions that contain [geometry functions](https://developers.arcgis.com/arcade/function-reference/geometry_functions/).
+   *
+   * Alternatively, the [view](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features.html#view) property can be used to provide the spatial reference instance for this property.
+   *
+   * @since 4.30
+   * @see [Type system](https://developers.arcgis.com/arcade/guide/types/#featuresetcollection)
+   * @see [Arcade Profiles: Popup](https://developers.arcgis.com/arcade/profiles/popup/)
+   */
+  get spatialReference(): SpatialReference | null | undefined;
+  set spatialReference(value: SpatialReferenceProperties | null | undefined);
+  /**
+   * Dates and times displayed in the widget will be displayed in this time zone. By default this time zone is
+   * inherited from [MapView#timeZone](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#timeZone) if the [view](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features.html#view) property is set. When a MapView is not associated with the widget
+   * then the property will fallback to the `system` time zone.
+   *
+   * **Possible Values**
+   *
+   * Value | Description |
+   * ----- | ----------- |
+   * 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.
+   * 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 4.30
+   */
+  accessor timeZone: TimeZone;
+  /**
+   * The title of the Features widget. This can be set to any string value no
+   * matter the features that are selected. If the [selected feature](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features.html#selectedFeature)
+   * has a [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html), then the title set in the
+   * corresponding template is used here.
+   *
+   * @see [headingLevel](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features.html#headingLevel)
+   * @example
+   * // This title will display in the widget unless a selected feature's
+   * // PopupTemplate overrides it.
+   * featuresWidget.title = "Population by zip codes in Southern California";
+   */
+  accessor title: string | null | undefined;
+  /**
+   * A reference to the [MapView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html) or [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html). Set this to link the widget to a specific view.
+   *
+   * > [!WARNING]
+   * >
+   * > The Features widget requires a view if:
+   * > - The [features](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features.html#features) have a popupTemplate containing Arcade expressions in [ExpressionInfo](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-ExpressionInfo.html) or [ExpressionContent](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-ExpressionContent.html) that may use [geometry functions](https://developers.arcgis.com/arcade/function-reference/geometry_functions/) or reference the `$map` profile variable (i.e. access data from layers within a map). Alternatively, set the [map](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features.html#map) property.
+   * > - Content is displayed from the popup template of an [aggregate feature](https://developers.arcgis.com/javascript/latest/api-reference/esri-Graphic.html#isAggregate) (i.e. a [cluster](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-FeatureReductionCluster.html) or [bin](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-FeatureReductionBinning.html)).
+   * > - Values from `date` and `timestamp-offset` {@link layers/support/Field#types fields} should respect the view's [time zone](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#timeZone). Alternatively, set the [timeZone](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features.html#timeZone) property.
+   * > - Using the [fetchFeatures()](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features.html#fetchFeatures) method or the `fetchFeatures` option in the [open()](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features.html#open) method.
+   * > - Using the `Zoom to` default action. If the `view` is not specified, set the [FeaturesViewModel#includeDefaultActions](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html#includeDefaultActions) property to `false` to remove this default action.
+   */
+  accessor view: MapViewOrSceneView | null | undefined;
+  /**
+   * This is a class that contains all the logic
+   * (properties and methods) that controls this widget's behavior. See the
+   * [FeaturesViewModel](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html) class to access
+   * all properties and methods on the widget.
+   */
+  get viewModel(): FeaturesViewModel;
+  set viewModel(value: FeaturesViewModelProperties);
+  /**
+   * Indicates whether the widget is visible.
+   *
+   * @example
+   * // Hides the widget in the view
+   * widget.visible = false;
+   */
+  accessor visible: boolean;
+  /**
+   * The visible elements that are displayed within the widget.
+   * This provides the ability to turn individual elements of the widget's display on/off.
+   */
+  get visibleElements(): FeaturesVisibleElements;
+  set visibleElements(value: FeaturesVisibleElementsProperties);
+  /** Use this method to remove focus from the Widget. */
+  blur(): void;
+  /**
+   * Removes [promises](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features.html#promises), [features](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features.html#features), [content](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features.html#content), and
+   * [title](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features.html#title) from the Features widget.
+   */
+  clear(): void;
+  /**
+   * This is a convenience method to closes the widget. Users can alternatively close the widget
+   * by directly setting the [visible](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features.html#visible) property to `false`.
+   *
+   * @see [visible](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features.html#visible)
+   */
+  close(): void;
+  /**
+   * Use this method to return feature(s) at a given screen location.
+   * These features are fetched from all of the [layer views](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-layers-LayerView.html)
+   * 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). This method allows a developer to
+   * control how the input location is handled.
+   *
+   * @param screenPoint - An object representing a point on the screen. This point can be in either the
+   * [ScreenPoint](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-interfaces.html#ScreenPoint) or
+   * [ScreenPoint](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-interfaces.html#ScreenPoint).
+   * @param options - The [options](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Popup-interfaces.html#FetchFeaturesOptions)
+   * to pass into the `fetchFeatures` method.
+   * @returns Resolves with the selected `hitTest`
+   * location. In addition, it also returns an array of [graphics](https://developers.arcgis.com/javascript/latest/api-reference/esri-Graphic.html) if the `hitTest` is
+   * performed directly on the [View](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View.html), a single Promise containing an array of all resulting
+   * [graphics](https://developers.arcgis.com/javascript/latest/api-reference/esri-Graphic.html), or an array of objects containing this array of resulting [graphics](https://developers.arcgis.com/javascript/latest/api-reference/esri-Graphic.html) in addition to its associated
+   * [LayerView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-layers-LayerView.html).
+   *
+   * Most commonly if accessing all features, use the single promise returned in the
+   * [result's allGraphicsPromise](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Popup-interfaces.html#FetchFeaturesOptions) and call `.then()`
+   * as seen in the example snippet.
+   * @example
+   * // Use reactiveUtils to watch the view's click event.
+   * reactiveUtils.on(() => view, "click",
+   * (event) => {
+   *   // Call fetchFeatures and pass in the click event screenPoint
+   *   featuresWidget.fetchFeatures(event.screenPoint).then((response) => {
+   *     // Access the response from fetchFeatures
+   *     response.allGraphicsPromise.then((graphics) => {
+   *     // If there are no graphics in the click event, then make sure
+   *     // the Features widget is not showing.
+   *       if(graphics.length === 0){
+   *         featuresWidget.visible = false;
+   *       }
+   *       // If graphics do exist, set the Features widget features property to the returned
+   *       // graphics from fetchFeatures and set the visible property to true.
+   *       else{
+   *         featuresWidget.features = graphics;
+   *         featuresWidget.visible = true;
+   *       }
+   *     });
+   *   });
+   */
+  fetchFeatures(screenPoint: ScreenPoint, options?: FetchFeaturesOptions): Promise<FetchPopupFeaturesResult>;
+  /** Use this method to give focus to the Widget if the widget is able to be focused. */
+  focus(): void;
+  /**
+   * Selects the feature at the next index in relation to the selected feature.
+   *
+   * @returns Returns an instance of the popup's view model.
+   * @see [selectedFeatureIndex](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features.html#selectedFeatureIndex)
+   */
+  next(): FeaturesViewModel;
+  /**
+   * Opens the Features widget in its [container](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features.html#container) with content defined either explicitly with `content`
+   * or driven from the [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) of input features. This method sets
+   * the Feature widget's [visible](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features.html#visible) property to `true`. Users can alternatively show the Features widget
+   * by directly setting the [visible](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features.html#visible) property to `true`.
+   *
+   * @param options - Defines the content of the Feature's widget when opened.
+   * @see [visible](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features.html#visible)
+   * @example
+   * // Use reactiveUtils to watch the view's click event.
+   * reactiveUtils.on(() => view, "click",
+   * (event) => {
+   *   featuresWidget.open({
+   *     // Title and content displayed in the widget
+   *     title: `Click location: (${event.mapPoint.x},${event.mapPoint.y})`,
+   *     content: "This is the default content displayed on click."
+   *   });
+   * });
+   * @example
+   * // The Features widget must have a view set on the widget along with the
+   * // location property to fetch features.
+   * // Use reactiveUtils to watch the view's click event.
+   * reactiveUtils.on(() => view, "click",
+   * (event) => {
+   *   featuresWidget.open({
+   *     location: event.mapPoint,
+   *     // Display the content for the selected feature(s) if a popupTemplate is defined.
+   *     fetchFeatures: true
+   *   });
+   * });
+   * @example
+   * // Open the Features widget with a specified array of graphics that already
+   * // have a PopupTemplate set and display the feature menu when it opens.
+   * featuresWidget.open({
+   *   // array of graphics
+   *   features: graphics,
+   *   // selected features initially display in a list
+   *   featureMenuOpen: true
+   * });
+   */
+  open(options?: FeaturesOpenOptions): void;
+  /**
+   * Selects the feature at the previous index in relation to the selected feature.
+   *
+   * @returns Returns an instance of the Features widget view model.
+   * @see [selectedFeatureIndex](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features.html#selectedFeatureIndex)
+   */
+  previous(): FeaturesViewModel;
+  /**
+   * Triggers the [@trigger-action](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features.html#event-trigger-action) event and executes the [action](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html#actions)
+   * at the specified index in the [FeaturesViewModel#actions](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html#actions) array.
+   *
+   * @param actionIndex - The index of the {@link widgets/Features#actions action} to execute.
+   */
+  triggerAction(actionIndex: number): void;
+}
+declare const FeaturesSuperclass: typeof Widget & typeof FeatureContentMixin

package/widgets/FloorFilter/FloorFilterViewModel.d.ts

@@ -1,4 +1,39 @@
-import "../../interfaces";
+import type Accessor from "../../core/Accessor.js";
+import type { MapViewOrSceneView } from "../../views/MapViewOrSceneView.js";
+import type { GoTo, GoToProperties } from "../support/GoTo.js";
 
-import FloorFilterViewModel = __esri.FloorFilterViewModel;
-export default FloorFilterViewModel;
+export interface FloorFilterViewModelProperties extends GoToProperties, Partial<Pick<FloorFilterViewModel, "facility" | "level" | "longNames" | "site" | "view">> {}
+
+/**
+ * Provides the logic for the [FloorFilter](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-FloorFilter.html) widget and [component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-floor-filter/).
+ *
+ * @since 4.19
+ * @see [FloorFilter](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-FloorFilter.html) widget
+ * @see [Floor Filter component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-floor-filter/)
+ * @see [Programming patterns: Widget viewModel pattern](https://developers.arcgis.com/javascript/latest/programming-patterns/#widget-viewmodel-pattern)
+ */
+export default class FloorFilterViewModel extends FloorFilterViewModelSuperclass {
+  constructor(properties?: FloorFilterViewModelProperties);
+  /** The currently selected facility. */
+  accessor facility: string | null | undefined;
+  /** The currently selected level. */
+  accessor level: string | null | undefined;
+  /**
+   * Determines if the widget is expanded or collapsed.
+   * If the value is `true`, the widget is expanded and the long names appear.
+   * Otherwise, short names are used and icons appear alone on buttons.
+   *
+   * @default false
+   */
+  accessor longNames: boolean;
+  /** The currently selected site. */
+  accessor site: string | null | undefined;
+  /**
+   * A reference to the [MapView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html) or [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html).
+   * If this property is set, the FloorFilter widget will update the view's [MapView#floors](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#floors)
+   * property whenever the floor filter is manipulated or updated programmatically. This property will affect
+   * any floor-aware layer in the view.
+   */
+  accessor view: MapViewOrSceneView | null | undefined;
+}
+declare const FloorFilterViewModelSuperclass: typeof Accessor & typeof GoTo