@arcgis/core 5.2.0-next.6 → 5.2.0-next.8

package/layers/mixins/DataSeriesLayer.d.ts

@@ -0,0 +1,161 @@
+import type TimeSeriesInfo from "../support/TimeSeriesInfo.js";
+import type { TimeSeriesInfoProperties } from "../support/TimeSeriesInfo.js";
+
+export interface DataSeriesLayerProperties {
+  /**
+   * An array of objects that define data series configurations for the layer. A data series
+   * describes a series of fields that represent a sequence of related data points over time or other dimensions.
+   * Client applications can use the information in a data series info to generate expressions for renderers,
+   * labels, popups, charts, or for other representations of the data to display in the web map. These may be
+   * defined and referenced by name in client applications for use in various contexts.
+   *
+   * @default null
+   * @example
+   * layer.dataSeriesInfos = [{
+   *   type: "time-series-fields",
+   *   name: "ts0",
+   *   title: "U.S. National Park Annual Visitation Numbers (10 year increments, 1910-2020)",
+   *   fieldTimeMappings: [
+   *     {
+   *       fieldName: "F1910",
+   *       timeValue: "1910"
+   *     },
+   *     {
+   *       fieldName: "F1920",
+   *       timeValue: "1920"
+   *     },
+   *     {
+   *       fieldName: "F1930",
+   *       timeValue: "1930"
+   *     },
+   *     {
+   *       fieldName: "F1940",
+   *       timeValue: "1940"
+   *     },
+   *     {
+   *       fieldName: "F1950",
+   *       timeValue: "1950"
+   *     },
+   *     {
+   *       fieldName: "F1960",
+   *       timeValue: "1960"
+   *     },
+   *     {
+   *       fieldName: "F1970",
+   *       timeValue: "1970"
+   *     },
+   *     {
+   *       fieldName: "F1980",
+   *       timeValue: "1980"
+   *     },
+   *     {
+   *       fieldName: "F1990",
+   *       timeValue: "1990"
+   *     },
+   *     {
+   *       fieldName: "F2000",
+   *       timeValue: "2000"
+   *     },
+   *     {
+   *       fieldName: "F2010",
+   *       timeValue: "2010"
+   *     },
+   *     {
+   *       fieldName: "F2020",
+   *       timeValue: "2020"
+   *     }
+   *   ],
+   *   timeInterval: 1,
+   *   timeValueUnits: "years",
+   *   timeIntervalUnits: "decades",
+   *   timeExtent: {
+   *     start: new Date("1910-01-01"),
+   *     end: new Date("2020-01-01")
+   *   }
+   * }];
+   */
+  dataSeriesInfos?: TimeSeriesInfoProperties[] | null;
+}
+
+/**
+ * Mixin for layers that support data series configurations.
+ *
+ * @since 5.1
+ */
+export abstract class DataSeriesLayer {
+  constructor(...args: any[]);
+  /**
+   * An array of objects that define data series configurations for the layer. A data series
+   * describes a series of fields that represent a sequence of related data points over time or other dimensions.
+   * Client applications can use the information in a data series info to generate expressions for renderers,
+   * labels, popups, charts, or for other representations of the data to display in the web map. These may be
+   * defined and referenced by name in client applications for use in various contexts.
+   *
+   * @default null
+   * @example
+   * layer.dataSeriesInfos = [{
+   *   type: "time-series-fields",
+   *   name: "ts0",
+   *   title: "U.S. National Park Annual Visitation Numbers (10 year increments, 1910-2020)",
+   *   fieldTimeMappings: [
+   *     {
+   *       fieldName: "F1910",
+   *       timeValue: "1910"
+   *     },
+   *     {
+   *       fieldName: "F1920",
+   *       timeValue: "1920"
+   *     },
+   *     {
+   *       fieldName: "F1930",
+   *       timeValue: "1930"
+   *     },
+   *     {
+   *       fieldName: "F1940",
+   *       timeValue: "1940"
+   *     },
+   *     {
+   *       fieldName: "F1950",
+   *       timeValue: "1950"
+   *     },
+   *     {
+   *       fieldName: "F1960",
+   *       timeValue: "1960"
+   *     },
+   *     {
+   *       fieldName: "F1970",
+   *       timeValue: "1970"
+   *     },
+   *     {
+   *       fieldName: "F1980",
+   *       timeValue: "1980"
+   *     },
+   *     {
+   *       fieldName: "F1990",
+   *       timeValue: "1990"
+   *     },
+   *     {
+   *       fieldName: "F2000",
+   *       timeValue: "2000"
+   *     },
+   *     {
+   *       fieldName: "F2010",
+   *       timeValue: "2010"
+   *     },
+   *     {
+   *       fieldName: "F2020",
+   *       timeValue: "2020"
+   *     }
+   *   ],
+   *   timeInterval: 1,
+   *   timeValueUnits: "years",
+   *   timeIntervalUnits: "decades",
+   *   timeExtent: {
+   *     start: new Date("1910-01-01"),
+   *     end: new Date("2020-01-01")
+   *   }
+   * }];
+   */
+  get dataSeriesInfos(): TimeSeriesInfo[] | null | undefined;
+  set dataSeriesInfos(value: TimeSeriesInfoProperties[] | null | undefined);
+}

package/layers/mixins/DataSeriesLayer.js

@@ -0,0 +1,2 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+import{__decorate as e}from"tslib";import{property as r,subclass as o}from"../../core/accessorSupport/decorators.js";import{excludeTables as s}from"../../core/accessorSupport/layerContainerType.js";import t from"../support/TimeSeriesInfo.js";const i=i=>{const a=i;let n=class extends a{constructor(){super(...arguments),this.dataSeriesInfos=null}};return e([r({type:[t],json:{write:{enabled:!0,allowNull:!0,layerContainerTypes:s},origins:{"web-scene":{write:!1,read:!1}}}})],n.prototype,"dataSeriesInfos",void 0),n=e([o("esri.layers.mixins.DataSeriesLayer")],n),n};export{i as DataSeriesLayer};

package/layers/mixins/FeatureLayerBase.d.ts

@@ -147,8 +147,8 @@ export abstract class FeatureLayerBase {
    * @default false
    * @since 4.21
    * @see [ArcGIS REST API - New in 10.9](https://developers.arcgis.com/rest/services-reference/enterprise/layer-table/#new-in-109)
-   * @see [What's new in ArcGIS Server](https://enterprise.arcgis.com/en/server/latest/get-started/windows/what-s-new-in-arcgis-for-server.htm)
-   * @see [Edit map service settings](https://enterprise.arcgis.com/en/server/latest/publish-services/windows/edit-map-service-settings.htm#LI_A5825E4A9A3A42E991C662CD7B76A860)
+   * @see [What's new in ArcGIS Server](https://doc.esri.com/en/arcgis-enterprise/latest/introduction/what-s-new-in-arcgis-enterprise.html)
+   * @see [Edit map service settings](https://doc.esri.com/en/arcgis-enterprise/latest/administer/edit-map-service-settings.html#LI_A5825E4A9A3A42E991C662CD7B76A860)
    * @example
    * // Only download data for the year 2020.
    * // if the layer supports unknown time zone then create
@@ -296,7 +296,7 @@ export abstract class FeatureLayerBase {
   set fullExtent(value: ExtentProperties | null | undefined);
   /**
    * The version of the geodatabase of the feature service data. Read
-   * the [Overview of versioning](https://pro.arcgis.com/en/pro-app/latest/help/data/geodatabases/overview/overview-of-versioning-in-arcgis-pro.htm) topic for more details
+   * the [Overview of versioning](https://doc.esri.com/en/arcgis-pro/latest/help/data/geodatabases/overview/overview-of-versioning-in-arcgis-pro.html) topic for more details
    * about this capability.
    */
   accessor gdbVersion: string | null | undefined;
@@ -329,17 +329,29 @@ export abstract class FeatureLayerBase {
    */
   accessor globalIdField: string | null | undefined;
   /**
-   * Indicates whether the client-side features in the layer have `M` (measurement) values.
-   * Use the `supportsM` property in the FeatureLayer's [capabilities.data](https://developers.arcgis.com/javascript/latest/references/core/layers/mixins/FeatureLayerBase/#capabilities)
-   * object to verify if `M` values are supported on [feature service](https://developers.arcgis.com/rest/services-reference/feature-service.htm) features.
+   * Indicates whether the layer has m aware geometries.
+   *  Use the `supportsM` property in the layer's [DataCapabilities](https://developers.arcgis.com/javascript/latest/references/core/layers/types/#DataCapabilities)
+   *  to verify if m-values are supported by the layer.
+   *
+   *  - When `true`: The layer has m aware features. M-values are part of the geometry.
+   *  - When `false`: The layer does not have m aware features. M-values are not part of the geometry.
+   *
+   * @see [returnM](https://developers.arcgis.com/javascript/latest/references/core/layers/mixins/FeatureLayerBase/#returnM) for details regarding fetching m-values with features from a layer
+   * @see [Linear referencing](https://pro.arcgis.com/en/pro-app/latest/help/data/linear-referencing/introduction-to-linear-referencing.htm)
    */
   accessor hasM: boolean;
   /**
-   * Indicates whether the client-side features in the layer have `Z` (elevation) values.
-   * Refer to [elevationInfo](https://developers.arcgis.com/javascript/latest/references/core/layers/mixins/FeatureLayerBase/#elevationInfo) for details regarding placement and rendering
-   * of features with z-values in 3D [SceneViews](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/).
-   * Use the `supportsZ` property in the FeatureLayer's [capabilities.data](https://developers.arcgis.com/javascript/latest/references/core/layers/mixins/FeatureLayerBase/#capabilities)
-   * object to verify if `Z` values are supported on [feature service](https://developers.arcgis.com/rest/services-reference/feature-service.htm) features.
+   * Indicates whether the layer has z aware geometries. Use the `supportsZ` property in the layer's [DataCapabilities](https://developers.arcgis.com/javascript/latest/references/core/layers/types/#DataCapabilities)
+   * to verify if z-values are supported by the layer.
+   *
+   *  - When `true`: The layer has z aware features. Z-values are part of the geometry.
+   *  - When `false`: The layer does not have z aware features. Z-values are not part of the geometry.
+   *  > [!NOTE]
+   *  > - Refer to [elevationInfo](https://developers.arcgis.com/javascript/latest/references/core/layers/mixins/FeatureLayerBase/#elevationInfo) for details regarding placement and rendering
+   *  > of features with z-values in 3D [SceneViews](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/).
+   *
+   * @see [returnZ](https://developers.arcgis.com/javascript/latest/references/core/layers/mixins/FeatureLayerBase/#returnZ) for details regarding fetching z-values with features from a layer
+   * @see [Point.z](https://developers.arcgis.com/javascript/latest/references/core/geometry/Point/#z) for more information on how z-values are represented in geometries
    */
   accessor hasZ: boolean;
   /**
@@ -452,17 +464,29 @@ export abstract class FeatureLayerBase {
    */
   get relationships(): Relationship[] | null | undefined;
   /**
-   * When `true`, indicates that M values will be returned. When
-   * `false`, indicates that M values will never be returned. The layer view
-   * determines whether to include M values in feature queries when the
-   * property value is `undefined`.
+   * Determines whether m-values (measure) are returned in feature geometries. For 2D views, support was added at version 5.1 and the behavior is as follows:
+   *  - When `undefined` (default): Fetches m-values if they are needed for rendering or labeling, or layer property interacts with the geometry.
+   *  Otherwise, m-values are excluded from feature queries.
+   *  - When `true`: Fetches m-values with the geometry, ensuring they are available on the client.
+   *  - When `false`: Excludes m-values from feature queries. M-values are not part of geometries.
+   *
+   *  > [!WARNING]
+   *  >
+   *  > 3D views do not support m-values. They will not be fetched or returned in 3D scene queries, regardless of this setting.
+   *
+   * @see [FeatureLayerBase.hasM](https://developers.arcgis.com/javascript/latest/references/core/layers/mixins/FeatureLayerBase/#hasM)
    */
   accessor returnM: boolean | null | undefined;
   /**
-   * When `true`, indicates that z-values will always be returned. When
-   * `false`, indicates that z-values will never be returned. The layer view
-   * determines whether to include z-values in feature queries when the
-   * property value is `undefined`.
+   * Determines whether z-values (elevation) are returned in feature geometries. For 3D views, z-values are always fetched regardless of the `returnZ` setting.
+   * For 2D views, support was added at version 5.1 and the behavior is as follows:
+   * - When `undefined` (default): Fetches z-values if they are needed for rendering or labeling, or layer property interacts with the geometry.
+   * Otherwise, z-values are excluded from feature queries.
+   * - When `true`: Fetches z-values with the geometry, ensuring they are available on the client.
+   * - When `false`: Excludes z-values from feature queries. Z-values are not part of geometries.
+   *
+   * @see [FeatureLayerBase.hasZ](https://developers.arcgis.com/javascript/latest/references/core/layers/mixins/FeatureLayerBase/#hasZ)
+   * @see [Geometry.hasZ](https://developers.arcgis.com/javascript/latest/references/core/geometry/Geometry/#hasZ)
    */
   accessor returnZ: boolean | null | undefined;
   /**

package/layers/mixins/TemporalLayer.d.ts

@@ -64,7 +64,8 @@ export interface TemporalLayerProperties extends Partial<Pick<TemporalLayer, "us
    * 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/) or
+   * [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
@@ -201,7 +202,8 @@ export abstract class TemporalLayer {
    * 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/) or
+   * [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

package/layers/orientedImagery/core/coverageUtils.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{throwIfAborted as e}from"../../../core/promiseUtils.js";import{create as t}from"../../../core/libs/gl-matrix-2/factories/mat3f64.js";import{zeros as r}from"../../../core/libs/gl-matrix-2/factories/vec3f64.js";import{transpose as n}from"../../../core/libs/gl-matrix-2/math/mat3.js";import{sub as o,add as a}from"../../../core/libs/gl-matrix-2/math/vec3.js";import i from"../../../geometry/Circle.js";import c from"../../../geometry/Mesh.js";import s from"../../../geometry/Multipoint.js";import f from"../../../geometry/Polygon.js";import{projectAsync as l}from"../../../geometry/projectionUtils.js";import m from"../../../geometry/SpatialReference.js";import{polygonCentroidPoint as u}from"../../../geometry/support/centroid.js";import{earth as p}from"../../../geometry/support/Ellipsoid.js";import h from"../../../geometry/support/MeshComponent.js";import y from"../../../geometry/support/MeshVertexAttributes.js";import{create as g,fromArray as x,intersectRay as d}from"../../../geometry/support/plane.js";import{isWebMercator as w}from"../../../geometry/support/spatialReferenceUtils.js";import{computeHFOVAndVFOV as M,convertToSRUnits as R,scaleWithFactor as j,scaleAndAddWithFactor as v,projectiveTransform as P,getWebMercatorScalingFactor as b,createRotationMatrixFromHPR as D,transformMat3 as A}from"../transformations/utils.js";const I=Math.PI/180;function z(e){const t=R(e,e.geometry.spatialReference);return e.isSpherical?S(t):V(t)}function V(e){const{horizontalFieldOfView:t,verticalFieldOfView:r,geometry:n,cameraHeading:o}=e,a=b(n.y,n.spatialReference);let i=e.cameraPitch,c=e.cameraRoll??0,s=150;t>150&&(i=90,c=0,s=5);const l=Math.ceil(t/s),m=F(l,o,t);let u=e.farDistance?e.farDistance*a:e.cameraHeight*a/Math.cos(i*I);e.cameraPitch+r/2>=90&&(u=(e.farDistance||20)*a);const p=new f({spatialReference:n?.spatialReference});p.imageID=e.objectId;let h=null;for(const f of m)h=H(f,i,e.cameraHeight,n,u,a,r,t,l,p,c,e.nearDistance);return h.imageID=e.objectId,{polygon:p,frustum:h}}function F(e,t,r){const n=[];if(e%2==0)for(let o=0;o<e/2;o++)n.push(t-r/e*(o+.5),t+r/e*(o+.5));else{n.push(t);for(let o=1;o<e/2;o++)n.push(t-r/e*o,t+r/e*o)}return n.sort(),n}function H(e,i,c,s,f,l,m,u,p,h,y=0,g=0){const x=n(t(),D([e,i,y??0])),d=U({cameraHeight:c,cameraPitch:i,farDistance:f,location:s,horizontalFieldOfView:u,nearDistance:g,verticalFieldOfView:m},x),w=A([0,0,-1],x),{x:M,y:R}=s,P=v([M,R,c],w,f,l),b=2*Math.tan(m*I/2)*f,z=2*Math.tan(u/p*I/2)*f,V=A([0,1,0],x),F=A([1,0,0],x),H=j(V,b/2,l),S=j(F,z/2,l),q=o(r(),H,S),C=a(r(),H,S),E=O([a(r(),P,q),a(r(),P,C),o(r(),P,q),o(r(),P,C)],c,s,l);return E.push(E[0]),h.addRing(E),d}function O(e,t,r,n){return e.map(e=>E(e,t,r,n))}function S(e){const{geometry:t,farDistance:r,objectId:n,nearDistance:o,cameraHeight:a}=e,s=b(t.y,t.spatialReference),f=new i({center:t.clone(),radius:r*s});if(f.imageID=n,o){const e=new i({center:t.clone(),radius:o*s});f.addRing(e.rings[0])}const l=t.clone();l.z=a-r*s;const m=c.createSphere(l,{size:2*r*s});return m.imageID=n,{polygon:f,frustum:m}}function q(e,t){return e.contains(t)}function C(e,t){return Math.sign(e)!==Math.sign(t)}function U(e,t,n){const{cameraHeight:i,cameraPitch:s,farDistance:f,location:l,horizontalFieldOfView:m,nearDistance:u,verticalFieldOfView:p}=e,h=L(l),g=s+p/2>=90==!1,x=2*Math.tan(p*I/2)*u,d=2*Math.tan(m*I/2)*u,w=2*Math.tan(p*I/2)*f,M=2*Math.tan(m*I/2)*f;let R,P;P=[0,0,-1],P=A(P,t),R=v([l.x,l.y,i],P,f,h),g&&(R[2]=0);const b=v([l.x,l.y,i],P,u,h);let D=[0,1,0];D=A(D,t);let z=[1,0,0];z=A(z,t);let V=[],F=[];u?(F=[{faces:[4,0,3,4,7,3]},{faces:[5,1,2,5,6,2]},{faces:[4,0,1,4,5,1]},{faces:[6,2,3,6,7,3]}],V=V.concat(a(r(),b,o(r(),j(D,x/2,h),j(z,d/2,h)))),V=V.concat(a(r(),b,a(r(),j(D,x/2,h),j(z,d/2,h)))),V=V.concat(o(r(),b,o(r(),j(D,x/2,h),j(z,d/2,h)))),V=V.concat(o(r(),b,a(r(),j(D,x/2,h),j(z,d/2,h))))):(V=[l.x,l.y,i],F=[{faces:[0,1,2,0,2,3,0,3,4,0,4,1]}]),V=V.concat(a(r(),R,o(r(),j(D,w/2,h),j(z,M/2,h)))),V=V.concat(a(r(),R,a(r(),j(D,w/2,h),j(z,M/2,h)))),V=V.concat(o(r(),R,o(r(),j(D,w/2,h),j(z,M/2,h)))),V=V.concat(o(r(),R,a(r(),j(D,w/2,h),j(z,M/2,h))));const H=new y({position:Float64Array.from(V)});return new c({vertexAttributes:H,components:F,spatialReference:l.spatialReference})}function E(e,t,n,a){{const i=Math.sqrt((e[2]-t)**2+(Math.sqrt((e[0]-n.x)**2+(e[1]-n.y)**2)/a)**2)*a,c=j(o(r(),[e[0],e[1],e[2]],[n.x,n.y,t]),1/i,1/a),s=t/(t-e[2]),f={x:(1-s)*n.x+s*e[0],y:(1-s)*n.y+s*e[1],z:(1-s)*t+s*e[2]},l=Math.sqrt((f.z-t)**2+(Math.sqrt((f.x-n.x)**2+(f.y-n.y)**2)/a)**2)*a,m=j(o(r(),[f.x,f.y,f.z],[n.x,n.y,t]),1/l,1/a);return C(c[0],m[0])&&C(c[1],m[1])&&C(c[2],m[2])||e[2]>=0?[e[0],e[1],0]:[f.x,f.y,f.z]}}function k(e){const{spatialReference:t,x:r,y:n}=e.geometry,{cameraHeading:o,cameraPitch:a,farDistance:i,nearDistance:c}=e,s=L(e.geometry),l=new f({spatialReference:t}),m=Math.abs(1.44*i*s);let u=Math.abs(1.44*c*s);(a<20||null==o)&&(u=m);const p=[];return p[0]={x:r+m*Math.sin((o-45)*I),y:n+m*Math.cos((o-45)*I)},p[1]={x:r+m*Math.sin((o+45)*I),y:n+m*Math.cos((o+45)*I)},p[2]={x:r+u*Math.sin((o+135)*I),y:n+u*Math.cos((o+135)*I)},p[3]={x:r+u*Math.sin((o+225)*I),y:n+u*Math.cos((o+225)*I)},l.addRing([[p[0].x,p[0].y,0],[p[1].x,p[1].y,0],[p[2].x,p[2].y,0],[p[3].x,p[3].y,0],[p[0].x,p[0].y,0]]),l}function L(e){return e&&w(e?.spatialReference)?1/Math.cos(Math.PI/2-2*Math.atan(Math.exp(-1*e.y/p.radius))):1}function W(e,t){const n=1+t/100;if("esri.geometry.Circle"===e.declaredClass){const{radius:t,center:r}=e,o=new i({radius:t*n,center:r});return e.rings.length>1&&o.addRing(e.rings[1]),o}if("esri.geometry.Polygon"===e.declaredClass){const t=new f({spatialReference:e.spatialReference}),a=u(e);if(a){const i=[];for(let t=0;t<e.rings[0].length;t++){const c=Math.sqrt((a.x-e.rings[0][t][0])**2+(a.y-e.rings[0][t][1])**2),s=j(o(r(),[e.rings[0][t][0],e.rings[0][t][1],0],[a.x,a.y,0]),1/c,1),f=v([a.x,a.y,0],s,c*n,1);i.push({x:f[0],y:f[1]})}t.addRing([[i[0].x,i[0].y,0],[i[1].x,i[1].y,0],[i[2].x,i[2].y,0],[i[3].x,i[3].y,0],[i[0].x,i[0].y,0]])}return t}return e}async function B(e,t,r){const{cameraHeight:n,cameraLocation:o,cameraPitch:a,frustumVertices:i,horizontalFieldOfView:c,imageHeight:s,imageWidth:f,inSRS:l,outSRS:u,verticalFieldOfView:p,cameraRoll:h,options:y}=r,g=new m(l),x=new m(u),d=M(c,p,h??0),w=i.length>15;return a+d.vfov/2>=90?await Q(i,e,f,s,g,x,w,y):await G(i,e,t,o,n,w,g,x,y)}async function G(e,t,r,n,o,a,i,s,f){const l=J(e,t,r,n,o);if(!l)return;const{farPlane:m,nearPlane:u}=l,p=await T([...u?.vertexPositions??e.slice(0,3),...m.vertexPositions],i,s,f),h=_(p);return new c({vertexAttributes:new y({position:p}),components:$(a?Y(h,!0):Z(h,!0)),spatialReference:s})}function J(e,t,r,n,o){const a=X(e),i=X(e,"near");if(!a)return;const c=t.length;for(let s=0;s<c;s++){const e=Array.from(r[s]),t=[e[0]-n[0],e[1]-n[1],e[2]-(n[2]??o)];N(n,t,s,i),K(n,t,s,a)}return{farPlane:a,nearPlane:i}}function K(e,t,n,o){const{coefficients:a,vertexPositions:i}=o,c=r();d(a,{origin:e,direction:t},c)&&i.splice(3*n,3,...c)}function N(e,t,n,o){if(!o)return;const a=r();d(o.coefficients,{origin:e,direction:t},a)&&o.vertexPositions.splice(3*n,3,...a)}async function Q(e,t,r,n,o,a,i,s){let f,l=i?new Array:[e[0],e[1],e[2]],m=new Array;for(const c of t)i?(f=P([c[0],c[1],1],[[0,0,1],[r,0,1],[r,n,1],[0,n,1]],[[e[0],e[1],e[2]],[e[3],e[4],e[5]],[e[6],e[7],e[8]],[e[9],e[10],e[11]]]),l=l.concat(...f),f=P([c[0],c[1],1],[[0,0,1],[r,0,1],[r,n,1],[0,n,1]],[[e[12],e[13],e[14]],[e[15],e[16],e[17]],[e[18],e[19],e[20]],[e[21],e[22],e[23]]]),m=m.concat(...f)):(f=P([c[0],c[1],1],[[0,0,1],[r,0,1],[r,n,1],[0,n,1]],[[e[3],e[4],e[5]],[e[6],e[7],e[8]],[e[9],e[10],e[11]],[e[12],e[13],e[14]]]),l=l.concat(...f));l=l.concat(m);const u=await T(l,o,a,s),p=_(u);return new c({vertexAttributes:new y({position:u}),components:$(i?Y(p,!0):Z(p,!0)),spatialReference:a})}async function T(t,r,n,o){if(r.equals(n))return t;const a=t.reduce((e,t,r)=>{const n=Math.floor(r/3);return e[n]||(e[n]=new Array),e[n].push(t),e},new Array),{points:i}=await l(new s({points:a,spatialReference:r}),n,o);return e(o),i.flat()}function X(e,t="far"){const r=g();let n;switch(t){case"far":if(n=Array.from(15===e.length?e.slice(3):e.slice(12)),x(r,n,!1))return{coefficients:r,vertexPositions:n};break;case"near":if(n=Array.from(e.slice(0,12)),15===e.length||!x(r,n,!1))return;return{coefficients:r,vertexPositions:n}}}const Y=(e,t=!1)=>{if(t&&e-2<=4||e<=4||e%2!=0)throw new Error("Invalid number of vertices");const r=[],n=e/2,o=Math.round((t?e-2:e)/2);for(let a=0;a<o;a++){const o=a+n,i=t?o+1:o,c=i%e,s=(t?o:i+1)%e;r.push({faces:new Uint32Array([a,s,c,a,a+1,c])})}return r};function Z(e,t=!1){if(e<3||t&&e-1<3)throw new Error("Invalid number of vertices");const r=[],n=t?e-2:e-1;for(let o=0;o<n;o++)r.push({faces:new Uint32Array([0,o+1,o+2])});return r}const $=e=>e.map(e=>new h(e)),_=e=>e.length/3;export{q as checkIfPolygonContainsSelectedPoint,k as computePolygonForInspection,z as createCoveragePolygon,O as limitZToGround,T as projectVertices,W as resizePolygon,B as updateFrustum};
+import{throwIfAborted as e}from"../../../core/promiseUtils.js";import{create as t}from"../../../core/libs/gl-matrix-2/factories/mat3f64.js";import{zeros as r}from"../../../core/libs/gl-matrix-2/factories/vec3f64.js";import{transpose as n}from"../../../core/libs/gl-matrix-2/math/mat3.js";import{sub as o,add as a}from"../../../core/libs/gl-matrix-2/math/vec3.js";import i from"../../../geometry/Circle.js";import s from"../../../geometry/Mesh.js";import c from"../../../geometry/Multipoint.js";import f from"../../../geometry/Polygon.js";import{projectAsync as l}from"../../../geometry/projectionUtils.js";import m from"../../../geometry/SpatialReference.js";import{polygonCentroidPoint as u}from"../../../geometry/support/centroid.js";import{earth as p}from"../../../geometry/support/Ellipsoid.js";import h from"../../../geometry/support/MeshComponent.js";import{createSphere as y}from"../../../geometry/support/meshUtils.js";import g from"../../../geometry/support/MeshVertexAttributes.js";import{create as x,fromArray as d,intersectRay as w}from"../../../geometry/support/plane.js";import{isWebMercator as M}from"../../../geometry/support/spatialReferenceUtils.js";import{computeHFOVAndVFOV as R,convertToSRUnits as j,scaleWithFactor as v,scaleAndAddWithFactor as P,projectiveTransform as b,getWebMercatorScalingFactor as D,createRotationMatrixFromHPR as A,transformMat3 as I}from"../transformations/utils.js";const z=Math.PI/180;function V(e){const t=j(e,e.geometry.spatialReference);return e.isSpherical?S(t):F(t)}function F(e){const{horizontalFieldOfView:t,verticalFieldOfView:r,geometry:n,cameraHeading:o}=e,a=D(n.y,n.spatialReference);let i=e.cameraPitch,s=e.cameraRoll??0,c=150;t>150&&(i=90,s=0,c=5);const l=Math.ceil(t/c),m=H(l,o,t);let u=e.farDistance?e.farDistance*a:e.cameraHeight*a/Math.cos(i*z);e.cameraPitch+r/2>=90&&(u=(e.farDistance||20)*a);const p=new f({spatialReference:n?.spatialReference});p.imageID=e.objectId;let h=null;for(const f of m)h=O(f,i,e.cameraHeight,n,u,a,r,t,l,p,s,e.nearDistance);return h.imageID=e.objectId,{polygon:p,frustum:h}}function H(e,t,r){const n=[];if(e%2==0)for(let o=0;o<e/2;o++)n.push(t-r/e*(o+.5),t+r/e*(o+.5));else{n.push(t);for(let o=1;o<e/2;o++)n.push(t-r/e*o,t+r/e*o)}return n.sort(),n}function O(e,i,s,c,f,l,m,u,p,h,y=0,g=0){const x=n(t(),A([e,i,y??0])),d=E({cameraHeight:s,cameraPitch:i,farDistance:f,location:c,horizontalFieldOfView:u,nearDistance:g,verticalFieldOfView:m},x),w=I([0,0,-1],x),{x:M,y:R}=c,j=P([M,R,s],w,f,l),b=2*Math.tan(m*z/2)*f,D=2*Math.tan(u/p*z/2)*f,V=I([0,1,0],x),F=I([1,0,0],x),H=v(V,b/2,l),O=v(F,D/2,l),S=o(r(),H,O),U=a(r(),H,O),C=q([a(r(),j,S),a(r(),j,U),o(r(),j,S),o(r(),j,U)],s,c,l);return C.push(C[0]),h.addRing(C),d}function q(e,t,r,n){return e.map(e=>k(e,t,r,n))}function S(e){const{geometry:t,farDistance:r,objectId:n,nearDistance:o,cameraHeight:a}=e,s=D(t.y,t.spatialReference),c=new i({center:t.clone(),radius:r*s});if(c.imageID=n,o){const e=new i({center:t.clone(),radius:o*s});c.addRing(e.rings[0])}const f=t.clone();f.z=a-r*s;const l=y(f,{size:2*r*s});return l.imageID=n,{polygon:c,frustum:l}}function U(e,t){return e.contains(t)}function C(e,t){return Math.sign(e)!==Math.sign(t)}function E(e,t,n){const{cameraHeight:i,cameraPitch:c,farDistance:f,location:l,horizontalFieldOfView:m,nearDistance:u,verticalFieldOfView:p}=e,h=W(l),y=c+p/2>=90==!1,x=2*Math.tan(p*z/2)*u,d=2*Math.tan(m*z/2)*u,w=2*Math.tan(p*z/2)*f,M=2*Math.tan(m*z/2)*f;let R,j;j=[0,0,-1],j=I(j,t),R=P([l.x,l.y,i],j,f,h),y&&(R[2]=0);const b=P([l.x,l.y,i],j,u,h);let D=[0,1,0];D=I(D,t);let A=[1,0,0];A=I(A,t);let V=[],F=[];u?(F=[{faces:[4,0,3,4,7,3]},{faces:[5,1,2,5,6,2]},{faces:[4,0,1,4,5,1]},{faces:[6,2,3,6,7,3]}],V=V.concat(a(r(),b,o(r(),v(D,x/2,h),v(A,d/2,h)))),V=V.concat(a(r(),b,a(r(),v(D,x/2,h),v(A,d/2,h)))),V=V.concat(o(r(),b,o(r(),v(D,x/2,h),v(A,d/2,h)))),V=V.concat(o(r(),b,a(r(),v(D,x/2,h),v(A,d/2,h))))):(V=[l.x,l.y,i],F=[{faces:[0,1,2,0,2,3,0,3,4,0,4,1]}]),V=V.concat(a(r(),R,o(r(),v(D,w/2,h),v(A,M/2,h)))),V=V.concat(a(r(),R,a(r(),v(D,w/2,h),v(A,M/2,h)))),V=V.concat(o(r(),R,o(r(),v(D,w/2,h),v(A,M/2,h)))),V=V.concat(o(r(),R,a(r(),v(D,w/2,h),v(A,M/2,h))));const H=new g({position:Float64Array.from(V)});return new s({vertexAttributes:H,components:F,spatialReference:l.spatialReference})}function k(e,t,n,a){{const i=Math.sqrt((e[2]-t)**2+(Math.sqrt((e[0]-n.x)**2+(e[1]-n.y)**2)/a)**2)*a,s=v(o(r(),[e[0],e[1],e[2]],[n.x,n.y,t]),1/i,1/a),c=t/(t-e[2]),f={x:(1-c)*n.x+c*e[0],y:(1-c)*n.y+c*e[1],z:(1-c)*t+c*e[2]},l=Math.sqrt((f.z-t)**2+(Math.sqrt((f.x-n.x)**2+(f.y-n.y)**2)/a)**2)*a,m=v(o(r(),[f.x,f.y,f.z],[n.x,n.y,t]),1/l,1/a);return C(s[0],m[0])&&C(s[1],m[1])&&C(s[2],m[2])||e[2]>=0?[e[0],e[1],0]:[f.x,f.y,f.z]}}function L(e){const{spatialReference:t,x:r,y:n}=e.geometry,{cameraHeading:o,cameraPitch:a,farDistance:i,nearDistance:s}=e,c=W(e.geometry),l=new f({spatialReference:t}),m=Math.abs(1.44*i*c);let u=Math.abs(1.44*s*c);(a<20||null==o)&&(u=m);const p=[];return p[0]={x:r+m*Math.sin((o-45)*z),y:n+m*Math.cos((o-45)*z)},p[1]={x:r+m*Math.sin((o+45)*z),y:n+m*Math.cos((o+45)*z)},p[2]={x:r+u*Math.sin((o+135)*z),y:n+u*Math.cos((o+135)*z)},p[3]={x:r+u*Math.sin((o+225)*z),y:n+u*Math.cos((o+225)*z)},l.addRing([[p[0].x,p[0].y,0],[p[1].x,p[1].y,0],[p[2].x,p[2].y,0],[p[3].x,p[3].y,0],[p[0].x,p[0].y,0]]),l}function W(e){return e&&M(e?.spatialReference)?1/Math.cos(Math.PI/2-2*Math.atan(Math.exp(-1*e.y/p.radius))):1}function B(e,t){const n=1+t/100;if("esri.geometry.Circle"===e.declaredClass){const{radius:t,center:r}=e,o=new i({radius:t*n,center:r});return e.rings.length>1&&o.addRing(e.rings[1]),o}if("esri.geometry.Polygon"===e.declaredClass){const t=new f({spatialReference:e.spatialReference}),a=u(e);if(a){const i=[];for(let t=0;t<e.rings[0].length;t++){const s=Math.sqrt((a.x-e.rings[0][t][0])**2+(a.y-e.rings[0][t][1])**2),c=v(o(r(),[e.rings[0][t][0],e.rings[0][t][1],0],[a.x,a.y,0]),1/s,1),f=P([a.x,a.y,0],c,s*n,1);i.push({x:f[0],y:f[1]})}t.addRing([[i[0].x,i[0].y,0],[i[1].x,i[1].y,0],[i[2].x,i[2].y,0],[i[3].x,i[3].y,0],[i[0].x,i[0].y,0]])}return t}return e}async function G(e,t,r){const{cameraHeight:n,cameraLocation:o,cameraPitch:a,frustumVertices:i,horizontalFieldOfView:s,imageHeight:c,imageWidth:f,inSRS:l,outSRS:u,verticalFieldOfView:p,cameraRoll:h,options:y}=r,g=new m(l),x=new m(u),d=R(s,p,h??0),w=i.length>15;return a+d.vfov/2>=90?await T(i,e,f,c,g,x,w,y):await J(i,e,t,o,n,w,g,x,y)}async function J(e,t,r,n,o,a,i,c,f){const l=K(e,t,r,n,o);if(!l)return;const{farPlane:m,nearPlane:u}=l,p=await X([...u?.vertexPositions??e.slice(0,3),...m.vertexPositions],i,c,f),h=ee(p);return new s({vertexAttributes:new g({position:p}),components:_(a?Z(h,!0):$(h,!0)),spatialReference:c})}function K(e,t,r,n,o){const a=Y(e),i=Y(e,"near");if(!a)return;const s=t.length;for(let c=0;c<s;c++){const e=Array.from(r[c]),t=[e[0]-n[0],e[1]-n[1],e[2]-(n[2]??o)];Q(n,t,c,i),N(n,t,c,a)}return{farPlane:a,nearPlane:i}}function N(e,t,n,o){const{coefficients:a,vertexPositions:i}=o,s=r();w(a,{origin:e,direction:t},s)&&i.splice(3*n,3,...s)}function Q(e,t,n,o){if(!o)return;const a=r();w(o.coefficients,{origin:e,direction:t},a)&&o.vertexPositions.splice(3*n,3,...a)}async function T(e,t,r,n,o,a,i,c){let f,l=i?new Array:[e[0],e[1],e[2]],m=new Array;for(const s of t)i?(f=b([s[0],s[1],1],[[0,0,1],[r,0,1],[r,n,1],[0,n,1]],[[e[0],e[1],e[2]],[e[3],e[4],e[5]],[e[6],e[7],e[8]],[e[9],e[10],e[11]]]),l=l.concat(...f),f=b([s[0],s[1],1],[[0,0,1],[r,0,1],[r,n,1],[0,n,1]],[[e[12],e[13],e[14]],[e[15],e[16],e[17]],[e[18],e[19],e[20]],[e[21],e[22],e[23]]]),m=m.concat(...f)):(f=b([s[0],s[1],1],[[0,0,1],[r,0,1],[r,n,1],[0,n,1]],[[e[3],e[4],e[5]],[e[6],e[7],e[8]],[e[9],e[10],e[11]],[e[12],e[13],e[14]]]),l=l.concat(...f));l=l.concat(m);const u=await X(l,o,a,c),p=ee(u);return new s({vertexAttributes:new g({position:u}),components:_(i?Z(p,!0):$(p,!0)),spatialReference:a})}async function X(t,r,n,o){if(r.equals(n))return t;const a=t.reduce((e,t,r)=>{const n=Math.floor(r/3);return e[n]||(e[n]=new Array),e[n].push(t),e},new Array),{points:i}=await l(new c({points:a,spatialReference:r}),n,o);return e(o),i.flat()}function Y(e,t="far"){const r=x();let n;switch(t){case"far":if(n=Array.from(15===e.length?e.slice(3):e.slice(12)),d(r,n,!1))return{coefficients:r,vertexPositions:n};break;case"near":if(n=Array.from(e.slice(0,12)),15===e.length||!d(r,n,!1))return;return{coefficients:r,vertexPositions:n}}}const Z=(e,t=!1)=>{if(t&&e-2<=4||e<=4||e%2!=0)throw new Error("Invalid number of vertices");const r=[],n=e/2,o=Math.round((t?e-2:e)/2);for(let a=0;a<o;a++){const o=a+n,i=t?o+1:o,s=i%e,c=(t?o:i+1)%e;r.push({faces:new Uint32Array([a,c,s,a,a+1,s])})}return r};function $(e,t=!1){if(e<3||t&&e-1<3)throw new Error("Invalid number of vertices");const r=[],n=t?e-2:e-1;for(let o=0;o<n;o++)r.push({faces:new Uint32Array([0,o+1,o+2])});return r}const _=e=>e.map(e=>new h(e)),ee=e=>e.length/3;export{U as checkIfPolygonContainsSelectedPoint,L as computePolygonForInspection,V as createCoveragePolygon,q as limitZToGround,X as projectVertices,B as resizePolygon,G as updateFrustum};

package/layers/support/AnnotationSublayer.d.ts

@@ -0,0 +1,44 @@
+import type AnnotationLayer from "../AnnotationLayer.js";
+import type { ClonableMixin } from "../../core/Clonable.js";
+import type { IdentifiableMixin, IdentifiableMixinProperties } from "../../core/Identifiable.js";
+import type { Loadable, LoadableMixinProperties } from "../../core/Loadable.js";
+
+export interface AnnotationSublayerProperties extends LoadableMixinProperties, IdentifiableMixinProperties, Partial<Pick<AnnotationSublayer, "parent" | "subtypeCode" | "title" | "visible">> {}
+
+/**
+ * Represents a sublayer in a [AnnotationLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/AnnotationLayer/). Each AnnotationSublayer
+ * is not a standalone service, but rather each sublayer corresponds to one subtype in the source feature service.
+ *
+ * The AnnotationSublayers are identified by their unique [subtypeCode](https://developers.arcgis.com/javascript/latest/references/core/layers/support/AnnotationSublayer/#subtypeCode). You can configure the properties of each sublayer while
+ * initializing the AnnotationLayer
+ *
+ * @since 5.1
+ * @see [AnnotationLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/AnnotationLayer/)
+ */
+export default class AnnotationSublayer extends AnnotationSublayerSuperclass {
+  constructor(properties?: AnnotationSublayerProperties);
+  /** The [AnnotationLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/AnnotationLayer/) to which the sublayer belongs. */
+  accessor parent: AnnotationLayer | null | undefined;
+  /**
+   * The unique identifier representing the [AnnotationSublayer](https://developers.arcgis.com/javascript/latest/references/core/layers/support/AnnotationSublayer/)
+   * created from the [AnnotationLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/AnnotationLayer/).
+   */
+  accessor subtypeCode: number;
+  /**
+   * The title of the layer used to identify it in places such as the [layer list](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-layer-list/).
+   * The title is set to the subtype description of the layer.
+   */
+  accessor title: string | null | undefined;
+  get type(): "annotation-sublayer";
+  /**
+   * Indicates if the layer is visible in the [View](https://developers.arcgis.com/javascript/latest/references/core/views/View/). When `false`,
+   * the annotations corresponding to this sublayer will not be visible in the view.
+   *
+   * @default true
+   * @example
+   * // The layer is no longer visible in the view
+   * layer.visible = false;
+   */
+  accessor visible: boolean;
+}
+declare const AnnotationSublayerSuperclass: typeof Loadable & typeof IdentifiableMixin & typeof ClonableMixin

package/layers/support/AnnotationSublayer.js

@@ -0,0 +1,2 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+import{__decorate as o}from"tslib";import{ClonableMixin as t}from"../../core/Clonable.js";import{IdentifiableMixin as e}from"../../core/Identifiable.js";import{Loadable as r}from"../../core/Loadable.js";import{property as p,subclass as i}from"../../core/accessorSupport/decorators.js";let s=class extends(t(e(r))){constructor(o){super(o),this.type="annotation-sublayer",this.parent=null,this.subtypeCode=null,this.title=null,this.visible=!0}};o([p({readOnly:!0,json:{read:!1}})],s.prototype,"type",void 0),o([p({clonable:!1})],s.prototype,"parent",void 0),o([p({type:Number})],s.prototype,"subtypeCode",void 0),o([p({type:String})],s.prototype,"title",void 0),o([p({type:Boolean})],s.prototype,"visible",void 0),s=o([i("esri.layers.support.AnnotationSublayer")],s);export{s as default};

package/layers/support/DateTimeFieldFormat.d.ts

@@ -67,7 +67,7 @@ export type Hour12 = "always" | "auto" | "never";
  * | `short-date-le`, `short-date-le-short-time`, `short-date-le-short-time-24`, `short-date-le-long-time`, `short-date-le-long-time-24` | Treated as equivalent to non-LE versions. `LE` is no longer needed since locale is implied from the browser. |
  *
  * @since 4.34
- * @see [MDN documentation - DateTimeFormat](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DateTimeFormat)
+ * @see [MDN documentation - DateTimeFormat](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/DateTimeFormat)
  * @see [CLDR](https://cldr.unicode.org/)
  * @see [FieldConfiguration](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FieldConfiguration/)
  * @example
@@ -95,10 +95,10 @@ export type Hour12 = "always" | "auto" | "never";
 export default class DateTimeFieldFormat extends FieldFormat {
   constructor(properties?: DateTimeFieldFormatProperties);
   /**
-   * Defines the date format. For more options, refer to the [MDN documentation](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DateTimeFormat#parameters).
+   * Defines the date format. For more options, refer to the [MDN documentation](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/DateTimeFormat#parameters).
    *
    * @since 4.34
-   * @see [MDN documentation](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DateTimeFormat)
+   * @see [MDN documentation](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/DateTimeFormat)
    */
   accessor dateStyle: "full" | "long" | "medium" | "short" | null | undefined;
   /**
@@ -112,21 +112,21 @@ export default class DateTimeFieldFormat extends FieldFormat {
    *
    * @default "auto"
    * @since 4.34
-   * @see [MDN documentation](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DateTimeFormat#parameters)
+   * @see [MDN documentation](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/DateTimeFormat#parameters)
    */
   accessor hour12: Hour12;
   /**
-   * Specifies how the month is displayed. For more options, refer to the [MDN documentation](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DateTimeFormat).
+   * Specifies how the month is displayed. For more options, refer to the [MDN documentation](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/DateTimeFormat).
    *
    * @since 4.34
-   * @see [MDN documentation](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DateTimeFormat)
+   * @see [MDN documentation](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/DateTimeFormat)
    */
   accessor month: "long" | "short" | null | undefined;
   /**
-   * Defines the time format. For more options, refer to the [MDN documentation](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DateTimeFormat#parameters).
+   * Defines the time format. For more options, refer to the [MDN documentation](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/DateTimeFormat#parameters).
    *
    * @since 4.34
-   * @see [MDN documentation](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DateTimeFormat)
+   * @see [MDN documentation](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/DateTimeFormat)
    */
   accessor timeStyle: "full" | "long" | "medium" | "short" | null | undefined;
   /**
@@ -136,10 +136,10 @@ export default class DateTimeFieldFormat extends FieldFormat {
    */
   get type(): "date-time";
   /**
-   * Specifies how the year is displayed. Currently, only supports `numeric`. For more options, refer to the [MDN documentation](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DateTimeFormat).
+   * Specifies how the year is displayed. Currently, only supports `numeric`. For more options, refer to the [MDN documentation](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/DateTimeFormat).
    *
    * @since 4.34
-   * @see [MDN documentation](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DateTimeFormat)
+   * @see [MDN documentation](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/DateTimeFormat)
    */
   accessor year: "numeric" | null | undefined;
 }