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

package/form/elements/inputs.d.ts

@@ -41,6 +41,7 @@
  * }
  * ```
  *
+ * @deprecated since 5.2. Import individual input modules directly instead.
  * @since 4.16
  * @see [FormTemplate](https://developers.arcgis.com/javascript/latest/references/core/form/FormTemplate/)
  * @see [FieldElement](https://developers.arcgis.com/javascript/latest/references/core/form/elements/FieldElement/)
@@ -70,77 +71,177 @@ import type TextAreaInputClass from "./inputs/TextAreaInput.js";
 import type TextBoxInputClass from "./inputs/TextBoxInput.js";
 import type TimePickerInputClass from "./inputs/TimePickerInput.js";
 
-/** Form element input types. */
+/**
+ * Form element input types.
+ *
+ * @deprecated since 5.2. Import [Input](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/Input/) directly instead.
+ */
 export type Input = BarcodeScannerInputClass | ComboBoxInputClass | DatePickerInputClass | DateTimeOffsetPickerInputClass | DateTimePickerInputClass | DynamicChoiceInputClass | MultipleChoiceInputClass | RadioButtonsInputClass | SwitchInputClass | TextAreaInputClass | TextBoxInputClass | TimePickerInputClass;
 
-/** The `BarcodeScannerInput` class defines the desired user interface for a barcode or QR code scanner. If this type is used in an ArcGIS Maps SDK for JavaScript web application, it will default to the [TextBoxInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/TextBoxInput/) type as the API does not support bar code scanning as an input type. */
+/**
+ * The `BarcodeScannerInput` class defines the desired user interface for a barcode or QR code scanner. If this type is used in an ArcGIS Maps SDK for JavaScript web application, it will default to the [TextBoxInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/TextBoxInput/) type as the API does not support bar code scanning as an input type.
+ *
+ * @deprecated since 5.2. Import [BarcodeScannerInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/BarcodeScannerInput/) directly instead.
+ */
 export const BarcodeScannerInput: typeof BarcodeScannerInputClass;
 
-/** The `BarcodeScannerInput` class defines the desired user interface for a barcode or QR code scanner. If this type is used in an ArcGIS Maps SDK for JavaScript web application, it will default to the [TextBoxInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/TextBoxInput/) type as the API does not support bar code scanning as an input type. */
+/**
+ * The `BarcodeScannerInput` class defines the desired user interface for a barcode or QR code scanner. If this type is used in an ArcGIS Maps SDK for JavaScript web application, it will default to the [TextBoxInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/TextBoxInput/) type as the API does not support bar code scanning as an input type.
+ *
+ * @deprecated since 5.2. Import [BarcodeScannerInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/BarcodeScannerInput/) directly instead.
+ */
 export type BarcodeScannerInput = BarcodeScannerInputClass;
 
-/** The `ComboBoxInput` class defines the desired user interface for a combo box group. */
+/**
+ * The `ComboBoxInput` class defines the desired user interface for a combo box group.
+ *
+ * @deprecated since 5.2. Import [ComboBoxInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/ComboBoxInput/) directly instead.
+ */
 export const ComboBoxInput: typeof ComboBoxInputClass;
 
-/** The `ComboBoxInput` class defines the desired user interface for a combo box group. */
+/**
+ * The `ComboBoxInput` class defines the desired user interface for a combo box group.
+ *
+ * @deprecated since 5.2. Import [ComboBoxInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/ComboBoxInput/) directly instead.
+ */
 export type ComboBoxInput = ComboBoxInputClass;
 
-/** The `DatePickerInput` class defines the desired user interface for working with date-only types. */
+/**
+ * The `DatePickerInput` class defines the desired user interface for working with date-only types.
+ *
+ * @deprecated since 5.2. Import [DatePickerInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/DatePickerInput/) directly instead.
+ */
 export const DatePickerInput: typeof DatePickerInputClass;
 
-/** The `DatePickerInput` class defines the desired user interface for working with date-only types. */
+/**
+ * The `DatePickerInput` class defines the desired user interface for working with date-only types.
+ *
+ * @deprecated since 5.2. Import [DatePickerInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/DatePickerInput/) directly instead.
+ */
 export type DatePickerInput = DatePickerInputClass;
 
-/** The `DateTimeOffsetPickerInput` class defines the desired user interface for editing date and time fields in a form that also requires the option to include an offset from Coordinated Universal Time (UTC). */
+/**
+ * The `DateTimeOffsetPickerInput` class defines the desired user interface for editing date and time fields in a form that also requires the option to include an offset from Coordinated Universal Time (UTC).
+ *
+ * @deprecated since 5.2. Import [DateTimeOffsetPickerInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/DateTimeOffsetPickerInput/) directly instead.
+ */
 export const DateTimeOffsetPickerInput: typeof DateTimeOffsetPickerInputClass;
 
-/** The `DateTimeOffsetPickerInput` class defines the desired user interface for editing date and time fields in a form that also requires the option to include an offset from Coordinated Universal Time (UTC). */
+/**
+ * The `DateTimeOffsetPickerInput` class defines the desired user interface for editing date and time fields in a form that also requires the option to include an offset from Coordinated Universal Time (UTC).
+ *
+ * @deprecated since 5.2. Import [DateTimeOffsetPickerInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/DateTimeOffsetPickerInput/) directly instead.
+ */
 export type DateTimeOffsetPickerInput = DateTimeOffsetPickerInputClass;
 
-/** The `DateTimePickerInput` class defines the desired user interface for editing date (including time) fields in a form. */
+/**
+ * The `DateTimePickerInput` class defines the desired user interface for editing date (including time) fields in a form.
+ *
+ * @deprecated since 5.2. Import [DateTimePickerInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/DateTimePickerInput/) directly instead.
+ */
 export const DateTimePickerInput: typeof DateTimePickerInputClass;
 
-/** The `DateTimePickerInput` class defines the desired user interface for editing date (including time) fields in a form. */
+/**
+ * The `DateTimePickerInput` class defines the desired user interface for editing date (including time) fields in a form.
+ *
+ * @deprecated since 5.2. Import [DateTimePickerInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/DateTimePickerInput/) directly instead.
+ */
 export type DateTimePickerInput = DateTimePickerInputClass;
 
-/** The `DynamicChoiceInput` class defines the desired user interface for a dynamically generated choice group. */
+/**
+ * The `DynamicChoiceInput` class defines the desired user interface for a dynamically generated choice group.
+ *
+ * @deprecated since 5.2. Import [DynamicChoiceInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/DynamicChoiceInput/) directly instead.
+ */
 export const DynamicChoiceInput: typeof DynamicChoiceInputClass;
 
-/** The `DynamicChoiceInput` class defines the desired user interface for a dynamically generated choice group. */
+/**
+ * The `DynamicChoiceInput` class defines the desired user interface for a dynamically generated choice group.
+ *
+ * @deprecated since 5.2. Import [DynamicChoiceInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/DynamicChoiceInput/) directly instead.
+ */
 export type DynamicChoiceInput = DynamicChoiceInputClass;
 
-/** The `MultipleChoiceInput` class defines the desired user interface for a multiple choice group. */
+/**
+ * The `MultipleChoiceInput` class defines the desired user interface for a multiple choice group.
+ *
+ * @deprecated since 5.2. Import [MultipleChoiceInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/MultipleChoiceInput/) directly instead.
+ */
 export const MultipleChoiceInput: typeof MultipleChoiceInputClass;
 
-/** The `MultipleChoiceInput` class defines the desired user interface for a multiple choice group. */
+/**
+ * The `MultipleChoiceInput` class defines the desired user interface for a multiple choice group.
+ *
+ * @deprecated since 5.2. Import [MultipleChoiceInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/MultipleChoiceInput/) directly instead.
+ */
 export type MultipleChoiceInput = MultipleChoiceInputClass;
 
-/** The `RadioButtonsInput` class defines the desired user interface for a radio button group. */
+/**
+ * The `RadioButtonsInput` class defines the desired user interface for a radio button group.
+ *
+ * @deprecated since 5.2. Import [RadioButtonsInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/RadioButtonsInput/) directly instead.
+ */
 export const RadioButtonsInput: typeof RadioButtonsInputClass;
 
-/** The `RadioButtonsInput` class defines the desired user interface for a radio button group. */
+/**
+ * The `RadioButtonsInput` class defines the desired user interface for a radio button group.
+ *
+ * @deprecated since 5.2. Import [RadioButtonsInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/RadioButtonsInput/) directly instead.
+ */
 export type RadioButtonsInput = RadioButtonsInputClass;
 
-/** The `SwitchInput` class defines the desired user interface for a binary switch or toggle. This should be used when selecting between two options in a form. */
+/**
+ * The `SwitchInput` class defines the desired user interface for a binary switch or toggle. This should be used when selecting between two options in a form.
+ *
+ * @deprecated since 5.2. Import [SwitchInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/SwitchInput/) directly instead.
+ */
 export const SwitchInput: typeof SwitchInputClass;
 
-/** The `SwitchInput` class defines the desired user interface for a binary switch or toggle. This should be used when selecting between two options in a form. */
+/**
+ * The `SwitchInput` class defines the desired user interface for a binary switch or toggle. This should be used when selecting between two options in a form.
+ *
+ * @deprecated since 5.2. Import [SwitchInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/SwitchInput/) directly instead.
+ */
 export type SwitchInput = SwitchInputClass;
 
-/** `TextAreaInput` defines the desired user interface for a multi-line text area. */
+/**
+ * `TextAreaInput` defines the desired user interface for a multi-line text area.
+ *
+ * @deprecated since 5.2. Import [TextAreaInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/TextAreaInput/) directly instead.
+ */
 export const TextAreaInput: typeof TextAreaInputClass;
 
-/** `TextAreaInput` defines the desired user interface for a multi-line text area. */
+/**
+ * `TextAreaInput` defines the desired user interface for a multi-line text area.
+ *
+ * @deprecated since 5.2. Import [TextAreaInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/TextAreaInput/) directly instead.
+ */
 export type TextAreaInput = TextAreaInputClass;
 
-/** `TextBoxInput` defines the desired user interface for a single-line text box. */
+/**
+ * `TextBoxInput` defines the desired user interface for a single-line text box.
+ *
+ * @deprecated since 5.2. Import [TextBoxInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/TextBoxInput/) directly instead.
+ */
 export const TextBoxInput: typeof TextBoxInputClass;
 
-/** `TextBoxInput` defines the desired user interface for a single-line text box. */
+/**
+ * `TextBoxInput` defines the desired user interface for a single-line text box.
+ *
+ * @deprecated since 5.2. Import [TextBoxInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/TextBoxInput/) directly instead.
+ */
 export type TextBoxInput = TextBoxInputClass;
 
-/** The `TimePickerInput` class defines the desired user interface for working with time-only types. */
+/**
+ * The `TimePickerInput` class defines the desired user interface for working with time-only types.
+ *
+ * @deprecated since 5.2. Import [TimePickerInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/TimePickerInput/) directly instead.
+ */
 export const TimePickerInput: typeof TimePickerInputClass;
 
-/** The `TimePickerInput` class defines the desired user interface for working with time-only types. */
+/**
+ * The `TimePickerInput` class defines the desired user interface for working with time-only types.
+ *
+ * @deprecated since 5.2. Import [TimePickerInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/TimePickerInput/) directly instead.
+ */
 export type TimePickerInput = TimePickerInputClass;

package/form/elements/inputs.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/6.0/LICENSE.txt */
-import e from"./inputs/BarcodeScannerInput.js";import t from"./inputs/ComboBoxInput.js";import n from"./inputs/DatePickerInput.js";import r from"./inputs/DateTimeOffsetPickerInput.js";import i from"./inputs/DateTimePickerInput.js";import a from"./inputs/DynamicChoiceInput.js";import o from"./inputs/Input.js";import s from"./inputs/MultipleChoiceInput.js";import c from"./inputs/RadioButtonsInput.js";import l from"./inputs/SwitchInput.js";import u from"./inputs/TextAreaInput.js";import d from"./inputs/TextBoxInput.js";import f from"./inputs/TimePickerInput.js";const p=e,m=t,h=n,g=r,_=i,v=a,y=s,b=c,x=l,S=u,C=d,w=f,T={base:o,key:`type`,typeMap:{"barcode-scanner":p,"combo-box":m,"date-picker":h,"datetime-picker":_,"dynamic-choice":v,"multiple-choice":y,"timestampoffset-picker":g,"datetimeoffset-picker":g,"radio-buttons":b,switch:x,"text-area":S,"text-box":C,"time-picker":w}};export{p as BarcodeScannerInput,m as ComboBoxInput,h as DatePickerInput,g as DateTimeOffsetPickerInput,_ as DateTimePickerInput,v as DynamicChoiceInput,y as MultipleChoiceInput,b as RadioButtonsInput,x as SwitchInput,S as TextAreaInput,C as TextBoxInput,w as TimePickerInput,T as types};
+import{deprecatedModule as e}from"../../core/deprecate.js";import t from"../../core/Logger.js";import n from"./inputs/BarcodeScannerInput.js";import r from"./inputs/ComboBoxInput.js";import i from"./inputs/DatePickerInput.js";import a from"./inputs/DateTimeOffsetPickerInput.js";import o from"./inputs/DateTimePickerInput.js";import s from"./inputs/DynamicChoiceInput.js";import c from"./inputs/Input.js";import l from"./inputs/MultipleChoiceInput.js";import u from"./inputs/RadioButtonsInput.js";import d from"./inputs/SwitchInput.js";import f from"./inputs/TextAreaInput.js";import p from"./inputs/TextBoxInput.js";import m from"./inputs/TimePickerInput.js";e(t.getLogger(`esri.form.elements.inputs`),`esri.form.elements.inputs`,{replacement:`Individual input module imports`,version:`5.2`,warnOnce:!0});const h=n,g=r,_=i,v=a,y=o,b=s,x=l,S=u,C=d,w=f,T=p,E=m,D={base:c,key:`type`,typeMap:{"barcode-scanner":h,"combo-box":g,"date-picker":_,"datetime-picker":y,"dynamic-choice":b,"multiple-choice":x,"timestampoffset-picker":v,"datetimeoffset-picker":v,"radio-buttons":S,switch:C,"text-area":w,"text-box":T,"time-picker":E}};export{h as BarcodeScannerInput,g as ComboBoxInput,_ as DatePickerInput,v as DateTimeOffsetPickerInput,y as DateTimePickerInput,b as DynamicChoiceInput,x as MultipleChoiceInput,S as RadioButtonsInput,C as SwitchInput,w as TextAreaInput,T as TextBoxInput,E as TimePickerInput,D as types};

package/form/elements.d.ts

@@ -34,6 +34,7 @@
  * }
  * ```
  *
+ * @deprecated since 5.2. Import individual element modules directly instead.
  * @since 4.16
  * @see [FormTemplate](https://developers.arcgis.com/javascript/latest/references/core/form/FormTemplate/)
  * @see [AttachmentElement](https://developers.arcgis.com/javascript/latest/references/core/form/elements/AttachmentElement/)

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