@arcgis/core 5.2.0-next.163 → 5.2.0-next.164

package/geometry/support/plane.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{clamp as e}from"../../core/mathUtils.js";import{exactEquals as t,subtract as n,normalize as r,dot as i,lerp as a,copy as o,add as s,scale as c,cross as l,set as u,scaleAndAdd as d}from"../../core/libs/gl-matrix-2/math/vec3.js";import{create as f}from"../../core/libs/gl-matrix-2/factories/vec3f64.js";import{equals as p,exactEquals as m}from"../../core/libs/gl-matrix-2/math/vec4.js";import{projectPointSignedLength as h}from"./vector.js";import{sv3d as g,sv4d as ee}from"./vectorStacks.js";import{tangentFrame as te}from"../../views/3d/support/mathUtils.js";function _(e=Z){return[e[0],e[1],e[2],e[3]]}const v=m,ne=p;function re(e=Z[0],t=Z[1],n=Z[2],r=Z[3]){return x(e,t,n,r,ee.get())}function y(e,t){return x(t[0],t[1],t[2],t[3],e)}function b(e){return e}function x(e,t,n,r,i=_()){return i[0]=e,i[1]=t,i[2]=n,i[3]=r,i}function S(e,t,n){return o(n,e),n[3]=t,n}function C(e,t,n){let r=t[0]*t[0]+t[1]*t[1]+t[2]*t[2],i=Math.abs(r-1)>1e-5&&r>1e-12?1/Math.sqrt(r):1;return n[0]=t[0]*i,n[1]=t[1]*i,n[2]=t[2]*i,n[3]=-(n[0]*e[0]+n[1]*e[1]+n[2]*e[2]),n}function w(e,t,n,r=_()){let i=n[0]-t[0],a=n[1]-t[1],o=n[2]-t[2],s=e[0]-t[0],c=e[1]-t[1],l=e[2]-t[2],u=a*l-o*c,d=o*s-i*l,f=i*c-a*s,p=u*u+d*d+f*f,m=Math.abs(p-1)>1e-5&&p>1e-12?1/Math.sqrt(p):1;return r[0]=u*m,r[1]=d*m,r[2]=f*m,r[3]=-(r[0]*e[0]+r[1]*e[1]+r[2]*e[2]),r}function T(e,a,o,s=0,c=Math.floor(1/3*o),l=Math.floor(2/3*o)){if(o<3)return!1;a(D,s);let u=c,d=!1;for(;u<o-1&&!d;)a(O,u),u++,d=!t(D,O);if(!d)return!1;for(u=Math.max(u,l),d=!1;u<o&&!d;)a(k,u),u++,n(A,D,O),r(A,A),n(j,O,k),r(j,j),d=!t(D,k)&&!t(O,k)&&Math.abs(i(A,j))<E;return d?(w(D,O,k,e),!0):s===0&&c===1&&l===2?!1:T(e,a,o,0,1,2)}function ie(e,t,n=!0){let r=t.length/3;return T(e,(e,n)=>u(e,t[n*3+0],t[n*3+1],t[n*3+2]),n?r-1:r)}const E=.99619469809,D=f(),O=f(),k=f(),A=f(),j=f();function ae(e,t,n){return t!==e&&y(e,t),e[3]=-i(b(e),n),e}function M(e,t){return t[0]=-e[0],t[1]=-e[1],t[2]=-e[2],t[3]=-e[3],t}function oe(e,t,n,r){return l(k,t,e),C(n,k,r)}function N(e,t,r,i){return Y(X(e,t,n(g.get(),r,t),le,i))}function P(e,t,n){return t!=null&&Y(X(e,t.origin,t.direction,ue,n))}function F(e,t,n){return Y(X(e,t.origin,t.vector,0,n))}function I(e,t,n){return Y(X(e,t.origin,t.vector,1,n))}function L(e,t){return J(e,t)<=0}function R(e,t){return J(e,t)>=0}function z(e,t){return V(e,t.ray.origin,t.ray.direction,t,!1,!1,!0)}function B(e,t){return V(e,t.ray.origin,t.ray.direction,t,!1,!1,!1)}function V(e,t,n,r,a,o,s){let c=i(b(e),n),l=J(e,t);if(c>-1e-6&&c<1e-6)return H(l,a,o);let u=-l/c,d=H(c,a,!1);return s&&!d&&!H(l,a,o)?!1:(d?u>r.c0&&(r.c0=u):u<r.c1&&(r.c1=u),r.c0<=r.c1)}function H(e,t,n){return n?t?e>=0:e<=0:t?e>0:e<0}function U(e,t,n,r=!1){let i=t.at(-1),s=J(e,i),c=r?s>0:s<=0;for(let l=0;l<t.length;l++){let u=t.at(l),d=J(e,u),f=r?d>0:d<=0;c!==f&&a(n(),i,u,s/(s-d)),f&&o(n(),u),i=u,s=d,c=f}}function W(e,t,r,i,a,o=!1){return n(Q,r,t),$.c0=0,$.c1=1,V(e,t,Q,$,o,!o,!1)?(d(i,t,Q,$.c0),d(a,t,Q,$.c1),!0):!1}function G(e,t,r){let i=c(g.get(),b(e),-e[3]),a=q(e,n(g.get(),t,i),g.get());return s(r,a,i),r}function K(e,t,r,i){let a=b(e),o=g.get(),s=g.get();te(a,o,s);let c=n(g.get(),r,t),l=h(o,c),d=h(s,c),f=h(a,c);return u(i,l,d,f)}function q(e,t,r){let a=c(g.get(),b(e),i(b(e),t));return n(r,t,a),r}function se(e,t){return Math.abs(J(e,t))}function J(e,t){return i(b(e),t)+e[3]}function ce(e,t,n){for(let r=0;r<n;++r)if(L(e,t[r]))return!1;return!0}function Y(e){return e===0||e===1}function X(t,n,r,a,o){let l=i(b(t),r),u=J(t,n);if(l===0)return u>=0?2:3;let d=-u/l;return a&1&&(d=e(d,0,1)),!(a&4)&&d<0||!(a&8)&&d>1?u>=0?2:3:(s(o,n,c(o,r,d)),u>=0?0:1)}const Z=[0,0,1,0],le=12,ue=8,Q=f(),$={c0:0,c1:1};export{ce as areAllPointsOutside,z as clip,B as clipInfinite,W as clipLineSegment,U as clipPolygon,y as copy,_ as create,se as distance,ne as equals,v as exactEquals,ie as fromArray,T as fromManyPoints,S as fromNormalAndOffset,w as fromPoints,C as fromPositionAndNormal,x as fromValues,oe as fromVectorsAndPoint,b as getNormal,N as intersectLine,X as intersectLineOrRay,F as intersectLineSegment,I as intersectLineSegmentClamp,P as intersectRay,R as isPointInClosedPositiveHalfspace,L as isPointInside,M as negate,G as projectPoint,K as projectPointLocal,q as projectVector,ae as setOffsetFromPoint,J as signedDistance,Z as up,re as wrap};
+import{clamp as e}from"../../core/mathUtils.js";import{exactEquals as t,subtract as n,normalize as r,dot as i,lerp as a,copy as o,add as s,scale as c,cross as l,set as u,scaleAndAdd as d}from"../../core/libs/gl-matrix-2/math/vec3.js";import{create as f}from"../../core/libs/gl-matrix-2/factories/vec3f64.js";import{equals as p,exactEquals as m}from"../../core/libs/gl-matrix-2/math/vec4.js";import{projectPointSignedLength as h}from"./vector.js";import{sv3d as g,sv4d as _}from"./vectorStacks.js";import{tangentFrame as ee}from"../../views/3d/support/mathUtils.js";function v(e=Z){return[e[0],e[1],e[2],e[3]]}const te=m,ne=p;function re(e=Z[0],t=Z[1],n=Z[2],r=Z[3]){return x(e,t,n,r,_.get())}function y(e,t){return x(t[0],t[1],t[2],t[3],e)}function b(e){return e}function x(e,t,n,r,i=v()){return i[0]=e,i[1]=t,i[2]=n,i[3]=r,i}function S(e,t,n){return o(n,e),n[3]=t,n}function C(e,t,n){let r=t[0]*t[0]+t[1]*t[1]+t[2]*t[2],i=Math.abs(r-1)>1e-5&&r>1e-12?1/Math.sqrt(r):1;return n[0]=t[0]*i,n[1]=t[1]*i,n[2]=t[2]*i,n[3]=-(n[0]*e[0]+n[1]*e[1]+n[2]*e[2]),n}function w(e,t,n,r=v()){let i=n[0]-t[0],a=n[1]-t[1],o=n[2]-t[2],s=e[0]-t[0],c=e[1]-t[1],l=e[2]-t[2],u=a*l-o*c,d=o*s-i*l,f=i*c-a*s,p=u*u+d*d+f*f,m=Math.abs(p-1)>1e-5&&p>1e-12?1/Math.sqrt(p):1;return r[0]=u*m,r[1]=d*m,r[2]=f*m,r[3]=-(r[0]*e[0]+r[1]*e[1]+r[2]*e[2]),r}function T(e,a,o,s=0,c=Math.floor(1/3*o),l=Math.floor(2/3*o)){if(o<3)return!1;a(D,s);let u=c,d=!1;for(;u<o-1&&!d;)a(O,u),u++,d=!t(D,O);if(!d)return!1;for(u=Math.max(u,l),d=!1;u<o&&!d;)a(k,u),u++,n(A,D,O),r(A,A),n(j,O,k),r(j,j),d=!t(D,k)&&!t(O,k)&&Math.abs(i(A,j))<ie;return d?(w(D,O,k,e),!0):s===0&&c===1&&l===2?!1:T(e,a,o,0,1,2)}function E(e,t,n=!0){let r=t.length/3;return T(e,(e,n)=>u(e,t[n*3+0],t[n*3+1],t[n*3+2]),n?r-1:r)}const ie=.99619469809,D=f(),O=f(),k=f(),A=f(),j=f();function ae(e,t,n){return t!==e&&y(e,t),e[3]=-i(b(e),n),e}function oe(e,t){return t[0]=-e[0],t[1]=-e[1],t[2]=-e[2],t[3]=-e[3],t}function se(e,t,n,r){return l(k,t,e),C(n,k,r)}function M(e,t,r,i){return Y(X(e,t,n(g.get(),r,t),ue,i))}function N(e,t,n){return t!=null&&Y(X(e,t.origin,t.direction,de,n))}function P(e,t,n){return Y(X(e,t.origin,t.vector,0,n))}function F(e,t,n){return Y(X(e,t.origin,t.vector,1,n))}function I(e,t){return q(e,t)<=0}function L(e,t){return q(e,t)>=0}function R(e,t){return V(e,t.ray.origin,t.ray.direction,t,!1,!1,!0,1e-6)}function z(e,t){return V(e,t.ray.origin,t.ray.direction,t,!1,!1,!1,1e-6)}function B(e,t){return t.c0<=t.c1&&V(e,t.ray.origin,t.ray.direction,t,!1,!0,!1,0)}function V(e,t,n,r,a,o,s,c){let l=i(b(e),n),u=q(e,t);if(l>=-c&&l<=c)return H(u,a,o);let d=-u/l,f=H(l,a,!1);return s&&!f&&!H(u,a,o)?!1:(f?d>r.c0&&(r.c0=d):d<r.c1&&(r.c1=d),r.c0<=r.c1)}function H(e,t,n){return n?t?e>=0:e<=0:t?e>0:e<0}function U(e,t,n,r=!1){let i=t.at(-1),s=q(e,i),c=r?s>0:s<=0;for(let l=0;l<t.length;l++){let u=t.at(l),d=q(e,u),f=r?d>0:d<=0;c!==f&&a(n(),i,u,s/(s-d)),f&&o(n(),u),i=u,s=d,c=f}}function W(e,t,r,i,a,o=!1){return n(Q,r,t),$.c0=0,$.c1=1,V(e,t,Q,$,o,!o,!1,1e-6)?(d(i,t,Q,$.c0),d(a,t,Q,$.c1),!0):!1}function G(e,t,r){let i=c(g.get(),b(e),-e[3]),a=K(e,n(g.get(),t,i),g.get());return s(r,a,i),r}function ce(e,t,r,i){let a=b(e),o=g.get(),s=g.get();ee(a,o,s);let c=n(g.get(),r,t),l=h(o,c),d=h(s,c),f=h(a,c);return u(i,l,d,f)}function K(e,t,r){let a=c(g.get(),b(e),i(b(e),t));return n(r,t,a),r}function le(e,t){return Math.abs(q(e,t))}function q(e,t){return i(b(e),t)+e[3]}function J(e,t,n){for(let r=0;r<n;++r)if(I(e,t[r]))return!1;return!0}function Y(e){return e===0||e===1}function X(t,n,r,a,o){let l=i(b(t),r),u=q(t,n);if(l===0)return u>=0?2:3;let d=-u/l;return a&1&&(d=e(d,0,1)),!(a&4)&&d<0||!(a&8)&&d>1?u>=0?2:3:(s(o,n,c(o,r,d)),u>=0?0:1)}const Z=[0,0,1,0],ue=12,de=8,Q=f(),$={c0:0,c1:1};export{J as areAllPointsOutside,R as clip,B as clipClosedNegativeHalfspace,z as clipInfinite,W as clipLineSegment,U as clipPolygon,y as copy,v as create,le as distance,ne as equals,te as exactEquals,E as fromArray,T as fromManyPoints,S as fromNormalAndOffset,w as fromPoints,C as fromPositionAndNormal,x as fromValues,se as fromVectorsAndPoint,b as getNormal,M as intersectLine,X as intersectLineOrRay,P as intersectLineSegment,F as intersectLineSegmentClamp,N as intersectRay,L as isPointInClosedPositiveHalfspace,I as isPointInside,oe as negate,G as projectPoint,ce as projectPointLocal,K as projectVector,ae as setOffsetFromPoint,q as signedDistance,Z as up,re as wrap};

package/kernel.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/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=`5.2.0-next.163`;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=`5.2.0-next.164`;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/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/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({