@arcgis/core 6.0.0-next.27 → 6.0.0-next.28

package/chunks/Water.glsl.js

@@ -1,6 +1,6 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/6.0/LICENSE.txt */
-import e from"../core/Error.js";import{sliceDraw as t}from"../views/3d/webgl-engine/core/shaderLibrary/Slice.glsl.js";import{Transform as n}from"../views/3d/webgl-engine/core/shaderLibrary/Transform.glsl.js";import{ObjectAndLayerIdColor as r}from"../views/3d/webgl-engine/core/shaderLibrary/attributes/ObjectAndLayerIdColor.glsl.js";import{OutputHighlight as i}from"../views/3d/webgl-engine/core/shaderLibrary/output/OutputHighlight.glsl.js";import{mainLightDirection as a,mainLightIntensity as o}from"../views/3d/webgl-engine/core/shaderLibrary/shading/lightingUniforms.js";import{NormalUtils as s}from"../views/3d/webgl-engine/core/shaderLibrary/shading/NormalUtils.glsl.js";import{readShadowDraw as c}from"../views/3d/webgl-engine/core/shaderLibrary/shading/readShadow.glsl.js";import{WaterColor as l}from"../views/3d/webgl-engine/core/shaderLibrary/shading/WaterColor.glsl.js";import{WaterDistortion as u}from"../views/3d/webgl-engine/core/shaderLibrary/shading/WaterDistortion.glsl.js";import{viewNormal as d}from"../views/3d/webgl-engine/core/shaderLibrary/util/cameraUniforms.js";import{ColorConversion as f}from"../views/3d/webgl-engine/core/shaderLibrary/util/ColorConversion.glsl.js";import{addProjViewLocalOrigin as p,addCameraPosition as m}from"../views/3d/webgl-engine/core/shaderLibrary/util/View.glsl.js";import{Float4PassUniform as h}from"../views/3d/webgl-engine/core/shaderModules/Float4PassUniform.js";import{FloatPassUniform as g}from"../views/3d/webgl-engine/core/shaderModules/FloatPassUniform.js";import{glsl as _}from"../views/3d/webgl-engine/core/shaderModules/glsl.js";import{outputColorHighlightOLID as v}from"../views/3d/webgl-engine/shaders/OutputColorHighlightOLID.glsl.js";import{ShaderBuilder as y}from"../views/webgl/ShaderBuilder.js";import{alphaCutoff as b}from"../webscene/support/AlphaCutoff.js";function x(x){let S=new y,{vertex:C,fragment:w,varyings:T}=S,{output:E,draped:D,receiveShadows:O}=x;p(C,x),S.include(n),S.attributes.add(`position`,`vec3`),S.attributes.add(`uv0`,`vec2`);let k=new h(`waterColor`,e=>e.color);switch(T.add(`vpos`,`vec3`,{invariant:!0}),C.uniforms.add(k),S.include(c,x),E){case 0:case 1:case 2:if(S.include(u),S.include(l,x),S.include(v,x),D)return C.main.add(_`
-          if (waterColor.a < ${_.float(b)}) {
+import e from"../core/Error.js";import{UNIT_Z as t}from"../core/libs/gl-matrix-2/factories/vec3f64.js";import{sliceDraw as n}from"../views/3d/webgl-engine/core/shaderLibrary/Slice.glsl.js";import{Transform as r}from"../views/3d/webgl-engine/core/shaderLibrary/Transform.glsl.js";import{ObjectAndLayerIdColor as i}from"../views/3d/webgl-engine/core/shaderLibrary/attributes/ObjectAndLayerIdColor.glsl.js";import{OutputHighlight as a}from"../views/3d/webgl-engine/core/shaderLibrary/output/OutputHighlight.glsl.js";import{getLocalUp as o}from"../views/3d/webgl-engine/core/shaderLibrary/shading/getLocalUp.glsl.js";import{mainLightDirection as s,mainLightIntensity as c}from"../views/3d/webgl-engine/core/shaderLibrary/shading/lightingUniforms.js";import{NormalUtils as l}from"../views/3d/webgl-engine/core/shaderLibrary/shading/NormalUtils.glsl.js";import{readShadowDraw as u}from"../views/3d/webgl-engine/core/shaderLibrary/shading/readShadow.glsl.js";import{WaterColor as d}from"../views/3d/webgl-engine/core/shaderLibrary/shading/WaterColor.glsl.js";import{WaterDistortion as f}from"../views/3d/webgl-engine/core/shaderLibrary/shading/WaterDistortion.glsl.js";import{viewNormal as p,localUpView as m}from"../views/3d/webgl-engine/core/shaderLibrary/util/cameraUniforms.js";import{ColorConversion as h}from"../views/3d/webgl-engine/core/shaderLibrary/util/ColorConversion.glsl.js";import{addProjViewLocalOrigin as g,addCameraPosition as _}from"../views/3d/webgl-engine/core/shaderLibrary/util/View.glsl.js";import{Float4PassUniform as v}from"../views/3d/webgl-engine/core/shaderModules/Float4PassUniform.js";import{FloatPassUniform as y}from"../views/3d/webgl-engine/core/shaderModules/FloatPassUniform.js";import{glsl as b}from"../views/3d/webgl-engine/core/shaderModules/glsl.js";import{outputColorHighlightOLID as x}from"../views/3d/webgl-engine/shaders/OutputColorHighlightOLID.glsl.js";import{ShaderBuilder as S}from"../views/webgl/ShaderBuilder.js";import{alphaCutoff as C}from"../webscene/support/AlphaCutoff.js";function w(w){let T=new S,{vertex:E,fragment:D,varyings:O}=T,{output:k,draped:A,receiveShadows:j,spherical:M}=w;g(E,w),T.include(r),T.attributes.add(`position`,`vec3`),T.attributes.add(`uv0`,`vec2`);let N=new v(`waterColor`,e=>e.color);switch(O.add(`vpos`,`vec3`,{invariant:!0}),E.uniforms.add(N),T.include(u,w),k){case 0:case 1:case 2:if(T.include(f),T.include(d,w),T.include(x,w),A)return E.main.add(b`
+          if (waterColor.a < ${b.float(C)}) {
             // Discard this vertex
             gl_Position = vec4(1e38, 1e38, 1e38, 1.0);
             return;
@@ -8,8 +8,8 @@ import e from"../core/Error.js";import{sliceDraw as t}from"../views/3d/webgl-eng
 
           vpos = position;
           gl_Position = transformPosition(proj, view, vpos);
-        `),w.uniforms.add(k),w.main.add(_`fragColor = waterColor;`),S;C.include(s,x),T.add(`vuv`,`vec2`),T.add(`vnormal`,`vec3`),T.add(`vtbnMatrix`,`mat3`),C.main.add(_`
-        if (waterColor.a < ${_.float(b)}) {
+        `),D.uniforms.add(N),D.main.add(b`fragColor = waterColor;`),T;O.add(`vuv`,`vec2`),E.main.add(b`
+        if (waterColor.a < ${b.float(C)}) {
           // Discard this vertex
           gl_Position = vec4(1e38, 1e38, 1e38, 1.0);
           return;
@@ -17,26 +17,24 @@ import e from"../core/Error.js";import{sliceDraw as t}from"../views/3d/webgl-eng
 
         vuv = uv0;
         vpos = position;
-        vnormal = getLocalUp(vpos, localOrigin);
-        vtbnMatrix = getTBNMatrix(vnormal);
-
         gl_Position = transformPosition(proj, view, vpos);
         forwardLinearDepthToReadShadow();
-      `),w.include(t,x),w.include(f),m(w,x),w.uniforms.add(a,o,k,new g(`timeElapsed`,({timeElapsed:e})=>e),C.uniforms.get(`view`),C.uniforms.get(`localOrigin`)).main.add(_`
+      `),M?(E.include(l,w),O.add(`upWorld`,`vec3`),O.add(`tbnMatrix`,`mat3`),E.main.add(b`upWorld = getLocalUp(vpos, localOrigin);
+tbnMatrix = getTBNMatrix(upWorld);`)):(D.constants.add(`upWorld`,`vec3`,t),D.main.add(b`mat3 tbnMatrix = mat3(1.0);`)),D.include(n,w),D.include(h),_(D,w),D.uniforms.add(s,c,N,new y(`timeElapsed`,({timeElapsed:e})=>e),E.uniforms.get(`view`),E.uniforms.get(`localOrigin`)).main.add(b`
         discardBySlice(vpos);
         // the created normal is in tangent space
         vec4 tangentNormalFoam = getSurfaceNormalAndFoam(vuv, timeElapsed);
 
         // we rotate the normal according to the tangent-bitangent-normal-Matrix
-        vec3 n = normalize(vtbnMatrix * tangentNormalFoam.xyz);
+        vec3 n = normalize(tbnMatrix * tangentNormalFoam.xyz);
         vec3 v = -normalize(vpos - cameraPosition);
-        float shadow = ${O?_`1.0 - readShadowMap(vpos)`:`1.0`};
+        float shadow = ${j?b`1.0 - readShadowMap(vpos)`:`1.0`};
         vec4 vPosView = view * vec4(vpos, 1.0);
-        vec4 final = vec4(getWaterColor(n, v, mainLightDirection, waterColor.rgb, mainLightIntensity, vnormal, shadow, tangentNormalFoam.w, vPosView.xyz, vpos + localOrigin), waterColor.w);
+        vec4 final = vec4(getWaterColor(n, v, mainLightDirection, waterColor.rgb, mainLightIntensity, upWorld, shadow, tangentNormalFoam.w, vPosView.xyz, vpos + localOrigin), waterColor.w);
 
         fragColor = delinearizeGamma(final);
-        outputColorHighlightOLID(applySlice(fragColor, vpos), final.rgb);`);break;case 4:S.include(u,x),C.include(s,x),C.main.add(_`
-        if (waterColor.a < ${_.float(b)}) {
+        outputColorHighlightOLID(applySlice(fragColor, vpos), final.rgb);`);break;case 4:T.include(f,w),E.main.add(b`
+        if (waterColor.a < ${b.float(C)}) {
           // Discard this vertex
           gl_Position = vec4(1e38, 1e38, 1e38, 1.0);
           return;
@@ -44,10 +42,11 @@ import e from"../core/Error.js";import{sliceDraw as t}from"../views/3d/webgl-eng
 
         vpos = position;
         gl_Position = transformPosition(proj, view, vpos);
-      `),w.include(t,x),w.main.add(_`discardBySlice(vpos);`),x.drapedNormals?(T.add(`vuv`,`vec2`),C.main.add(`vuv = uv0;`),w.uniforms.add(new g(`timeElapsed`,({timeElapsed:e})=>e)).main.add(_`vec4 tangentNormalFoam = getSurfaceNormalAndFoam(vuv, timeElapsed);
+      `),D.include(n,w),D.main.add(b`discardBySlice(vpos);`),w.drapedNormals?(O.add(`vuv`,`vec2`),E.main.add(`vuv = uv0;`),D.uniforms.add(new y(`timeElapsed`,({timeElapsed:e})=>e)).main.add(b`vec4 tangentNormalFoam = getSurfaceNormalAndFoam(vuv, timeElapsed);
 tangentNormalFoam.xyz = normalize(tangentNormalFoam.xyz);
-fragColor = vec4((tangentNormalFoam.xyz + vec3(1.0)) * 0.5, tangentNormalFoam.a);`)):(T.add(`vnormal`,`vec3`),C.uniforms.add(d).main.add(`vnormal = normalize((viewNormal * vec4(getLocalUp(vpos, localOrigin), 1.0)).xyz);`),w.main.add(`fragColor = vec4(vec3(0.5) + 0.5 * vnormal, 1.0);`));break;case 3:C.main.add(_`
-        if (waterColor.a < ${_.float(b)}) {
+fragColor = vec4((tangentNormalFoam.xyz + vec3(1.0)) * 0.5, tangentNormalFoam.a);`)):M?(E.include(o,w),O.add(`normalView`,`vec3`),E.uniforms.add(p).main.add(b`vec3 upWorld = getLocalUp(vpos, localOrigin);
+normalView = normalize((viewNormal * vec4(upWorld, 1.0)).xyz);`),D.main.add(b`fragColor = vec4(vec3(0.5) + 0.5 * normalView, 1.0);`)):D.uniforms.add(m).main.add(b`fragColor = vec4(vec3(0.5) + 0.5 * localUpView, 1.0);`);break;case 3:E.main.add(b`
+        if (waterColor.a < ${b.float(C)}) {
           // Discard this vertex
           gl_Position = vec4(1e38, 1e38, 1e38, 1.0);
           return;
@@ -55,17 +54,17 @@ fragColor = vec4((tangentNormalFoam.xyz + vec3(1.0)) * 0.5, tangentNormalFoam.a)
 
         vpos = position;
         gl_Position = transformPosition(proj, view, vpos);
-      `),w.include(t,x),w.main.add(`discardBySlice(vpos);`);break;case 10:S.include(i,x),C.main.add(_`
-        if (waterColor.a < ${_.float(b)}) {
+      `),D.include(n,w),D.main.add(`discardBySlice(vpos);`);break;case 10:T.include(a,w),E.main.add(b`
+        if (waterColor.a < ${b.float(C)}) {
           // Discard this vertex
           gl_Position = vec4(1e38, 1e38, 1e38, 1.0);
           return;
         }
 
         vpos = position;
-        gl_Position = transformPosition(proj, view, vpos);`),w.include(t,x),w.main.add(_`discardBySlice(vpos);
-calculateOcclusionAndOutputHighlight();`);break;case 11:S.include(r,x),C.main.add(_`
-        if (waterColor.a < ${_.float(b)}) {
+        gl_Position = transformPosition(proj, view, vpos);`),D.include(n,w),D.main.add(b`discardBySlice(vpos);
+calculateOcclusionAndOutputHighlight();`);break;case 11:T.include(i,w),E.main.add(b`
+        if (waterColor.a < ${b.float(C)}) {
           // Discard this vertex
           gl_Position = vec4(1e38, 1e38, 1e38, 1.0);
           return;
@@ -73,5 +72,5 @@ calculateOcclusionAndOutputHighlight();`);break;case 11:S.include(r,x),C.main.ad
 
         vpos = position;
         gl_Position = transformPosition(proj, view, vpos);
-        forwardObjectAndLayerIdColor();`),w.include(t,x),w.main.add(_`discardBySlice(vpos);
-outputObjectAndLayerIdColor();`);break;default:throw new e(`shaderbuilder:missing-output`,`Unimplemented shader output ${E} for WaterTechnique`)}return S}const S=Object.freeze(Object.defineProperty({__proto__:null,build:x},Symbol.toStringTag,{value:`Module`}));export{S as W,x as b};
+        forwardObjectAndLayerIdColor();`),D.include(n,w),D.main.add(b`discardBySlice(vpos);
+outputObjectAndLayerIdColor();`);break;default:throw new e(`shaderbuilder:missing-output`,`Unimplemented shader output ${k} for WaterTechnique`)}return T}const T=Object.freeze(Object.defineProperty({__proto__:null,build:w},Symbol.toStringTag,{value:`Module`}));export{T as W,w as b};

package/config.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/6.0/LICENSE.txt */
-import"./core/has.js";import{deepMerge as e}from"./core/object.js";const t={apiKey:void 0,apiKeys:{scopes:[]},applicationName:``,applicationUrl:globalThis.location?.href,assetsPath:``,fontsUrl:`https://static.arcgis.com/fonts`,geometryServiceUrl:`https://utility.arcgisonline.com/arcgis/rest/services/Geometry/GeometryServer`,geoRSSServiceUrl:`https://utility.arcgis.com/sharing/rss`,kmlServiceUrl:`https://utility.arcgis.com/sharing/kml`,userPrivilegesApplied:!0,portalUrl:`https://www.arcgis.com`,respectPrefersReducedMotion:!0,routeServiceUrl:`https://route-api.arcgis.com/arcgis/rest/services/World/Route/NAServer/Route_World`,workers:{loaderConfig:{has:{},paths:{},map:{},packages:[]}},request:{crossOriginNoCorsDomains:null,httpsDomains:[`arcgis.com`,`arcgisonline.com`,`esrikr.com`,`premiumservices.blackbridge.com`,`esripremium.accuweather.com`,`gbm.digitalglobe.com`,`firstlook.digitalglobe.com`,`msi.digitalglobe.com`],interceptors:[],internalInterceptors:[],maxUrlLength:2e3,priority:`high`,proxyRules:[],proxyUrl:null,timeout:62e3,trustedServers:[],useIdentity:!0},log:{interceptors:[],level:null}};globalThis.esriConfig&&(e(t,globalThis.esriConfig,!0),delete t.has),t.assetsPath||(t.assetsPath=`https://cdn.jsdelivr.net/npm/@arcgis/core@6.0.0-next.27/assets`,t.defaultAssetsPath=t.assetsPath);export{t as default};
+import"./core/has.js";import{deepMerge as e}from"./core/object.js";const t={apiKey:void 0,apiKeys:{scopes:[]},applicationName:``,applicationUrl:globalThis.location?.href,assetsPath:``,fontsUrl:`https://static.arcgis.com/fonts`,geometryServiceUrl:`https://utility.arcgisonline.com/arcgis/rest/services/Geometry/GeometryServer`,geoRSSServiceUrl:`https://utility.arcgis.com/sharing/rss`,kmlServiceUrl:`https://utility.arcgis.com/sharing/kml`,userPrivilegesApplied:!0,portalUrl:`https://www.arcgis.com`,respectPrefersReducedMotion:!0,routeServiceUrl:`https://route-api.arcgis.com/arcgis/rest/services/World/Route/NAServer/Route_World`,workers:{loaderConfig:{has:{},paths:{},map:{},packages:[]}},request:{crossOriginNoCorsDomains:null,httpsDomains:[`arcgis.com`,`arcgisonline.com`,`esrikr.com`,`premiumservices.blackbridge.com`,`esripremium.accuweather.com`,`gbm.digitalglobe.com`,`firstlook.digitalglobe.com`,`msi.digitalglobe.com`],interceptors:[],internalInterceptors:[],maxUrlLength:2e3,priority:`high`,proxyRules:[],proxyUrl:null,timeout:62e3,trustedServers:[],useIdentity:!0},log:{interceptors:[],level:null}};globalThis.esriConfig&&(e(t,globalThis.esriConfig,!0),delete t.has),t.assetsPath||(t.assetsPath=`https://cdn.jsdelivr.net/npm/@arcgis/core@6.0.0-next.28/assets`,t.defaultAssetsPath=t.assetsPath);export{t as default};

package/form/elements/inputs/DynamicChoiceInput.d.ts

@@ -12,13 +12,13 @@ export interface DynamicChoiceInputProperties extends SingleChoiceInputPropertie
  *
  * @since 5.2
  * @see [FieldElement](https://developers.arcgis.com/javascript/latest/references/core/form/elements/FieldElement/)
- * @see [Sample - Edit features with dynamic choices ](https://developers.arcgis.com/javascript/latest/sample-code/editor-dynamic-choices/)
+ * @see [Sample - Edit features with dynamic choices](https://developers.arcgis.com/javascript/latest/sample-code/editor-dynamic-choices/)
  * @example
  * // Creates a new dynamic choice input for a field element within a form
  * const dynamicChoiceInput = new DynamicChoiceInput({
  *   choiceExpression: dynamicChoiceExpression.name, // reference to the defined expression
  *   noValueOptionLabel: "No Value (null)", // label for the option representing a null value
- *   showNoValueOption: false, // whether to display the choice representing a null value (ie. "No Value")
+ *   showNoValueOption: false, // whether to display the choice representing a null value (i.e., "No Value")
  * });
  */
 export default class DynamicChoiceInput extends SingleChoiceInput {

package/geometry/operators/containsOperator.d.ts

@@ -1,6 +1,6 @@
 /**
  * Performs a relational operation to determine if one 2D geometry contains another 2D geometry.
- * Geometry A contains geometry B, when B is the intersection of A and B.
+ * Geometry A contains geometry B when B is the intersection of A and B.
  * A contains B is equivalent to B within A. Geometry B can be non-simple geometry.
  *
  * ![Contains operator](https://developers.arcgis.com/javascript/latest/assets/references/core/operators/contains.avif "Contains operator")

package/geometry/operators/densifyOperator.d.ts

@@ -1,5 +1,5 @@
 /**
- * Densifies 2D geometries by length, deviation and/or angle in a 2D plane. The result geometry contains segments less than or equal to `maxSegementLength`, and it will not contain curves.
+ * Densifies 2D geometries by length, deviation and/or angle in a 2D plane. The result geometry contains segments less than or equal to `maxSegmentLength`, and it will not contain curves.
  * The piecewise approximation of curves will be within the specified deviation from the original curve,
  * and the angle between tangent segments does not exceed the specified value.
  *

package/geometry/operators/differenceOperator.d.ts

@@ -36,18 +36,19 @@ export function differenceExecute(geometry: GeometryUnion, subtractor: GeometryU
 export function execute(geometry: GeometryUnion, subtractor: GeometryUnion): GeometryWithoutMeshUnion | null | undefined;
 
 /**
- * Performs the Topological difference operation on the geometry set.
+ * Performs the topological difference operation on the geometry set.
  *
  * @param geometries - The set of geometry instances to be subtracted by the `subtractor`.
  * All the geometries must have the same spatial reference.
  * @param subtractor - The geometry on the right-hand side being subtracted.
- * @returns Returns an array whose elements are the result of subtracting each input geometry from `geometries`, or null. The result has the dimensions of the `geometries`.
+ * @returns Returns an array whose elements are the result of subtracting `subtractor` from each input geometry in `geometries`.
+ * Individual entries may be `null` or `undefined`. Each result has the dimensions of its corresponding input geometry.
  * @since 5.2
  */
 export function differenceExecuteMany(geometries: GeometryUnion[], subtractor: GeometryUnion): (GeometryWithoutMeshUnion | null | undefined)[];
 
 /**
- * Performs the Topological difference operation on the geometry set.
+ * Performs the topological difference operation on the geometry set.
  *
  * @deprecated
  * since 5.2. Refactor using \@arcgis/codemod or manually replace usages
@@ -55,7 +56,8 @@ export function differenceExecuteMany(geometries: GeometryUnion[], subtractor: G
  * @param geometries - An array of geometries.
  *                     All the geometries must have the same spatial reference.
  * @param subtractor - The geometry to be subtracted from each and every geometry in `geometries`.
- * @returns An array of computed geometries. The size of the array will be equivalent to the size of `geometries`.
+ * @returns Returns an array whose elements are the result of subtracting `subtractor` from each input geometry in `geometries`.
+ * Individual entries may be `null` or `undefined`. Each result has the dimensions of its corresponding input geometry.
  */
 export function executeMany(geometries: GeometryUnion[], subtractor: GeometryUnion): (GeometryWithoutMeshUnion | null | undefined)[];
 

package/geometry/operators/distanceOperator.d.ts

@@ -49,7 +49,7 @@ export function distanceExecute(geometry1: GeometryUnion, geometry2: GeometryUni
  * @param geometry1 - The first input geometry.
  * @param geometry2 - The second input geometry.
  * @param options - Additional options.
- * @returns The distance between the two geometries. Will return NaN if either input geometries are empty.
+ * @returns The distance between the two geometries. Will return NaN if either input geometry is empty.
  * @example
  * // Calculate the planar distance between two points
  * const distance = distanceExecute(point1, point2);

package/geometry/operators/geodesicProximityOperator.d.ts

@@ -109,7 +109,7 @@ export function load(): Promise<void>;
 
 /**
  * Returns the nearest coordinate on the geometry to the given input point.
- * The operator interprets all segments in the shape preserving manner, that is it treats segments as if they are densified with a small step in the input spatial reference and then the calculation is performed geodesicly.
+ * The operator interprets all segments in a shape-preserving manner, that is, it treats segments as if they are densified with a small step in the input spatial reference and then the calculation is performed geodesically.
  *
  * @param geometry - The input geometry.
  * @param point - The point used to search for the nearest coordinate in `geometry`.
@@ -128,7 +128,7 @@ export function geodesicProximityGetNearestCoordinate(geometry: GeometryUnion, p
 
 /**
  * Returns the nearest coordinate on the geometry to the given input point.
- * The operator interprets all segments in the shape preserving manner, that is it treats segments as if they are densified with a small step in the input spatial reference and then the calculation is performed geodesicly.
+ * The operator interprets all segments in a shape-preserving manner, that is, it treats segments as if they are densified with a small step in the input spatial reference and then the calculation is performed geodesically.
  *
  * @deprecated
  * since 5.2. Refactor using \@arcgis/codemod or manually replace usages
@@ -151,7 +151,7 @@ export function getNearestCoordinate(geometry: GeometryUnion, point: Point, opti
  * Returns the nearest vertex on the geometry.
  *
  * @param geometry - The input geometry.
- * @param point - The point used to search for the nearest coordinate in the input `geometry`.
+ * @param point - The point used to search for the nearest vertex in the input `geometry`.
  * @param options - Additional options.
  * @returns Returns the result of proximity operation.
  * @since 5.2
@@ -172,7 +172,7 @@ export function geodesicProximityGetNearestVertex(geometry: GeometryUnion, point
  * since 5.2. Refactor using \@arcgis/codemod or manually replace usages
  *             with [geodesicProximityGetNearestVertex()](https://developers.arcgis.com/javascript/latest/references/core/geometry/operators/geodesicProximityOperator/#geodesicProximityGetNearestVertex).
  * @param geometry - The input geometry.
- * @param point - The point used to search for the nearest coordinate in the input `geometry`.
+ * @param point - The point used to search for the nearest vertex in the input `geometry`.
  * @param options - Additional options.
  * @returns Returns the result of proximity operation.
  * @example
@@ -189,13 +189,13 @@ export function getNearestVertex(geometry: GeometryUnion, point: Point, options?
  * Returns vertices of the geometry that are closer to the given point than the given radius.
  *
  * @param geometry - The input geometry.
- * @param point - The point used to search for the nearest coordinate in `geometry`.
+ * @param point - The point used to search for the nearest vertices in `geometry`.
  * @param searchRadius - The distance to search from the `point` to the nearest vertices in the `geometry`.
  * Unless the `unit` option is set, the default is meters.
  * @param maxVertexCountToReturn - The maximum number of vertices that will be returned. Must be a positive number.
  * @param options - Additional options.
  * @returns The array of vertices that are in the given search radius to the point.
- * The array is sorted by distance to the queryPoint with the closest point first.
+ * The array is sorted by distance to the query point, with the closest vertex first.
  * When there are more than the `maxVertexCountToReturn` vertices to return, it returns the closest vertices.
  * The array will be empty when `geometry` is empty.
  * @since 5.2
@@ -216,13 +216,13 @@ export function geodesicProximityGetNearestVertices(geometry: GeometryUnion, poi
  * since 5.2. Refactor using \@arcgis/codemod or manually replace usages
  *             with [geodesicProximityGetNearestVertices()](https://developers.arcgis.com/javascript/latest/references/core/geometry/operators/geodesicProximityOperator/#geodesicProximityGetNearestVertices).
  * @param geometry - The input geometry.
- * @param point - The point used to search for the nearest coordinate in `geometry`.
+ * @param point - The point used to search for the nearest vertices in `geometry`.
  * @param searchRadius - The distance to search from the `point` to the nearest vertices in the `geometry`.
  * Unless the `unit` option is set, the default is meters.
  * @param maxVertexCountToReturn - The maximum number of vertices that will be returned. Must be a positive number.
  * @param options - Additional options.
  * @returns The array of vertices that are in the given search radius to the point.
- * The array is sorted by distance to the queryPoint with the closest point first.
+ * The array is sorted by distance to the query point, with the closest vertex first.
  * When there are more than the `maxVertexCountToReturn` vertices to return, it returns the closest vertices.
  * The array will be empty when `geometry` is empty.
  * @example

package/geometry/operators/graphicBufferOperator.d.ts

@@ -67,8 +67,8 @@ export type Options = GraphicBufferOptions;
  * * Miter joins are replaced with bevel when the ratio of the miter thickness to the buffer distance is greater than miter limit. The miter thickness is the distance from the vertex to the mitered corner of the buffer that this vertex generates.
  * @param caps - Defines the buffer's shape at the end points of the geometries.
  * * Points with square caps will be drawn as squares.
- * * Open polylines paths with square caps degenerate to a point and will be drawn as squares (degenerate with zero tolerance).
- * * Open polylines paths with round caps degenerate to a point and will be drawn as circles (degenerate with zero tolerance).
+ * * Open polyline paths with square caps degenerate to a point and will be drawn as squares (degenerate with zero tolerance).
+ * * Open polyline paths with round caps degenerate to a point and will be drawn as circles (degenerate with zero tolerance).
  * @param options - Additional options.
  * @returns Returns the buffered geometries.
  * @since 5.2
@@ -79,7 +79,7 @@ export type Options = GraphicBufferOptions;
  *   [1000, 1500],
  *   "square",
  *   "round",
- *   10,
+ *   { miterLimit: 10 },
  * );
  */
 export function graphicBufferExecuteMany(geometries: GeometryUnion[], distances: number[], joins: "round" | "miter" | "bevel", caps: "round" | "butt" | "square", options?: GraphicBufferOptions): Polygon[];
@@ -102,8 +102,8 @@ export function graphicBufferExecuteMany(geometries: GeometryUnion[], distances:
  * * Miter joins are replaced with bevel when the ratio of the miter thickness to the buffer distance is greater than miter limit. The miter thickness is the distance from the vertex to the mitered corner of the buffer that this vertex generates.
  * @param caps - Defines the buffer's shape at the end points of the geometries.
  * * Points with square caps will be drawn as squares.
- * * Open polylines paths with square caps degenerate to a point and will be drawn as squares (degenerate with zero tolerance).
- * * Open polylines paths with round caps degenerate to a point and will be drawn as circles (degenerate with zero tolerance).
+ * * Open polyline paths with square caps degenerate to a point and will be drawn as squares (degenerate with zero tolerance).
+ * * Open polyline paths with round caps degenerate to a point and will be drawn as circles (degenerate with zero tolerance).
  * @param options - Additional options.
  * @returns Returns the buffered geometries.
  * @example
@@ -113,7 +113,7 @@ export function graphicBufferExecuteMany(geometries: GeometryUnion[], distances:
  *   [1000, 1500],
  *   "square",
  *   "round",
- *   10,
+ *   { miterLimit: 10 },
  * );
  */
 export function executeMany(geometries: GeometryUnion[], distances: number[], joins: "round" | "miter" | "bevel", caps: "round" | "butt" | "square", options?: GraphicBufferOptions): Polygon[];

package/geometry/operators/integrateOperator.d.ts

@@ -14,7 +14,7 @@ import type { GeometryUnion, GeometryWithoutMeshUnion } from "../types.js";
  *
  * @param geometries - The set of geometries to integrate.
  * All the geometries must have the same spatial reference.
- * @returns Returns the result of the subtraction.
+ * @returns Returns the result of the integration.
  * The operation filters out degenerate segments and returns `null` for empty geometries.
  * @since 5.2
  * @example
@@ -31,7 +31,7 @@ export function integrateExecuteMany(geometries: GeometryUnion[]): (GeometryWith
  *             with [integrateExecuteMany()](https://developers.arcgis.com/javascript/latest/references/core/geometry/operators/integrateOperator/#integrateExecuteMany).
  * @param geometries - The set of geometries to integrate.
  * All the geometries must have the same spatial reference.
- * @returns Returns the result of the subtraction.
+ * @returns Returns the result of the integration.
  * The operation filters out degenerate segments and returns `null` for empty geometries.
  * @example
  * // Integrate a set of geometries

package/geometry/operators/intersectsOperator.d.ts

@@ -1,6 +1,6 @@
 /**
  * Performs a relational operation to determine if one 2D geometry intersects another 2D geometry.
- * Intersect is same as not disjoint.
+ * Intersects is the same as not being disjoint.
  * This operator can be used with non-simple geometries.
  *
  * ![Intersects operator](https://developers.arcgis.com/javascript/latest/assets/references/core/operators/intersects.avif "Intersects operator")
@@ -30,7 +30,7 @@ export function intersectsAccelerateGeometry(geometry: GeometryUnion): boolean;
 export function accelerateGeometry(geometry: GeometryUnion): boolean;
 
 /**
- * Perform a intersects operation on two geometries.
+ * Performs the intersects operation on two geometries.
  *
  * @param geometry1 - The geometry that is tested for the intersects relationship to `geometry2`.
  * @param geometry2 - The geometry being intersected.
@@ -43,7 +43,7 @@ export function accelerateGeometry(geometry: GeometryUnion): boolean;
 export function intersectsExecute(geometry1: GeometryUnion, geometry2: GeometryUnion): boolean;
 
 /**
- * Perform a intersects operation on two geometries.
+ * Performs the intersects operation on two geometries.
  *
  * @deprecated
  * since 5.2. Refactor using \@arcgis/codemod or manually replace usages

package/geometry/operators/linesToPolygonsOperator.d.ts

@@ -11,7 +11,7 @@ import type { GeometryUnion } from "../types.js";
  *
  * @param geometries - The set of input geometries.
  * All the geometries must have the same spatial reference.
- * @returns Returns the result of polygons.
+ * @returns Returns the resulting polygons.
  * @since 5.2
  * @example
  * // Perform the lines to polygons operation
@@ -27,7 +27,7 @@ export function linesToPolygonsExecuteMany(geometries: GeometryUnion[]): Polygon
  *             with [linesToPolygonsExecuteMany()](https://developers.arcgis.com/javascript/latest/references/core/geometry/operators/linesToPolygonsOperator/#linesToPolygonsExecuteMany).
  * @param geometries - The set of input geometries.
  * All the geometries must have the same spatial reference.
- * @returns Returns the result of polygons.
+ * @returns Returns the resulting polygons.
  * @example
  * // Perform the lines to polygons operation
  * const polygons = linesToPolygonsExecuteMany([polyline1, polyline2]);

package/geometry/operators/locateBetweenOperator.d.ts

@@ -18,7 +18,7 @@ import type { GeometryUnion, GeometryWithoutMeshUnion } from "../types.js";
  * All the geometries must have the same spatial reference.
  * @param startM - The M value to start the operation.
  * @param endM - The M value to end the operation.
- * @returns Returns the result of geometries.
+ * @returns Returns the resulting geometries.
  * For 1-dimensional geometries, the result could be either point, multipoint, or polyline.
  * For polylines, the result can be both polyline and multipoint.
  * @since 5.2
@@ -39,7 +39,7 @@ export function locateBetweenExecuteMany(geometries: GeometryUnion[], startM: nu
  * All the geometries must have the same spatial reference.
  * @param startM - The M value to start the operation.
  * @param endM - The M value to end the operation.
- * @returns Returns the result of geometries.
+ * @returns Returns the resulting geometries.
  * For 1-dimensional geometries, the result could be either point, multipoint, or polyline.
  * For polylines, the result can be both polyline and multipoint.
  * @example

package/geometry/operators/minimumBoundingCircleOperator.d.ts

@@ -1,7 +1,7 @@
 /**
  * Create a minimum bounding circle for the input geometry.
  * The output is a polygon with a single closed circular segment containing curves.
- * Implements the Welzl's algorithm using greedy heuristic with expected O(n) time complexity.
+ * Implements Welzl's algorithm using a greedy heuristic with expected O(n) time complexity.
  *
  * > [!WARNING]
  * >

package/geometry/operators/multiPartToSinglePartOperator.d.ts

@@ -34,7 +34,7 @@ export type Options = MultiPartToSinglePartOptions;
  * All the geometries must have the same spatial reference.
  * @param options - Additional options.
  * @returns Returns the single part geometries.
- * For non-simple polygons, the output of the method is not guaranteed to be correct if the `simplifyPolgons` option is set to `false`.
+ * For non-simple polygons, the output of the method is not guaranteed to be correct if the `simplifyPolygons` option is set to `false`.
  * In that case, the method may either throw an error, or produce some output which is not guaranteed to be correct.
  * @since 5.2
  * @example
@@ -55,7 +55,7 @@ export function multiPartToSinglePartExecuteMany(geometries: GeometryUnion[], op
  * All the geometries must have the same spatial reference.
  * @param options - Additional options.
  * @returns Returns the single part geometries.
- * For non-simple polygons, the output of the method is not guaranteed to be correct if the `simplifyPolgons` option is set to `false`.
+ * For non-simple polygons, the output of the method is not guaranteed to be correct if the `simplifyPolygons` option is set to `false`.
  * In that case, the method may either throw an error, or produce some output which is not guaranteed to be correct.
  * @example
  * // Convert multipart geometries to single part geometries

package/geometry/operators/polygonSlicerOperator.d.ts

@@ -45,7 +45,7 @@ export type FindSlicesByAreaOptions = PolygonSlicerFindSlicesByAreaOptions;
  *
  * @param polygon - The input polygon.
  * @param partCount - The number of parts to slice into.
- * @param remainingArea - The size of the remaining piece of the uncut polygon. Pass zero, if you want to slice the whole polygon.
+ * @param remainingArea - The size of the remaining piece of the uncut polygon. Pass zero if you want to slice the whole polygon.
  * Unless the `unit` option is set, the default is the spatial reference unit of `polygon`.
  * @param options - Additional options.
  * @returns Returns the y-coordinate set for the slice positions sorted in increasing y-order. The set can be used as input to the
@@ -65,7 +65,7 @@ export function polygonSlicerFindSlicesByArea(polygon: Polygon, partCount: numbe
  *             with [polygonSlicerFindSlicesByArea()](https://developers.arcgis.com/javascript/latest/references/core/geometry/operators/polygonSlicerOperator/#polygonSlicerFindSlicesByArea).
  * @param polygon - The input polygon.
  * @param partCount - The number of parts to slice into.
- * @param remainingArea - The size of the remaining piece of the uncut polygon. Pass zero, if you want to slice the whole polygon.
+ * @param remainingArea - The size of the remaining piece of the uncut polygon. Pass zero if you want to slice the whole polygon.
  * Unless the `unit` option is set, the default is the spatial reference unit of `polygon`.
  * @param options - Additional options.
  * @returns Returns the y-coordinate set for the slice positions sorted in increasing y-order. The set can be used as input to the

package/geometry/operators/projectOperator.d.ts

@@ -135,7 +135,7 @@ export function execute(geometry: GeometryUnion, outSpatialReference: SpatialRef
  * All the geometries must have the same spatial reference.
  * @param outSpatialReference - The spatial reference to which the input geometry is projected.
  * @param options - Additional options.
- * @returns Returns the projected geometries or null.
+ * @returns Returns an array of projected geometries, and individual entries may be `null` or `undefined`.
  * @since 5.2
  */
 export function projectExecuteMany(geometries: GeometryUnion[], outSpatialReference: SpatialReference, options?: ProjectOptions): (GeometryWithoutMeshUnion | null | undefined)[];
@@ -150,7 +150,7 @@ export function projectExecuteMany(geometries: GeometryUnion[], outSpatialRefere
  * All the geometries must have the same spatial reference.
  * @param outSpatialReference - The spatial reference to which the input geometry is projected.
  * @param options - Additional options.
- * @returns Returns the projected geometries or null.
+ * @returns Returns an array of projected geometries, and individual entries may be `null` or `undefined`.
  */
 export function executeMany(geometries: GeometryUnion[], outSpatialReference: SpatialReference, options?: ProjectOptions): (GeometryWithoutMeshUnion | null | undefined)[];
 

package/geometry/operators/proximityOperator.d.ts

@@ -60,7 +60,7 @@ export type GetNearestCoordinateOptions = ProximityGetNearestCoordinateOptions;
  * @param geometry - The input geometry.
  * @param point - The point used to search for the nearest coordinate in `geometry`.
  * @param options - Additional options.
- * @returns Returns the proximity result which contains the nearest coordinate on the input `geometry` to the given `inputPoint`.
+ * @returns Returns the proximity result which contains the nearest coordinate on the input `geometry` to the given `point`.
  * @since 5.2
  * @example
  * // Return the nearest result on a polygon to the given point
@@ -77,7 +77,7 @@ export function proximityGetNearestCoordinate(geometry: GeometryUnion, point: Po
  * @param geometry - The input geometry.
  * @param point - The point used to search for the nearest coordinate in `geometry`.
  * @param options - Additional options.
- * @returns Returns the proximity result which contains the nearest coordinate on the input `geometry` to the given `inputPoint`.
+ * @returns Returns the proximity result which contains the nearest coordinate on the input `geometry` to the given `point`.
  * @example
  * // Return the nearest result on a polygon to the given point
  * const proximityResult = proximityGetNearestCoordinate(polygon, point);
@@ -88,13 +88,13 @@ export function getNearestCoordinate(geometry: GeometryUnion, point: Point, opti
  * Returns the nearest vertex on the geometry.
  *
  * @param geometry - The input geometry.
- * @param point - The point used to search for the nearest coordinate in the input `geometry`.
+ * @param point - The point used to search for the nearest vertex in the input `geometry`.
  * @param options - Additional options.
- * @returns Returns the proximity result which contains the nearest vertex on the `geometry` to the given `inputPoint`.
+ * @returns Returns the proximity result which contains the nearest vertex on the `geometry` to the given `point`.
  * @since 5.2
  * @example
  * // Return the nearest vertex on a polygon to the given point
- * const proximityResult = proximityGetNearestCoordinate(polygon, point);
+ * const proximityResult = proximityGetNearestVertex(polygon, point);
  */
 export function proximityGetNearestVertex(geometry: GeometryUnion, point: Point, options?: ProximityOptions): ProximityResult;
 
@@ -105,9 +105,9 @@ export function proximityGetNearestVertex(geometry: GeometryUnion, point: Point,
  * since 5.2. Refactor using \@arcgis/codemod or manually replace usages
  *             with [proximityGetNearestVertex()](https://developers.arcgis.com/javascript/latest/references/core/geometry/operators/proximityOperator/#proximityGetNearestVertex).
  * @param geometry - The input geometry.
- * @param point - The point used to search for the nearest coordinate in the input `geometry`.
+ * @param point - The point used to search for the nearest vertex in the input `geometry`.
  * @param options - Additional options.
- * @returns Returns the proximity result which contains the nearest vertex on the `geometry` to the given `inputPoint`.
+ * @returns Returns the proximity result which contains the nearest vertex on the `geometry` to the given `point`.
  * @example
  * // Return the nearest vertex on a polygon to the given point
  * const proximityResult = proximityGetNearestVertex(polygon, point);
@@ -118,13 +118,13 @@ export function getNearestVertex(geometry: GeometryUnion, point: Point, options?
  * Returns vertices of the geometry that are closer to the given point than the given radius.
  *
  * @param geometry - The input geometry.
- * @param point - The point used to search for the nearest coordinate in `geometry`.
- * @param searchRadius - The planar distance from the `inputPoint` to search for vertices.
+ * @param point - The point used to search for the nearest vertices in `geometry`.
+ * @param searchRadius - The planar distance from the `point` to search for vertices.
  * Unless the `unit` option is set, the default is the geometry's spatial reference unit.
  * @param maxVertexCountToReturn - The maximum number of vertices that will be returned. Must be a positive number.
  * @param options - Additional options.
- * @returns Returns an array of proximity results which contain the nearest vertices on `geometry` to the given `inputPoint` that are less than or equal to the planar distance of search radius.
- * The array is sorted by distance to the `inputPoint` with the closest point first.
+ * @returns Returns an array of proximity results which contain the nearest vertices on `geometry` to the given `point` that are less than or equal to the planar distance of search radius.
+ * The array is sorted by distance to the query point, with the closest vertex first.
  * When there are more than the `maxVertexCountToReturn` vertices to return, it returns the closest vertices.
  * The array will be empty when `geometry` is empty.
  * @since 5.2
@@ -141,13 +141,13 @@ export function proximityGetNearestVertices(geometry: GeometryUnion, point: Poin
  * since 5.2. Refactor using \@arcgis/codemod or manually replace usages
  *             with [proximityGetNearestVertices()](https://developers.arcgis.com/javascript/latest/references/core/geometry/operators/proximityOperator/#proximityGetNearestVertices).
  * @param geometry - The input geometry.
- * @param point - The point used to search for the nearest coordinate in `geometry`.
- * @param searchRadius - The planar distance from the `inputPoint` to search for vertices.
+ * @param point - The point used to search for the nearest vertices in `geometry`.
+ * @param searchRadius - The planar distance from the `point` to search for vertices.
  * Unless the `unit` option is set, the default is the geometry's spatial reference unit.
  * @param maxVertexCountToReturn - The maximum number of vertices that will be returned. Must be a positive number.
  * @param options - Additional options.
- * @returns Returns an array of proximity results which contain the nearest vertices on `geometry` to the given `inputPoint` that are less than or equal to the planar distance of search radius.
- * The array is sorted by distance to the `inputPoint` with the closest point first.
+ * @returns Returns an array of proximity results which contain the nearest vertices on `geometry` to the given `point` that are less than or equal to the planar distance of search radius.
+ * The array is sorted by distance to the query point, with the closest vertex first.
  * When there are more than the `maxVertexCountToReturn` vertices to return, it returns the closest vertices.
  * The array will be empty when `geometry` is empty.
  * @example

package/geometry/operators/shapePreservingProjectOperator.d.ts

@@ -161,7 +161,7 @@ export function execute(geometry: GeometryUnion, outSpatialReference: SpatialRef
  * All the geometries must have the same spatial reference.
  * @param outSpatialReference - The spatial reference to which the input geometries are projected.
  * @param options - Additional options.
- * @returns Returns the projected geometries or null.
+ * @returns Returns an array of projected geometries, and individual entries may be `null` or `undefined`.
  * @since 5.2
  */
 export function shapePreservingProjectExecuteMany(geometries: GeometryUnion[], outSpatialReference: SpatialReference, options?: ShapePreservingProjectOptions): (GeometryWithoutMeshUnion | null | undefined)[];
@@ -176,7 +176,7 @@ export function shapePreservingProjectExecuteMany(geometries: GeometryUnion[], o
  * All the geometries must have the same spatial reference.
  * @param outSpatialReference - The spatial reference to which the input geometries are projected.
  * @param options - Additional options.
- * @returns Returns the projected geometries or null.
+ * @returns Returns an array of projected geometries, and individual entries may be `null` or `undefined`.
  */
 export function executeMany(geometries: GeometryUnion[], outSpatialReference: SpatialReference, options?: ShapePreservingProjectOptions): (GeometryWithoutMeshUnion | null | undefined)[];
 

package/geometry/operators/simplifyOperator.d.ts

@@ -41,7 +41,7 @@ export function execute(geometry: GeometryUnion): GeometryWithoutMeshUnion | nul
 /**
  * Performs the simplify operation on the geometry set.
  *
- * @param geometries - The array of geometries to be simplified,
+ * @param geometries - The array of geometries to be simplified.
  * All the geometries must have the same spatial reference.
  * @returns Returns an array whose elements may either be simplified geometries or null.
  * @since 5.2
@@ -54,7 +54,7 @@ export function simplifyExecuteMany(geometries: GeometryUnion[]): (GeometryWitho
  * @deprecated
  * since 5.2. Refactor using \@arcgis/codemod or manually replace usages
  *             with [simplifyExecuteMany()](https://developers.arcgis.com/javascript/latest/references/core/geometry/operators/simplifyOperator/#simplifyExecuteMany).
- * @param geometries - The array of geometries to be simplified,
+ * @param geometries - The array of geometries to be simplified.
  * All the geometries must have the same spatial reference.
  * @returns Returns an array whose elements may either be simplified geometries or null.
  */