@arcgis/core 5.2.0-next.168 → 5.2.0-next.169

package/config.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/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@5.2.0-next.168/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@5.2.0-next.169/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.
  */

package/geometry/operators/support/GeographicTransformationStep.d.ts

@@ -7,7 +7,7 @@ export interface GeographicTransformationStepProperties extends Partial<Pick<Geo
 /**
  * Represents a step in the process of transforming coordinates from one geographic coordinate system to another.
  * A geographic transformation step can be constructed from a
- * well-known ID [(wkid)](https://developers.arcgis.com/javascript/latest/references/core/geometry/operators/support/GeographicTransformationStep/#wkid) or a well known text [(wkt)](https://developers.arcgis.com/javascript/latest/references/core/geometry/operators/support/GeographicTransformationStep/#wkt) that represents a geographic datum transformation.
+ * well-known ID [(wkid)](https://developers.arcgis.com/javascript/latest/references/core/geometry/operators/support/GeographicTransformationStep/#wkid) or well-known text [(wkt)](https://developers.arcgis.com/javascript/latest/references/core/geometry/operators/support/GeographicTransformationStep/#wkt) that represents a geographic datum transformation.
  *
  * @since 5.2
  * @since 4.32
@@ -34,7 +34,7 @@ export default class GeographicTransformationStep extends GeographicTransformati
    */
   accessor isUsable: boolean | null | undefined;
   /**
-   * The well-known id (wkid) hat represents a known geographic transformation.
+   * The well-known ID (WKID) that represents a known geographic transformation.
    * See [Geographic datum transformations](https://pro.arcgis.com/en/pro-app/latest/help/mapping/properties/geographic-coordinate-system-transformation.htm)
    * for the list of supported equation-based geographic transformations.
    *
@@ -50,7 +50,7 @@ export default class GeographicTransformationStep extends GeographicTransformati
    *
    * @example
    * // Create a geographic transformation step for NAD_1927_To_WGS_1984_1
-   * // using its well known text or wkt
+   * // using its well-known text (WKT)
    * let wkt = "GEOGTRAN[\"NAD_1927_To_WGS_1984_1\",GEOGCS[\"GCS_North_American_1927\",DATUM[\"D_North_American_1927\",SPHEROID[\"Clarke_1866\",6378206.4,294.9786982]],PRIMEM[\"Greenwich\",0.0],UNIT[\"Degree\",0.0174532925199433]],GEOGCS[\"GCS_WGS_1984\",DATUM[\"D_WGS_1984\",SPHEROID[\"WGS_1984\",6378137.0,298.257223563]],PRIMEM[\"Greenwich\",0.0],UNIT[\"Degree\",0.0174532925199433]],METHOD[\"Geocentric_Translation\"],PARAMETER[\"X_Axis_Translation\",-3.0],PARAMETER[\"Y_Axis_Translation\",142.0],PARAMETER[\"Z_Axis_Translation\",183.0]]";
    *
    * let geoStep = new GeographicTransformationStep({ wkt });

package/geometry/operators/support/Transformation.d.ts

@@ -37,13 +37,13 @@ export default class Transformation {
    * @param x1 - The x-coordinate of the second geometry.
    * @example
    * // Flip the x-coordinates of a geometry on the vertical axis
-   * const transform = new Transformation();
-   * transform.flipX(0, 10);
+   * const transformation = new Transformation();
+   * transformation.flipX(0, 10);
    * const result = affineTransformExecute(polygon, transform);
    *
    * // Flip the x-coordinates of a geometry on the vertical axis centered at the geometry's center
    * const centerX = polygon.extent.center.x;
-   * transform.flipX(centerX, centerX);
+   * transformation.flipX(centerX, centerX);
    * const result = affineTransformExecute(polygon, transform);
    */
   flipX(x0: number, x1: number): this;
@@ -62,7 +62,7 @@ export default class Transformation {
    *
    * // Flip the y-coordinates of a geometry on the horizontal axis centered at the geometry's center
    * const centerY = polygon.extent.center.y;
-   * transform.flipY(centerY, centerY);
+   * transformation.flipY(centerY, centerY);
    * const result = affineTransformExecute(polygon, transform);
    */
   flipY(y0: number, y1: number): this;
@@ -107,7 +107,7 @@ export default class Transformation {
    * @example
    * // Rotate a geometry
    * transformation.rotate(90, 0, 0);
-   * const result = affineTransformExecute(polygon, transform);
+   * const result = affineTransformExecute(polygon, transformation);
    */
   rotate(angleInDegrees: number, rotationX?: number, rotationY?: number): this;
   /**
@@ -121,7 +121,7 @@ export default class Transformation {
    * @example
    * // Scale a geometry
    * transformation.scale(2, 2);
-   * const result = affineTransformExecute(polygon, transform);
+   * const result = affineTransformExecute(polygon, transformation);
    */
   scale(x: number, y: number): this;
   /**
@@ -149,7 +149,7 @@ export default class Transformation {
    * @example
    * // Shear a geometry
    * transformation.shear(0.5, 0.5);
-   * const result = affineTransformExecute(polygon, transform);
+   * const result = affineTransformExecute(polygon, transformation);
    */
   shear(proportionX: number, proportionY: number): this;
   /**
@@ -162,7 +162,7 @@ export default class Transformation {
    * @example
    * // Shift the coordinates of a geometry
    * transformation.shift(5, 2);
-   * const result = affineTransformExecute(polygon, transform);
+   * const result = affineTransformExecute(polygon, transformation);
    */
   shift(x: number, y: number): this;
 }

package/geometry/operators/support/geographicTransformationUtils.d.ts

@@ -79,7 +79,7 @@ export function load(): Promise<void>;
  *   await geographicTransformationUtils.load();
  * }
  *
- * const geogtrans = projection.getTransformation(cs1, cs2, extent);
+ * const geogtrans = geographicTransformationUtils.getTransformation(cs1, cs2, extent);
  */
 export function getTransformation(inSpatialReference: SpatialReference, outSpatialReference: SpatialReference, areaOfInterestExtent?: Extent | null, returnUnusable?: boolean): GeographicTransformation | null | undefined;
 
@@ -96,7 +96,7 @@ export function getTransformation(inSpatialReference: SpatialReference, outSpati
  * >
  * > Grid-based datum transformations are not supported in the SDK.
  * > Geographic transformations are returned with their maximum number of [GeographicTransformation.steps](https://developers.arcgis.com/javascript/latest/references/core/geometry/operators/support/GeographicTransformation/#steps).
- * > Currently, number of steps is limited to 2.
+ * > Currently, the number of steps is limited to 2.
  *
  * @param inSpatialReference - The spatial reference that the geometries are currently using.
  * @param outSpatialReference - The spatial reference to which you are converting the geometries to.
@@ -128,7 +128,7 @@ export function getTransformation(inSpatialReference: SpatialReference, outSpati
  *   await geographicTransformationUtils.load();
  * }
  *
- * const geogtrans = projection.getTransformations(cs1, cs2, extent);
+ * const geogtrans = geographicTransformationUtils.getTransformations(cs1, cs2, extent);
  * geogtrans.forEach((geogtran, index) => {
  *   geogtran.steps.forEach((step, index) => {
  *     console.log("step wkid: ", step.wkid);

package/geometry/operators/symmetricDifferenceOperator.d.ts

@@ -17,7 +17,7 @@ import type { GeometryUnion, GeometryWithoutMeshUnion } from "../types.js";
  *
  * @param leftGeometry - The first geometry to be XOR'd.
  * @param rightGeometry - The second geometry to be XOR'd.
- * @returns Returns the symmetric difference of the two geometries. The result has the higher of dimensions of the two geometries.
+ * @returns Returns the symmetric difference of the two geometries. The result has the higher dimension of the two geometries.
  * @since 5.2
  * @example
  * // Calculate the symmetric difference of two polygons.
@@ -33,7 +33,7 @@ export function symmetricDifferenceExecute(leftGeometry: GeometryUnion, rightGeo
  *             with [symmetricDifferenceExecute()](https://developers.arcgis.com/javascript/latest/references/core/geometry/operators/symmetricDifferenceOperator/#symmetricDifferenceExecute).
  * @param leftGeometry - The first geometry to be XOR'd.
  * @param rightGeometry - The second geometry to be XOR'd.
- * @returns Returns the symmetric difference of the two geometries. The result has the higher of dimensions of the two geometries.
+ * @returns Returns the symmetric difference of the two geometries. The result has the higher dimension of the two geometries.
  * @example
  * // Calculate the symmetric difference of two polygons.
  * const differencePolygon = symmetricDifferenceExecute(polygon1, polygon2);