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

package/interfaces.d.ts

@@ -13087,13 +13087,6 @@ declare namespace __esri {
   export type DirectLineMeasurement3D = import("./widgets/DirectLineMeasurement3D.js").default;
   export const DirectLineMeasurement3D: typeof import("./widgets/DirectLineMeasurement3D.js").default;
 
-  /** @deprecated since 5.0. Refactor using \@arcgis/codemod */
-  export type DirectionalPadProperties = import("./widgets/DirectionalPad.js").DirectionalPadProperties;
-
-  /** @deprecated since 5.0. Refactor using \@arcgis/codemod */
-  export type DirectionalPad = import("./widgets/DirectionalPad.js").default;
-  export const DirectionalPad: typeof import("./widgets/DirectionalPad.js").default;
-
   /** @deprecated since 5.0. Refactor using \@arcgis/codemod */
   export type DirectionsProperties = import("./widgets/Directions.js").DirectionsProperties;
 
@@ -13640,23 +13633,6 @@ declare namespace __esri {
   export type TimeZoneLabel = import("./widgets/TimeZoneLabel.js").default;
   export const TimeZoneLabel: typeof import("./widgets/TimeZoneLabel.js").default;
 
-  /** @deprecated since 5.0. Refactor using \@arcgis/codemod */
-  export type TrackProperties = import("./widgets/Track.js").TrackProperties;
-
-  /** @deprecated since 5.0. Refactor using \@arcgis/codemod */
-  export type Track = import("./widgets/Track.js").default;
-  export const Track: typeof import("./widgets/Track.js").default;
-
-  /** @deprecated since 5.0. Refactor using \@arcgis/codemod */
-  export type TrackTrackEvent = import("./widgets/Track/TrackViewModel.js").TrackViewModelTrackEvent;
-  /** @deprecated since 5.0. Refactor using \@arcgis/codemod */
-  export type TrackTrackEventHandler = (event: TrackTrackEvent) => void;
-
-  /** @deprecated since 5.0. Refactor using \@arcgis/codemod */
-  export type TrackTrackErrorEvent = import("./widgets/Track/TrackViewModel.js").TrackViewModelTrackErrorEvent;
-  /** @deprecated since 5.0. Refactor using \@arcgis/codemod */
-  export type TrackTrackErrorEventHandler = (event: TrackTrackErrorEvent) => void;
-
   /** @deprecated since 5.0. Refactor using \@arcgis/codemod */
   export type UtilityNetworkAssociationsProperties = import("./widgets/UtilityNetworkAssociations.js").UtilityNetworkAssociationsProperties;
 
@@ -14202,20 +14178,6 @@ declare namespace __esri {
   /** @deprecated since 5.0. Refactor using \@arcgis/codemod */
   export type DirectLineMeasurement3DViewModelMeasurement = import("./widgets/DirectLineMeasurement3D/DirectLineMeasurement3DViewModel.js").Measurement;
 
-  /** @deprecated since 5.0. Refactor using \@arcgis/codemod */
-  export type DirectionalPadViewModelProperties = import("./widgets/DirectionalPad/DirectionalPadViewModel.js").DirectionalPadViewModelProperties;
-
-  /** @deprecated since 5.0. Refactor using \@arcgis/codemod */
-  export type DirectionalPadViewModel = import("./widgets/DirectionalPad/DirectionalPadViewModel.js").default;
-  export const DirectionalPadViewModel: typeof import("./widgets/DirectionalPad/DirectionalPadViewModel.js").default;
-
-  /** @deprecated since 5.0. Refactor using \@arcgis/codemod */
-  export type DirectionalPadVisibleElements = import("./widgets/DirectionalPad/VisibleElements.js").default;
-  export const DirectionalPadVisibleElements: typeof import("./widgets/DirectionalPad/VisibleElements.js").default;
-
-  /** @deprecated since 5.0. Refactor using \@arcgis/codemod */
-  export type Vector = import("./widgets/DirectionalPad/types.js").Vector;
-
   /** @deprecated since 5.0. Refactor using \@arcgis/codemod */
   export type DirectionsViewModelProperties = import("./widgets/Directions/DirectionsViewModel.js").DirectionsViewModelProperties;
 
@@ -15616,23 +15578,6 @@ declare namespace __esri {
   /** @deprecated since 5.0. Refactor using \@arcgis/codemod */
   export type Action = import("./widgets/TimeSlider/types.js").Action;
 
-  /** @deprecated since 5.0. Refactor using \@arcgis/codemod */
-  export type TrackViewModelProperties = import("./widgets/Track/TrackViewModel.js").TrackViewModelProperties;
-
-  /** @deprecated since 5.0. Refactor using \@arcgis/codemod */
-  export type TrackViewModel = import("./widgets/Track/TrackViewModel.js").default;
-  export const TrackViewModel: typeof import("./widgets/Track/TrackViewModel.js").default;
-
-  /** @deprecated since 5.0. Refactor using \@arcgis/codemod */
-  export type TrackViewModelTrackEvent = import("./widgets/Track/TrackViewModel.js").TrackViewModelTrackEvent;
-  /** @deprecated since 5.0. Refactor using \@arcgis/codemod */
-  export type TrackViewModelTrackEventHandler = (event: TrackViewModelTrackEvent) => void;
-
-  /** @deprecated since 5.0. Refactor using \@arcgis/codemod */
-  export type TrackViewModelTrackErrorEvent = import("./widgets/Track/TrackViewModel.js").TrackViewModelTrackErrorEvent;
-  /** @deprecated since 5.0. Refactor using \@arcgis/codemod */
-  export type TrackViewModelTrackErrorEventHandler = (event: TrackViewModelTrackErrorEvent) => void;
-
   /** @deprecated since 5.0. Refactor using \@arcgis/codemod */
   export type UtilityNetworkAssociationsViewModelProperties = import("./widgets/UtilityNetworkAssociations/UtilityNetworkAssociationsViewModel.js").UtilityNetworkAssociationsViewModelProperties;
 

package/kernel.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/6.0/LICENSE.txt */
-import"./core/has.js";import{addQueryParameter as e}from"./core/urlUtils.js";Symbol.dispose??=Symbol(`Symbol.dispose`),Symbol.asyncDispose??=Symbol(`Symbol.asyncDispose`);const t=`5.2`;let n=`5.2`;n=`6.0.0-next.21`;let r;function i(e){r=e}function a(t){let n=r?.findCredential(t);return n?.token?e(t,`token`,n.token):t}globalThis.$arcgis||Object.defineProperty(globalThis,"$arcgis",{configurable:!1,enumerable:!0,writable:!1,value:{}});export{a as addTokenParameter,n as fullVersion,r as id,i as setId,t as version};
+import"./core/has.js";import{addQueryParameter as e}from"./core/urlUtils.js";Symbol.dispose??=Symbol(`Symbol.dispose`),Symbol.asyncDispose??=Symbol(`Symbol.asyncDispose`);const t=`5.2`;let n=`5.2`;n=`6.0.0-next.23`;let r;function i(e){r=e}function a(t){let n=r?.findCredential(t);return n?.token?e(t,`token`,n.token):t}globalThis.$arcgis||Object.defineProperty(globalThis,"$arcgis",{configurable:!1,enumerable:!0,writable:!1,value:{}});export{a as addTokenParameter,n as fullVersion,r as id,i as setId,t as version};

package/layers/ElevationLayer.d.ts

@@ -33,12 +33,16 @@ export interface FetchTileOptions extends AbortOptions {
 
 /**
  * ElevationLayer is a tile layer used for rendering elevations in [SceneViews](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/).
- * A default [world elevation layer](https://www.arcgis.com/home/item.html?id=7029fb60158543ad845c7e1527af11e4)
+ * The default [Terrain 3D](https://www.arcgis.com/home/item.html?id=7029fb60158543ad845c7e1527af11e4)
  * can be added to the map by setting the [map's ground](https://developers.arcgis.com/javascript/latest/references/core/Map/#ground) property to `world-elevation`.
  *
  *
  * ![elev-default](https://developers.arcgis.com/javascript/latest/assets/references/core/ground/elev-default.avif)
  *
+ * Custom elevation layers can supplement the default Terrain 3D elevation layer with higher-resolution
+ * elevation data or representing another scenario or point in time for an area of interest.
+ * Elevation sources must be published as cached image services.
+ *
  * Elevation layers are set in the [Ground.layers](https://developers.arcgis.com/javascript/latest/references/core/Ground/#layers) property of a
  * [map's ground](https://developers.arcgis.com/javascript/latest/references/core/Map/#ground). They should not be added to the
  * map's [operational layers](https://developers.arcgis.com/javascript/latest/references/core/Map/#layers).
@@ -46,7 +50,7 @@ export interface FetchTileOptions extends AbortOptions {
  * ```js
  * let elevLyr = new ElevationLayer({
  *   // Custom elevation service
- *   url: "https://sampleserver6.arcgisonline.com/arcgis/rest/services/Elevation/MtBaldy_Elevation/ImageServer"
+ *   url: "https://tiles.arcgis.com/tiles/V6ZHFr6zdgNZuVG0/arcgis/rest/services/ELEV__3857__US_Oso__LandslideAfter/ImageServer"
  * });
  * // Add elevation layer to the map's ground.
  * map.ground.layers.add(elevLyr);

package/layers/FeatureLayer.d.ts

@@ -85,13 +85,9 @@ export interface FeatureLayerProperties extends LayerProperties, APIKeyMixinProp
    */
   attributeTableTemplate?: AttributeTableTemplateProperties | null;
   /**
-   * An object that allows you to create a dynamic layer with data
-   * either from map service sublayers or data from a registered workspace.
-   * See [DynamicMapLayer](https://developers.arcgis.com/javascript/latest/references/core/rest/layerSources/DynamicMapLayer/)
-   * for creating dynamic layers from map service layers for on the fly
-   * rendering, labeling, and filtering (definition expressions). To create
-   * dynamic layers from other sources in registered workspaces such as tables and table joins,
-   * see [DynamicDataLayer](https://developers.arcgis.com/javascript/latest/references/core/rest/layerSources/DynamicDataLayer/).
+   * An object that defines the data source for a dynamic layer in a map service. Use
+   * [DynamicDataLayer](https://developers.arcgis.com/javascript/latest/references/core/rest/layerSources/DynamicDataLayer/) for data such as tables and table joins in a registered workspace, or
+   * [DynamicWorkspaceLayer](https://developers.arcgis.com/javascript/latest/references/core/rest/layerSources/DynamicWorkspaceLayer/) for a pre-authored ArcGIS Pro layer file (`.lyrx`) in a registered workspace.
    *
    * If you already have a [Sublayer](https://developers.arcgis.com/javascript/latest/references/core/layers/support/Sublayer/) instance, you
    * can call the [Sublayer.createFeatureLayer()](https://developers.arcgis.com/javascript/latest/references/core/layers/support/Sublayer/#createFeatureLayer)
@@ -152,6 +148,19 @@ export interface FeatureLayerProperties extends LayerProperties, APIKeyMixinProp
    *     }
    *   }
    * });
+   * @example
+   * Use a pre-authored layer file in a registered workspace as the dynamic data source.
+   *
+   * ```js
+   * const layer = new FeatureLayer({
+   *   url: "<your-map-service-url>",
+   *   dynamicDataSource: {
+   *     type: "workspace-layer",
+   *     workspaceId: "lyrx_folder",
+   *     layerId: "WorldCities.lyrx"
+   *   }
+   * });
+   * ```
    */
   dynamicDataSource?: (DynamicDataLayerProperties & { type: "data-layer" }) | (DynamicWorkspaceLayerProperties & { type: "workspace-layer" }) | null;
   /**
@@ -843,13 +852,9 @@ export abstract class __FeatureLayerSansType extends FeatureLayerSuperclass {
    */
   accessor charts: object[] | null | undefined;
   /**
-   * An object that allows you to create a dynamic layer with data
-   * either from map service sublayers or data from a registered workspace.
-   * See [DynamicMapLayer](https://developers.arcgis.com/javascript/latest/references/core/rest/layerSources/DynamicMapLayer/)
-   * for creating dynamic layers from map service layers for on the fly
-   * rendering, labeling, and filtering (definition expressions). To create
-   * dynamic layers from other sources in registered workspaces such as tables and table joins,
-   * see [DynamicDataLayer](https://developers.arcgis.com/javascript/latest/references/core/rest/layerSources/DynamicDataLayer/).
+   * An object that defines the data source for a dynamic layer in a map service. Use
+   * [DynamicDataLayer](https://developers.arcgis.com/javascript/latest/references/core/rest/layerSources/DynamicDataLayer/) for data such as tables and table joins in a registered workspace, or
+   * [DynamicWorkspaceLayer](https://developers.arcgis.com/javascript/latest/references/core/rest/layerSources/DynamicWorkspaceLayer/) for a pre-authored ArcGIS Pro layer file (`.lyrx`) in a registered workspace.
    *
    * If you already have a [Sublayer](https://developers.arcgis.com/javascript/latest/references/core/layers/support/Sublayer/) instance, you
    * can call the [Sublayer.createFeatureLayer()](https://developers.arcgis.com/javascript/latest/references/core/layers/support/Sublayer/#createFeatureLayer)
@@ -910,6 +915,19 @@ export abstract class __FeatureLayerSansType extends FeatureLayerSuperclass {
    *     }
    *   }
    * });
+   * @example
+   * Use a pre-authored layer file in a registered workspace as the dynamic data source.
+   *
+   * ```js
+   * const layer = new FeatureLayer({
+   *   url: "<your-map-service-url>",
+   *   dynamicDataSource: {
+   *     type: "workspace-layer",
+   *     workspaceId: "lyrx_folder",
+   *     layerId: "WorldCities.lyrx"
+   *   }
+   * });
+   * ```
    */
   get dynamicDataSource(): DynamicDataLayer | DynamicWorkspaceLayer | null;
   set dynamicDataSource(value: (DynamicDataLayerProperties & { type: "data-layer" }) | (DynamicWorkspaceLayerProperties & { type: "workspace-layer" }) | null);

package/layers/GeoJSONLayer.d.ts

@@ -6,7 +6,6 @@ import type FeatureTemplate from "./support/FeatureTemplate.js";
 import type Field from "./support/Field.js";
 import type FieldsIndex from "./support/FieldsIndex.js";
 import type LabelClass from "./support/LabelClass.js";
-import type TimeInfo from "./support/TimeInfo.js";
 import type PortalItem from "../portal/PortalItem.js";
 import type AttributeBinsFeatureSet from "../rest/support/AttributeBinsFeatureSet.js";
 import type FeatureSet from "../rest/support/FeatureSet.js";
@@ -43,7 +42,6 @@ import type { TimeZone } from "../time/types.js";
 import type { ObjectId } from "../views/types.js";
 import type { TimeExtentProperties } from "../time/TimeExtent.js";
 import type { TimeIntervalProperties } from "../time/TimeInterval.js";
-import type { TimeInfoProperties } from "./support/TimeInfo.js";
 import type { AttributeTableTemplateProperties } from "../tables/AttributeTableTemplate.js";
 import type { ElevationInfoProperties } from "../symbols/support/ElevationInfo.js";
 import type { FieldProperties } from "./support/Field.js";
@@ -400,58 +398,6 @@ export interface GeoJSONLayerProperties extends LayerProperties, PortalLayerProp
    * });
    */
   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, along with its `startField` and `endField` properties, must be set at the
-   * time of layer initialization if it is being set for a [GeoJSONLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/GeoJSONLayer/).
-   * The timeInfo parameters cannot be changed after the layer is [loaded](https://developers.arcgis.com/javascript/latest/references/core/layers/GeoJSONLayer/#loaded).
-   * The [TimeInfo.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.
-   *
-   * @since 4.11
-   * @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.
-   *   // timeExtent is automatically calculated from the start and end date fields
-   *   // The date values must be in milliseconds number from the UNIX epoch specified in UTC.
-   *   timeInfo: {
-   *     startField: "time"
-   *   }
-   * });
-   * @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.
@@ -484,6 +430,7 @@ export interface GeoJSONLayerProperties extends LayerProperties, PortalLayerProp
    *     }
    *   }
    * });
+   * @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({
@@ -1214,59 +1161,6 @@ export default class GeoJSONLayer extends GeoJSONLayerSuperclass {
    */
   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, along with its `startField` and `endField` properties, must be set at the
-   * time of layer initialization if it is being set for a [GeoJSONLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/GeoJSONLayer/).
-   * The timeInfo parameters cannot be changed after the layer is [loaded](https://developers.arcgis.com/javascript/latest/references/core/layers/GeoJSONLayer/#loaded).
-   * The [TimeInfo.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.
-   *
-   * @since 4.11
-   * @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.
-   *   // timeExtent is automatically calculated from the start and end date fields
-   *   // The date values must be in milliseconds number from the UNIX epoch specified in UTC.
-   *   timeInfo: {
-   *     startField: "time"
-   *   }
-   * });
-   * @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.
@@ -1299,6 +1193,7 @@ export default class GeoJSONLayer extends GeoJSONLayerSuperclass {
    *     }
    *   }
    * });
+   * @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/IntegratedMeshLayer.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/6.0/LICENSE.txt */
-import{__addDisposableResource as e,__disposeResources as t,__decorate as n}from"tslib";import{isSome as r}from"../core/arrayUtils.js";import{ClonableMixin as i}from"../core/Clonable.js";import a from"../core/Error.js";import{abortHandle as o,disposable as s,makeHandle as c}from"../core/handleUtils.js";import has from"../core/has.js";import l from"../core/Logger.js";import{MultiOriginJSONSupportMixin as u}from"../core/MultiOriginJSONSupport.js";import{throwIfAborted as d,throwIfAbortError as f}from"../core/promiseUtils.js";import{on as p,sync as m,watch as h}from"../core/reactiveUtils.js";import{property as g,subclass as _}from"../core/accessorSupport/decorators.js";import{persistable as v}from"../core/accessorSupport/decorators/persistable.js";import y from"./Layer.js";import{APIKeyMixin as b}from"./mixins/APIKeyMixin.js";import{ArcGISService as x}from"./mixins/ArcGISService.js";import{CustomParametersMixin as S}from"./mixins/CustomParametersMixin.js";import{OperationalLayer as C}from"./mixins/OperationalLayer.js";import{PortalLayer as w}from"./mixins/PortalLayer.js";import{ScaleRangeLayer as T}from"./mixins/ScaleRangeLayer.js";import{SceneService as E}from"./mixins/SceneService.js";import{elevationInfo as D}from"./support/commonProperties.js";import{GeometryDescriptor as O}from"./support/GeometryDescriptor.js";import{queryIntegratedMeshElevation as k,defaultNoDataValue as A}from"./support/I3SIntegratedMeshElevationQuery.js";import{I3SNodePageDefinition as j,I3SMaterialDefinition as M,I3STextureSetDefinition as N,I3SGeometryDefinition as P}from"./support/I3SLayerDefinitions.js";import F from"./support/SceneModifications.js";import{logInvalidElevationInfoWarning as I,elevationModeRequiredMessage as L,featureExpressionUnsupportedMessage as R}from"../support/elevationInfoUtils.js";import{isGround as z}from"../support/groundInstanceUtils.js";import{f as B}from"../chunks/persistableUrlUtils.js";import{isBasemap as V}from"../support/userTypeGuards/isBasemap.js";import{SceneLayerWorkerHandle as H}from"../views/3d/layers/SceneLayerWorkerHandle.js";import{I3SDataRequester as U}from"../views/3d/layers/i3s/I3SDataRequester.js";import W from"../views/3d/layers/i3s/I3SNodeLoader.js";import{ImmediateTask as G}from"../views/support/Scheduler.js";import{reader as K}from"../core/accessorSupport/decorators/reader.js";let q=class extends E(x(C(w(T(u(S(b(i(y))))))))){constructor(...e){super(...e),this.geometryType=`mesh`,this.operationalLayerType=`IntegratedMeshLayer`,this.type=`integrated-mesh`,this.nodePages=null,this.materialDefinitions=null,this.textureSetDefinitions=null,this.geometryDefinitions=null,this.serviceUpdateTimeStamp=null,this.profile=`mesh-pyramids`,this.modifications=null,this._modificationsSource=null,this.path=null,this.definitionExpression=null,this._elevationQueryAbortController=new AbortController,this._elevationQueryWorkerContext=`i3s-elevation-query-${this.uid}`,this._elevationQueryWorkerHandle=null,this._elevationQueryWorkerSetup=null,this._modificationsGeneration=0}destroy(){this._elevationQueryAbortController.abort();let e=this._elevationQueryWorkerHandle;this._elevationQueryWorkerHandle=null,this._elevationQueryWorkerSetup=null,e?.destroyContextAndSelf(this._elevationQueryWorkerContext),super.destroy()}initialize(){this.addHandles([p(()=>this.modifications,`after-changes`,()=>{this.modifications=this.modifications,this._modificationsGeneration++},m),h(()=>this.modifications,()=>this._modificationsGeneration++,m),h(()=>this.memoizedElevationQueryDependencies,()=>this._abortElevationQueriesAfterDependencyChange(),m)])}normalizeCtorArgs(e,t){return typeof e==`string`?{url:e,...t}:e}readModifications(e,t,n){this._modificationsSource={url:B(e,n),context:n}}set elevationInfo(e){(e==null||e.mode===`absolute-height`)&&this._set(`elevationInfo`,e),this._validateElevationInfo(e)}async load(e){return this.addResolvingPromise(this._doLoad(e)),this}get _elevationQueryWorker(){return this._elevationQueryWorkerHandle??=new H((e,t)=>G.schedule(e,t))}get memoizedElevationQueryDependencies(){return[this.elevationInfo?.offset,this._modificationsGeneration]}async queryElevation(n,i,a){let l={stack:[],error:void 0,hasError:!1};try{let t=a?.noDataValue??Number.MAX_VALUE,u=this._elevationQueryWorker,f=new AbortController;n.addHandles(o(f),f),e(l,s(c(()=>n.removeHandles(f))),!1);let p=AbortSignal.any([a?.signal,this._elevationQueryAbortController.signal,f.signal].filter(r));await this.load({signal:p}),d(p);let m=O.fromGeometry(i),h={signal:p,elevationOffset:this.elevationInfo?.offset??0,scheduler:n.resourceController.scheduler};if(this._elevationQueryWorkerSetup==null){let e=this.store?.defaultGeometrySchema;e!=null&&(this._elevationQueryWorkerSetup=u.setLegacySchema(this._elevationQueryWorkerContext,e))}let g=await k(this,m,h);d(p);let _=g.coordinates[0].z===A;_&&(g.coordinates[0].z=t);let v=await g.project(i.spatialReference,p);d(p);let y=v??m.clone(),b={geometry:y.export(),noDataValue:t};return a?.returnSampleInfo&&(b.sampleInfo=y.coordinates.map(()=>({demResolution:_?-1:1}))),b}catch(e){l.error=e,l.hasError=!0}finally{t(l)}}_abortElevationQueriesAfterDependencyChange(){let e=this._elevationQueryAbortController;this._elevationQueryAbortController=new AbortController,e.abort()}async processElevationQueryGeometry(e,t){return await this._elevationQueryWorkerSetup,d(t),this._elevationQueryWorker.invoke(e,t)}async _doLoad(e){let t=e?.signal;try{await this.loadFromPortal({supportedTypes:[`Scene Service`]},e)}catch(e){f(e)}if(d(t),await this._fetchService(t),d(t),this._modificationsSource!=null){let n=await F.fromUrl(this._modificationsSource.url,this.spatialReference,e);d(t),this.setAtOrigin(`modifications`,n,this._modificationsSource.context.origin),this._modificationsSource=null}await this._fetchIndexAndUpdateExtent(this.nodePages,t),d(t)}beforeSave(){if(this._modificationsSource!=null)return this.load().then(()=>{},()=>{})}async saveAs(e,t){return this._debouncedSaveOperations(1,{...t,getTypeKeywords:()=>this._getTypeKeywords(),portalItemLayerType:`integrated-mesh`},e)}async save(){return this._debouncedSaveOperations(0,{getTypeKeywords:()=>this._getTypeKeywords(),portalItemLayerType:`integrated-mesh`})}get isUsedAsGroundLayer(){return!has(`enable-feature:im-as-ground`)||V(this.parent)||z(this.parent)}get replacesTerrain(){return!1}validateLayer(e){if(e.layerType&&e.layerType!==`IntegratedMesh`)throw new a(`integrated-mesh-layer:layer-type-not-supported`,`IntegratedMeshLayer does not support this layer type`,{layerType:e.layerType});if(isNaN(this.version.major)||isNaN(this.version.minor))throw new a(`layer:service-version-not-supported`,`Service version is not supported.`,{serviceVersion:this.version.versionString,supportedVersions:`1.x`});if(this.version.major>1)throw new a(`layer:service-version-too-new`,`Service version is too new.`,{serviceVersion:this.version.versionString,supportedVersions:`1.x`})}_getTypeKeywords(){return[`IntegratedMeshLayer`]}get elevationQueryDataRequester(){return new U(this.customParameters,this.apiKey)}get elevationQueryNodeLoader(){return new W(this,this.elevationQueryDataRequester,l.getLogger(`esri.layers.IntegratedMeshLayer`),this.store?.defaultGeometrySchema,[],{loadFeatureData:!1,textureUsageMask:0})}_validateElevationInfo(e){let t=`Integrated mesh layers`;I(l.getLogger(this),L(t,`absolute-height`,e)),I(l.getLogger(this),R(t,e))}};n([g({type:String,readOnly:!0})],q.prototype,`geometryType`,void 0),n([g({type:[`show`,`hide`]})],q.prototype,`listMode`,void 0),n([g({type:[`IntegratedMeshLayer`]})],q.prototype,`operationalLayerType`,void 0),n([g({json:{read:!1},readOnly:!0})],q.prototype,`type`,void 0),n([g({type:j,readOnly:!0,clonable:!1})],q.prototype,`nodePages`,void 0),n([g({type:[M],readOnly:!0,clonable:!1})],q.prototype,`materialDefinitions`,void 0),n([g({type:[N],readOnly:!0,clonable:!1})],q.prototype,`textureSetDefinitions`,void 0),n([g({type:[P],readOnly:!0,clonable:!1})],q.prototype,`geometryDefinitions`,void 0),n([g({readOnly:!0})],q.prototype,`serviceUpdateTimeStamp`,void 0),n([g({type:F,clonable:e=>e?.clone()??e}),v({origins:[`web-scene`,`portal-item`],type:`resource`,prefix:`modifications`})],q.prototype,`modifications`,void 0),n([g({clonable:e=>e?{...e}:null})],q.prototype,`_modificationsSource`,void 0),n([K([`web-scene`,`portal-item`],`modifications`)],q.prototype,`readModifications`,null),n([g(D)],q.prototype,`elevationInfo`,null),n([g({type:String,json:{origins:{"web-scene":{read:!0,write:!0},"portal-item":{read:!0,write:!0}},read:!1}})],q.prototype,`path`,void 0),n([g({clonable:!1})],q.prototype,`_elevationQueryWorker`,null),n([g()],q.prototype,`_modificationsGeneration`,void 0),n([g()],q.prototype,`memoizedElevationQueryDependencies`,null),n([g()],q.prototype,`isUsedAsGroundLayer`,null),n([g()],q.prototype,`replacesTerrain`,null),n([g({clonable:!1})],q.prototype,`elevationQueryDataRequester`,null),n([g({clonable:!1})],q.prototype,`elevationQueryNodeLoader`,null),q=n([_(`esri.layers.IntegratedMeshLayer`)],q);const J=q;export{J as default};
+import{__addDisposableResource as e,__disposeResources as t,__decorate as n}from"tslib";import{isSome as r}from"../core/arrayUtils.js";import{result as i,assertResult as a}from"../core/asyncUtils.js";import{ClonableMixin as o}from"../core/Clonable.js";import s from"../core/Error.js";import{abortHandle as c,disposable as l,makeHandle as u}from"../core/handleUtils.js";import has from"../core/has.js";import d from"../core/Logger.js";import{MultiOriginJSONSupportMixin as f}from"../core/MultiOriginJSONSupport.js";import{throwIfAborted as p,throwIfAbortError as m}from"../core/promiseUtils.js";import{on as h,sync as g,watch as _}from"../core/reactiveUtils.js";import{property as v,subclass as y}from"../core/accessorSupport/decorators.js";import{persistable as b}from"../core/accessorSupport/decorators/persistable.js";import x from"./Layer.js";import{APIKeyMixin as S}from"./mixins/APIKeyMixin.js";import{ArcGISService as C}from"./mixins/ArcGISService.js";import{CustomParametersMixin as w}from"./mixins/CustomParametersMixin.js";import{OperationalLayer as T}from"./mixins/OperationalLayer.js";import{PortalLayer as E}from"./mixins/PortalLayer.js";import{ScaleRangeLayer as D}from"./mixins/ScaleRangeLayer.js";import{SceneService as O}from"./mixins/SceneService.js";import{elevationInfo as k}from"./support/commonProperties.js";import{GeometryDescriptor as A}from"./support/GeometryDescriptor.js";import{queryIntegratedMeshElevation as j,defaultNoDataValue as M}from"./support/I3SIntegratedMeshElevationQuery.js";import{I3SNodePageDefinition as N,I3SMaterialDefinition as P,I3STextureSetDefinition as F,I3SGeometryDefinition as I}from"./support/I3SLayerDefinitions.js";import L from"./support/SceneModifications.js";import{logInvalidElevationInfoWarning as R,elevationModeRequiredMessage as z,featureExpressionUnsupportedMessage as B}from"../support/elevationInfoUtils.js";import{isGround as V}from"../support/groundInstanceUtils.js";import{f as H}from"../chunks/persistableUrlUtils.js";import{isBasemap as U}from"../support/userTypeGuards/isBasemap.js";import{SceneLayerWorkerHandle as W}from"../views/3d/layers/SceneLayerWorkerHandle.js";import{I3SDataRequester as G}from"../views/3d/layers/i3s/I3SDataRequester.js";import K from"../views/3d/layers/i3s/I3SNodeLoader.js";import{ImmediateTask as q}from"../views/support/Scheduler.js";import{reader as J}from"../core/accessorSupport/decorators/reader.js";let Y=class extends O(C(T(E(D(f(w(S(o(x))))))))){constructor(...e){super(...e),this.geometryType=`mesh`,this.operationalLayerType=`IntegratedMeshLayer`,this.type=`integrated-mesh`,this.nodePages=null,this.materialDefinitions=null,this.textureSetDefinitions=null,this.geometryDefinitions=null,this.serviceUpdateTimeStamp=null,this.profile=`mesh-pyramids`,this.modifications=null,this._modificationsSource=null,this.path=null,this.definitionExpression=null,this._elevationQueryAbortController=new AbortController,this._elevationQueryWorkerContext=`i3s-elevation-query-${this.uid}`,this._elevationQueryWorkerHandle=null,this._elevationQueryWorkerSetup=null,this._modificationsGeneration=0}destroy(){this._elevationQueryAbortController.abort();let e=this._elevationQueryWorkerHandle;this._elevationQueryWorkerHandle=null,this._elevationQueryWorkerSetup=null,e?.destroyContextAndSelf(this._elevationQueryWorkerContext),super.destroy()}initialize(){this.addHandles([h(()=>this.modifications,`after-changes`,()=>{this.modifications=this.modifications,this._modificationsGeneration++},g),_(()=>this.modifications,()=>this._modificationsGeneration++,g),_(()=>this.memoizedElevationQueryDependencies,()=>this._abortElevationQueriesAfterDependencyChange(),g)])}normalizeCtorArgs(e,t){return typeof e==`string`?{url:e,...t}:e}readModifications(e,t,n){this._modificationsSource={url:H(e,n),context:n}}set elevationInfo(e){(e==null||e.mode===`absolute-height`)&&this._set(`elevationInfo`,e),this._validateElevationInfo(e)}async load(e){return this.addResolvingPromise(this._doLoad(e)),this}get _elevationQueryWorker(){return this._elevationQueryWorkerHandle??=new W((e,t)=>q.schedule(e,t))}get memoizedElevationQueryDependencies(){return[this.elevationInfo?.offset,this._modificationsGeneration]}async queryElevation(n,a,o){let s={stack:[],error:void 0,hasError:!1};try{let t=o?.noDataValue??Number.MAX_VALUE,d=this._elevationQueryWorker,f=new AbortController;n.addHandles(c(f),f),e(s,l(u(()=>n.removeHandles(f))),!1);let m=AbortSignal.any([o?.signal,this._elevationQueryAbortController.signal,f.signal].filter(r));await this.load({signal:m}),p(m);let h=A.fromGeometry(a),g={signal:m,elevationOffset:this.elevationInfo?.offset??0,scheduler:n.resourceController.scheduler};if(this._elevationQueryWorkerSetup==null){let e=this.store?.defaultGeometrySchema;e!=null&&(this._elevationQueryWorkerSetup=i(d.setLegacySchema(this._elevationQueryWorkerContext,e)))}let _=await j(this,h,g);p(m);let v=_.coordinates[0].z===M;v&&(_.coordinates[0].z=t);let y=await _.project(a.spatialReference,m);p(m);let b=y??h.clone(),x={geometry:b.export(),noDataValue:t};return o?.returnSampleInfo&&(x.sampleInfo=b.coordinates.map(()=>({demResolution:v?-1:1}))),x}catch(e){s.error=e,s.hasError=!0}finally{t(s)}}_abortElevationQueriesAfterDependencyChange(){let e=this._elevationQueryAbortController;this._elevationQueryAbortController=new AbortController,e.abort()}async processElevationQueryGeometry(e,t){let n=await this._elevationQueryWorkerSetup;return n!=null&&a(n),p(t),this._elevationQueryWorker.invoke(e,t)}async _doLoad(e){let t=e?.signal;try{await this.loadFromPortal({supportedTypes:[`Scene Service`]},e)}catch(e){m(e)}if(p(t),await this._fetchService(t),p(t),this._modificationsSource!=null){let n=await L.fromUrl(this._modificationsSource.url,this.spatialReference,e);p(t),this.setAtOrigin(`modifications`,n,this._modificationsSource.context.origin),this._modificationsSource=null}await this._fetchIndexAndUpdateExtent(this.nodePages,t),p(t)}beforeSave(){if(this._modificationsSource!=null)return this.load().then(()=>{},()=>{})}async saveAs(e,t){return this._debouncedSaveOperations(1,{...t,getTypeKeywords:()=>this._getTypeKeywords(),portalItemLayerType:`integrated-mesh`},e)}async save(){return this._debouncedSaveOperations(0,{getTypeKeywords:()=>this._getTypeKeywords(),portalItemLayerType:`integrated-mesh`})}get isUsedAsGroundLayer(){return!has(`enable-feature:im-as-ground`)||U(this.parent)||V(this.parent)}get replacesTerrain(){return!1}validateLayer(e){if(e.layerType&&e.layerType!==`IntegratedMesh`)throw new s(`integrated-mesh-layer:layer-type-not-supported`,`IntegratedMeshLayer does not support this layer type`,{layerType:e.layerType});if(isNaN(this.version.major)||isNaN(this.version.minor))throw new s(`layer:service-version-not-supported`,`Service version is not supported.`,{serviceVersion:this.version.versionString,supportedVersions:`1.x`});if(this.version.major>1)throw new s(`layer:service-version-too-new`,`Service version is too new.`,{serviceVersion:this.version.versionString,supportedVersions:`1.x`})}_getTypeKeywords(){return[`IntegratedMeshLayer`]}get elevationQueryDataRequester(){return new G(this.customParameters,this.apiKey)}get elevationQueryNodeLoader(){return new K(this,this.elevationQueryDataRequester,d.getLogger(`esri.layers.IntegratedMeshLayer`),this.store?.defaultGeometrySchema,[],{loadFeatureData:!1,textureUsageMask:0})}_validateElevationInfo(e){let t=`Integrated mesh layers`;R(d.getLogger(this),z(t,`absolute-height`,e)),R(d.getLogger(this),B(t,e))}};n([v({type:String,readOnly:!0})],Y.prototype,`geometryType`,void 0),n([v({type:[`show`,`hide`]})],Y.prototype,`listMode`,void 0),n([v({type:[`IntegratedMeshLayer`]})],Y.prototype,`operationalLayerType`,void 0),n([v({json:{read:!1},readOnly:!0})],Y.prototype,`type`,void 0),n([v({type:N,readOnly:!0,clonable:!1})],Y.prototype,`nodePages`,void 0),n([v({type:[P],readOnly:!0,clonable:!1})],Y.prototype,`materialDefinitions`,void 0),n([v({type:[F],readOnly:!0,clonable:!1})],Y.prototype,`textureSetDefinitions`,void 0),n([v({type:[I],readOnly:!0,clonable:!1})],Y.prototype,`geometryDefinitions`,void 0),n([v({readOnly:!0})],Y.prototype,`serviceUpdateTimeStamp`,void 0),n([v({type:L,clonable:e=>e?.clone()??e}),b({origins:[`web-scene`,`portal-item`],type:`resource`,prefix:`modifications`})],Y.prototype,`modifications`,void 0),n([v({clonable:e=>e?{...e}:null})],Y.prototype,`_modificationsSource`,void 0),n([J([`web-scene`,`portal-item`],`modifications`)],Y.prototype,`readModifications`,null),n([v(k)],Y.prototype,`elevationInfo`,null),n([v({type:String,json:{origins:{"web-scene":{read:!0,write:!0},"portal-item":{read:!0,write:!0}},read:!1}})],Y.prototype,`path`,void 0),n([v({clonable:!1})],Y.prototype,`_elevationQueryWorker`,null),n([v()],Y.prototype,`_modificationsGeneration`,void 0),n([v()],Y.prototype,`memoizedElevationQueryDependencies`,null),n([v()],Y.prototype,`isUsedAsGroundLayer`,null),n([v()],Y.prototype,`replacesTerrain`,null),n([v({clonable:!1})],Y.prototype,`elevationQueryDataRequester`,null),n([v({clonable:!1})],Y.prototype,`elevationQueryNodeLoader`,null),Y=n([y(`esri.layers.IntegratedMeshLayer`)],Y);const X=Y;export{X as default};

package/layers/MapImageLayer.d.ts

@@ -264,7 +264,8 @@ export interface MapImageLayerEvents extends RefreshableLayerEvents, LayerEvents
  * [Dynamic workspace layers](https://developers.arcgis.com/javascript/latest/references/core/rest/layerSources/DynamicWorkspaceLayer/) allow you
  * to use pre-authored ArcGIS Pro layer files (`.lyrx`) stored in registered folders.
  * These layers support advanced renderers and cartographically enriched symbols
- * that are not supported by the map service's REST API specifications.
+ * that are not supported by the map service's REST API specifications. Set a sublayer's
+ * [source](https://developers.arcgis.com/javascript/latest/references/core/layers/support/Sublayer/#source) to a DynamicWorkspaceLayer to use one in a MapImageLayer.
  *
  * > [!WARNING]
  * >

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/SubtypeGroupLayer.d.ts

@@ -5,6 +5,7 @@ import type Layer from "./Layer.js";
 import type Field from "./support/Field.js";
 import type SubtypeSublayer from "./support/SubtypeSublayer.js";
 import type PortalItem from "../portal/PortalItem.js";
+import type DynamicWorkspaceLayer from "../rest/layerSources/DynamicWorkspaceLayer.js";
 import type AttachmentInfo from "../rest/query/support/AttachmentInfo.js";
 import type FeatureSet from "../rest/support/FeatureSet.js";
 import type Query from "../rest/support/Query.js";
@@ -30,10 +31,41 @@ import type { RequestOptions } from "../request/types.js";
 import type { AttachmentQueryProperties } from "../rest/support/AttachmentQuery.js";
 import type { QueryProperties } from "../rest/support/Query.js";
 import type { RelationshipQueryProperties } from "../rest/support/RelationshipQuery.js";
+import type { DynamicWorkspaceLayerProperties } from "../rest/layerSources/DynamicWorkspaceLayer.js";
 import type { SubtypeSublayerProperties } from "./support/SubtypeSublayer.js";
 import type { ReadonlyArrayOrCollection } from "../core/Collection.js";
 
 export interface SubtypeGroupLayerProperties extends LayerProperties, APIKeyMixinProperties, CustomParametersMixinProperties, PortalLayerProperties, OperationalLayerProperties, RefreshableLayerProperties, ScaleRangeLayerProperties, TemporalLayerProperties, BlendLayerProperties, DisplayFilteredLayerProperties, FeatureLayerBaseProperties, Partial<Pick<SubtypeGroupLayer, "outFields">> {
+  /**
+   * A dynamic workspace source that identifies a pre-authored ArcGIS Pro layer file (`.lyrx`) in a registered workspace.
+   * Set this property instead of `layerId` to use the workspace layer as the data source for this SubtypeGroupLayer.
+   * The map service must have dynamic layers enabled, and the workspace layer must have a subtype field.
+   *
+   * > [!WARNING]
+   * >
+   * > **Known Limitations**
+   * >
+   * > A SubtypeGroupLayer with a `dynamicDataSource` cannot be persisted to web maps, web scenes, or portal items.
+   *
+   * @internal
+   * @beta
+   * @since 5.2
+   * @see [DynamicWorkspaceLayer](https://developers.arcgis.com/javascript/latest/references/core/rest/layerSources/DynamicWorkspaceLayer/)
+   * @example
+   * ```js
+   * const DynamicWorkspaceLayer = await $arcgis.import("@arcgis/core/rest/layerSources/DynamicWorkspaceLayer.js");
+   * const SubtypeGroupLayer = await $arcgis.import("@arcgis/core/layers/SubtypeGroupLayer.js");
+   *
+   * const layer = new SubtypeGroupLayer({
+   *   url: "<your-map-service-url>"
+   * });
+   * layer.dynamicDataSource = new DynamicWorkspaceLayer({
+   *   workspaceId: "lyrx_folder",
+   *   layerId: "SubtypeGroup.lyrx"
+   * });
+   * ```
+   */
+  dynamicDataSource?: DynamicWorkspaceLayerProperties | null;
   /**
    * A [Collection](https://developers.arcgis.com/javascript/latest/references/core/core/Collection/) of [SubtypeSublayer](https://developers.arcgis.com/javascript/latest/references/core/layers/support/SubtypeSublayer/) objects that allow
    * you to alter the properties of one or more sublayers of the SubtypeGroupLayer.
@@ -185,6 +217,37 @@ export default class SubtypeGroupLayer extends SubtypeGroupLayerSuperclass {
    */
   "@eventTypes": SubtypeGroupLayerEvents;
   constructor(properties?: SubtypeGroupLayerProperties);
+  /**
+   * A dynamic workspace source that identifies a pre-authored ArcGIS Pro layer file (`.lyrx`) in a registered workspace.
+   * Set this property instead of `layerId` to use the workspace layer as the data source for this SubtypeGroupLayer.
+   * The map service must have dynamic layers enabled, and the workspace layer must have a subtype field.
+   *
+   * > [!WARNING]
+   * >
+   * > **Known Limitations**
+   * >
+   * > A SubtypeGroupLayer with a `dynamicDataSource` cannot be persisted to web maps, web scenes, or portal items.
+   *
+   * @internal
+   * @beta
+   * @since 5.2
+   * @see [DynamicWorkspaceLayer](https://developers.arcgis.com/javascript/latest/references/core/rest/layerSources/DynamicWorkspaceLayer/)
+   * @example
+   * ```js
+   * const DynamicWorkspaceLayer = await $arcgis.import("@arcgis/core/rest/layerSources/DynamicWorkspaceLayer.js");
+   * const SubtypeGroupLayer = await $arcgis.import("@arcgis/core/layers/SubtypeGroupLayer.js");
+   *
+   * const layer = new SubtypeGroupLayer({
+   *   url: "<your-map-service-url>"
+   * });
+   * layer.dynamicDataSource = new DynamicWorkspaceLayer({
+   *   workspaceId: "lyrx_folder",
+   *   layerId: "SubtypeGroup.lyrx"
+   * });
+   * ```
+   */
+  get dynamicDataSource(): DynamicWorkspaceLayer | null | undefined;
+  set dynamicDataSource(value: DynamicWorkspaceLayerProperties | null | undefined);
   /**
    * Determines if the layer is editable.
    *

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 {