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

package/geometry/Mesh.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{__decorate as e}from"tslib";import{ClonableMixin as t}from"../core/Clonable.js";import r from"../core/Error.js";import{LoadableMixin as o}from"../core/Loadable.js";import s from"../core/Logger.js";import{EsriPromiseMixin as n}from"../core/Promise.js";import{throwIfAborted as i,isPromiseLike as a,whenOrAbort as p}from"../core/promiseUtils.js";import{watch as c}from"../core/reactiveUtils.js";import{property as l,subclass as m}from"../core/accessorSupport/decorators.js";import{fromValues as h}from"../core/libs/gl-matrix-2/factories/vec3f64.js";import u from"./Geometry.js";import d from"./Point.js";import f from"./Polygon.js";import{create as g,fromBuffer as x,zero as y}from"./support/aaBoundingBox.js";import{composeAxes as v,create as j}from"./support/axisAngleDegrees.js";import w from"./support/MeshComponent.js";import{componentNotFoundMessage as S,meshNotLoadedMessage as b,invalidLocationMessage as L,invalidPolygonMessage as A,InvalidLocationError as C}from"./support/meshErrors.js";import M from"./support/MeshGeoreferencedVertexSpace.js";import U from"./support/MeshLocalVertexSpace.js";import R from"./support/MeshTransform.js";import _ from"./support/MeshVertexAttributes.js";import{vertexSpaceOriginToPoint as F,isRelativeVertexSpace as P,selectVertexSpace as E}from"./support/meshVertexSpaceUtils.js";import{centerAt as B}from"./support/meshUtils/centerAt.js";import{computeMeshExtent as I}from"./support/meshUtils/extent.js";import{loadExternal as G}from"./support/meshUtils/loadExternal.js";import{addMeshMaterialCloneContext as k,addMeshTextureCloneContext as T,getMeshCloneContext as O}from"./support/meshUtils/meshCloneUtils.js";import{Metadata as z}from"./support/meshUtils/Metadata.js";import{convertUnitGeometry as V,createUnitSizeBox as D,extractSingleFaceOfBox as N,createUnitSizeSphere as Z,createUnitSizeCylinder as H,convertPlaneSizeParameter as K,createUnitSizePlane as W}from"./support/meshUtils/primitives.js";import{rotate as q}from"./support/meshUtils/rotate.js";import{scale as J}from"./support/meshUtils/scale.js";import{polygonToRenderInfoNotElevationAligned as Q}from"../views/3d/support/renderInfoUtils/polygon.js";var X;const Y={base:null,key:"type",defaultKeyValue:"georeferenced",typeMap:{georeferenced:M,local:U}};let $=X=class extends(t(o(n(u)))){constructor(e){super(e),this.components=null,this.vertexSpace=new M,this.transform=null,this.metadata=new z,this.hasZ=!0,this.hasM=!1,this.vertexAttributes=new _,this.type="mesh"}initialize(){(0===this.metadata.externalSources.length||this.vertexAttributes.position.length)&&(this.loadStatus="loaded"),this.when(()=>{this.addHandles(c(()=>({vertexAttributes:this.vertexAttributes,components:this.components?.map(e=>e.clone())}),()=>this._clearSources(),{once:!0,sync:!0}))})}get hasExtent(){return this.loaded?this.vertexAttributes.position.length>0&&(!this.components||this.components.length>0):null!=this.metadata.displaySource?.extent}get _transformedExtent(){const{spatialReference:e,vertexSpace:t}=this,r=this;return I({get transform(){return r.transform},vertexSpace:t,spatialReference:e,untransformedBounds:this._untransformedBounds})}get _untransformedBounds(){const{vertexAttributes:{position:e},components:t}=this;return 0===e.length||0===t?.length?g(y):x(e)}get origin(){const e=F(this.vertexSpace,this.spatialReference);if(null!=e)return e;const{center:t,zmin:r}=this._transformedExtent;return new d({x:t.x,y:t.y,z:r,spatialReference:this.spatialReference})}get extent(){return this.loaded||null==this.metadata?.displaySource?.extent?this._transformedExtent:this.metadata.displaySource.extent.clone()}addComponent(e){this._checkIfLoaded("addComponent()")&&(this.components||(this.components=[]),this.components.push(w.from(e)),this.notifyChange("components"))}removeComponent(e){if(this._checkIfLoaded("removeComponent()")){if(this.components){const t=this.components.indexOf(e);if(-1!==t)return this.components.splice(t,1),void this.notifyChange("components")}s.getLogger(this).error("removeComponent()",S)}}rotate(e,t,r,o){return v(e,t,r,ee),q(this,ee,o),this}offset(e,t,r){if(!this._checkIfLoaded("offset()"))return this;const{vertexSpace:o,vertexAttributes:s}=this,n=s?.position;if(!n)return this;if(P(o)){const[s,n,i]=o.origin;o.origin=h(s+e,n+t,i+r)}else{for(let o=0;o<n.length;o+=3)n[o]+=e,n[o+1]+=t,n[o+2]+=r;this.vertexAttributesChanged()}return this}scale(e,t){return this._checkIfLoaded("scale()")?(J(this,e,t),this):this}centerAt(e,t){return this._checkIfLoaded("centerAt()")?(B(this,e,t),this):this}load(e){const{metadata:{displaySource:t}}=this;return t&&this.addResolvingPromise(G(this,t,e)),Promise.resolve(this)}addExternalSources(e){this.metadata.externalSources.addMany(e)}updateDisplaySource(e){this.metadata.displaySource=e}clone(e){return super.clone(k(T(e)))}cloneShallow(){return new X({components:this.components,spatialReference:this.spatialReference,vertexAttributes:this.vertexAttributes,vertexSpace:this.vertexSpace.clone(),transform:this.transform,metadata:this.metadata})}vertexAttributesChanged(){this.notifyChange("vertexAttributes")}async toBinaryGLTF(e){const[{toBinaryGLTF:t}]=await Promise.all([import("./support/meshUtils/exporters/gltf/gltfexport.js"),this.load(e)]);return i(e),await t(this,e)}get usedMemory(){return this.components?this.components.reduce((e,t)=>e+t.memoryUsage,this.vertexAttributes.usedMemory):this.vertexAttributes.usedMemory}_clearSources(){this.metadata.clearSources()}_checkIfLoaded(e){return!!this.loaded||(s.getLogger(this).error(e,b),!1)}static createBox(e,t){if(!(e instanceof d))return s.getLogger(this.prototype).error(".createBox()",L),null;const r=new X(V(D(),e,t));return t?.imageFace&&"all"!==t.imageFace?N(r,t.imageFace):r}static createSphere(e,t){return e instanceof d?new X(V(Z(t?.densificationFactor||0),e,t)):(s.getLogger(this.prototype).error(".createSphere()",L),null)}static createCylinder(e,t){return e instanceof d?new X(V(H(t?.densificationFactor||0),e,t)):(s.getLogger(this.prototype).error(".createCylinder()",L),null)}static createPlane(e,t){if(!(e instanceof d))return s.getLogger(this.prototype).error(".createPlane()",L),null;const r=t?.facing??"up",o=K(r,t?.size);return new X(V(W(r),e,{...t,size:o}))}static createFromPolygon(e,t){if(!(e instanceof f))return s.getLogger(this.prototype).error(".createFromPolygon()",A),null;const r=Q(e,{method:"earcut"}),o=a(r)?null:r,n=o?.positions??[],i=o?.polygonIndices??[];return new X({vertexAttributes:new _({position:n}),components:[new w({faces:i,shading:"flat",material:t?.material??null})],spatialReference:e.spatialReference,vertexSpace:new M})}static async createFromGLTF(e,t,r){if(!(e instanceof d)){const e=new C;throw s.getLogger(this.prototype).error(".createfromGLTF()",e.message),e}const{loadGLTFMesh:o}=await p(import("./support/meshUtils/loadGLTFMesh.js"),r);return new X((await o(e,t,r)).mesh)}static createWithExternalSource(e,t,r){const o=r?.extent??null,{spatialReference:s}=e,n=r?.transform?.clone()??new R,i=E(e,r),a=r?.unitConversionDisabled,p={source:t,extent:o,unitConversionDisabled:a},c=new z;return c.externalSources.push(p),new X({metadata:c,transform:n,vertexSpace:i,spatialReference:s})}static createIncomplete(e,t){const{spatialReference:o}=e,s=t?.transform?.clone()??new R,n=E(e,t),i=new X({transform:s,vertexSpace:n,spatialReference:o});return i.addResolvingPromise(Promise.reject(new r("mesh-incomplete","Mesh resources are not complete"))),i}};e([l({type:[w],json:{write:!0}})],$.prototype,"components",void 0),e([l({nonNullable:!0,types:Y,constructOnly:!0,json:{write:!0},clonable:(e,t)=>O(t)?.vertexSpace??e.clone(t)})],$.prototype,"vertexSpace",void 0),e([l({type:R,clonable:(e,t)=>{const r=O(t);return r&&"transform"in r?r.transform:e?.clone()??e},json:{write:!0}})],$.prototype,"transform",void 0),e([l({constructOnly:!0,type:z,clonable:(e,t)=>O(t)?.metadata??e.clone()})],$.prototype,"metadata",void 0),e([l()],$.prototype,"hasExtent",null),e([l()],$.prototype,"_transformedExtent",null),e([l()],$.prototype,"_untransformedBounds",null),e([l()],$.prototype,"origin",null),e([l({readOnly:!0,json:{read:!1}})],$.prototype,"extent",null),e([l({readOnly:!0,json:{read:!1,write:!0,default:!0}})],$.prototype,"hasZ",void 0),e([l({readOnly:!0,json:{read:!1,write:!0,default:!1}})],$.prototype,"hasM",void 0),e([l({type:_,nonNullable:!0,json:{write:!0},clonable:(e,t)=>O(t)?.vertexAttributes??e.clone(t)})],$.prototype,"vertexAttributes",void 0),$=X=e([m("esri.geometry.Mesh")],$);const ee=j();export{$ as default};
+import{__decorate as e}from"tslib";import{ClonableMixin as t}from"../core/Clonable.js";import{LoadableMixin as r}from"../core/Loadable.js";import o from"../core/Logger.js";import{EsriPromiseMixin as s}from"../core/Promise.js";import{throwIfAborted as n,isPromiseLike as i,whenOrAbort as a}from"../core/promiseUtils.js";import{watch as p}from"../core/reactiveUtils.js";import{property as c,subclass as l}from"../core/accessorSupport/decorators.js";import{fromValues as m}from"../core/libs/gl-matrix-2/factories/vec3f64.js";import h from"./Geometry.js";import u from"./Point.js";import d from"./Polygon.js";import{create as f,fromBuffer as g,zero as y}from"./support/aaBoundingBox.js";import{composeAxes as x,create as v}from"./support/axisAngleDegrees.js";import j from"./support/MeshComponent.js";import{componentNotFoundMessage as S,meshNotLoadedMessage as b,invalidLocationMessage as w,invalidPolygonMessage as L,InvalidLocationError as A}from"./support/meshErrors.js";import M from"./support/MeshGeoreferencedVertexSpace.js";import U from"./support/MeshLocalVertexSpace.js";import C from"./support/MeshTransform.js";import _ from"./support/MeshVertexAttributes.js";import{vertexSpaceOriginToPoint as F,isRelativeVertexSpace as B}from"./support/meshVertexSpaceUtils.js";import{centerAt as P}from"./support/meshUtils/centerAt.js";import{computeMeshExtent as R}from"./support/meshUtils/extent.js";import{loadExternal as E}from"./support/meshUtils/loadExternal.js";import{addMeshMaterialCloneContext as G,addMeshTextureCloneContext as I,getMeshCloneContext as k}from"./support/meshUtils/meshCloneUtils.js";import{Metadata as T}from"./support/meshUtils/Metadata.js";import{convertUnitGeometry as O,createUnitSizeBox as z,extractSingleFaceOfBox as V,createUnitSizeSphere as D,createUnitSizeCylinder as N,convertPlaneSizeParameter as Z,createUnitSizePlane as H}from"./support/meshUtils/primitives.js";import{rotate as K}from"./support/meshUtils/rotate.js";import{scale as q}from"./support/meshUtils/scale.js";import{polygonToRenderInfoNotElevationAligned as J}from"../views/3d/support/renderInfoUtils/polygon.js";var Q;const W={base:null,key:"type",defaultKeyValue:"georeferenced",typeMap:{georeferenced:M,local:U}};let X=Q=class extends(t(r(s(h)))){constructor(e){super(e),this.components=null,this.vertexSpace=new M,this.transform=null,this.metadata=new T,this.hasZ=!0,this.hasM=!1,this.vertexAttributes=new _,this.type="mesh"}initialize(){(0===this.metadata.externalSources.length||this.vertexAttributes.position.length)&&(this.loadStatus="loaded"),this.when(()=>{this.addHandles(p(()=>({vertexAttributes:this.vertexAttributes,components:this.components?.map(e=>e.clone())}),()=>this._clearSources(),{once:!0,sync:!0}))})}get hasExtent(){return this.loaded?this.vertexAttributes.position.length>0&&(!this.components||this.components.length>0):null!=this.metadata.displaySource?.extent}get _transformedExtent(){const{spatialReference:e,vertexSpace:t}=this,r=this;return R({get transform(){return r.transform},vertexSpace:t,spatialReference:e,untransformedBounds:this._untransformedBounds})}get _untransformedBounds(){const{vertexAttributes:{position:e},components:t}=this;return 0===e.length||0===t?.length?f(y):g(e)}get origin(){const e=F(this.vertexSpace,this.spatialReference);if(null!=e)return e;const{center:t,zmin:r}=this._transformedExtent;return new u({x:t.x,y:t.y,z:r,spatialReference:this.spatialReference})}get extent(){return this.loaded||null==this.metadata?.displaySource?.extent?this._transformedExtent:this.metadata.displaySource.extent.clone()}addComponent(e){this._checkIfLoaded("addComponent()")&&(this.components||(this.components=[]),this.components.push(j.from(e)),this.notifyChange("components"))}removeComponent(e){if(this._checkIfLoaded("removeComponent()")){if(this.components){const t=this.components.indexOf(e);if(-1!==t)return this.components.splice(t,1),void this.notifyChange("components")}o.getLogger(this).error("removeComponent()",S)}}rotate(e,t,r,o){return x(e,t,r,Y),K(this,Y,o),this}offset(e,t,r){if(!this._checkIfLoaded("offset()"))return this;const{vertexSpace:o,vertexAttributes:s}=this,n=s?.position;if(!n)return this;if(B(o)){const[s,n,i]=o.origin;o.origin=m(s+e,n+t,i+r)}else{for(let o=0;o<n.length;o+=3)n[o]+=e,n[o+1]+=t,n[o+2]+=r;this.vertexAttributesChanged()}return this}scale(e,t){return this._checkIfLoaded("scale()")?(q(this,e,t),this):this}centerAt(e,t){return this._checkIfLoaded("centerAt()")?(P(this,e,t),this):this}load(e){const{metadata:{displaySource:t}}=this;return t&&this.addResolvingPromise(E(this,t,e)),Promise.resolve(this)}addExternalSources(e){this.metadata.externalSources.addMany(e)}updateDisplaySource(e){this.metadata.displaySource=e}clone(e){return super.clone(G(I(e)))}cloneShallow(){return new Q({components:this.components,spatialReference:this.spatialReference,vertexAttributes:this.vertexAttributes,vertexSpace:this.vertexSpace.clone(),transform:this.transform,metadata:this.metadata})}vertexAttributesChanged(){this.notifyChange("vertexAttributes")}async toBinaryGLTF(e){const[{toBinaryGLTF:t}]=await Promise.all([import("./support/meshUtils/exporters/gltf/gltfexport.js"),this.load(e)]);return n(e),await t(this,e)}get usedMemory(){return this.components?this.components.reduce((e,t)=>e+t.memoryUsage,this.vertexAttributes.usedMemory):this.vertexAttributes.usedMemory}_clearSources(){this.metadata.clearSources()}_checkIfLoaded(e){return!!this.loaded||(o.getLogger(this).error(e,b),!1)}static createBox(e,t){if(!(e instanceof u))return o.getLogger(this.prototype).error(".createBox()",w),null;const r=new Q(O(z(),e,t));return t?.imageFace&&"all"!==t.imageFace?V(r,t.imageFace):r}static createSphere(e,t){return e instanceof u?new Q(O(D(t?.densificationFactor||0),e,t)):(o.getLogger(this.prototype).error(".createSphere()",w),null)}static createCylinder(e,t){return e instanceof u?new Q(O(N(t?.densificationFactor||0),e,t)):(o.getLogger(this.prototype).error(".createCylinder()",w),null)}static createPlane(e,t){if(!(e instanceof u))return o.getLogger(this.prototype).error(".createPlane()",w),null;const r=t?.facing??"up",s=Z(r,t?.size);return new Q(O(H(r),e,{...t,size:s}))}static createFromPolygon(e,t){if(!(e instanceof d))return o.getLogger(this.prototype).error(".createFromPolygon()",L),null;const r=J(e,{method:"earcut"}),s=i(r)?null:r,n=s?.positions??[],a=s?.polygonIndices??[];return new Q({vertexAttributes:new _({position:n}),components:[new j({faces:a,shading:"flat",material:t?.material??null})],spatialReference:e.spatialReference,vertexSpace:new M})}static async createFromGLTF(e,t,r){if(!(e instanceof u)){const e=new A;throw o.getLogger(this.prototype).error(".createfromGLTF()",e.message),e}const{loadGLTFMesh:s}=await a(import("./support/meshUtils/loadGLTFMesh.js"),r);return new Q((await s(e,t,r)).mesh)}};e([c({type:[j],json:{write:!0}})],X.prototype,"components",void 0),e([c({nonNullable:!0,types:W,constructOnly:!0,json:{write:!0},clonable:(e,t)=>k(t)?.vertexSpace??e.clone(t)})],X.prototype,"vertexSpace",void 0),e([c({type:C,clonable:(e,t)=>{const r=k(t);return r&&"transform"in r?r.transform:e?.clone()??e},json:{write:!0}})],X.prototype,"transform",void 0),e([c({constructOnly:!0,type:T,clonable:(e,t)=>k(t)?.metadata??e.clone()})],X.prototype,"metadata",void 0),e([c()],X.prototype,"hasExtent",null),e([c()],X.prototype,"_transformedExtent",null),e([c()],X.prototype,"_untransformedBounds",null),e([c()],X.prototype,"origin",null),e([c({readOnly:!0,json:{read:!1}})],X.prototype,"extent",null),e([c({readOnly:!0,json:{read:!1,write:!0,default:!0}})],X.prototype,"hasZ",void 0),e([c({readOnly:!0,json:{read:!1,write:!0,default:!1}})],X.prototype,"hasM",void 0),e([c({type:_,nonNullable:!0,json:{write:!0},clonable:(e,t)=>k(t)?.vertexAttributes??e.clone(t)})],X.prototype,"vertexAttributes",void 0),X=Q=e([l("esri.geometry.Mesh")],X);const Y=v();export{X as default};

package/geometry/Multipoint.d.ts

@@ -36,6 +36,15 @@ export default class Multipoint extends BaseGeometry {
    * @returns A new instance of a Multipoint object equal to the object used to call `.clone()`.
    */
   clone(): Multipoint;
+  /**
+   * Determines if the input multipoint is equal to the multipoint calling the function.
+   *
+   * @param multipoint - The input multipoint to test.
+   * @returns Returns `true` if the points and spatial reference of the input multipoint
+   *                   are exactly equal to those of the multipoint calling `equals()`.
+   * @since 5.1
+   */
+  equals(multipoint: Multipoint | null | undefined): boolean;
   /**
    * Returns the point at the specified index.
    *

package/geometry/Multipoint.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{__decorate as t}from"tslib";import{clone as e}from"../core/lang.js";import{property as s,subclass as r}from"../core/accessorSupport/decorators.js";import i from"./Extent.js";import o from"./Geometry.js";import n from"./Point.js";import p from"./SpatialReference.js";import{getMultipointExtent as a}from"./support/extentUtils.js";import{updateSupportFromPoint as h}from"./support/zmUtils.js";import{writer as l}from"../core/accessorSupport/decorators/writer.js";var c;function u(t){if(!t)return;let{points:e,hasM:s,hasZ:r,spatialReference:i}=t;switch(e??=[],e?.at(0)?.length){case 4:r??=!0,s??=!0;break;case 3:r??=!0!==s,s??=!r;break;default:r??=!1,s??=!1}return i??=p.WGS84,{...t,hasM:s,hasZ:r,points:e,spatialReference:i}}let m=c=class extends o{constructor(t){super(u(t)),this.points=[],this.type="multipoint"}get cache(){return this.commitProperty("points"),this.commitProperty("hasZ"),this.commitProperty("hasM"),this.commitProperty("spatialReference"),{}}get extent(){const t=a(this);return t?new i({...t,spatialReference:this.spatialReference}):null}writePoints(t,s){s.points=e(this.points)}clone(){const{points:t,spatialReference:s,hasM:r,hasZ:i}=this;return new c({points:e(t),spatialReference:s.clone(),hasM:r,hasZ:i})}addPoint(t){return h(this,t),Array.isArray(t)?this.points.push(t):this.points.push(t.toArray()),this.notifyChange("points"),this}getPoint(t){if(!this._validateInputs(t))return null;const e=this.points[t],s={x:e[0],y:e[1],spatialReference:this.spatialReference};let r=2;return this.hasZ&&(s.z=e[2],r=3),this.hasM&&(s.m=e[r]),new n(s)}removePoint(t){if(!this._validateInputs(t))return null;const e=new n(this.points.splice(t,1)[0],this.spatialReference);return this.notifyChange("points"),e}setPoint(t,e){return this._validateInputs(t)?(h(this,e),Array.isArray(e)||(e=e.toArray()),this.points[t]=e,this.notifyChange("points"),this):this}toJSON(t){return this.write({},t)}_validateInputs(t){return null!=t&&t>=0&&t<this.points.length}};t([s({readOnly:!0})],m.prototype,"cache",null),t([s({readOnly:!0})],m.prototype,"extent",null),t([s({type:[[Number]],json:{write:{isRequired:!0}}})],m.prototype,"points",void 0),t([l("points")],m.prototype,"writePoints",null),m=c=t([r("esri.geometry.Multipoint")],m),m.prototype.toJSON.isDefaultToJSON=!0;export{m as default};
+import{__decorate as t}from"tslib";import{equals as e}from"../core/arrayUtils.js";import{clone as s}from"../core/lang.js";import{property as r,subclass as i}from"../core/accessorSupport/decorators.js";import o from"./Extent.js";import n from"./Geometry.js";import p from"./Point.js";import a from"./SpatialReference.js";import{getMultipointExtent as l}from"./support/extentUtils.js";import{comparePoints as h}from"./support/geometryUtils.js";import{updateSupportFromPoint as u}from"./support/zmUtils.js";import{writer as c}from"../core/accessorSupport/decorators/writer.js";var m;function f(t){if(!t)return;let{points:e,hasM:s,hasZ:r,spatialReference:i}=t;switch(e??=[],e?.at(0)?.length){case 4:r??=!0,s??=!0;break;case 3:r??=!0!==s,s??=!r;break;default:r??=!1,s??=!1}return i??=a.WGS84,{...t,hasM:s,hasZ:r,points:e,spatialReference:i}}let y=m=class extends n{constructor(t){super(f(t)),this.points=[],this.type="multipoint"}get cache(){return this.commitProperty("points"),this.commitProperty("hasZ"),this.commitProperty("hasM"),this.commitProperty("spatialReference"),{}}get extent(){const t=l(this);return t?new o({...t,spatialReference:this.spatialReference}):null}writePoints(t,e){e.points=s(this.points)}clone(){const{points:t,spatialReference:e,hasM:r,hasZ:i}=this;return new m({points:s(t),spatialReference:e.clone(),hasM:r,hasZ:i})}equals(t){if(this===t)return!0;if(null==t)return!1;const s=this.spatialReference,r=t.spatialReference;return null!=s==(null!=r)&&(!(null!=s&&null!=r&&!s.equals(r))&&e(this.points,t.points,h))}addPoint(t){return u(this,t),Array.isArray(t)?this.points.push(t):this.points.push(t.toArray()),this.notifyChange("points"),this}getPoint(t){if(!this._validateInputs(t))return null;const e=this.points[t],s={x:e[0],y:e[1],spatialReference:this.spatialReference};let r=2;return this.hasZ&&(s.z=e[2],r=3),this.hasM&&(s.m=e[r]),new p(s)}removePoint(t){if(!this._validateInputs(t))return null;const e=new p(this.points.splice(t,1)[0],this.spatialReference);return this.notifyChange("points"),e}setPoint(t,e){return this._validateInputs(t)?(u(this,e),Array.isArray(e)||(e=e.toArray()),this.points[t]=e,this.notifyChange("points"),this):this}toJSON(t){return this.write({},t)}_validateInputs(t){return null!=t&&t>=0&&t<this.points.length}};t([r({readOnly:!0})],y.prototype,"cache",null),t([r({readOnly:!0})],y.prototype,"extent",null),t([r({type:[[Number]],json:{write:{isRequired:!0}}})],y.prototype,"points",void 0),t([c("points")],y.prototype,"writePoints",null),y=m=t([i("esri.geometry.Multipoint")],y),y.prototype.toJSON.isDefaultToJSON=!0;export{y as default};

package/geometry/Point.d.ts

@@ -1,41 +1,10 @@
 import type Geometry from "./Geometry.js";
 import type { GeometryProperties } from "./Geometry.js";
 
-export interface PointProperties extends GeometryProperties, Partial<Pick<Point, "latitude" | "longitude" | "m" | "x" | "y" | "z">> {
-  /**
-   * Indicates if the geometry has M values.
-   *
-   * > [!WARNING]
-   * >
-   * > **M-values** (measure) allow attribute values to be stored at the vertex
-   * > of a point. A common usage for storing a measurement in the vertices
-   * > along a linear feature are
-   * > [linear referencing](https://pro.arcgis.com/en/pro-app/latest/help/data/linear-referencing/introduction-to-linear-referencing.htm)
-   * > applications.
-   */
-  hasM?: boolean;
-  /**
-   * Indicates if the geometry has z-values (elevation).
-   *
-   * > [!WARNING]
-   * >
-   * > **Z-values** defined in a geographic or metric coordinate system are
-   * > expressed in meters. However, in local scenes that use a
-   * > projected coordinate system, vertical units are assumed to be the same as the
-   * > horizontal units specified by the service.
-   */
-  hasZ?: boolean;
-}
+export interface PointProperties extends GeometryProperties, Partial<Pick<Point, "latitude" | "longitude" | "m" | "x" | "y" | "z">> {}
 
 /**
- * A location defined by X, Y, and Z coordinates.
- *
- * > [!WARNING]
- * >
- * > **Z-values** defined in a geographic or metric coordinate system are
- * > expressed in meters. However, in local scenes that use a
- * > projected coordinate system, vertical units are assumed to be the same as the
- * > horizontal units specified by the service.
+ * A location defined by [x](https://developers.arcgis.com/javascript/latest/references/core/geometry/Point/#x) and [y](https://developers.arcgis.com/javascript/latest/references/core/geometry/Point/#y) coordinates, with optional [z](https://developers.arcgis.com/javascript/latest/references/core/geometry/Point/#z) (elevation) and [m](https://developers.arcgis.com/javascript/latest/references/core/geometry/Point/#m) (measure) values.
  *
  * @since 4.0
  * @see [Sample - Add graphics (MapView)](https://developers.arcgis.com/javascript/latest/sample-code/intro-graphics/)
@@ -44,29 +13,6 @@ export interface PointProperties extends GeometryProperties, Partial<Pick<Point,
  */
 export default class Point extends Geometry {
   constructor(properties?: PointProperties);
-  /**
-   * Indicates if the geometry has M values.
-   *
-   * > [!WARNING]
-   * >
-   * > **M-values** (measure) allow attribute values to be stored at the vertex
-   * > of a point. A common usage for storing a measurement in the vertices
-   * > along a linear feature are
-   * > [linear referencing](https://pro.arcgis.com/en/pro-app/latest/help/data/linear-referencing/introduction-to-linear-referencing.htm)
-   * > applications.
-   */
-  accessor hasM: boolean;
-  /**
-   * Indicates if the geometry has z-values (elevation).
-   *
-   * > [!WARNING]
-   * >
-   * > **Z-values** defined in a geographic or metric coordinate system are
-   * > expressed in meters. However, in local scenes that use a
-   * > projected coordinate system, vertical units are assumed to be the same as the
-   * > horizontal units specified by the service.
-   */
-  accessor hasZ: boolean;
   /**
    * The latitude of the point. If the spatial reference is Web Mercator, the latitude will be given in WGS84. In any
    * geographic spatial reference, the latitude will equal the [y](https://developers.arcgis.com/javascript/latest/references/core/geometry/Point/#y) coordinate. In all other cases the latitude
@@ -80,15 +26,11 @@ export default class Point extends Geometry {
    */
   accessor longitude: number | null | undefined;
   /**
-   * The m-coordinate of the point in map units.
+   * The m-value (measure) of the point.
    *
-   * > [!WARNING]
-   * >
-   * > **M-values** (measure) allow attribute values to be stored at the vertex
-   * > of a point. A common usage for storing a measurement in the vertices
-   * > along a linear feature are
-   * > [linear referencing](https://pro.arcgis.com/en/pro-app/latest/help/data/linear-referencing/introduction-to-linear-referencing.htm)
-   * > applications.
+   * @see [Geometry.hasM](https://developers.arcgis.com/javascript/latest/references/core/geometry/Geometry/#hasM)
+   * @see [FeatureLayerBase.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 m: number | undefined;
   /** The string value representing the type of geometry. */
@@ -106,14 +48,16 @@ export default class Point extends Geometry {
    */
   accessor y: number;
   /**
-   * The z-coordinate (or elevation) of the point in map units.
+   * The z-coordinate (or elevation) of the geometry. The units of the z-values are expressed by the vertical unit of the service's vertical
+   * coordinate system (VCS) if one is defined. In the absence of a VCS, the vertical units default to the linear units of the service's
+   * horizontal coordinate system. If the service's coordinate system is a geographic coordinate system, the z-values are expressed in meters.
+   *
+   * For display purposes, z-values are automatically scaled to match the linear unit of the view's spatial reference. For example, if a service is in a State Plane
+   * projection (with linear units in us feet) but the view's spatial reference is Web Mercator, any displayed z-values (such as in labels) will be scaled and shown
+   * in meters.
    *
-   * > [!WARNING]
-   * >
-   * > **Z-values** defined in a geographic or metric coordinate system are
-   * > expressed in meters. However, in local scenes that use a
-   * > projected coordinate system, vertical units are assumed to be the same as the
-   * > horizontal units specified by the service.
+   * @see [Geometry.hasZ](https://developers.arcgis.com/javascript/latest/references/core/geometry/Geometry/#hasZ)
+   * @see [FeatureLayerBase.returnZ](https://developers.arcgis.com/javascript/latest/references/core/layers/mixins/FeatureLayerBase/#returnZ) for details regarding fetching z-values with features from a layer
    */
   accessor z: number | undefined;
   /**

package/geometry/Polygon.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{__decorate as t}from"tslib";import{equals as e}from"../core/arrayUtils.js";import{deprecatedProperty as r}from"../core/deprecate.js";import{clone as i}from"../core/lang.js";import s from"../core/Logger.js";import{property as n,subclass as o}from"../core/accessorSupport/decorators.js";import a from"./Extent.js";import l from"./Geometry.js";import h from"./Point.js";import c from"./SpatialReference.js";import{polygonCentroidPoint as p}from"./support/centroid.js";import{polygonContainsPoint as u}from"./support/contains.js";import{isClockwise as m}from"./support/coordsUtils.js";import{getPolygonExtent as f}from"./support/extentUtils.js";import{project as g}from"./support/webMercatorUtils.js";import{updateSupportFromPoint as y}from"./support/zmUtils.js";import{writer as R}from"../core/accessorSupport/decorators/writer.js";var d;function w(t){return!Array.isArray(t[0])}function v(t){return"number"==typeof t[0]?.[0]}function x(t){if(!t)return;let{rings:e,hasM:r,hasZ:i,spatialReference:s}=t;switch(e??=[],v(e)&&(e=[e]),e[0]?.[0]?.length){case 4:i??=!0,r??=!0;break;case 3:i??=!0!==r,r??=!i;break;default:i??=!1,r??=!1}return s??=c.WGS84,{...t,hasM:r,hasZ:i,rings:e,spatialReference:s}}let j=d=class extends l{static fromExtent(t){const e=t.clone().normalize(),{spatialReference:r}=t;let i=!1,s=!1;for(const o of e)o.hasZ&&(i=!0),o.hasM&&(s=!0);const n={rings:e.map(t=>{const e=[[t.xmin,t.ymin],[t.xmin,t.ymax],[t.xmax,t.ymax],[t.xmax,t.ymin],[t.xmin,t.ymin]];if(i&&t.hasZ){const r=t.zmin+.5*(t.zmax-t.zmin);for(let t=0;t<e.length;t++)e[t].push(r)}if(s&&t.hasM){const r=t.mmin+.5*(t.mmax-t.mmin);for(let t=0;t<e.length;t++)e[t].push(r)}return e}),spatialReference:r};return i&&(n.hasZ=!0),s&&(n.hasM=!0),new d(n)}constructor(t){super(x(t)),this.curveRings=void 0,this.rings=[],this.type="polygon"}get cache(){return this.commitProperty("curveRings"),this.commitProperty("hasM"),this.commitProperty("hasZ"),this.commitProperty("rings"),this.commitProperty("spatialReference"),{}}get centroid(){r(s.getLogger(this),"centroid",{replacement:"Please use centroidOperator.execute() instead.",version:"4.34",warnOnce:!0});const t=p(this);return t?h.fromJSON(t):null}writeCurveRings(t,e){e.curveRings=i(t)}get extent(){const t=f(this),{spatialReference:e}=this;return t?new a({...t,spatialReference:e}):null}writeRings(t,e){e.rings=i(this.rings)}addRing(t){if(!t)return;const e=this.rings,r=e.length;if(w(t)){const i=[];for(let e=0,r=t.length;e<r;e++)i[e]=t[e].toArray();e[r]=i}else e[r]=t.slice();return this.notifyChange("rings"),this}clone(){const t=new d;return t.spatialReference=this.spatialReference,t.rings=i(this.rings),t.curveRings=i(this.curveRings),t.hasZ=this.hasZ,t.hasM=this.hasM,t}equals(t){if(this===t)return!0;if(null==t)return!1;const r=this.spatialReference,i=t.spatialReference;if(null!=r!=(null!=i))return!1;if(null!=r&&null!=i&&!r.equals(i))return!1;if(this.rings.length!==t.rings.length)return!1;const s=([t,e,r,i],[s,n,o,a])=>t===s&&e===n&&(null==r&&null==o||r===o)&&(null==i&&null==a||i===a);for(let n=0;n<this.rings.length;n++){const r=this.rings[n],i=t.rings[n];if(!e(r,i,s))return!1}return!0}contains(t){if(!t)return!1;const e=g(t,this.spatialReference);return u(this,null!=e?e:t)}isClockwise(t){const e=w(t)?t.map(t=>this.hasZ?this.hasM?[t.x,t.y,t.z,t.m]:[t.x,t.y,t.z]:[t.x,t.y]):t;return m(e)}getPoint(t,e){if(!this._validateInputs(t,e))return null;const r=this.rings[t][e],i=this.hasZ,s=this.hasM;return i&&!s?new h(r[0],r[1],r[2],void 0,this.spatialReference):s&&!i?new h(r[0],r[1],void 0,r[2],this.spatialReference):i&&s?new h(r[0],r[1],r[2],r[3],this.spatialReference):new h(r[0],r[1],this.spatialReference)}insertPoint(t,e,r){return this._validateInputs(t,e,!0)?(y(this,r),Array.isArray(r)||(r=r.toArray()),this.rings[t].splice(e,0,r),this.notifyChange("rings"),this):this}removePoint(t,e){if(!this._validateInputs(t,e))return null;const r=new h(this.rings[t].splice(e,1)[0],this.spatialReference);return this.notifyChange("rings"),r}removeRing(t){if(!this._validateInputs(t,null))return null;const e=this.rings.splice(t,1)[0],r=this.spatialReference,i=e.map(t=>new h(t,r));return this.notifyChange("rings"),i}setPoint(t,e,r){return this._validateInputs(t,e)?(y(this,r),Array.isArray(r)||(r=r.toArray()),this.rings[t][e]=r,this.notifyChange("rings"),this):this}_validateInputs(t,e,r=!1){if(null==t||t<0||t>=this.rings.length)return!1;if(null!=e){const i=this.rings[t];if(r&&(e<0||e>i.length))return!1;if(!r&&(e<0||e>=i.length))return!1}return!0}toJSON(t){return this.write({},t)}};t([n({readOnly:!0})],j.prototype,"cache",null),t([n({readOnly:!0})],j.prototype,"centroid",null),t([n({json:{write:!0,origins:{"portal-item":{write:!1},"web-map":{write:!1},"web-scene":{write:!1}}}})],j.prototype,"curveRings",void 0),t([R("curveRings")],j.prototype,"writeCurveRings",null),t([n({readOnly:!0})],j.prototype,"extent",null),t([n({type:[[[Number]]],json:{write:{isRequired:!0}}})],j.prototype,"rings",void 0),t([R("rings")],j.prototype,"writeRings",null),j=d=t([o("esri.geometry.Polygon")],j),j.prototype.toJSON.isDefaultToJSON=!0;export{j as default};
+import{__decorate as t}from"tslib";import{equals as e}from"../core/arrayUtils.js";import{deprecatedProperty as r}from"../core/deprecate.js";import{clone as i}from"../core/lang.js";import s from"../core/Logger.js";import{property as n,subclass as o}from"../core/accessorSupport/decorators.js";import a from"./Extent.js";import l from"./Geometry.js";import h from"./Point.js";import p from"./SpatialReference.js";import{polygonCentroidPoint as c}from"./support/centroid.js";import{polygonContainsPoint as u}from"./support/contains.js";import{isClockwise as m}from"./support/coordsUtils.js";import{getPolygonExtent as f}from"./support/extentUtils.js";import{comparePoints as g}from"./support/geometryUtils.js";import{project as y}from"./support/webMercatorUtils.js";import{updateSupportFromPoint as R}from"./support/zmUtils.js";import{writer as d}from"../core/accessorSupport/decorators/writer.js";var w;function v(t){return!Array.isArray(t[0])}function x(t){return"number"==typeof t[0]?.[0]}function j(t){if(!t)return;let{rings:e,hasM:r,hasZ:i,spatialReference:s}=t;switch(e??=[],x(e)&&(e=[e]),e[0]?.[0]?.length){case 4:i??=!0,r??=!0;break;case 3:i??=!0!==r,r??=!i;break;default:i??=!1,r??=!1}return s??=p.WGS84,{...t,hasM:r,hasZ:i,rings:e,spatialReference:s}}let P=w=class extends l{static fromExtent(t){const e=t.clone().normalize(),{spatialReference:r}=t;let i=!1,s=!1;for(const o of e)o.hasZ&&(i=!0),o.hasM&&(s=!0);const n={rings:e.map(t=>{const e=[[t.xmin,t.ymin],[t.xmin,t.ymax],[t.xmax,t.ymax],[t.xmax,t.ymin],[t.xmin,t.ymin]];if(i&&t.hasZ){const r=t.zmin+.5*(t.zmax-t.zmin);for(let t=0;t<e.length;t++)e[t].push(r)}if(s&&t.hasM){const r=t.mmin+.5*(t.mmax-t.mmin);for(let t=0;t<e.length;t++)e[t].push(r)}return e}),spatialReference:r};return i&&(n.hasZ=!0),s&&(n.hasM=!0),new w(n)}constructor(t){super(j(t)),this.curveRings=void 0,this.rings=[],this.type="polygon"}get cache(){return this.commitProperty("curveRings"),this.commitProperty("hasM"),this.commitProperty("hasZ"),this.commitProperty("rings"),this.commitProperty("spatialReference"),{}}get centroid(){r(s.getLogger(this),"centroid",{replacement:"Please use centroidOperator.execute() instead.",version:"4.34",warnOnce:!0});const t=c(this);return t?h.fromJSON(t):null}writeCurveRings(t,e){e.curveRings=i(t)}get extent(){const t=f(this),{spatialReference:e}=this;return t?new a({...t,spatialReference:e}):null}writeRings(t,e){e.rings=i(this.rings)}addRing(t){if(!t)return;const e=this.rings,r=e.length;if(v(t)){const i=[];for(let e=0,r=t.length;e<r;e++)i[e]=t[e].toArray();e[r]=i}else e[r]=t.slice();return this.notifyChange("rings"),this}clone(){const t=new w;return t.spatialReference=this.spatialReference,t.rings=i(this.rings),t.curveRings=i(this.curveRings),t.hasZ=this.hasZ,t.hasM=this.hasM,t}equals(t){if(this===t)return!0;if(null==t)return!1;const r=this.spatialReference,i=t.spatialReference;if(null!=r!=(null!=i))return!1;if(null!=r&&null!=i&&!r.equals(i))return!1;if(this.rings.length!==t.rings.length)return!1;for(let s=0;s<this.rings.length;s++){const r=this.rings[s],i=t.rings[s];if(!e(r,i,g))return!1}return!0}contains(t){if(!t)return!1;const e=y(t,this.spatialReference);return u(this,null!=e?e:t)}isClockwise(t){const e=v(t)?t.map(t=>this.hasZ?this.hasM?[t.x,t.y,t.z,t.m]:[t.x,t.y,t.z]:[t.x,t.y]):t;return m(e)}getPoint(t,e){if(!this._validateInputs(t,e))return null;const r=this.rings[t][e],i=this.hasZ,s=this.hasM;return i&&!s?new h(r[0],r[1],r[2],void 0,this.spatialReference):s&&!i?new h(r[0],r[1],void 0,r[2],this.spatialReference):i&&s?new h(r[0],r[1],r[2],r[3],this.spatialReference):new h(r[0],r[1],this.spatialReference)}insertPoint(t,e,r){return this._validateInputs(t,e,!0)?(R(this,r),Array.isArray(r)||(r=r.toArray()),this.rings[t].splice(e,0,r),this.notifyChange("rings"),this):this}removePoint(t,e){if(!this._validateInputs(t,e))return null;const r=new h(this.rings[t].splice(e,1)[0],this.spatialReference);return this.notifyChange("rings"),r}removeRing(t){if(!this._validateInputs(t,null))return null;const e=this.rings.splice(t,1)[0],r=this.spatialReference,i=e.map(t=>new h(t,r));return this.notifyChange("rings"),i}setPoint(t,e,r){return this._validateInputs(t,e)?(R(this,r),Array.isArray(r)||(r=r.toArray()),this.rings[t][e]=r,this.notifyChange("rings"),this):this}_validateInputs(t,e,r=!1){if(null==t||t<0||t>=this.rings.length)return!1;if(null!=e){const i=this.rings[t];if(r&&(e<0||e>i.length))return!1;if(!r&&(e<0||e>=i.length))return!1}return!0}toJSON(t){return this.write({},t)}};t([n({readOnly:!0})],P.prototype,"cache",null),t([n({readOnly:!0})],P.prototype,"centroid",null),t([n({json:{write:!0,origins:{"portal-item":{write:!1},"web-map":{write:!1},"web-scene":{write:!1}}}})],P.prototype,"curveRings",void 0),t([d("curveRings")],P.prototype,"writeCurveRings",null),t([n({readOnly:!0})],P.prototype,"extent",null),t([n({type:[[[Number]]],json:{write:{isRequired:!0}}})],P.prototype,"rings",void 0),t([d("rings")],P.prototype,"writeRings",null),P=w=t([o("esri.geometry.Polygon")],P),P.prototype.toJSON.isDefaultToJSON=!0;export{P as default};

package/geometry/support/MeshMaterial.d.ts

@@ -57,10 +57,10 @@ export interface MeshMaterialProperties extends Partial<Pick<MeshMaterial, "alph
  * The material properties support a number of convenience autocast types, including
  * hex color strings and well-known color strings (autocasts to
  * [Color](https://developers.arcgis.com/javascript/latest/references/core/Color/)), or strings representing URLs to images,
- * [HTMLImageElements](https://developer.mozilla.org/en-US/docs/Web/API/HTMLImageElement),
- * [HTMLCanvasElements](https://developer.mozilla.org/en-US/docs/Web/API/HTMLCanvasElement),
- * [HTMLVideoElement](https://developer.mozilla.org/en-US/docs/Web/API/HTMLVideoElement),
- * or [ImageData](https://developer.mozilla.org/en-US/docs/Web/API/ImageData)
+ * [HTMLImageElements](https://developer.mozilla.org/docs/Web/API/HTMLImageElement),
+ * [HTMLCanvasElements](https://developer.mozilla.org/docs/Web/API/HTMLCanvasElement),
+ * [HTMLVideoElement](https://developer.mozilla.org/docs/Web/API/HTMLVideoElement),
+ * or [ImageData](https://developer.mozilla.org/docs/Web/API/ImageData)
  * (autocasts to [MeshTexture](https://developers.arcgis.com/javascript/latest/references/core/geometry/support/MeshTexture/)).
  *
  * ```js
@@ -81,7 +81,7 @@ export interface MeshMaterialProperties extends Partial<Pick<MeshMaterial, "alph
  *   url: "./image.png"
  * });
  *
- * const boxMesh = Mesh.createBox(location, {
+ * const boxMesh = createBox(location, {
  *   material: {
  *     colorTexture: meshTextureByUrl
  *   }

package/geometry/support/MeshTexture.d.ts

@@ -5,11 +5,11 @@ import type { MeshTextureData } from "../types.js";
 export interface MeshTextureProperties extends Partial<Pick<MeshTexture, "transparent" | "url" | "wrap">> {
   /**
    * A direct reference to the image or video data. The data can be an
-   * [image element](https://developer.mozilla.org/en-US/docs/Web/API/HTMLImageElement),
-   * [canvas element](https://developer.mozilla.org/en-US/docs/Web/API/HTMLCanvasElement),
-   * [video element](https://developer.mozilla.org/en-US/docs/Web/API/HTMLVideoElement)
-   * or [ImageData](https://developer.mozilla.org/en-US/docs/Web/API/ImageData).
-   * If the data is set to a [video element](https://developer.mozilla.org/en-US/docs/Web/API/HTMLVideoElement),
+   * [image element](https://developer.mozilla.org/docs/Web/API/HTMLImageElement),
+   * [canvas element](https://developer.mozilla.org/docs/Web/API/HTMLCanvasElement),
+   * [video element](https://developer.mozilla.org/docs/Web/API/HTMLVideoElement)
+   * or [ImageData](https://developer.mozilla.org/docs/Web/API/ImageData).
+   * If the data is set to a [video element](https://developer.mozilla.org/docs/Web/API/HTMLVideoElement),
    * the element needs to be visible in the DOM.
    * The data property is mutually exclusive with the url property, setting the data will clear the
    * url (if there is one).
@@ -27,17 +27,17 @@ export interface MeshTextureProperties extends Partial<Pick<MeshTexture, "transp
  * set either as a [MeshMaterial.colorTexture](https://developers.arcgis.com/javascript/latest/references/core/geometry/support/MeshMaterial/#colorTexture)
  * or as [MeshMaterial.normalTexture](https://developers.arcgis.com/javascript/latest/references/core/geometry/support/MeshMaterial/#normalTexture).
  * Images can be referred to either by url or directly by data (
- * [HTMLImageElement](https://developer.mozilla.org/en-US/docs/Web/API/HTMLImageElement),
- * [HTMLCanvasElement](https://developer.mozilla.org/en-US/docs/Web/API/HTMLCanvasElement),
- * [HTMLVideoElement](https://developer.mozilla.org/en-US/docs/Web/API/HTMLVideoElement)
- * or [ImageData](https://developer.mozilla.org/en-US/docs/Web/API/ImageData)).
+ * [HTMLImageElement](https://developer.mozilla.org/docs/Web/API/HTMLImageElement),
+ * [HTMLCanvasElement](https://developer.mozilla.org/docs/Web/API/HTMLCanvasElement),
+ * [HTMLVideoElement](https://developer.mozilla.org/docs/Web/API/HTMLVideoElement)
+ * or [ImageData](https://developer.mozilla.org/docs/Web/API/ImageData)).
  *
  * ```js
  * const meshColorByUrl = new MeshTexture({
  *   url: "./image.png"
  * });
  *
- * const mesh = Mesh.createBox(location, {
+ * const mesh = createBox(location, {
  *   material: {
  *     colorTexture: meshColorByUrl
  *   }
@@ -47,14 +47,14 @@ export interface MeshTextureProperties extends Partial<Pick<MeshTexture, "transp
  *   data: canvasElement
  * });
  *
- * const meshWithCanvasMaterial = Mesh.createBox(location, {
+ * const meshWithCanvasMaterial = createBox(location, {
  *   material: {
  *     colorTexture: meshColorByCanvas
  *   }
  * });
  *
  * // Support for autocasting within a mesh material constructor
- * const meshWithAutocastMaterial = Mesh.createSphere(location, {
+ * const meshWithAutocastMaterial = createSphere(location, {
  *   material: {
  *     colorTexture: {
  *       url: "./image.png"
@@ -65,7 +65,7 @@ export interface MeshTextureProperties extends Partial<Pick<MeshTexture, "transp
  * // Mesh materials also support additional advanced autocasting types
  * // such as a Canvas element. In this case the canvas element will be
  * // available in the MeshTexture.data property.
- * const meshWithCanvasAutocastMaterial = Mesh.createSphere(location, {
+ * const meshWithCanvasAutocastMaterial = createSphere(location, {
  *   material: {
  *     colorTexture: canvasElement
  *   }
@@ -87,7 +87,7 @@ export interface MeshTextureProperties extends Partial<Pick<MeshTexture, "transp
  * video.style.height = 0;
  * video.style.visibility = "hidden";
  *
- * const meshWithVideoMaterial = Mesh.createPlane(location, {
+ * const meshWithVideoMaterial = createPlane(location, {
  *   material: {
  *     colorTexture: { data: video }
  *   }
@@ -103,11 +103,11 @@ export default class MeshTexture extends MeshTextureSuperclass {
   constructor(properties?: MeshTextureProperties);
   /**
    * A direct reference to the image or video data. The data can be an
-   * [image element](https://developer.mozilla.org/en-US/docs/Web/API/HTMLImageElement),
-   * [canvas element](https://developer.mozilla.org/en-US/docs/Web/API/HTMLCanvasElement),
-   * [video element](https://developer.mozilla.org/en-US/docs/Web/API/HTMLVideoElement)
-   * or [ImageData](https://developer.mozilla.org/en-US/docs/Web/API/ImageData).
-   * If the data is set to a [video element](https://developer.mozilla.org/en-US/docs/Web/API/HTMLVideoElement),
+   * [image element](https://developer.mozilla.org/docs/Web/API/HTMLImageElement),
+   * [canvas element](https://developer.mozilla.org/docs/Web/API/HTMLCanvasElement),
+   * [video element](https://developer.mozilla.org/docs/Web/API/HTMLVideoElement)
+   * or [ImageData](https://developer.mozilla.org/docs/Web/API/ImageData).
+   * If the data is set to a [video element](https://developer.mozilla.org/docs/Web/API/HTMLVideoElement),
    * the element needs to be visible in the DOM.
    * The data property is mutually exclusive with the url property, setting the data will clear the
    * url (if there is one).

package/geometry/support/geometryUtils.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import e from"../Extent.js";import{getExtentForScale as t}from"./scaleUtils.js";async function n(e,t){if(e.hasZ||"2d"===t.type)return e;const n=t.map?.ground;return n?.layers.length?(await n.queryElevation(e,{cache:t.basemapTerrain?.elevationQueryCache})).geometry:e}function r(e,t,n){return a(e.center,t,n)}function a(n,r,a){const i=n.hasZ?n.z:void 0;if(r?.map){return(null!=a?t(r,a):r.extent).clone().centerAt(n).set({zmax:i,zmin:i})}const{x:o,y:c,spatialReference:s}=n;return new e({xmin:o-.25,ymin:c-.25,xmax:o+.25,ymax:c+.25,spatialReference:s,zmin:i,zmax:i})}function i(e,t,n,r){switch(e?.type){case"extent":return e;case"polygon":case"polyline":case"multipoint":return e.extent??void 0;case"point":return a(r.execute(e),t??void 0,n??void 0);default:return}}export{a as createExtentFromPoint,i as getExtentFromGeometry,n as getPointWithElevation,r as scaleExtent};
+import e from"../Extent.js";import{getExtentForScale as n}from"./scaleUtils.js";async function t(e,n){if(e.hasZ||"2d"===n.type)return e;const t=n.map?.ground;return t?.layers.length?(await t.queryElevation(e,{cache:n.basemapTerrain?.elevationQueryCache})).geometry:e}function r(e,n,t){return a(e.center,n,t)}function a(t,r,a){const i=t.hasZ?t.z:void 0;if(r?.map){return(null!=a?n(r,a):r.extent).clone().centerAt(t).set({zmax:i,zmin:i})}const{x:o,y:u,spatialReference:c}=t;return new e({xmin:o-.25,ymin:u-.25,xmax:o+.25,ymax:u+.25,spatialReference:c,zmin:i,zmax:i})}function i(e,n,t,r){switch(e?.type){case"extent":return e;case"polygon":case"polyline":case"multipoint":return e.extent??void 0;case"point":return a(r.execute(e),n??void 0,t??void 0);default:return}}function o([e,n,t,r],[a,i,o,u]){return e===a&&n===i&&(null==t&&null==o||t===o)&&(null==r&&null==u||r===u)}export{o as comparePoints,a as createExtentFromPoint,i as getExtentFromGeometry,t as getPointWithElevation,r as scaleExtent};

package/geometry/support/jsonUtils.d.ts

@@ -12,7 +12,7 @@ import type { GeometryType } from "../../portal/jsonTypes.js";
  * Creates a new instance of an appropriate [Geometry](https://developers.arcgis.com/javascript/latest/references/core/geometry/Geometry/) class and initializes it with values from a JSON object
  * generated from an ArcGIS product. The object passed into the input `json`
  * parameter often comes from a response to a query operation in the REST API or a
- * [toJSON()](https://pro.arcgis.com/en/pro-app/latest/tool-reference/conversion/features-to-json.htm)
+ * [toJSON()](https://doc.esri.com/en/arcgis-pro/latest/tool-reference/conversion/features-to-json.html?tabs=dialog)
  * method from another ArcGIS product. See the [Using fromJSON()](https://developers.arcgis.com/javascript/latest/using-fromjson)
  * topic in the Guide for details and examples of when and how to use this function.
  *

package/geometry/support/meshUtils.d.ts

@@ -6,11 +6,14 @@
 import type Ground from "../../Ground.js";
 import type Extent from "../Extent.js";
 import type Mesh from "../Mesh.js";
+import type Point from "../Point.js";
+import type Polygon from "../Polygon.js";
 import type ElevationLayer from "../../layers/ElevationLayer.js";
 import type ElevationSampler from "../../layers/support/ElevationSampler.js";
 import type { AbortOptions } from "../../core/promiseUtils.js";
 import type { MeshVertexSpaceUnion } from "../types.js";
-import type { CreateElevationSamplerParameters, CreateFromElevationParameters } from "./meshUtils/types.js";
+import type { MeshMaterialProperties } from "./MeshMaterial.js";
+import type { CreateBoxParameters, CreateCylinderParameters, CreateElevationSamplerParameters, CreateFromElevationParameters, CreateFromGLTFParameters, CreatePlaneParameters, CreateSphereParameters } from "./meshUtils/types.js";
 
 /**
  * Creates a mesh geometry by sampling elevation data from an elevation service on a regular grid.
@@ -99,4 +102,129 @@ export function merge(geometries: Mesh[]): Mesh | null | undefined;
  *
  * view.graphics.add(new Graphic({ geometry: highestPoint }));
  */
-export function convertVertexSpace(mesh: Mesh, targetVertexSpace: MeshVertexSpaceUnion, options?: AbortOptions): Promise<Mesh>;
+export function convertVertexSpace(mesh: Mesh, targetVertexSpace: MeshVertexSpaceUnion, options?: AbortOptions): Promise<Mesh>;
+
+/**
+ * Creates a mesh representing a box. The spatial reference of the resulting mesh is the same
+ * as the location where it is placed.
+ *
+ * #### Box UV coordinate space
+ *
+ * The box geometry will have UV coordinates generated according to the following scheme:
+ *
+ * <img src="https://developers.arcgis.com/javascript/latest/assets/references/core/geometry/mesh-box-uv.avif" width="300" height="300"/>
+ *
+ * @param location - The location bottom center of the box.
+ * @param parameters - Parameters to configure the box creation.
+ * @returns The resulting mesh.
+ * @since 5.1
+ * @example
+ * let mesh = meshUtils.createBox(point, {
+ *   size: {
+ *     width: 10,
+ *     height: 100,
+ *     depth: 20
+ *   },
+ *   material: {
+ *     color: "green"
+ *   }
+ * });
+ * @example
+ * let mesh = meshUtils.createBox(point, {
+ *   imageFace: "top",
+ *   material: {
+ *     colorTexture: new MeshTexture({ url: "./url-to-image.png" })
+ *   }
+ * });
+ */
+export function createBox(location: Point, parameters?: CreateBoxParameters): Mesh;
+
+/**
+ * Creates a mesh representing a sphere. The spatial reference of the resulting mesh is the same
+ * as the location where it is placed.
+ *
+ * #### Sphere UV coordinate space
+ *
+ * The sphere geometry will have UV coordinates generated according to the following scheme
+ * (example is shown for 8x8 vertices sphere):
+ *
+ * <img src="https://developers.arcgis.com/javascript/latest/assets/references/core/geometry/mesh-sphere-uv.avif" width="300" height="300"/>
+ *
+ * @param location - The location of the bottom center of the sphere.
+ * @param parameters - Parameters to configure the sphere creation.
+ * @returns The resulting mesh.
+ * @since 5.1
+ */
+export function createSphere(location: Point, parameters?: CreateSphereParameters): Mesh;
+
+/**
+ * Creates a mesh representing a cylinder. The spatial reference of the resulting mesh is the same
+ * as the location where it is placed.
+ *
+ * #### Cylinder UV coordinate space
+ *
+ * The cylinder geometry will have UV coordinates generated according to the following scheme
+ * (example is shown for 8 vertices cylinder):
+ *
+ * <img src="https://developers.arcgis.com/javascript/latest/assets/references/core/geometry/mesh-cylinder-uv.avif" width="300" height="300"/>
+ *
+ * @param location - The location of the bottom center of the cylinder.
+ * @param parameters - Parameters to configure the cylinder creation.
+ * @returns The resulting mesh.
+ * @since 5.1
+ */
+export function createCylinder(location: Point, parameters?: CreateCylinderParameters): Mesh;
+
+/**
+ * Creates a mesh representing a plane. The spatial reference of the resulting mesh is the same
+ * as the location where it is placed. A plane consists of two triangles and may be conveniently
+ * oriented at creation time.
+ *
+ * #### Plane UV coordinate space
+ *
+ * The plane geometry will have UV coordinates generated according to the following scheme:
+ *
+ * <img src="https://developers.arcgis.com/javascript/latest/assets/references/core/geometry/mesh-plane-uv.avif" width="300" height="300"/>
+ *
+ * @param location - The location of the bottom center of the plane.
+ * @param parameters - Parameters to configure the plane creation.
+ * @returns The resulting mesh.
+ * @since 5.1
+ */
+export function createPlane(location: Point, parameters?: CreatePlaneParameters): Mesh;
+
+/**
+ * Creates a new mesh geometry from a polygon geometry. The resulting mesh contains only
+ * a position vertex attribute and a single component with faces. The default shading will be
+ * set to `flat`. The spatial reference of the resulting mesh is the same
+ * as the input polygon. The resulting mesh will not contain any UV nor normal vertex attributes.
+ *
+ * @param polygon - The input polygon.
+ * @param parameters - Optional parameters.
+ * @returns A promise that resolves to a new mesh representing the triangulated polygon.
+ * @since 5.1
+ */
+export function createFromPolygon(polygon: Polygon, parameters?: CreateFromPolygonParameters): Promise<Mesh>;
+
+/**
+ * Creates a new mesh geometry from a glTF model referenced by the `url` parameter.
+ *
+ * The spatial reference of the resulting mesh is the same as the spatial reference of the `location` parameter. For
+ * more information on the supported glTF features you can read the
+ * [Visualizing points with 3D symbols](https://developers.arcgis.com/javascript/latest/visualizing-points-3d/) guide topic. Animations are currently unsupported.
+ *
+ * @param location - The location of the origin of the model. If the location does not
+ *  contain a z-value, z is assumed to be `0`.
+ * @param url - The URL of the glTF model. The URL should point to a glTF file (.gltf or .glb) which can
+ *  reference additional binary (.bin) and image files (.jpg, .png).
+ * @param parameters - Parameters to configure the mesh from glTF creation.
+ * @returns A promise that resolves to a mesh geometry representing the loaded
+ *  glTF model.
+ * @since 5.1
+ */
+export function createFromGLTF(location: Point, url: string, parameters?: CreateFromGLTFParameters): Promise<Mesh>;
+
+export interface CreateFromPolygonParameters {
+  /** The material to be used for the mesh. */
+  material?: MeshMaterialProperties;
+}

package/geometry/support/meshUtils.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{throwIfAborted as e}from"../../core/promiseUtils.js";import t from"../Mesh.js";import{merge as r}from"./meshUtils/merge.js";async function s(t,r,s){const n=await import("./meshUtils/elevation.js");return e(s),n.create(t,r,s)}async function n(e,t){await e.load();const{create:r}=await import("./meshUtils/elevationSampler.js");return r(e,t)}function o(e){const s=r(e);return null!=s?new t(s):null}async function i(t,r,s){const{convertMeshVertexSpace:n}=await import("./meshUtils/convertMeshVertexSpace.js");return e(s),n(t,r,s)}export{i as convertVertexSpace,n as createElevationSampler,s as createFromElevation,o as merge};
+import e from"../../core/Error.js";import{throwIfAborted as t,whenOrAbort as n,isPromiseLike as r}from"../../core/promiseUtils.js";import s from"../Mesh.js";import o from"./MeshComponent.js";import i from"./MeshGeoreferencedVertexSpace.js";import a from"./MeshTransform.js";import c from"./MeshVertexAttributes.js";import{selectVertexSpace as m}from"./meshVertexSpaceUtils.js";import{merge as l}from"./meshUtils/merge.js";import{Metadata as p}from"./meshUtils/Metadata.js";import{convertUnitGeometry as f,createUnitSizeSphere as u,createUnitSizeBox as w,extractSingleFaceOfBox as h,createUnitSizeCylinder as j,convertPlaneSizeParameter as d,createUnitSizePlane as v}from"./meshUtils/primitives.js";import{polygonToRenderInfoNotElevationAligned as x}from"../../views/3d/support/renderInfoUtils/polygon.js";async function M(e,n,r){const s=await import("./meshUtils/elevation.js");return t(r),s.create(e,n,r)}async function g(e,t){await e.load();const{create:n}=await import("./meshUtils/elevationSampler.js");return n(e,t)}function U(e){const t=l(e);return null!=t?new s(t):null}async function S(e,n,r){const{convertMeshVertexSpace:s}=await import("./meshUtils/convertMeshVertexSpace.js");return t(r),s(e,n,r)}function y(e,t){const n=new s(f(w(),e,t));return t?.imageFace&&"all"!==t.imageFace?h(n,t.imageFace):n}function F(e,t){return new s(f(u(t?.densificationFactor||0),e,t))}function R(e,t){return new s(f(j(t?.densificationFactor||0),e,t))}function V(e,t){const n=t?.facing??"up",r=d(n,t?.size);return new s(f(v(n),e,{...t,size:r}))}async function b(e,t){let n=x(e);r(n)&&(await n,n=x(e));const a=r(n)?null:n,m=a?.positions??[],l=a?.polygonIndices??[];return new s({vertexAttributes:new c({position:m}),components:[new o({faces:l,shading:"flat",material:t?.material??null})],spatialReference:e.spatialReference,vertexSpace:new i})}async function C(e,t,r){const{loadGLTFMesh:o}=await n(import("./meshUtils/loadGLTFMesh.js"),r);return new s((await o(e,t,r)).mesh)}function G(e,t,n){const r=n?.extent??null,{spatialReference:o}=e,i=n?.transform?.clone()??new a,c=m(e,n),l=n?.unitConversionDisabled,f={source:t,extent:r,unitConversionDisabled:l},u=new p;return u.externalSources.push(f),new s({metadata:u,transform:i,vertexSpace:c,spatialReference:o})}function T(t,n){const{spatialReference:r}=t,o=n?.transform?.clone()??new a,i=m(t,n),c=new s({transform:o,vertexSpace:i,spatialReference:r});return c.addResolvingPromise(Promise.reject(new e("mesh-incomplete","Mesh resources are not complete"))),c}export{S as convertVertexSpace,y as createBox,R as createCylinder,g as createElevationSampler,M as createFromElevation,C as createFromGLTF,b as createFromPolygon,T as createIncomplete,V as createPlane,F as createSphere,G as createWithExternalSource,U as merge};

package/graphic/AnnotationGraphicOrigin.d.ts

@@ -0,0 +1,34 @@
+import type GraphicOrigin from "./GraphicOrigin.js";
+import type AnnotationLayer from "../layers/AnnotationLayer.js";
+
+/**
+ * Provides information about the [AnnotationLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/AnnotationLayer/) from which a graphic originates.
+ * The [origin](https://developers.arcgis.com/javascript/latest/references/core/Graphic/#origin) information may be available when a graphic is returned from methods such as
+ * [hitTest()](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#hitTest) or [queryFeatures()](https://developers.arcgis.com/javascript/latest/references/core/layers/AnnotationLayer/#queryFeatures).
+ *
+ * @since 5.1
+ * @see [MapView.hitTest()](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#hitTest)
+ * @see [SceneView.hitTest()](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/#hitTest)
+ * @see [AnnotationLayer.queryFeatures()](https://developers.arcgis.com/javascript/latest/references/core/layers/AnnotationLayer/#queryFeatures)
+ * @example
+ * // get a point from view's click event
+ *  view.on("click", async (event) => {
+ *    // Search for all features only on included layer at the clicked location
+ *    const response = await view.hitTest(event, {include: layer});
+ *    // if graphics are returned from layer, get the layer id from graphic origin
+ *    if (response.results.length > 0) {
+ *      const originId = response.results[0].graphic?.origin?.layer?.id;
+ *    }
+ *  });
+ */
+export default class AnnotationGraphicOrigin extends GraphicOrigin {
+  constructor(layer: AnnotationLayer);
+  /** A layer from which a graphic originates. */
+  readonly layer: AnnotationLayer;
+  /**
+   * Indicates the type of layer the graphic originated from.
+   *
+   * @default "annotation"
+   */
+  readonly type: AnnotationLayer["type"];
+}

package/graphic/AnnotationGraphicOrigin.js

@@ -0,0 +1,2 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+import{idFieldsProviderSymbol as r}from"./getIdFieldsProvider.js";import{popupProviderSymbol as t}from"./getPopupProvider.js";import{getSliceableContainerSymbol as e}from"./getSliceableContainer.js";import i from"./GraphicOrigin.js";class o extends i{get[t](){return this.layer}get[r](){return this.layer}get[e](){return this.layer}constructor(r){super(),this.type="annotation",this.layer=r}get id(){return this.layer.id}}export{o as default};

package/graphic/DimensionFeatureGraphicOrigin.d.ts

@@ -0,0 +1,34 @@
+import type GraphicOrigin from "./GraphicOrigin.js";
+import type DimensionFeatureLayer from "../layers/DimensionFeatureLayer.js";
+
+/**
+ * Provides information about the [DimensionFeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/DimensionFeatureLayer/) from which a graphic originates.
+ * The [origin](https://developers.arcgis.com/javascript/latest/references/core/Graphic/#origin) information may be available when a graphic is returned from methods such as
+ * [hitTest()](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#hitTest) or [queryFeatures()](https://developers.arcgis.com/javascript/latest/references/core/layers/DimensionFeatureLayer/#queryFeatures).
+ *
+ * @since 5.1
+ * @see [MapView.hitTest()](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#hitTest)
+ * @see [SceneView.hitTest()](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/#hitTest)
+ * @see [DimensionFeatureLayer.queryFeatures()](https://developers.arcgis.com/javascript/latest/references/core/layers/DimensionFeatureLayer/#queryFeatures)
+ * @example
+ * // get a point from view's click event
+ *  view.on("click", async (event) => {
+ *    // Search for all features only on included layer at the clicked location
+ *    const response = await view.hitTest(event, {include: layer});
+ *    // if graphics are returned from layer, get the layer id from graphic origin
+ *    if (response.results.length > 0) {
+ *      const originId = response.results[0].graphic?.origin?.layer?.id;
+ *    }
+ *  });
+ */
+export default class DimensionFeatureGraphicOrigin extends GraphicOrigin {
+  constructor(layer: DimensionFeatureLayer);
+  /** A layer from which a graphic originates. */
+  readonly layer: DimensionFeatureLayer;
+  /**
+   * Indicates the type of layer the graphic originated from.
+   *
+   * @default "dimension-feature"
+   */
+  readonly type: DimensionFeatureLayer["type"];
+}

package/graphic/DimensionFeatureGraphicOrigin.js

@@ -0,0 +1,2 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+import{idFieldsProviderSymbol as r}from"./getIdFieldsProvider.js";import{popupProviderSymbol as e}from"./getPopupProvider.js";import{getSliceableContainerSymbol as t}from"./getSliceableContainer.js";import i from"./GraphicOrigin.js";class s extends i{get[e](){return this.layer}get[r](){return this.layer}get[t](){return this.layer}constructor(r){super(),this.type="dimension-feature",this.layer=r}get id(){return this.layer.id}}export{s as default};