@arcgis/core 6.0.0-next.22 → 6.0.0-next.23

package/layers/SceneLayer.d.ts

@@ -266,21 +266,33 @@ export interface SceneLayerProperties extends LayerProperties, APIKeyMixinProper
    */
   timeExtent?: TimeExtentProperties | null;
   /**
-   * TimeInfo provides information such as date fields that store
-   * [start](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#startField)
-   * and [end](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#endField) time
-   * for each feature and the [TimeInfo.fullTimeExtent](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#fullTimeExtent)
-   * for the layer.
+   * Defines temporal information for a layer, such as [start](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#startField) and [end](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#endField)
+   * date fields used to track when features remain visible, as well as the layer's [full time extent](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#fullTimeExtent).
+   * If `timeInfo` is configured on the underlying service, it is automatically read and used by the layer.
    *
-   * If timeInfo configuration exists on the service it gets read and used from there. A developer
-   * can overwrite or create a timeInfo configuration on initialization.
-   * The timeInfo parameters cannot be changed after the layer is [loaded](https://developers.arcgis.com/javascript/latest/references/core/layers/SceneLayer/#load).
+   * The `timeInfo` property can be set or overridden in the scene layer constructor or at runtime.
+   * When overriding `timeInfo`, ensure that `startField` and `endField` correspond to valid date fields in the layer's schema.
+   * To calculate a `fullTimeExtent` that covers all dates in the configured `startField` and `endField`, call
+   * the [getTimeExtentFromLayers()](https://developers.arcgis.com/javascript/latest/references/core/support/timeUtils/#getTimeExtentFromLayers) function. Then assign the result to `layer.timeInfo.fullTimeExtent`.
    *
    * TimeInfo's [startField](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#startField) and [endField](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#endField)
    * can be `date`, `date-only` or `timestamp-offset` [field type](https://developers.arcgis.com/javascript/latest/references/core/layers/support/Field/#type) for [SceneLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/SceneLayer/)
    * and [BuildingComponentSublayer](https://developers.arcgis.com/javascript/latest/references/core/layers/buildingSublayers/BuildingComponentSublayer/).
    *
    * @since 4.30
+   * @example
+   * // update layer's timeInfo at runtime
+   * sceneLayer.timeInfo = {
+   *   startField: "DateField",
+   *   timeZone: "UTC"
+   * };
+   *
+   * // calculate the fullTimeExtent based on startField
+   * const fullTimeExtent = getTimeExtentFromLayers([sceneLayer]);
+   * sceneLayer.timeInfo.fullTimeExtent = fullTimeExtent;
+   * @example
+   * // set layer's timeInfo to null
+   * sceneLayer.timeInfo = null;
    */
   timeInfo?: TimeInfoProperties | null;
   /**
@@ -1043,21 +1055,33 @@ export default class SceneLayer extends SceneLayerSuperclass {
   get timeExtent(): TimeExtent | null | undefined;
   set timeExtent(value: TimeExtentProperties | null | undefined);
   /**
-   * TimeInfo provides information such as date fields that store
-   * [start](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#startField)
-   * and [end](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#endField) time
-   * for each feature and the [TimeInfo.fullTimeExtent](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#fullTimeExtent)
-   * for the layer.
+   * Defines temporal information for a layer, such as [start](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#startField) and [end](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#endField)
+   * date fields used to track when features remain visible, as well as the layer's [full time extent](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#fullTimeExtent).
+   * If `timeInfo` is configured on the underlying service, it is automatically read and used by the layer.
    *
-   * If timeInfo configuration exists on the service it gets read and used from there. A developer
-   * can overwrite or create a timeInfo configuration on initialization.
-   * The timeInfo parameters cannot be changed after the layer is [loaded](https://developers.arcgis.com/javascript/latest/references/core/layers/SceneLayer/#load).
+   * The `timeInfo` property can be set or overridden in the scene layer constructor or at runtime.
+   * When overriding `timeInfo`, ensure that `startField` and `endField` correspond to valid date fields in the layer's schema.
+   * To calculate a `fullTimeExtent` that covers all dates in the configured `startField` and `endField`, call
+   * the [getTimeExtentFromLayers()](https://developers.arcgis.com/javascript/latest/references/core/support/timeUtils/#getTimeExtentFromLayers) function. Then assign the result to `layer.timeInfo.fullTimeExtent`.
    *
    * TimeInfo's [startField](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#startField) and [endField](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#endField)
    * can be `date`, `date-only` or `timestamp-offset` [field type](https://developers.arcgis.com/javascript/latest/references/core/layers/support/Field/#type) for [SceneLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/SceneLayer/)
    * and [BuildingComponentSublayer](https://developers.arcgis.com/javascript/latest/references/core/layers/buildingSublayers/BuildingComponentSublayer/).
    *
    * @since 4.30
+   * @example
+   * // update layer's timeInfo at runtime
+   * sceneLayer.timeInfo = {
+   *   startField: "DateField",
+   *   timeZone: "UTC"
+   * };
+   *
+   * // calculate the fullTimeExtent based on startField
+   * const fullTimeExtent = getTimeExtentFromLayers([sceneLayer]);
+   * sceneLayer.timeInfo.fullTimeExtent = fullTimeExtent;
+   * @example
+   * // set layer's timeInfo to null
+   * sceneLayer.timeInfo = null;
    */
   get timeInfo(): TimeInfo | null | undefined;
   set timeInfo(value: TimeInfoProperties | null | undefined);

package/layers/ViewshedLayer.d.ts

@@ -84,16 +84,22 @@ export interface ViewshedLayerProperties extends LayerProperties, OperationalLay
  *
  * > [!WARNING]
  * >
- * > **Known Limitations**
- * >
- * > This layer is only supported in a 3D [SceneView](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/).
- * > The results of the tool vary depending on the zoom level, as changes in zoom level affect the level of detail (LOD) of the scene geometry.
+ * > **Things to consider:**
+ * > * This analysis is only supported in a 3D [SceneView](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/).
+ * > * The results of the tool vary depending on the zoom level, as changes in zoom level affect the level of detail (LOD) of the scene geometry.
+ * > * Snapping, tooltips, display units, and input units used during interactive placement and editing are inherited from
+ * [ViewOptions](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/options/ViewOptions/).
+ * >   * Snapping is enabled by default. This can be temporarily disabled by holding the `CTRL` key.
+ * >   * Layer types currently supported for snapping are: [FeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/), [GraphicsLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/GraphicsLayer/) (except Mesh geometries),
+ * > [GeoJSONLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/GeoJSONLayer/), [WFSLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/WFSLayer/), [CSVLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/CSVLayer/),
+ * > [3D Object SceneLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/SceneLayer/), and [BuildingSceneLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/BuildingSceneLayer/).
  *
  * @since 4.31
  * @see [ViewshedLayerView](https://developers.arcgis.com/javascript/latest/references/core/views/layers/ViewshedLayerView/)
  * @see [Viewshed](https://developers.arcgis.com/javascript/latest/references/core/analysis/Viewshed/)
  * @see [ViewshedAnalysis](https://developers.arcgis.com/javascript/latest/references/core/analysis/ViewshedAnalysis/)
  * @see [ViewshedAnalysisView3D](https://developers.arcgis.com/javascript/latest/references/core/views/3d/analysis/ViewshedAnalysisView3D/)
+ * @see [ViewOptions](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/options/ViewOptions/)
  * @see [Sample - ViewshedLayer in slides](https://developers.arcgis.com/javascript/latest/sample-code/layers-viewshed/)
  */
 export default class ViewshedLayer extends ViewshedLayerSuperclass {

package/layers/WMSLayer.d.ts

@@ -3,7 +3,6 @@ import type Collection from "../core/Collection.js";
 import type Extent from "../geometry/Extent.js";
 import type SpatialReference from "../geometry/SpatialReference.js";
 import type Layer from "./Layer.js";
-import type TimeInfo from "./support/TimeInfo.js";
 import type WMSSublayer from "./support/WMSSublayer.js";
 import type TimeExtent from "../time/TimeExtent.js";
 import type TimeInterval from "../time/TimeInterval.js";
@@ -17,7 +16,6 @@ import type { PortalLayer, PortalLayerProperties } from "./mixins/PortalLayer.js
 import type { RefreshableLayer, RefreshableLayerEvents, RefreshableLayerProperties } from "./mixins/RefreshableLayer.js";
 import type { ScaleRangeLayer, ScaleRangeLayerProperties } from "./mixins/ScaleRangeLayer.js";
 import type { TemporalLayer, TemporalLayerProperties } from "./mixins/TemporalLayer.js";
-import type { TimeInfoProperties } from "./support/TimeInfo.js";
 import type { WMSDimension } from "./wms/types.js";
 import type { TimeExtentProperties } from "../time/TimeExtent.js";
 import type { TimeIntervalProperties } from "../time/TimeInterval.js";
@@ -150,39 +148,6 @@ export interface WMSLayerProperties extends LayerProperties, PortalLayerProperti
    * });
    */
   timeExtent?: TimeExtentProperties | null;
-  /**
-   * TimeInfo provides information such as date fields that store
-   * [start](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#startField)
-   * and [end](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#endField) time
-   * for each feature and the [TimeInfo.fullTimeExtent](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#fullTimeExtent)
-   * for the layer. The `timeInfo` property is automatically set at layer initialization if the layer has one or more time dimensions.
-   * The [TimeInfo.fullTimeExtent](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#fullTimeExtent) for `timeInfo` is
-   * automatically set to the union of all time dimension extents.
-   * The timeInfo parameters cannot be changed after the layer is [loaded](https://developers.arcgis.com/javascript/latest/references/core/layers/WMSLayer/#load).
-   *
-   * @since 4.17
-   * @example
-   * // create geojson layer from usgs earthquakes geojson feed
-   * const geojsonLayer = new GeoJSONLayer({
-   *   url: "https://earthquake.usgs.gov/earthquakes/feed/v1.0/summary/all_month.geojson",
-   *   copyright: "USGS Earthquakes",
-   *   fields: [
-   *     { "name": "mag", "type": "double" },
-   *     { "name": "place", "type": "string" },
-   *     { "name": "time", "type": "date" }, // date field
-   *     { "name": "depth", "type": "double" }
-   *   ],
-   *   // timeInfo can be used to do temporal queries
-   *   // set the startField and endField.
-   *   // timeExtent is automatically calculated from the
-   *   // the start and end date fields
-   *   // The date values must be in milliseconds number from the UNIX epoch specified in UTC.
-   *   timeInfo: {
-   *     startField: "time"
-   *   }
-   * });
-   */
-  timeInfo?: TimeInfoProperties | null;
   /**
    * A temporary offset of the time data based on a certain [TimeInterval](https://developers.arcgis.com/javascript/latest/references/core/time/TimeInterval/). This allows
    * users to overlay features from two or more time-aware layers with different time extents.
@@ -215,6 +180,7 @@ export interface WMSLayerProperties extends LayerProperties, PortalLayerProperti
    *     }
    *   }
    * });
+   * @see [Sample - Time Bar with actions and layer timeOffset](https://developers.arcgis.com/javascript/latest/sample-code/time-bar-time-offset/)
    * @example
    * // Offset a CSV Layer containing hurricanes from 2015 so that they appear in 2019 (+4 years).
    * let layer = new CSVLayer({
@@ -678,40 +644,6 @@ export default class WMSLayer extends WMSLayerSuperclass {
    */
   get timeExtent(): TimeExtent | null | undefined;
   set timeExtent(value: TimeExtentProperties | null | undefined);
-  /**
-   * TimeInfo provides information such as date fields that store
-   * [start](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#startField)
-   * and [end](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#endField) time
-   * for each feature and the [TimeInfo.fullTimeExtent](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#fullTimeExtent)
-   * for the layer. The `timeInfo` property is automatically set at layer initialization if the layer has one or more time dimensions.
-   * The [TimeInfo.fullTimeExtent](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#fullTimeExtent) for `timeInfo` is
-   * automatically set to the union of all time dimension extents.
-   * The timeInfo parameters cannot be changed after the layer is [loaded](https://developers.arcgis.com/javascript/latest/references/core/layers/WMSLayer/#load).
-   *
-   * @since 4.17
-   * @example
-   * // create geojson layer from usgs earthquakes geojson feed
-   * const geojsonLayer = new GeoJSONLayer({
-   *   url: "https://earthquake.usgs.gov/earthquakes/feed/v1.0/summary/all_month.geojson",
-   *   copyright: "USGS Earthquakes",
-   *   fields: [
-   *     { "name": "mag", "type": "double" },
-   *     { "name": "place", "type": "string" },
-   *     { "name": "time", "type": "date" }, // date field
-   *     { "name": "depth", "type": "double" }
-   *   ],
-   *   // timeInfo can be used to do temporal queries
-   *   // set the startField and endField.
-   *   // timeExtent is automatically calculated from the
-   *   // the start and end date fields
-   *   // The date values must be in milliseconds number from the UNIX epoch specified in UTC.
-   *   timeInfo: {
-   *     startField: "time"
-   *   }
-   * });
-   */
-  get timeInfo(): TimeInfo | null | undefined;
-  set timeInfo(value: TimeInfoProperties | null | undefined);
   /**
    * A temporary offset of the time data based on a certain [TimeInterval](https://developers.arcgis.com/javascript/latest/references/core/time/TimeInterval/). This allows
    * users to overlay features from two or more time-aware layers with different time extents.
@@ -744,6 +676,7 @@ export default class WMSLayer extends WMSLayerSuperclass {
    *     }
    *   }
    * });
+   * @see [Sample - Time Bar with actions and layer timeOffset](https://developers.arcgis.com/javascript/latest/sample-code/time-bar-time-offset/)
    * @example
    * // Offset a CSV Layer containing hurricanes from 2015 so that they appear in 2019 (+4 years).
    * let layer = new CSVLayer({

package/layers/mixins/TemporalLayer.d.ts

@@ -57,28 +57,24 @@ export interface TemporalLayerProperties extends Partial<Pick<TemporalLayer, "us
    */
   timeExtent?: TimeExtentProperties | null;
   /**
-   * TimeInfo provides information such as date fields that store
-   * [start](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#startField)
-   * and [end](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#endField) time
-   * for each feature and the [fullTimeExtent](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#fullTimeExtent)
-   * for the layer. The `timeInfo` property, along with its `startField` and `endField` properties, must be set at the
-   * time of layer initialization if it is being set for a
-   * [CSVLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/CSVLayer/),
-   * [GeoJSONLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/GeoJSONLayer/),
-   * [OGCFeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/OGCFeatureLayer/) or
-   * [FeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/)
-   * initialized from [client-side features](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#creating-a-featurelayer).
-   * The [fullTimeExtent](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#fullTimeExtent) for `timeInfo` is
-   * automatically calculated based on its `startField` and `endField` properties.
-   * The timeInfo parameters cannot be changed after the layer is [loaded](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#load).
+   * Defines temporal information for a layer, such as [start](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#startField) and [end](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#endField)
+   * date fields used to track when features remain visible, as well as the layer's [full time extent](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#fullTimeExtent).
+   * If `timeInfo` is configured on the underlying service, it is automatically read and used by the layer.
    *
-   * TimeInfo's [TimeInfo.startField](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#startField) and [endField](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#startField)
-   * can be `date`, `date-only` or `timestamp-offset` [field type](https://developers.arcgis.com/javascript/latest/references/core/layers/support/Field/#type) for [FeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/)
-   * and [MapImageLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/MapImageLayer/).
+   * The `timeInfo` can be set or overridden on the following feature based layers in the layer constructor or at runtime: [AnnotationFeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/AnnotationFeatureLayer/),
+   * [CSVLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/CSVLayer/), [CatalogLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/CatalogLayer/), [DimensionFeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/DimensionFeatureLayer/), [FeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/),
+   * [GeoJSONLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/GeoJSONLayer/), [OGCFeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/OGCFeatureLayer/), [OrientedImageryLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/OrientedImageryLayer/), [SceneLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/SceneLayer/),
+   * [StreamLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/StreamLayer/), and [SubtypeGroupLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/SubtypeGroupLayer/).
    *
-   * @since 4.11
+   * When overriding a layer's `timeInfo`, ensure that `startField` and `endField` correspond to valid date fields in the layer's schema.
+   * To calculate a `fullTimeExtent` that covers all dates in the configured `startField` and `endField`, call
+   * [getTimeExtentFromLayers()](https://developers.arcgis.com/javascript/latest/references/core/support/timeUtils/#getTimeExtentFromLayers) method. Then assign the result to `layer.timeInfo.fullTimeExtent`.
+   *
+   * The `startField` and `endField` properties accept `date`, `date-only`, or `timestamp-offset` field types.
+   *
+   * @see [Samples using time-aware layers](https://developers.arcgis.com/javascript/latest/sample-code/?tagged=arcgis-time-bar)
    * @example
-   * // create geojson layer from usgs earthquakes geojson feed
+   * // create geojson layer from USGS earthquakes GeoJSON feed
    * const geojsonLayer = new GeoJSONLayer({
    *   url: "https://earthquake.usgs.gov/earthquakes/feed/v1.0/summary/all_month.geojson",
    *   copyright: "USGS Earthquakes",
@@ -89,14 +85,28 @@ export interface TemporalLayerProperties extends Partial<Pick<TemporalLayer, "us
    *     { "name": "depth", "type": "double" }
    *   ],
    *   // timeInfo can be used to do temporal queries
-   *   // set the startField and endField.
-   *   // timeExtent is automatically calculated from the
-   *   // the start and end date fields
-   *   // The date values must be in milliseconds number from the UNIX epoch specified in UTC.
    *   timeInfo: {
-   *     startField: "time"
+   *     startField: "time",
+   *     fullTimeExtent: {
+   *       start: new Date(1970, 0, 1),
+   *       end: new Date(2000, 11, 31)
+   *     },
+   *     timeZone: "UTC"
    *   }
    * });
+   * @example
+   * // update layer's timeInfo at runtime after the feature layer is loaded
+   * featureLayer.timeInfo = {
+   *   startField: "DateField",
+   *   timeZone: "UTC"
+   * };
+   *
+   * // calculate the fullTimeExtent based on startField
+   * const fullTimeExtent = getTimeExtentFromLayers([featureLayer]);
+   * featureLayer.timeInfo.fullTimeExtent = fullTimeExtent;
+   * @example
+   * // set layer's timeInfo to null
+   * layer.timeInfo = null;
    */
   timeInfo?: TimeInfoProperties | null;
   /**
@@ -107,6 +117,7 @@ export interface TemporalLayerProperties extends Partial<Pick<TemporalLayer, "us
    * A time offset can be used for display purposes only. The query and selection are not affected by the offset.
    *
    * @since 4.14
+   * @see [Sample - Time Bar with actions and layer timeOffset](https://developers.arcgis.com/javascript/latest/sample-code/time-bar-time-offset/)
    * @example
    * // Offset a CSV Layer containing hurricanes from 2015 so that they appear in 2019 (+4 years).
    * let layer = new CSVLayer({
@@ -195,28 +206,24 @@ export abstract class TemporalLayer {
   get timeExtent(): TimeExtent | null | undefined;
   set timeExtent(value: TimeExtentProperties | null | undefined);
   /**
-   * TimeInfo provides information such as date fields that store
-   * [start](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#startField)
-   * and [end](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#endField) time
-   * for each feature and the [fullTimeExtent](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#fullTimeExtent)
-   * for the layer. The `timeInfo` property, along with its `startField` and `endField` properties, must be set at the
-   * time of layer initialization if it is being set for a
-   * [CSVLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/CSVLayer/),
-   * [GeoJSONLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/GeoJSONLayer/),
-   * [OGCFeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/OGCFeatureLayer/) or
-   * [FeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/)
-   * initialized from [client-side features](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#creating-a-featurelayer).
-   * The [fullTimeExtent](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#fullTimeExtent) for `timeInfo` is
-   * automatically calculated based on its `startField` and `endField` properties.
-   * The timeInfo parameters cannot be changed after the layer is [loaded](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#load).
+   * Defines temporal information for a layer, such as [start](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#startField) and [end](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#endField)
+   * date fields used to track when features remain visible, as well as the layer's [full time extent](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#fullTimeExtent).
+   * If `timeInfo` is configured on the underlying service, it is automatically read and used by the layer.
    *
-   * TimeInfo's [TimeInfo.startField](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#startField) and [endField](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#startField)
-   * can be `date`, `date-only` or `timestamp-offset` [field type](https://developers.arcgis.com/javascript/latest/references/core/layers/support/Field/#type) for [FeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/)
-   * and [MapImageLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/MapImageLayer/).
+   * The `timeInfo` can be set or overridden on the following feature based layers in the layer constructor or at runtime: [AnnotationFeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/AnnotationFeatureLayer/),
+   * [CSVLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/CSVLayer/), [CatalogLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/CatalogLayer/), [DimensionFeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/DimensionFeatureLayer/), [FeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/),
+   * [GeoJSONLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/GeoJSONLayer/), [OGCFeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/OGCFeatureLayer/), [OrientedImageryLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/OrientedImageryLayer/), [SceneLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/SceneLayer/),
+   * [StreamLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/StreamLayer/), and [SubtypeGroupLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/SubtypeGroupLayer/).
    *
-   * @since 4.11
+   * When overriding a layer's `timeInfo`, ensure that `startField` and `endField` correspond to valid date fields in the layer's schema.
+   * To calculate a `fullTimeExtent` that covers all dates in the configured `startField` and `endField`, call
+   * [getTimeExtentFromLayers()](https://developers.arcgis.com/javascript/latest/references/core/support/timeUtils/#getTimeExtentFromLayers) method. Then assign the result to `layer.timeInfo.fullTimeExtent`.
+   *
+   * The `startField` and `endField` properties accept `date`, `date-only`, or `timestamp-offset` field types.
+   *
+   * @see [Samples using time-aware layers](https://developers.arcgis.com/javascript/latest/sample-code/?tagged=arcgis-time-bar)
    * @example
-   * // create geojson layer from usgs earthquakes geojson feed
+   * // create geojson layer from USGS earthquakes GeoJSON feed
    * const geojsonLayer = new GeoJSONLayer({
    *   url: "https://earthquake.usgs.gov/earthquakes/feed/v1.0/summary/all_month.geojson",
    *   copyright: "USGS Earthquakes",
@@ -227,14 +234,28 @@ export abstract class TemporalLayer {
    *     { "name": "depth", "type": "double" }
    *   ],
    *   // timeInfo can be used to do temporal queries
-   *   // set the startField and endField.
-   *   // timeExtent is automatically calculated from the
-   *   // the start and end date fields
-   *   // The date values must be in milliseconds number from the UNIX epoch specified in UTC.
    *   timeInfo: {
-   *     startField: "time"
+   *     startField: "time",
+   *     fullTimeExtent: {
+   *       start: new Date(1970, 0, 1),
+   *       end: new Date(2000, 11, 31)
+   *     },
+   *     timeZone: "UTC"
    *   }
    * });
+   * @example
+   * // update layer's timeInfo at runtime after the feature layer is loaded
+   * featureLayer.timeInfo = {
+   *   startField: "DateField",
+   *   timeZone: "UTC"
+   * };
+   *
+   * // calculate the fullTimeExtent based on startField
+   * const fullTimeExtent = getTimeExtentFromLayers([featureLayer]);
+   * featureLayer.timeInfo.fullTimeExtent = fullTimeExtent;
+   * @example
+   * // set layer's timeInfo to null
+   * layer.timeInfo = null;
    */
   get timeInfo(): TimeInfo | null | undefined;
   set timeInfo(value: TimeInfoProperties | null | undefined);
@@ -246,6 +267,7 @@ export abstract class TemporalLayer {
    * A time offset can be used for display purposes only. The query and selection are not affected by the offset.
    *
    * @since 4.14
+   * @see [Sample - Time Bar with actions and layer timeOffset](https://developers.arcgis.com/javascript/latest/sample-code/time-bar-time-offset/)
    * @example
    * // Offset a CSV Layer containing hurricanes from 2015 so that they appear in 2019 (+4 years).
    * let layer = new CSVLayer({

package/layers/mixins/TiledImagery.d.ts

@@ -4,7 +4,6 @@ import type SpatialReference from "../../geometry/SpatialReference.js";
 import type DimensionalDefinition from "../support/DimensionalDefinition.js";
 import type MultidimensionalSubset from "../support/MultidimensionalSubset.js";
 import type RasterInfo from "../support/RasterInfo.js";
-import type TimeInfo from "../support/TimeInfo.js";
 import type ImageSampleParameters from "../../rest/support/ImageSampleParameters.js";
 import type ImageSampleResult from "../../rest/support/ImageSampleResult.js";
 import type TimeExtent from "../../time/TimeExtent.js";
@@ -273,16 +272,6 @@ export abstract class TiledImagery {
    * });
    */
   abstract accessor timeExtent: TimeExtent | null | undefined;
-  /**
-   * TimeInfo provides information such as date fields that store
-   * [start](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#startField)
-   * and [end](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#endField) time
-   * for each feature and the [TimeInfo.fullTimeExtent](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#fullTimeExtent)
-   * for the layer.
-   *
-   * @since 4.22
-   */
-  abstract accessor timeInfo: TimeInfo | null | undefined;
   /**
    * A temporary offset of the time data based on a certain [TimeInterval](https://developers.arcgis.com/javascript/latest/references/core/time/TimeInterval/). This allows
    * users to overlay features from two or more time-aware layers with different time extents.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcgis/core",
-  "version": "6.0.0-next.22",
+  "version": "6.0.0-next.23",
   "description": "ArcGIS Maps SDK for JavaScript: A complete 2D and 3D mapping and data visualization API",
   "keywords": [
     "ArcGIS",
@@ -20,7 +20,7 @@
   "license": "SEE LICENSE IN LICENSE.md",
   "dependencies": {
     "@amcharts/amcharts5": "~5.21.5",
-    "@arcgis/toolkit": "6.0.0-next.22",
+    "@arcgis/toolkit": "6.0.0-next.23",
     "@esri/arcgis-html-sanitizer": "~4.2.0-next.2",
     "@esri/calcite-components": "^5.2.0",
     "@vaadin/grid": "~25.3.4",

package/popup/content.d.ts

@@ -36,6 +36,7 @@
  * }
  * ```
  *
+ * @deprecated at 5.2. Use individual content imports instead.
  * @since 4.11
  * @see [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/)
  * @see [TextContent](https://developers.arcgis.com/javascript/latest/references/core/popup/content/TextContent/)
@@ -58,98 +59,134 @@ import type UtilityNetworkAssociationsContentClass from "./content/UtilityNetwor
 /**
  * AttachmentsContent represents an attachment element associated with a
  * feature.
+ *
+ * @deprecated at 5.2. Import [AttachmentsContent](https://developers.arcgis.com/javascript/latest/references/core/popup/content/AttachmentsContent/) directly instead.
  */
 export type AttachmentsContent = AttachmentsContentClass;
 
 /**
  * AttachmentsContent represents an attachment element associated with a
  * feature.
+ *
+ * @deprecated at 5.2. Import [AttachmentsContent](https://developers.arcgis.com/javascript/latest/references/core/popup/content/AttachmentsContent/) directly instead.
  */
 export const AttachmentsContent: typeof AttachmentsContentClass;
 
 /**
  * CustomContent represents a custom content element associated with a
  * feature.
+ *
+ * @deprecated at 5.2. Import [CustomContent](https://developers.arcgis.com/javascript/latest/references/core/popup/content/CustomContent/) directly instead.
  */
 export type CustomContent = CustomContentClass;
 
 /**
  * CustomContent represents a custom content element associated with a
  * feature.
+ *
+ * @deprecated at 5.2. Import [CustomContent](https://developers.arcgis.com/javascript/latest/references/core/popup/content/CustomContent/) directly instead.
  */
 export const CustomContent: typeof CustomContentClass;
 
 /**
  * ExpressionContent represents an expression element associated with a
  * feature.
+ *
+ * @deprecated at 5.2. Import [ExpressionContent](https://developers.arcgis.com/javascript/latest/references/core/popup/content/ExpressionContent/) directly instead.
  */
 export type ExpressionContent = ExpressionContentClass;
 
 /**
  * ExpressionContent represents an expression element associated with a
  * feature.
+ *
+ * @deprecated at 5.2. Import [ExpressionContent](https://developers.arcgis.com/javascript/latest/references/core/popup/content/ExpressionContent/) directly instead.
  */
 export const ExpressionContent: typeof ExpressionContentClass;
 
 /**
  * FieldsContent represents the [FieldInfo](https://developers.arcgis.com/javascript/latest/references/core/popup/FieldInfo/) associated with a
  * feature.
+ *
+ * @deprecated at 5.2. Import [FieldsContent](https://developers.arcgis.com/javascript/latest/references/core/popup/content/FieldsContent/) directly instead.
  */
 export type FieldsContent = FieldsContentClass;
 
 /**
  * FieldsContent represents the [FieldInfo](https://developers.arcgis.com/javascript/latest/references/core/popup/FieldInfo/) associated with a
  * feature.
+ *
+ * @deprecated at 5.2. Import [FieldsContent](https://developers.arcgis.com/javascript/latest/references/core/popup/content/FieldsContent/) directly instead.
  */
 export const FieldsContent: typeof FieldsContentClass;
 
 /**
  * MediaContent contains an individual or array of chart and/or image media elements
  * to display within a popup's content.
+ *
+ * @deprecated at 5.2. Import [MediaContent](https://developers.arcgis.com/javascript/latest/references/core/popup/content/MediaContent/) directly instead.
  */
 export type MediaContent = MediaContentClass;
 
 /**
  * MediaContent contains an individual or array of chart and/or image media elements
  * to display within a popup's content.
+ *
+ * @deprecated at 5.2. Import [MediaContent](https://developers.arcgis.com/javascript/latest/references/core/popup/content/MediaContent/) directly instead.
  */
 export const MediaContent: typeof MediaContentClass;
 
 /**
  * RelationshipContent represents a relationship element associated with a
  * feature.
+ *
+ * @deprecated at 5.2. Import [RelationshipContent](https://developers.arcgis.com/javascript/latest/references/core/popup/content/RelationshipContent/) directly instead.
  */
 export type RelationshipContent = RelationshipContentClass;
 
 /**
  * RelationshipContent represents a relationship element associated with a
  * feature.
+ *
+ * @deprecated at 5.2. Import [RelationshipContent](https://developers.arcgis.com/javascript/latest/references/core/popup/content/RelationshipContent/) directly instead.
  */
 export const RelationshipContent: typeof RelationshipContentClass;
 
 /**
  * TextContent defines descriptive text as an element within the [PopupTemplate's](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/)
  * content.
+ *
+ * @deprecated at 5.2. Import [TextContent](https://developers.arcgis.com/javascript/latest/references/core/popup/content/TextContent/) directly instead.
  */
 export type TextContent = TextContentClass;
 
 /**
  * TextContent defines descriptive text as an element within the [PopupTemplate's](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/)
  * content.
+ *
+ * @deprecated at 5.2. Import [TextContent](https://developers.arcgis.com/javascript/latest/references/core/popup/content/TextContent/) directly instead.
  */
 export const TextContent: typeof TextContentClass;
 
 /**
  * UtilityNetworkAssociationsContent represents an utility network associations element associated with a
  * feature.
+ *
+ * @deprecated at 5.2. Import [UtilityNetworkAssociationsContent](https://developers.arcgis.com/javascript/latest/references/core/popup/content/UtilityNetworkAssociationsContent/) directly instead.
  */
 export type UtilityNetworkAssociationsContent = UtilityNetworkAssociationsContentClass;
 
 /**
  * UtilityNetworkAssociationsContent represents an utility network associations element associated with a
  * feature.
+ *
+ * @deprecated at 5.2. Import [UtilityNetworkAssociationsContent](https://developers.arcgis.com/javascript/latest/references/core/popup/content/UtilityNetworkAssociationsContent/) directly instead.
  */
 export const UtilityNetworkAssociationsContent: typeof UtilityNetworkAssociationsContentClass;
 
-/** Popup content element types. */
+/**
+ * Popup content element types.
+ *
+ * @deprecated at 5.2. Use individual content imports instead.
+ */
 export type Content = AttachmentsContent | FieldsContent | MediaContent | TextContent | CustomContent | ExpressionContent | RelationshipContent | UtilityNetworkAssociationsContent;

package/popup/content.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/6.0/LICENSE.txt */
-import e from"./content/AttachmentsContent.js";import t from"./content/Content.js";import n from"./content/CustomContent.js";import r from"./content/ExpressionContent.js";import i from"./content/FieldsContent.js";import a from"./content/MediaContent.js";import o from"./content/RelationshipContent.js";import s from"./content/TextContent.js";import c from"./content/UtilityNetworkAssociationsContent.js";const l=e,u=t,d=n,f=r,p=i,m=a,h=o,g=s,_=c;function v(e){return e instanceof u}const y={base:null,key:`type`,typeMap:{attachment:l,media:m,text:g,expression:f,field:p,relationship:h,utilityNetworkAssociations:_}},b={base:null,key:`type`,typeMap:{attachment:l,media:m,text:g,expression:f,field:p,relationship:h}};export{l as AttachmentsContent,u as BaseContent,d as CustomContent,f as ExpressionContent,p as FieldsContent,m as MediaContent,h as RelationshipContent,g as TextContent,_ as UtilityNetworkAssociationsContent,v as isContent,y as persistableTypes,b as persistableWebSceneTypes};
+import{deprecatedModule as e}from"../core/deprecate.js";import t from"../core/Logger.js";import n from"./content/AttachmentsContent.js";import r from"./content/Content.js";import i from"./content/CustomContent.js";import a from"./content/ExpressionContent.js";import o from"./content/FieldsContent.js";import s from"./content/MediaContent.js";import c from"./content/RelationshipContent.js";import l from"./content/TextContent.js";import u from"./content/UtilityNetworkAssociationsContent.js";e(t.getLogger(`esri.popup.content`),`esri.popup.content`,{replacement:`Individual content module imports`,version:`5.2`,warnOnce:!0});const d=n,f=r,p=i,m=a,h=o,g=s,_=c,v=l,y=u;function b(e){return e instanceof f}const x={base:null,key:`type`,typeMap:{attachment:d,media:g,text:v,expression:m,field:h,relationship:_,utilityNetworkAssociations:y}},S={base:null,key:`type`,typeMap:{attachment:d,media:g,text:v,expression:m,field:h,relationship:_}};export{d as AttachmentsContent,f as BaseContent,p as CustomContent,m as ExpressionContent,h as FieldsContent,g as MediaContent,_ as RelationshipContent,v as TextContent,y as UtilityNetworkAssociationsContent,b as isContent,x as persistableTypes,S as persistableWebSceneTypes};