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

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);

package/geometry/operators/withinOperator.d.ts

@@ -1,5 +1,5 @@
 /**
- * Perform a relational operation to determine if one 2D geometry is within another 2D geometry. Geometry A is within geometry B, when A is the intersection of A and B.
+ * Perform a relational operation to determine if one 2D geometry is within another 2D geometry. Geometry A is within geometry B when A is the intersection of A and B.
  *
  * Geometry A can be non-simple geometry.
  *
@@ -37,7 +37,7 @@ export function accelerateGeometry(geometry: GeometryUnion): boolean;
  * @returns Returns `true` if `inner` is within `outer`.
  * @since 5.2
  * @example
- * Returns true if a geometry is completely within another
+ * // Returns true if a geometry is completely within another
  * const isWithin = withinExecute(polygon1, polygon2);
  */
 export function withinExecute(inner: GeometryUnion, outer: GeometryUnion): boolean;
@@ -52,7 +52,7 @@ export function withinExecute(inner: GeometryUnion, outer: GeometryUnion): boole
  * @param outer - The comparison geometry that is tested for the "contains" relationship with `inner`.
  * @returns Returns `true` if `inner` is within `outer`.
  * @example
- * Returns true if a geometry is completely within another
+ * // Returns true if a geometry is completely within another
  * const isWithin = withinExecute(polygon1, polygon2);
  */
 export function execute(inner: GeometryUnion, outer: GeometryUnion): boolean;

package/graphic/MapNotesGraphicOrigin.d.ts

@@ -15,6 +15,7 @@ import type MapNotesLayer from "../layers/MapNotesLayer.js";
  * If you only need the title of the child GraphicsLayer, use [getGraphicOriginTitle](https://developers.arcgis.com/javascript/latest/references/core/graphic/getGraphicOriginTitle/).
  * To get the popup template applicable to the graphic, call [Graphic.getEffectivePopupTemplate()](https://developers.arcgis.com/javascript/latest/references/core/Graphic/#getEffectivePopupTemplate) on the graphic.
  *
+ * @deprecated since 5.2, use [SketchGraphicOrigin](https://developers.arcgis.com/javascript/latest/references/core/graphic/SketchGraphicOrigin/) instead.
  * @since 5.0
  * @see [MapView.hitTest()](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#hitTest)
  * @see [Map component hitTest()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#hitTest)

package/kernel.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import"./core/has.js";import{addQueryParameter as e}from"./core/urlUtils.js";Symbol.dispose??=Symbol(`Symbol.dispose`),Symbol.asyncDispose??=Symbol(`Symbol.asyncDispose`);const t=`5.2`;let n=`5.2`;n=`5.2.0-next.167`;let r;function i(e){r=e}function a(t){let n=r?.findCredential(t);return n?.token?e(t,`token`,n.token):t}globalThis.$arcgis||Object.defineProperty(globalThis,"$arcgis",{configurable:!1,enumerable:!0,writable:!1,value:{}});export{a as addTokenParameter,n as fullVersion,r as id,i as setId,t as version};
+import"./core/has.js";import{addQueryParameter as e}from"./core/urlUtils.js";Symbol.dispose??=Symbol(`Symbol.dispose`),Symbol.asyncDispose??=Symbol(`Symbol.asyncDispose`);const t=`5.2`;let n=`5.2`;n=`5.2.0-next.169`;let r;function i(e){r=e}function a(t){let n=r?.findCredential(t);return n?.token?e(t,`token`,n.token):t}globalThis.$arcgis||Object.defineProperty(globalThis,"$arcgis",{configurable:!1,enumerable:!0,writable:!1,value:{}});export{a as addTokenParameter,n as fullVersion,r as id,i as setId,t as version};

package/layers/ElevationLayer.d.ts

@@ -33,12 +33,16 @@ export interface FetchTileOptions extends AbortOptions {
 
 /**
  * ElevationLayer is a tile layer used for rendering elevations in [SceneViews](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/).
- * A default [world elevation layer](https://www.arcgis.com/home/item.html?id=7029fb60158543ad845c7e1527af11e4)
+ * The default [Terrain 3D](https://www.arcgis.com/home/item.html?id=7029fb60158543ad845c7e1527af11e4)
  * can be added to the map by setting the [map's ground](https://developers.arcgis.com/javascript/latest/references/core/Map/#ground) property to `world-elevation`.
  *
  *
  * ![elev-default](https://developers.arcgis.com/javascript/latest/assets/references/core/ground/elev-default.avif)
  *
+ * Custom elevation layers can supplement the default Terrain 3D elevation layer with higher-resolution
+ * elevation data or representing another scenario or point in time for an area of interest.
+ * Elevation sources must be published as cached image services.
+ *
  * Elevation layers are set in the [Ground.layers](https://developers.arcgis.com/javascript/latest/references/core/Ground/#layers) property of a
  * [map's ground](https://developers.arcgis.com/javascript/latest/references/core/Map/#ground). They should not be added to the
  * map's [operational layers](https://developers.arcgis.com/javascript/latest/references/core/Map/#layers).
@@ -46,7 +50,7 @@ export interface FetchTileOptions extends AbortOptions {
  * ```js
  * let elevLyr = new ElevationLayer({
  *   // Custom elevation service
- *   url: "https://sampleserver6.arcgisonline.com/arcgis/rest/services/Elevation/MtBaldy_Elevation/ImageServer"
+ *   url: "https://tiles.arcgis.com/tiles/V6ZHFr6zdgNZuVG0/arcgis/rest/services/ELEV__3857__US_Oso__LandslideAfter/ImageServer"
  * });
  * // Add elevation layer to the map's ground.
  * map.ground.layers.add(elevLyr);

package/layers/GeospatialPDFLayer.d.ts

@@ -28,7 +28,7 @@ export interface GeospatialPDFLayerProperties extends LayerProperties, ScaleRang
  * The entire document is downloaded before rendering; large or complex PDFs can increase load time and memory usage.
  * The layer derives its [spatial reference](https://developers.arcgis.com/javascript/latest/references/core/layers/GeospatialPDFLayer/#spatialReference) and
  * [extent](https://developers.arcgis.com/javascript/latest/references/core/layers/GeospatialPDFLayer/#fullExtent) from the embedded georeferencing information.
- * The rendered imagery can be reprojected to the spatial reference of the view. In an scene, it is draped on the ground.
+ * The rendered imagery can be reprojected to the spatial reference of the view. In a scene, it is draped on the ground.
  *
  * Additionally the PDF defines the boundary of the georeferenced map within the page, called a *neatline*.
  * Set [clippedToNeatline](https://developers.arcgis.com/javascript/latest/references/core/layers/GeospatialPDFLayer/#clippedToNeatline) to `true` to hide content outside this boundary, such as page margins, legends, and titles.
@@ -44,7 +44,7 @@ export interface GeospatialPDFLayerProperties extends LayerProperties, ScaleRang
  * >
  * > - Documents that require a password to open are not supported.
  * > - Tile reprojection is limited: grid-based transformations are not supported. As a result, the layer may still display but appear shifted. See the [project operator's known limitations](https://developers.arcgis.com/javascript/latest/references/core/geometry/operators/projectOperator/).
- * > - To decode certain image types from PDF files, GeospatialPDFLayer is using WebAssembly features not available yet in Safari. As a result it uses a slower JavaScript fallback which impact the initial load of the layer.
+ * > - To decode certain image types from PDF files, GeospatialPDFLayer uses WebAssembly features not yet available in Safari. As a result, it uses a slower JavaScript fallback, which impacts the initial load of the layer.
  * > - Not supported by the [Legend](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-legend/).
  *
  * @beta

package/layers/ParquetLayer.d.ts

@@ -365,7 +365,7 @@ export default class ParquetLayer extends ParquetLayerSuperclass {
   /** Describes the layer's supported capabilities. */
   get capabilities(): FeatureLayerCapabilities | null | undefined;
   /**
-   * Array of Chart Items of type WebMapWebChart available on the parquet layer.
+   * Array of chart items of type WebMapWebChart available on the Parquet layer.
    *
    * @since 5.2
    */

package/layers/VectorTileLayer.d.ts

@@ -155,7 +155,8 @@ export interface VectorTileLayerEvents extends RefreshableLayerEvents, LayerEven
  * and can be restyled for multiple uses. VectorTileLayer delivers styled maps while taking advantage of cached raster map tiles
  * with vector map data.
  *
- * How the VectorTileLayer displays is defined by the [MapLibre style specification](https://maplibre.org/maplibre-style-spec/).
+ * The layer's style defines how vector tile features are drawn. See [Vector tile style support](https://developers.arcgis.com/javascript/latest/vector-tile-style-support/) for
+ * supported style layer types, layout and paint properties, expression operators, and limitations.
  * VectorTileLayer [style](https://developers.arcgis.com/javascript/latest/references/core/layers/VectorTileLayer/#currentStyleInfo) information is stored separately from its tiles. This means that one set of vector tiles may be styled in numerous
  * ways without having to generate a new image cache for each style. This helps save space and speeds up the process of creating new map styles.
  *
@@ -360,6 +361,7 @@ export interface VectorTileLayerEvents extends RefreshableLayerEvents, LayerEven
  * > [fill](https://maplibre.org/maplibre-style-spec/layers/#paint-fill-fill-pattern) style layers in the VectorTileLayer style should be a power of two to ensure the best results.
  *
  * @since 4.0
+ * @see [Vector tile style support](https://developers.arcgis.com/javascript/latest/vector-tile-style-support/)
  * @see [TileLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/TileLayer/)
  * @see [WebTileLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/WebTileLayer/)
  * @see [Sample - Vector tiles](https://developers.arcgis.com/javascript/latest/sample-code/layers-vectortilelayer/)
@@ -668,6 +670,7 @@ export default class VectorTileLayer extends VectorTileLayerSuperclass {
    * in the VectorTileLayer's [currentStyleInfo.style](https://developers.arcgis.com/javascript/latest/references/core/layers/VectorTileLayer/#currentStyleInfo).
    * @returns [Layout](https://maplibre.org/maplibre-style-spec/layers/#layout-property) JSON object for the specified style layer.
    * @since 4.10
+   * @see [Vector tile style support](https://developers.arcgis.com/javascript/latest/vector-tile-style-support/)
    */
   getLayoutProperties(layerId: string): any;
   /**
@@ -678,6 +681,7 @@ export default class VectorTileLayer extends VectorTileLayerSuperclass {
    * in the VectorTileLayer's [currentStyleInfo.style](https://developers.arcgis.com/javascript/latest/references/core/layers/VectorTileLayer/#currentStyleInfo).
    * @returns [Paint](https://maplibre.org/maplibre-style-spec/layers/#paint) JSON object of the style layer.
    * @since 4.10
+   * @see [Vector tile style support](https://developers.arcgis.com/javascript/latest/vector-tile-style-support/)
    */
   getPaintProperties(layerId: string): any;
   /**
@@ -688,6 +692,7 @@ export default class VectorTileLayer extends VectorTileLayerSuperclass {
    * specified in the VectorTileLayer's [currentStyleInfo.style](https://developers.arcgis.com/javascript/latest/references/core/layers/VectorTileLayer/#currentStyleInfo).
    * @returns The json object representing the [style Layer](https://maplibre.org/maplibre-style-spec/layers).
    * @since 4.18
+   * @see [Vector tile style support](https://developers.arcgis.com/javascript/latest/vector-tile-style-support/)
    * @see [Sample - VectorTileLayer - update style layers](https://developers.arcgis.com/javascript/latest/sample-code/layers-vectortilelayer-style/)
    */
   getStyleLayer(layerId: string): any;
@@ -720,6 +725,7 @@ export default class VectorTileLayer extends VectorTileLayerSuperclass {
    * as specified in the VectorTileLayer's [currentStyleInfo.style](https://developers.arcgis.com/javascript/latest/references/core/layers/VectorTileLayer/#currentStyleInfo).
    * @returns Visibility of style layer. Returns either `"none"` or `"visible"`.
    * @since 4.18
+   * @see [Vector tile style support](https://developers.arcgis.com/javascript/latest/vector-tile-style-support/)
    * @see [Sample - VectorTileLayer - update style layers](https://developers.arcgis.com/javascript/latest/sample-code/layers-vectortilelayer-style/)
    * @example
    * // Get the visibility of the grassland style layer in the style.
@@ -758,6 +764,7 @@ export default class VectorTileLayer extends VectorTileLayerSuperclass {
    * in the VectorTileLayer's [currentStyleInfo.style](https://developers.arcgis.com/javascript/latest/references/core/layers/VectorTileLayer/#currentStyleInfo).
    * @param layout - An instance of layout properties to assign to the style layer.
    * @since 4.10
+   * @see [Vector tile style support](https://developers.arcgis.com/javascript/latest/vector-tile-style-support/)
    * @example
    * // get the layout properties for the "Admin0 point/large" layer
    * const layoutProperties = vtLayer.getLayoutProperties("Admin0 point/large");
@@ -781,6 +788,7 @@ export default class VectorTileLayer extends VectorTileLayerSuperclass {
    * in the VectorTileLayer's [currentStyleInfo.style](https://developers.arcgis.com/javascript/latest/references/core/layers/VectorTileLayer/#currentStyleInfo).
    * @param painter - An instance of paint properties to assign to the specified style layer.
    * @since 4.10
+   * @see [Vector tile style support](https://developers.arcgis.com/javascript/latest/vector-tile-style-support/)
    * @example
    * // get the paint properties for the "marine area/1" layer
    * const paintProperties = vtLayer.getPaintProperties("Marine area/1");
@@ -887,6 +895,7 @@ export default class VectorTileLayer extends VectorTileLayerSuperclass {
    * [getStyleLayer()](https://developers.arcgis.com/javascript/latest/references/core/layers/VectorTileLayer/#getStyleLayer) method.
    * @param index - Index of the style layer in the style. Set this parameter when adding a new style layer or re-ordering a style layer.
    * @since 4.18
+   * @see [Vector tile style support](https://developers.arcgis.com/javascript/latest/vector-tile-style-support/)
    * @see [Sample - VectorTileLayer - update style layers](https://developers.arcgis.com/javascript/latest/sample-code/layers-vectortilelayer-style/)
    * @example
    * // change style layer paint and layout properties at once