@arcgis/map-components 5.2.0-next.16 → 5.2.0-next.160

package/dist/components/arcgis-feature-table/customElement.d.ts

@@ -1,10 +1,10 @@
 /// <reference path="../../index.d.ts" />
 import type FeatureTable from "@arcgis/core/widgets/FeatureTable.js";
-import type RelationshipColumn from "@arcgis/core/widgets/FeatureTable/RelationshipColumn.js";
-import type GroupColumn from "@arcgis/core/widgets/FeatureTable/Grid/GroupColumn.js";
-import type Column from "@arcgis/core/widgets/FeatureTable/Grid/Column.js";
-import type AttachmentsColumn from "@arcgis/core/widgets/FeatureTable/AttachmentsColumn.js";
 import type ActionColumn from "@arcgis/core/widgets/FeatureTable/ActionColumn.js";
+import type AttachmentsColumn from "@arcgis/core/widgets/FeatureTable/AttachmentsColumn.js";
+import type Column from "@arcgis/core/widgets/FeatureTable/Grid/Column.js";
+import type GroupColumn from "@arcgis/core/widgets/FeatureTable/Grid/GroupColumn.js";
+import type RelationshipColumn from "@arcgis/core/widgets/FeatureTable/RelationshipColumn.js";
 import type LinkChartView from "@arcgis/core/views/LinkChartView.js";
 import type AttributeTableTemplate from "@arcgis/core/tables/AttributeTableTemplate.js";
 import type Collection from "@arcgis/core/core/Collection.js";
@@ -15,11 +15,11 @@ import type Relationship from "@arcgis/core/layers/support/Relationship.js";
 import type SelectionManager from "@arcgis/core/views/SelectionManager.js";
 import type TableTemplate from "@arcgis/core/widgets/FeatureTable/support/TableTemplate.js";
 import type TimeExtent from "@arcgis/core/time/TimeExtent.js";
+import type { CollectionChangeEvent } from "@arcgis/core/core/Collection.js";
+import type { DiscardPendingEditsParameters, FeatureStoreEdits, TableInteractionCellClickEvent, TableInteractionCellDblclickEvent, TableInteractionCellKeydownEvent, TableInteractionCellPointeroutEvent, TableInteractionCellPointeroverEvent, TableInteractionColumnReorderEvent, TableMenuConfig, GridMultiSortPriority, FeatureTableState } from "@arcgis/core/widgets/FeatureTable/Grid/types.js";
+import type { FeatureStoreItem, ActionColumnConfig, FeatureTableSupportedFilters, ColumnSortOrder, FeatureTableSupportedLayer } from "@arcgis/core/widgets/FeatureTable/support/types.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 import type { ArcgisReferenceElement, IconName } from "../types.js";
-import type { FeatureStoreItem, ActionColumnConfig, FeatureTableSupportedFilters, ColumnSortOrder, FeatureTableSupportedLayer } from "@arcgis/core/widgets/FeatureTable/support/types.js";
-import type { CollectionChangeEvent } from "@arcgis/core/core/Collection.js";
-import type { DiscardPendingEditsParameters, FeatureStoreEdits, TableInteractionColumnReorderEvent, TableInteractionCellPointeroverEvent, TableInteractionCellPointeroutEvent, TableInteractionCellKeydownEvent, TableInteractionCellClickEvent, TableInteractionCellDblclickEvent, TableMenuConfig, GridMultiSortPriority, FeatureTableState } from "@arcgis/core/widgets/FeatureTable/Grid/types.js";
 import type { MapViewOrSceneView } from "@arcgis/core/views/MapViewOrSceneView.js";
 import type { FeatureTableDescriptionFunction, FeatureTableTitleFunction } from "@arcgis/core/widgets/FeatureTable.js";
 import type { GeometryUnion } from "@arcgis/core/geometry/types.js";
@@ -33,10 +33,10 @@ import type { Icon } from "@esri/calcite-components/components/calcite-icon";
  */
 export abstract class ArcgisFeatureTable extends LitElement {
   /**
-   * Reference to the current [action column](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/ActionColumn/). This column is only generated if a [configuration](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#actionColumnConfig) has been provided.
+   * Reference to the current [action column](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/ActionColumn/). This column is only generated if a [configuration](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-table/#actionColumnConfig) has been provided.
    *
    * @since 4.33
-   * @see [actionColumnConfig](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#actionColumnConfig)
+   * @see [FeatureTable.actionColumnConfig](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-table/#actionColumnConfig)
    */
   get actionColumn(): ActionColumn | null | undefined;
   /**
@@ -50,7 +50,7 @@ export abstract class ArcgisFeatureTable extends LitElement {
    * ![featuretable action column](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/featuretable/action-column.avif)
    *
    * @since 4.30
-   * @see [actionColumn](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#actionColumn)
+   * @see [FeatureTable.actionColumn](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-table/#actionColumn)
    * @see [ActionColumn](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/ActionColumn/)
    * @see [Calcite Icon Search](https://developers.arcgis.com/calcite-design-system/icons/)
    * @see [Sample - FeatureTable with row highlighting](https://developers.arcgis.com/javascript/latest/sample-code/widgets-featuretable-row-highlights/)
@@ -117,7 +117,7 @@ export abstract class ArcgisFeatureTable extends LitElement {
    */
   accessor attachmentsEnabled: boolean;
   /**
-   * This read-only property provides the the configuration options for the attachments view.
+   * This read-only property provides the configuration options for the attachments view.
    *
    * @since 4.33
    */
@@ -127,7 +127,7 @@ export abstract class ArcgisFeatureTable extends LitElement {
    *
    * > [!WARNING]
    * >
-   * > This property differs from the [tableTemplate](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#tableTemplate) property. The `tableTemplate` property provides more fine-grained control over how the table is rendered within the application by offering more advanced configurations such as custom cell rendering, column formatting, and more. It is useful for application-level development that remains within an application. Use the [attributeTableTemplate](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#attributeTableTemplate) property to access the table's settings across different applications. By using this property, the settings can be saved within a webmap or layer. Please refer to the [AttributeTableTemplate](https://developers.arcgis.com/javascript/latest/references/core/tables/AttributeTableTemplate/) and [TableTemplate](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/support/TableTemplate/) documentation for more information.
+   * > This property differs from the [tableTemplate](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-table/#tableTemplate) property. The `tableTemplate` property provides more fine-grained control over how the table is rendered within the application by offering more advanced configurations such as custom cell rendering, column formatting, and more. It is useful for application-level development that remains within an application. Use the `attributeTableTemplate` property to access the table's settings across different applications. By using this property, the settings can be saved within a webmap or layer. Please refer to the [AttributeTableTemplate](https://developers.arcgis.com/javascript/latest/references/core/tables/AttributeTableTemplate/) and [TableTemplate](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/support/TableTemplate/) documentation for more information.
    *
    * @since 4.31
    * @see [Sample - FeatureTable Component](https://developers.arcgis.com/javascript/latest/sample-code/feature-table/)
@@ -141,6 +141,15 @@ export abstract class ArcgisFeatureTable extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-feature-table auto-destroy-disabled></arcgis-feature-table>
+   * ```
+   *
+   * ```js
+   * featureTableElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**
@@ -156,6 +165,12 @@ export abstract class ArcgisFeatureTable extends LitElement {
    * @since 5.0
    */
   accessor autoSaveDisabled: boolean;
+  /**
+   * Indicates the number of pages currently cached in the store.
+   *
+   * @internal
+   */
+  get cachedPageCount(): number;
   /**
    * Indicates whether the table supports adding a related record based on the current relationship
    * configuration. This accounts for whether table is currently configured to show related features.
@@ -212,7 +227,7 @@ export abstract class ArcgisFeatureTable extends LitElement {
    */
   accessor description: string | FeatureTableDescriptionFunction | null | undefined;
   /**
-   * 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
    * @since 5.0
@@ -235,7 +250,7 @@ export abstract class ArcgisFeatureTable extends LitElement {
    */
   get effectiveSize(): number;
   /**
-   * A flattened array of all [field columns](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/FieldColumn/) within the table, including nested columns.
+   * A flattened array of all [field columns](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-table/#fieldColumns) within the table, including nested columns.
    *
    * @since 4.33
    */
@@ -316,7 +331,7 @@ export abstract class ArcgisFeatureTable extends LitElement {
    */
   get hasPendingEdits(): boolean;
   /**
-   * TODO
+   * A list of field names to hide in the table.
    *
    * @since 4.16
    * @see [TableTemplate](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/support/TableTemplate/)
@@ -329,7 +344,7 @@ export abstract class ArcgisFeatureTable extends LitElement {
    *   container: document.getElementById("tableDiv")
    * });
    * @example
-   * // Set this syntax if needing to display a default hidden field, e.g. 'CreationDate`
+   * // Set this syntax if needing to display a default hidden field, e.g. `date_created`
    * const featureTable = new FeatureTable({
    *   layer: featureLayer,
    *   view: view,
@@ -498,7 +513,7 @@ export abstract class ArcgisFeatureTable extends LitElement {
    */
   accessor hideTooltips: boolean;
   /**
-   * Indicates whether to highlight the associated feature when a row is selected by checking the corresponding checkbox. This property is only applicable when working with a map and the [view](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#view) property is set.
+   * Indicates whether to highlight the associated feature when a row is selected by checking the corresponding checkbox. This property is only applicable when working with a map and the [view](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-table/#view) property is set.
    *
    * @default false
    * @since 4.25
@@ -510,7 +525,6 @@ export abstract class ArcgisFeatureTable extends LitElement {
    * This property accepts and returns a collection of feature object IDs. Use this to access and control which features are currently selected in the table and subsequently highlighted within the map. Once an application sets a collection of object IDs, the table will select the corresponding row and highlight its feature within the map.
    *
    * @since 4.25
-   * @see [highlightEnabled](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#highlightEnabled)
    * @see [Sample - FeatureTable using a map](https://developers.arcgis.com/javascript/latest/sample-code/widgets-featuretable-map/)
    * @see [Sample - FeatureTable with popup interaction](https://developers.arcgis.com/javascript/latest/sample-code/widgets-featuretable-popup-interaction/)
    * @see [Sample - FeatureTable with related data](https://developers.arcgis.com/javascript/latest/sample-code/widgets-featuretable-relates/)
@@ -547,7 +561,7 @@ export abstract class ArcgisFeatureTable extends LitElement {
   get icon(): Icon["icon"];
   set icon(value: IconName);
   /**
-   * The user-provided number of total features accessed from the data source. This is used for initial load of the data store as opposed to querying a specified layer. Additionally, the table will query data counts to verify the data's integrity, or when requested via [refresh()](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#refresh).
+   * The user-provided number of total features accessed from the data source. This is used for initial load of the data store as opposed to querying a specified layer. Additionally, the table will query data counts to verify the data's integrity, or when requested via [refresh()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-table/#refresh).
    *
    * @since 4.31
    */
@@ -588,22 +602,31 @@ export abstract class ArcgisFeatureTable extends LitElement {
    * > [!WARNING]
    * > Use `layer`, `layerUrl`, `mapLayerId`, and `layerItemId` independently; only one should be set at a time.
    *
-   * @see [pageSize](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#pageSize)
+   * @see [FeatureTable.pageSize](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-table/#pageSize).
    */
   accessor layer: FeatureTableSupportedLayer | null | undefined;
   /**
    * The layer ID of a layer in the service.
-   * Use with `layerUrl` when the service contains multiple layers and you want to specify which layer to use.
+   * Use with [layerItemId](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-table/#layerItemId) when the service contains multiple layers and you want to specify which layer to use.
    *
-   * @since 5.1
-   * @internal
+   * @since 5.2
+   * @example
+   * ```html
+   * <arcgis-feature-table
+   *   layer-item-id="0777d381a2b249ed8c5243f7d0ca49f7"
+   *   reference-element="my-map"
+   *   layer-id="0">
+   * </arcgis-feature-table>
+   * ```
    */
   accessor layerId: number | undefined;
   /**
    * The portal item ID of a layer.
    *
+   *
    * > [!WARNING]
-   * > Use `layer`, `layerUrl`, `mapLayerId`, and `layerItemId` independently; only one should be set at a time.
+   * > * Use `layer`, `layerUrl`, `mapLayerId`, and `layerItemId` independently; only one should be set at a time.
+   * > * If referencing an item containing multiple layers, use [layerId](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-table/#layerId) or [tableId](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-table/#tableId) to specify which layer or standalone table to use.
    */
   accessor layerItemId: string | undefined;
   /**
@@ -649,7 +672,7 @@ export abstract class ArcgisFeatureTable extends LitElement {
    */
   accessor mapLayerId: string | undefined;
   /**
-   * This property is applicable when working with layers that contain a large number of features, as it provides the ability to limit the displayed total feature count. If [paginationEnabled](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#paginationEnabled) is `true`, and `maxSize` is greater than the current value of [pageSize](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#pageSize), multiple pages usually display. If `maxSize` is less than [pageSize](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#pageSize), a single page shows the total number of features limited to `maxSize`.
+   * This property is applicable when working with layers that contain a large number of features, as it provides the ability to limit the displayed total feature count. If [paginationEnabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-table/#paginationEnabled) is `true`, and `maxSize` is greater than the current value of [pageSize](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-table/#pageSize), multiple pages usually display. If `maxSize` is less than [pageSize](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-table/#pageSize), a single page shows the total number of features limited to `maxSize`.
    *
    * @since 4.31
    */
@@ -677,9 +700,8 @@ export abstract class ArcgisFeatureTable extends LitElement {
    *
    * @default false
    * @since 4.23
-   * @see [FieldColumnTemplate#initialSortPriority](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/support/FieldColumnTemplate/#initialSortPriority)
    * @see [FieldColumnTemplate#direction](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/support/FieldColumnTemplate/#direction)
-   * @see [sortColumn()](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#sortColumn)
+   * @see [FeatureTable.sortColumn](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-table/#sortColumn)
    * @see [Sample - FeatureTable with editing enabled](https://developers.arcgis.com/javascript/latest/sample-code/widgets-featuretable-editing/)
    * @see [Sample - FeatureTable](https://developers.arcgis.com/javascript/latest/sample-code/widgets-featuretable/)
    * @example
@@ -712,7 +734,7 @@ export abstract class ArcgisFeatureTable extends LitElement {
    */
   accessor multipleSortEnabled: boolean;
   /**
-   * This property can be used to determine how newly sorted columns are prioritized. By default, newly sorted columns are
+   * This property can be used to determine how newly-sorted columns are prioritized. By default, newly sorted columns are
    * given the highest sort priority.
    *
    * @default "prepend"
@@ -726,7 +748,7 @@ export abstract class ArcgisFeatureTable extends LitElement {
    * @default "m"
    * @since 4.33
    */
-  accessor navigationScale: "s" | "m" | "l";
+  accessor navigationScale: "l" | "m" | "s";
   /**
    * This property can be used to override the text displayed when the table is fully loaded but no rows are available.
    *
@@ -735,8 +757,8 @@ export abstract class ArcgisFeatureTable extends LitElement {
   accessor noDataMessage: string | null | undefined;
   /**
    * This property accepts and returns a collection of feature object IDs. Use this to access and control which features are currently visible in the table.
-   * When the collection is empty, all potential rows are displayed. Modifying object IDs is not supported while [filterBySelectionEnabled](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#filterBySelectionEnabled) is `true` as these properties are mutually exclusive.
-   * This filter can also be combined with [filterGeometry](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#filterGeometry) to display features that satisfy both conditions.
+   * When the collection is empty, all potential rows are displayed. Modifying object IDs is not supported while [filterBySelectionEnabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-table/#filterBySelectionEnabled) is `true` as these properties are mutually exclusive.
+   * This filter can also be combined with [filterGeometry](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-table/#filterGeometry) to display features that satisfy both conditions.
    *
    * @since 4.30
    */
@@ -748,19 +770,19 @@ export abstract class ArcgisFeatureTable extends LitElement {
    */
   accessor outFields: Array<string> | null | undefined;
   /**
-   * Number of pages of features to be displayed in the table, based on the total [number of features](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#size) and configured [pageSize](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#pageSize).
+   * Number of pages of features to be displayed in the table, based on the total [number of features](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-table/#size) and configured [pageSize](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-table/#pageSize).
    *
    * @since 4.31
    */
   get pageCount(): number;
   /**
-   * Represents the index of the page of the feature currently being displayed. The number of features per page can be adjusted by modifying the [pageSize](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#pageSize). [Pagination](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#paginationEnabled) must be enabled or the value of this property may not be not reliable due to virtualization of visible pages.
+   * Represents the index of the page of the feature currently being displayed. The number of features per page can be adjusted by modifying the [pageSize](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-table/#pageSize). [Pagination](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-table/#paginationEnabled) must be enabled or the value of this property may not be reliable due to virtualization of visible pages.
    *
    * @since 4.31
    */
   accessor pageIndex: number;
   /**
-   * The default page size used when displaying features within the table. By default, the page loads the first 50 features returned by the service. It can be used with [paginationEnabled](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#paginationEnabled) to display a subset of features.
+   * The default page size used when displaying features within the table. By default, the page loads the first 50 features returned by the service. It can be used with [paginationEnabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-table/#paginationEnabled) to display a subset of features.
    *
    * > [!WARNING]
    * >
@@ -772,7 +794,7 @@ export abstract class ArcgisFeatureTable extends LitElement {
    */
   accessor pageSize: number;
   /**
-   * Controls whether the table should only display a single page of features at any time. Current page can be determined via the [pageIndex](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#pageIndex) property. The current page can be modified by calling the [goToPage()](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#goToPage) method and passing in the desired [page index](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#pageIndex).
+   * Controls whether the table should only display a single page of features at any time. Current page can be determined via the [pageIndex](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-table/#pageIndex) property. The current page can be modified by calling the [goToPage()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-table/#goToPage) method and passing in the desired [page index](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-table/#pageIndex).
    *
    * @default false
    * @since 4.31
@@ -785,7 +807,7 @@ export abstract class ArcgisFeatureTable extends LitElement {
    */
   accessor referenceElement: ArcgisReferenceElement | string | undefined;
   /**
-   * Indicates whether to display any related records associated with rows within the table. Take note that related layers must be provided via the [layers](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#layers) property when there is no associated [view](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#view).
+   * Indicates whether to display any related records associated with rows within the table. Take note that related layers must be provided via the [layers](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-table/#layers) property when there is no associated [view](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-table/#view).
    *
    * @default false
    * @since 4.30
@@ -803,7 +825,7 @@ export abstract class ArcgisFeatureTable extends LitElement {
   /**
    * A collection of nested table instances. This is typically used to represent relationships between each other.
    * These are configured and managed by a single table component instance. Only applies if this particular table instance is responsible for managing all nested tables.
-   * Nested tables reference the main table controller via the [tableController](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#tableController) property.
+   * Nested tables reference the main table controller via the [tableController](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-table/#tableController) property.
    *
    * @since 4.31
    */
@@ -833,7 +855,7 @@ export abstract class ArcgisFeatureTable extends LitElement {
   accessor returnGeometryEnabled: boolean;
   /**
    * Indicates whether geometries fetched for the corresponding features contain M values, if supported.
-   * The [returnGeometryEnabled](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#returnGeometryEnabled) property must also be true.
+   * The [returnGeometryEnabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-table/#returnGeometryEnabled) property must also be true.
    *
    * > [!WARNING]
    * >
@@ -845,7 +867,7 @@ export abstract class ArcgisFeatureTable extends LitElement {
   accessor returnMEnabled: boolean;
   /**
    * Indicates whether the fetched features' geometries contain Z values. This is only applicable if Z-values are supported.
-   * The [returnGeometryEnabled](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#returnGeometryEnabled) property must also be true.
+   * The [returnGeometryEnabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-table/#returnGeometryEnabled) property must also be true.
    *
    * > [!WARNING]
    * >
@@ -856,7 +878,7 @@ export abstract class ArcgisFeatureTable extends LitElement {
    */
   accessor returnZEnabled: boolean;
   /**
-   * This property accepts and returns a collection of feature object IDs. It is used to access and control which rows display a darker background, i.e., highlighted. Take note that highlighted rows are not considered selected as this property is independent of the table's selection state. Use the [highlightIds](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#highlightIds) property to choose rows. Setting `rowHighlightIds` applies an alternative highlight style to an entire row or rows.
+   * This property accepts and returns a collection of feature object IDs. It is used to access and control which rows display a darker background, i.e., highlighted. Take note that highlighted rows are not considered selected as this property is independent of the table's selection state. Use the [highlightIds](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-table/#highlightIds) property to choose rows. Setting `rowHighlightIds` applies an alternative highlight style to an entire row or rows.
    *
    * >
    * > Use this property to highlight rows based on an event or action from another component (e.g. the view). For example, purposefully highlighting rows when hovering over a feature on the map or applying a "filter" via another component to call out specific rows in the table. Generally, this property is not modified based on table events but rather an event or action from a different component.
@@ -887,7 +909,6 @@ export abstract class ArcgisFeatureTable extends LitElement {
    * This is useful when applications want to share selection sets between components, without relying on the view's selection manager. This property is ignored if [syncViewSelection](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-table/#syncViewSelection) is `true`.
    *
    * @since 5.0
-   * @beta
    */
   accessor selectionManager: SelectionManager | null | undefined;
   /**
@@ -974,7 +995,6 @@ export abstract class ArcgisFeatureTable extends LitElement {
    *
    * @default false
    * @since 5.0
-   * @beta
    */
   accessor syncViewSelection: boolean;
   /**
@@ -988,6 +1008,21 @@ export abstract class ArcgisFeatureTable extends LitElement {
    * @default false
    */
   accessor tableDisabled: boolean;
+  /**
+   * The table ID of a layer in the service.
+   * Use with [layerItemId](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-table/#layerItemId) when the service contains multiple layers and tables, and you want to specify which table to use.
+   *
+   * @since 5.2
+   * @example
+   * ```html
+   * <arcgis-feature-table
+   *   layer-item-id="0777d381a2b249ed8c5243f7d0ca49f7"
+   *   reference-element="my-map"
+   *   table-id="0">
+   * </arcgis-feature-table>
+   * ```
+   */
+  accessor tableId: number | undefined;
   /**
    * Reference to a table instance that this table is directly related to.
    *
@@ -1001,7 +1036,7 @@ export abstract class ArcgisFeatureTable extends LitElement {
    *
    * > [!WARNING]
    * >
-   * > The `TableTemplate` provides more fine-grained control over how the table is rendered within the application by offering more advanced configurations such as custom cell rendering, column formatting, and more. `TableTemplate` is useful for application-level development that remains within an application. This property differs from the [attributeTableTemplate](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#attributeTableTemplate) property as that property should be used to access the table's settings across different applications. By using [attributeTableTemplate](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#attributeTableTemplate), the settings can be saved within a webmap or layer. Please refer to the [AttributeTableTemplate](https://developers.arcgis.com/javascript/latest/references/core/tables/AttributeTableTemplate/) and [TableTemplate](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/support/TableTemplate/) documentation for more information.
+   * > The `TableTemplate` provides more fine-grained control over how the table is rendered within the application by offering more advanced configurations such as custom cell rendering, column formatting, and more. `TableTemplate` is useful for application-level development that remains within an application. This property differs from the [attributeTableTemplate](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-table/#attributeTableTemplate) property as that property should be used to access the table's settings across different applications. By using [attributeTableTemplate](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-table/#attributeTableTemplate), the settings can be saved within a webmap or layer. Please refer to the [AttributeTableTemplate](https://developers.arcgis.com/javascript/latest/references/core/tables/AttributeTableTemplate/) and [TableTemplate](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/support/TableTemplate/) documentation for more information.
    *
    * > [!WARNING]
    * >
@@ -1046,10 +1081,11 @@ export abstract class ArcgisFeatureTable extends LitElement {
    */
   accessor tableTitle: string | FeatureTableTitleFunction | null | undefined;
   /**
-   * The [TimeExtent](https://developers.arcgis.com/javascript/latest/references/core/time/TimeExtent/) in which to filter and display data within the FeatureTable component. Setting this property directly on the component or its [viewModel](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/FeatureTableViewModel/#timeExtent) takes precedence over the layer's [FeatureLayer#timeExtent](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#timeExtent). If this property is set directly on the component, the table will not refresh when the layer's [TimeExtent](https://developers.arcgis.com/javascript/latest/references/core/time/TimeExtent/) changes.
+   * The [TimeExtent](https://developers.arcgis.com/javascript/latest/references/core/time/TimeExtent/) in which to filter and display data within the FeatureTable component. Setting this property directly on the component takes precedence over the layer's [timeExtent](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#timeExtent). If this property is set directly on the component, the table will not refresh when the layer's [TimeExtent](https://developers.arcgis.com/javascript/latest/references/core/time/TimeExtent/) changes.
    *
    * @since 4.30
-   * @see [FeatureLayer#timeExtent](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#timeExtent)
+   * @see [FeatureLayer.timeExtent](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#timeExtent)
+   * @see [FeatureTable.viewTimeEnabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-table/#viewTimeEnabled)
    * @example
    * // Filters the table to display only features that fit within the time extent
    * reactiveUtils.watch(
@@ -1067,17 +1103,31 @@ export abstract class ArcgisFeatureTable extends LitElement {
    * >
    * > The following considerations apply when working with date, time, and big integer field types:
    * >
-   * > By default, the [FeatureTable](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/) displays timezones for `date` and `timestamp-offset` field [types](https://developers.arcgis.com/javascript/latest/references/core/layers/support/Field/#type) reflecting the MapView's timezone. This timezone can be overridden by setting the table's [timeZone](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#timeZone) property.
-   * > If the table's [view](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureTable/#view) isn't set, and the table's [Feature#timeZone](https://developers.arcgis.com/javascript/latest/references/core/widgets/Feature/#timeZone) isn't set, the table defaults to `system` time. The only time that this is not the case is when there is a [FeatureLayer#preferredTimeZone](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#preferredTimeZone) set on the table's layer. If the latter is true, the preferred time zone is used as opposed to `system`.
+   * > By default, the FeatureTable displays time zones for `date` and `timestamp-offset` field [types](https://developers.arcgis.com/javascript/latest/references/core/layers/support/Field/#type) using the associated view's time zone. This time zone can be overridden by setting the table's [timeZone](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-table/#timeZone) property.
+   * > If the table's [view](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-table/#view) isn't set, and, (if applicable), a [Feature.timeZone](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-next/#timeZone) isn't set, the table defaults to `system` time. The only instance where this is not the case is when there is a [FeatureLayer#preferredTimeZone](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#preferredTimeZone) set on the table's layer. If the latter is true, the preferred time zone is used as opposed to `system`.
    *
    * @since 4.28
    */
   accessor timeZone: string | null | 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-feature-table 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-feature-table component will be associated with a map or scene component rather than using the `view` property.
    */
   accessor view: LinkChartView | MapViewOrSceneView | null | undefined;
+  /**
+   * Controls [time extent](https://developers.arcgis.com/javascript/latest/references/core/time/TimeExtent/) filtering behavior for the table. When `true`, the [table's time extent](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-table/#timeExtent) will
+   * be derived from the intersection of the [view](https://developers.arcgis.com/javascript/latest/references/core/views/View/#timeExtent)
+   * and [layer's](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#timeExtent) `timeExtent`.
+   * When `false`, only the [layer's `timeExtent`](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#timeExtent)
+   * will be considered.
+   * When [timeExtent](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-table/#timeExtent) is defined on the
+   * table, only that [time extent](https://developers.arcgis.com/javascript/latest/references/core/time/TimeExtent/) will be used and this property will
+   * be ignored.
+   *
+   * @default false
+   * @since 5.2
+   */
+  accessor viewTimeEnabled: boolean;
   /**
    * A flattened array of all top-level visible columns. Take note that this does not include nested columns.
    *
@@ -1137,6 +1187,14 @@ export abstract class ArcgisFeatureTable extends LitElement {
   exportSelectionToCSV(includeGeometry?: boolean): Promise<void>;
   /** @param fieldName */
   findColumn(fieldName: string): Promise<ActionColumn | AttachmentsColumn | Column | GroupColumn | RelationshipColumn | null | undefined>;
+  /**
+   * Returns cached features for a specific page index.
+   *
+   * @param pageIndex - The index of the page for which to retrieve cached features.
+   * @returns An array of FeatureStoreItem objects representing the cached features for the specified page, or undefined if no cached features are found for that page.
+   * @internal
+   */
+  getCachedFeaturesByPageIndex(pageIndex: number): Promise<FeatureStoreItem[] | undefined>;
   /**
    * Returns information about the feature with the provided object ID from the internal store.
    *
@@ -1198,7 +1256,7 @@ export abstract class ArcgisFeatureTable extends LitElement {
   readonly arcgisColumnReorder: import("@arcgis/lumina").TargetedEvent<this, TableInteractionColumnReorderEvent>;
   /** 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: "effectiveSize" | "isQueryingOrSyncing" | "layerView" | "size" | "state"; }>;
-  /** 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>;
   /** Fires when a row selection is added or removed. */
   readonly arcgisSelectionChange: import("@arcgis/lumina").TargetedEvent<this, CollectionChangeEvent<number | string>>;