@arcgis/core 5.0.0-next.51 → 5.0.0-next.53

package/layers/catalog/catalogUtils.d.ts

@@ -1,4 +1,43 @@
-import "../../interfaces";
+import type CatalogLayer from "../CatalogLayer.js";
+import type Layer from "../Layer.js";
 
-export const getCatalogLayerForLayer: __esri.catalogUtils["getCatalogLayerForLayer"];
-export const isLayerFromCatalog: __esri.catalogUtils["isLayerFromCatalog"];
+/**
+ * Utility method to check if the layer is temporarily available in the map and can be removed at any time because it is part of a [CatalogLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-CatalogLayer.html).
+ *
+ * It recursively checks if the [layer's parent](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-Layer.html#parent) is [CatalogLayer#dynamicGroupLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-CatalogLayer.html#dynamicGroupLayer).
+ *
+ * Use this utility to selectively exclude layers from your user experience.
+ * For example, to limit the options available for these layers in the [LayerList](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList.html).
+ *
+ * @param layer - The layer to test.
+ * @returns `true` if the layer or its parent is part of a catalog.
+ * @example
+ * // Get all layer not part of a catalog.
+ * const layers = map.allLayers.filter((layer) => !isLayerFromCatalog(layer))
+ */
+export function isLayerFromCatalog(layer: Layer): boolean;
+
+/**
+ * Utility method to get the parent [CatalogLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-CatalogLayer.html) for a given layer in
+ * [CatalogDynamicGroupLayer#layers](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-catalog-CatalogDynamicGroupLayer.html#layers) collection.
+ *
+ * @param layer - The layer for which the [CatalogLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-CatalogLayer.html) is to be retrieved.
+ * @returns The catalog for that layer when it can be found.
+ * @example
+ * // Highlight the footprint for a layer if it's part of a catalog dynamic grouplayer.
+ * function highlightFootprintForLayer(view, layer) {
+ *   const catalog = getCatalogLayerForLayer(layer);
+ *
+ *   if (catalog) {
+ *     const footprint = catalog.createFootprintFromLayer(layer);
+ *
+ *     if (footprint) {
+ *       const catalogLayerView = view.allLayerViews.find((layerView) => layerView.layer === catalog);
+ *       return catalogLayerView?.footprintLayerView?.highlight(footprint);
+ *     }
+ *   }
+ *
+ *   return { remove() {} };
+ * }
+ */
+export function getCatalogLayerForLayer(layer: Layer): CatalogLayer | null | undefined;

package/layers/effects/interfaces.d.ts

@@ -0,0 +1,276 @@
+
+/**
+ * Effect provides various filter functions that can be performed on a layer or a layerView to achieve different visual effects similar to
+ * how image filters (photo apps) work. The [CSS filters](https://developer.mozilla.org/en-US/docs/Web/CSS/filter) are supported as effects in the API
+ * with the following differences:
+ *
+ * * No [url()](https://developer.mozilla.org/en-US/docs/Web/CSS/filter) css filter support.
+ * * Only [absolute length](https://developer.mozilla.org/en-US/docs/Web/CSS/length) units are allowed for the effects where lengths are accepted.
+ * * Support for [bloom](https://en.wikipedia.org/wiki/Bloom_(shader_effect)) effect in addition to css filters.
+ *
+ * The following effects are supported: `bloom`, `blur`, `brightness`, `contrast`, `drop-shadow`, `grayscale`, `hue-rotate`, `invert`, `opacity`, `saturate`
+ * and `sepia`. The effect can be set in two different ways. It can be set as a string or as an array of objects.
+ *
+ * > [!WARNING]
+ * >
+ * > **Known Limitations**
+ * >
+ * > The effect is not supported in 3D [SceneViews](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html).
+ * > The effect cannot be applied to a layer with a [heatmap renderer](https://developers.arcgis.com/javascript/latest/api-reference/esri-renderers-HeatmapRenderer.html).
+ * > The effect is not supported in layers with [FeatureLayer#featureReduction](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html#featureReduction) of type `cluster` enabled.
+ * > See [print](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-print.html) for known printing limitations.
+ *
+ * ##### Setting effect as a string
+ *
+ * Effects can be chained together separated by a space character. Effects are applied in the order they are set. When set as a string, the effect is
+ * applied at all scales.
+ *
+ * ```js
+ *  // the following effect will be applied to the layer at all scales
+ *  // brightness will be applied first, then hue-rotate followed by contrast
+ *  // changing order of the effects will change the final result
+ *  layer.effect = "brightness(5) hue-rotate(270deg) contrast(200%)";
+ * ```
+ *
+ * ##### Setting effect as an array of objects
+ *
+ * Some effects such as `bloom` and `drop-shadow` are sensitive to scale. Scale dependent effects should be used to fine tune or control parameters of your effects
+ * at different scales so it produces desired effects. Scale dependent effects can be set as an array of objects where you specify the `scale` and the effect
+ * `value` for that scale. When you set scale dependent effects,
+ * the API will interpolate the effects in between scales. For example, if you set `opacity(0%)` at one scale and `opacity(100%)` at another, the API will
+ * interpolate the opacity value between the scales. The type and order of effects should be consistent at all scales so that they can be interpolated.
+ * If the type and order are not consistent, the effect will be set to `null`, and a warning will be shown in the console.
+ *
+ * ```js
+ * // This is a valid scale dependent effects
+ * // at scale 4622324, the brightness will not be applied
+ * // since it is dropped.
+ * layer.featureEffect = new FeatureEffect({
+ *   filter: featureFilter,
+ *   includedEffect: [
+ *     {
+ *       scale: 36978595, // small scale
+ *       value: "drop-shadow(3px, 3px, 4px) brightness(400%)",
+ *    },
+ *    {
+ *       scale: 18489297, // large scale
+ *       value: "drop-shadow(2px, 2px, 3px) brightness(200%)",
+ *    },
+ *    {
+ *       scale: 4622324, // larger scale
+ *       value: "drop-shadow(1px, 1px, 2px)",
+ *    }
+ *   ],
+ *   // applied at all scales
+ *   excludedEffect: "brightness(80%)"
+ * });
+ * ```
+ *
+ * ```js
+ * // This is an illegal scale dependent effect.
+ * // Scale dependent effects cannot be mixed like this.
+ * // No effects will be applied to the layer.
+ * // Invalid effect warning will be thrown in the console.
+ * layer.effect = [
+ *   {
+ *     scale: 36978595,
+ *     value: "opacity(50%)"
+ *   },
+ *   {
+ *     scale: 4622324,
+ *     value: "brightness(500%)"
+ *   }
+ * ];
+ * ```
+ *
+ * <figure>
+ *   <img src="https://developers.arcgis.com/javascript/latest/assets/img/apiref/layers/effects/water-effects-layer.png" alt="bloom" style="width:800px;"/>
+ *   <figcaption> The left map shows the original layers without any effects. The right map shows result of the following effects being applied to two layers in the map.
+ *   </figcaption>
+ * </figure>
+ *
+ * ```js
+ * // hillshade layer is displayed under the water color layer
+ * hillShadeLayer.effect = "saturate(400%) contrast(100%) blur(10px)";
+ * waterColorLayer.effect = "sepia(50%) saturate(100%) contrast(100%)";
+ * ```
+ *
+ * If all of the following four properties are applied, then they will be applied in this order: `featureEffect`, `effect`, `opacity` and `blendMode`.
+ *
+ * <details>
+ * <summary>Read More</summary>
+ *
+ * [bloom(strength, radius, threshold)](https://docs.unrealengine.com/en-US/Engine/Rendering/PostProcessEffects/Bloom/index.html#:~:text=Bloom%20is%20a%20real%20world,on%20a%20much%20darker%20background.) - The
+ * bloom effect produces fringes of light extending from the borders of bright areas in a layer. It causes brighter colors than the specified `threshold` to glow. You can add glow to your layers when mapping fires,
+ * volcanic eruptions and night lights.
+ *
+ * | Parameter | Description |
+ * | --------- | ----------- |
+ * | strength | The intensity of the bloom effect. This value can percent or number. Default is 1. The higher the value, the brighter the glow. Negative values are not allowed. |
+ * | radius | Determines the radius of the blur in an [absolute length](https://developer.mozilla.org/en-US/docs/Web/CSS/length). Default value is 0. Negative values are not allowed. Leaves the features inside the radius untouched. |
+ * | threshold | Determines how bright a color must be before it blooms or glows. Accepted values are 0%-100% or 0-1. Default value is 0. |
+ *
+ * ```js
+ * layer.effect = "bloom(200%, 1px, 0.2)";
+ *  // same as the line above
+ * layer.effect = "bloom(2, 1px, 20%)";
+ * ```
+ *
+ * <figure>
+ *   <img src="https://developers.arcgis.com/javascript/latest/assets/img/apiref/layers/effects/bloom-effect-layer.png" alt="bloom" style="width:800px;"/>
+ *   <figcaption> In the following screenshot, both maps show the bombing missions of the Vietnam War (USA). The left map shows the layer without any effects.
+ *    The right map shows the layer after the <code>bloom</code> effect is applied.</figcaption>
+ * </figure>
+ *
+ * ```js
+ * // scale dependent bloom effect is applied to US missions layer
+ * // that is shown in the above screen shot
+ * layer.effect = [
+ *   {
+ *    value: "bloom(3, 1px, 0.4)",
+ *    scale: 9244648.868618
+ *   },
+ *   {
+ *     value: "bloom(1, 0.75px, 0.3)",
+ *     scale: 4622324.434309
+ *   },
+ *   {
+ *     value: "bloom(3, 0.5px, 0.2)",
+ *     scale: 577790.5542885
+ *   }
+ * ];
+ * ```
+ *
+ * [blur(radius)](https://developer.mozilla.org/en-US/docs/Web/CSS/filter-function/blur) - Applies a [Gaussian blur](https://en.wikipedia.org/wiki/Gaussian_blur#:~:text=In%20image%20processing%2C%20a%20Gaussian,image%20noise%20and%20reduce%20detail.)
+ * to a layer or a layerView. It makes look like you are viewing a layer through a translucent screen making it look out of focus or blurry. The `radius` parameter of the blur is
+ * specified in a [absolute length](https://developer.mozilla.org/en-US/docs/Web/CSS/length).
+ * It defines how many pixels on the screen blend into each other. A larger value will create more blur. Negative values are not allowed.
+ *
+ * The `blur` effect can be used to soften a layer underneath a reference layer, or other layers of importance, so above features can stand out more clearly.
+ * For a layerView, it could be used to blur out excluded features from the filter so that the included features will stand out clearly.
+ *
+ * <figure>
+ *   <img src="https://developers.arcgis.com/javascript/latest/assets/img/apiref/layers/effects/blur-effect-layer.png" alt="bloom" style="width:800px;" alt="Grizzly Bear habitat ranges">
+ *   <figcaption> These maps show historic (blue) and current (red) Grizzly Bear habitat ranges. The map on the right uses a <code>blur</code> layer effect to indicate uncertainty or fuzziness to the boundaries.</figcaption>
+ * </figure>
+ *
+ * ```js
+ * // apply effect to a layer
+ * layer.effect = "blur(5px)";
+ * ```
+ *
+ * [brightness(percent | number)](https://developer.mozilla.org/en-US/docs/Web/CSS/filter-function/brightness) - Applies a linear multiplier to a layer or a layerView, making it appear brighter or darker.
+ *
+ * | Values | Effect |
+ * | ------ | ------ |
+ * | brightness(0%) or brightness(0) | Produces a completely black layer |
+ * | brightness(100%) or brightness(1) | Unchanged layer |
+ * | > 100% or > 1 | Brighter layer |
+ * | < 100% or < 1 | Darker layer |
+ *
+ * [contrast(percent | number)](https://developer.mozilla.org/en-US/docs/Web/CSS/filter-function/contrast) – Adjusts the contrast of a layer or a layerView. Negative values are not allowed.
+ *
+ * | Values | Effect |
+ * | ------ | ------ |
+ * | contrast(0%) or contrast(0) | Completely a gray layer |
+ * | contrast(100%) or contrast(1) | Unchanged layer |
+ * | > 100% or > 1 | More contrast in a layer |
+ * | < 100% or < 1 | Less contrast in a layer |
+ *
+ * [drop-shadow(offsetX, offsetY, blurRadius?, color?)](https://developer.mozilla.org/en-US/docs/Web/CSS/filter-function/drop-shadow) - Applies a drop shadow effect to a layer or a layerView that follows
+ * the outline of the layer or the layerView. The `drop-shadow` effect is useful when you want some features to stand out from the rest of the features on a busy map. For example, you can apply this effect
+ * to your labels (reference layer) to make them legible.
+ *
+ * | Parameter | Description |
+ * | --------- | ----------- |
+ * | offset-x | An [absolute length](https://developer.mozilla.org/en-US/docs/Web/CSS/length) value that determines the shadow offset in the horizontal distance. Negative values place the shadow to the left of the layer. If both x and y offsets are 0, the shadow is placed directly underneath the layer. |
+ * | offset-y | An [absolute length](https://developer.mozilla.org/en-US/docs/Web/CSS/length) value that determines the shadow offset in the vertical distance. Negative values place the shadow above the layer. |
+ * | blur-radius |An absolute length value that determines the blur radius. The larger the value, the larger and more blurred the shadow becomes. If unspecified, it defaults to 0, resulting in a sharp, unblurred edge. Negative values are not allowed. |
+ * | color | The [color](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value) of the shadow. If unspecified, it defaults to black color. |
+ *
+ * ```js
+ * const featureFilter = new FeatureFilter({
+ *   where: "BoroughEdge='true'"
+ * });
+ * layer.featureEffect = new FeatureEffect({
+ *   filter: featureFilter,
+ *   includedEffect: "drop-shadow(3px, 3px, 3px, black)",
+ *   excludedEffect: "blur(1px) brightness(65%)"
+ * });
+ * ```
+ *
+ * <figure>
+ *   <img src="https://developers.arcgis.com/javascript/latest/assets/img/apiref/layers/effects/drop-shadow-effect-layer.png" alt="drop-shadow" style="width:800px;"/>
+ *   <figcaption> These maps show areas in Greater London that intersect the boundaries of London boroughs. The right map shows the result of applying a <code>drop-shadow</code> effect to features that
+ *   intersect boundaries of London boroughs while applying <code>blur</code> and <code>brightness</code> effects to features do not meet from the filter criteria.
+ *   </figcaption>
+ * </figure>
+ *
+ * [grayscale(percent | number)](https://developer.mozilla.org/en-US/docs/Web/CSS/filter-function/grayscale) - Converts a layer or a layerView to grayscale. The value of amount defines the proportion
+ * of the conversion. If the amount parameter is missing, a value of 100% is used. Negative values are not allowed.
+ *
+ * | Values | Effect |
+ * | ------ | ------ |
+ * | grayscale(0%) or grayscale(0) | Unchanged layer |
+ * | grayscale(100%) or grayscale(1) | Completely gray layer |
+ * | < 100% or < 1 | Varying shades of gray |
+ * | > 100% or > 1 | Same as 100% or 1 |
+ *
+ * [hue-rotate(angle)](https://developer.mozilla.org/en-US/docs/Web/CSS/filter-function/hue-rotate) - Applies a hue rotation on a layer or a layerView. The value of angle defines the number of degrees
+ * around the [color wheel](https://en.wikipedia.org/wiki/Color_wheel). The colors in the layer will be shifted to the colors at the specified angle.
+ * A value of `0deg` leaves the input unchanged. Maximum value is `360deg`. A positive hue rotation shifts the hue clock-wise while a negative rotation shifts the hue counter clock-wise.
+ *
+ * | Parameter | Description |
+ * | --------- | ----------- |
+ * | angle | The relative change in hue of the input sample, specified as an [angle](https://developer.mozilla.org/en-US/docs/Web/CSS/angle) such as `deg`, `rad`, `grad` and `turn`. |
+ *
+ * [invert(percent | number)](https://developer.mozilla.org/en-US/docs/Web/CSS/filter-function/invert) - Inverts the samples in the layer. The value of amount defines the proportion
+ * of the conversion. Negative values are not allowed.
+ *
+ * | Values | Effect |
+ * | ------ | ------ |
+ * | invert(0%) or invert(0) | Unchanged layer |
+ * | invert(100%) or invert(1) | Completely inverted layer |
+ * | < 100% or < 1 | Varying degrees of inversion |
+ * | > 100% or > 1 |Same as 100% or 1 |
+ *
+ * [opacity(percent | number)](https://developer.mozilla.org/en-US/docs/Web/CSS/filter-function/opacity) - Applies transparency to a layer or a layerView. The value of amount
+ * defines the proportion of the conversion. Negative values are not allowed.
+ *
+ * | Values | Effect |
+ * | ------ | ------ |
+ * | opacity(0%) or opacity(0) | Completely transparent layer |
+ * | opacity(100%) or opacity(1) | Completely opaque layer |
+ * | < 100% or < 1 | Varying degrees of opacity |
+ * | > 100% or > 1 | Same as 100% or 1 |
+ *
+ * [saturate(percent | number)](https://developer.mozilla.org/en-US/docs/Web/CSS/filter-function/opacity) - Saturates or desaturates a layer or a layerView.
+ *
+ * | Values | Effect |
+ * | ------ | ------ |
+ * | saturate(0%) or saturate(0) | Completely unsaturated layer |
+ * | saturate(100%) or saturate(1) | Leaves the layer or layerView unchanged |
+ * | < 100% or < 1 | Varying degrees of desaturation |
+ * | > 100% or > 1 | Varying degrees of saturation |
+ *
+ * [sepia(percent | number)](https://developer.mozilla.org/en-US/docs/Web/CSS/filter-function/opacity) - Converts colors in a layer or a layerView to sepia, giving it a warmer, more yellow/brown appearance.
+ * Negative values are not allowed.
+ * | Values | Effect |
+ * | ------ | ------ |
+ * | sepia(0%) or sepia(0) | Unchanged layer or layerView |
+ * | sepia(100%) or sepia(1) | Completely sepia |
+ * | < 100% or < 1 | Varying degrees of sepia |
+ * | > 100% or > 1 | Same as 100% or 1 |
+ *
+ * </details>
+ *
+ * @see [SDK samples that use effect](https://developers.arcgis.com/javascript/latest/sample-code/?search=effect)
+ */
+export type EffectPropertyAPI = null | undefined | string | EffectScaleStop[];
+
+export interface EffectScaleStop {
+  /** The [MapView#scale](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#scale) of the view for the effect to take place. Use only when setting a scale dependent effect. */
+  scale: number;
+  /** The effect to be applied to a layer or layerView at the corresponding [MapView#scale](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#scale). Use only when setting a scale dependent effect. */
+  value: string;
+}

package/layers/graphics/editingSupport.d.ts

@@ -0,0 +1,251 @@
+import type Graphic from "../../Graphic.js";
+import type Collection from "../../core/Collection.js";
+import type EsriError from "../../core/Error.js";
+import type SpatialReference from "../../geometry/SpatialReference.js";
+
+/**
+ * A feature identifier.
+ * Either objectId or globalId is required when this object is used as input
+ * for operations.
+ */
+export interface FeatureIdentifier {
+  /** The globalId of the feature or the attachment that was edited. */
+  globalId?: string | null;
+  /** The objectId of the feature or the attachmentId of the attachment that was added/edited/deleted. */
+  objectId?: number | null;
+}
+
+/** FeatureEditResult represents the result of adding, updating or deleting a feature or an attachment. */
+export interface FeatureEditResult extends FeatureIdentifier {
+  /** If the edit failed, the edit result includes an error. */
+  error?: EsriError | null;
+}
+
+/**
+ * AttachmentEdit represents an attachment that can be added, updated or deleted via [FeatureLayer#applyEdits()](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html#applyEdits).
+ * This object can be either pre-uploaded data or base 64 encoded data.
+ */
+export interface AttachmentEdit {
+  /** The attachment to be added, updated or deleted. */
+  attachment: Attachment;
+  /**
+   * The feature, `objectId` or `globalId` of feature associated
+   * with the attachment.
+   */
+  feature: Graphic | FeatureIdentifier;
+}
+
+export interface Attachment {
+  /**
+   * The content type of the attachment. For example, `'image/jpeg'`.
+   * See the [ArcGIS REST API documentation](https://developers.arcgis.com/rest/services-reference/query-attachments-feature-service-layer-.htm)
+   * for more information on supported attachment types.
+   */
+  contentType?: string;
+  /** The attachment data. */
+  data?: Blob | File | string;
+  /**
+   * The globalId of the attachment to be added or updated. These Global IDs must be from the Global ID field created by ArcGIS.
+   * For more information on ArcGIS generated Global IDs, see the Global IDs and Attachments and relationship classes sections in the
+   * [Data Preparation](https://enterprise.arcgis.com/en/server/latest/publish-services/windows/prepare-data-for-offline-use.htm#ESRI_SECTION1_CDC34577197B43A980E4B5021DB1C32A) documentation.
+   */
+  globalId: string;
+  /** The name of the attachment. This parameter must be set if the attachment type is `Blob`. */
+  name?: string;
+  /** The id of pre-loaded attachment. */
+  uploadId?: string;
+}
+
+export interface EditOptions {
+  /**
+   * The geodatabase version to apply the edits. This parameter applies only if the
+   * {@link layers/graphics/editingSupport#capabilities capabilities.data.isVersioned} property of the layer is `true`. If the gdbVersion parameter is not specified, edits are made to the published map's version.
+   */
+  gdbVersion?: string;
+  /**
+   * Indicates whether the edits can be applied using globalIds of features or attachments.
+   * This parameter applies only if the layer's {@link layers/graphics/editingSupport#capabilities capabilities.editing.supportsGlobalId} property is `true`.
+   * When `false`, globalIds submitted with the features are ignored and the service assigns new globalIds
+   * to the new features. When `true`, the globalIds must be submitted with the new features. When updating existing features, if the `globalIdUsed` is
+   * `false`, the objectIds of the features to be updated must be provided. If the `globalIdUsed` is `true`, globalIds of features to be updated must be provided.
+   * When deleting existing features, set this property to `false` as deletes operation only accepts `objectIds` at the current version of the API.
+   *
+   * When adding, updating or deleting attachments, `globalIdUsed` parameter must be set to `true` and the attachment globalId must be set.
+   * For new attachments, the user must provide globalIds. In order for an attachment to be updated or deleted, clients must include its globalId.
+   * Attachments are not supported in an edit payload when `globalIdUsed` is `false`.
+   *
+   * ```js
+   * // add an image attachments to features
+   * function addAttachment(selectedFeature) {
+   *   const blob = new Blob(byteArrays, { type: "image/png" });
+   *   addAttachments.push({
+   *     feature: selectedFeature,
+   *     attachment: {
+   *       globalId: "8c4d6085-a33c-42a0-8e11-21e9528bca0d",
+   *       name: "brokenLight",
+   *       data: blob
+   *     }
+   *   });
+   *
+   *   const edits = {
+   *     addAttachments: addAttachments
+   *   };
+   *
+   *   const options = {
+   *     // globalIdUsed has to be true when adding, updating or deleting attachments
+   *     globalIdUsed: true,
+   *     rollbackOnFailureEnabled: true
+   *   };
+   *
+   *   featureLayer.applyEdits(edits, options).then(function(results) {
+   *     console.log("edits added: ", results);
+   *   });
+   * }
+   * ```
+   */
+  globalIdUsed?: boolean;
+  /**
+   * Indicates whether the edit results should return the time edits were applied. If `true`, the feature service will return
+   * the time edits were applied in the edit result's `editMoment` property. Only applicable with ArcGIS Server services only. This option was added at the version 4.20.
+   */
+  returnEditMoment?: boolean;
+  /**
+   * If set to `original-and-current-features`, the [EditedFeatureResult](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-graphics-editingSupport.html#EditedFeatureResult) parameter will be included
+   * in the `applyEdits` response. It contains all edited features participating in composite relationships in a database as result of editing a feature. Note that even for deletions, the geometry and attributes
+   * of the deleted feature are returned. The `original-and-current-features` option is only valid when `rollbackOnFailureEnabled` is `true`. The default value is `none`, which will not include the
+   * `EditedFeatureResult` parameter in the response. This is only applicable with ArcGIS Server services only. This option was added at the version 4.20.
+   */
+  returnServiceEditsOption?: "none" | "original-and-current-features";
+  /**
+   * Indicates whether the edits should be applied only if all submitted edits succeed.
+   * If `false`, the server will apply the edits that succeed even if some of the submitted edits fail. If `true`, the server will apply the edits
+   * only if all edits succeed. The layer's {@link layers/graphics/editingSupport#capabilities capabilities.editing.supportsRollbackOnFailure} property must be `true` if using this parameter.
+   * If `supportsRollbackOnFailure` is `false` for a layer, then `rollbackOnFailureEnabled` will always be true, regardless of how the parameter is set.
+   */
+  rollbackOnFailureEnabled?: boolean;
+}
+
+export interface Edits {
+  /**
+   * An array of attachments to be added. Applies only when the `options.globalIdUsed`
+   * parameter is set to `true`. User must provide [globalId](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-graphics-editingSupport.html#AttachmentEdit)s for all attachments to be added.
+   */
+  addAttachments?: AttachmentEdit[];
+  /**
+   * An array or a
+   * [Collection](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-Collection.html) of features to be added. Feature geometries must be of type
+   * [Mesh](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Mesh.html). Values of non nullable fields must be provided when adding new features. Date fields must have
+   * [numeric](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/getTime) values
+   * representing universal time.
+   */
+  addFeatures?: Graphic[] | Collection<Graphic>;
+  /**
+   * An array of [globalId](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-graphics-editingSupport.html#AttachmentEdit)s for attachments to be deleted. Applies only when the `options.globalIdUsed`
+   * parameter is set to `true`.
+   */
+  deleteAttachments?: string[];
+  /**
+   * An array or a
+   * [Collection](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-Collection.html) of features, or an array of objects with {@link layers/graphics/editingSupport#globalIdField globalId} of each feature to be deleted.
+   * When an array or collection of features is passed, each feature must have a valid {@link layers/graphics/editingSupport#globalIdField globalId}. When an array of objects is used,
+   * each object must have a valid value set for the {@link layers/graphics/editingSupport#globalIdField globalId} property.
+   */
+  deleteFeatures?: Graphic[] | Collection<Graphic> | FeatureIdentifier[];
+  /**
+   * An array of attachments to be updated. Applies only when the `options.globalIdUsed`
+   * parameter is set to `true`. User must provide [globalId](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-graphics-editingSupport.html#AttachmentEdit)s for all attachments to be updated.
+   */
+  updateAttachments?: AttachmentEdit[];
+  /**
+   * An array or a
+   * [Collection](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-Collection.html) of features to be updated. Each feature must have a valid
+   * {@link layers/graphics/editingSupport#objectIdField objectId} or {@link layers/graphics/editingSupport#globalIdField globalId} for attribute updates, while geometry updates must always use a valid
+   * {@link layers/graphics/editingSupport#globalIdField globalId}. Values of non nullable fields must be provided when updating features. Date fields must have
+   * [numeric](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/getTime) values
+   * representing universal time.
+   */
+  updateFeatures?: Graphic[] | Collection<Graphic>;
+}
+
+/** Results returned from the [FeatureLayer#applyEdits()](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html#applyEdits) method. */
+export interface EditsResult {
+  /** Result of adding attachments. */
+  addAttachmentResults: FeatureEditResult[];
+  /** Result of adding features. */
+  addFeatureResults: FeatureEditResult[];
+  /** Result of deleting attachments. */
+  deleteAttachmentResults: FeatureEditResult[];
+  /** Result of deleting features. */
+  deleteFeatureResults: FeatureEditResult[];
+  /**
+   * Edited features as result of editing a feature that participates in composite relationships in a database.
+   * This parameter is returned only when the `returnServiceEditsOption` parameter of the [FeatureLayer#applyEdits()](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html#applyEdits) method is set to `original-and-current-features`. This parameter was added at 4.20.
+   */
+  editedFeatureResults?: EditedFeatureResult[];
+  /**
+   * The time edits were applied to the feature service.
+   * This parameter is returned only when the `returnEditMoment` parameter of the [FeatureLayer#applyEdits()](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html#applyEdits) method is set to `true`. This option was added at the version 4.20.
+   */
+  editMoment?: number;
+  /** Result of updating attachments. */
+  updateAttachmentResults: FeatureEditResult[];
+  /** Result of updating features. */
+  updateFeatureResults: FeatureEditResult[];
+}
+
+/**
+ * Results returned from the [FeatureLayer#applyEdits()](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html#applyEdits) method if the `returnServiceEditsOption` parameter is set to `original-and-current-features`. It contains features
+ * that were added, deleted or updated in different feature layers of a feature service as a result of editing a single feature that participates in a composite relationship in
+ * a database. The results are organized by each layer affected by the edit.
+ * For example, if a feature is deleted and it is the origin in a composite relationship, the edited features as a result of this deletion are returned.
+ *
+ * The `editedFeatures` object returns full features including newly added features, the original features prior to delete, the original and current features for updates.
+ *
+ * @since 4.20
+ */
+export interface EditedFeatureResult {
+  /** Object containing all edited features belonging to the specified layer. */
+  editedFeatures: EditedFeatures;
+  /** The layerId of the feature layer where features were edited. */
+  layerId: number;
+}
+
+export interface EditedFeatures {
+  /** Newly added features as a result of editing a feature that participates in a composite relationship. */
+  adds: Graphic[];
+  /** Deleted features as a result of editing a feature that participates in a composite relationship. */
+  deletes: Graphic[];
+  /** Edited features are returned in the spatial reference of the feature service. */
+  spatialReference?: SpatialReference | null;
+  /** Object containing original and updated features as a result of editing a feature that participates in a composite relationship. */
+  updates: EditedFeaturesUpdate[];
+}
+
+export interface EditedFeaturesUpdate {
+  /** Updated feature as a result of editing a feature that participates in a composite relationship. */
+  current: Graphic;
+  /** Original feature before the update took place. */
+  original: Graphic;
+}
+
+export interface EditsResultEvent {
+  /** An array of successfully added attachments. */
+  addedAttachments: FeatureEditResult[];
+  /** An array of successfully added features. */
+  addedFeatures: FeatureEditResult[];
+  /** An array of successfully deleted attachments. */
+  deletedAttachments: FeatureEditResult[];
+  /** An array of successfully deleted features. */
+  deletedFeatures: FeatureEditResult[];
+  /**
+   * Edited features as result of editing a feature that participates in composite relationships in a database.
+   * This parameter is returned only when the `returnServiceEditsOption` parameter of the [FeatureLayer#applyEdits()](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html#applyEdits) method is set to `original-and-current-features`. This parameter was added at 4.20.
+   */
+  editedFeatures?: EditedFeatureResult[];
+  /** Returns `true` when the number of records returned exceeds the maximum number configured on the service. */
+  exceededTransferLimit: boolean;
+  /** An array of successfully updated attachments. */
+  updatedAttachments: FeatureEditResult[];
+  /** An array of successfully updated features. */
+  updatedFeatures: FeatureEditResult[];
+}

package/layers/graphics/sources/ParquetSource.d.ts

@@ -0,0 +1,26 @@
+import type Collection from "../../../core/Collection.js";
+import type SpatialReference from "../../../geometry/SpatialReference.js";
+import type Field from "../../support/Field.js";
+import type { ParquetGeometryEncodingUnion } from "../../support/ParquetGeometryEncodingBase.js";
+import type { ParquetGeometryType } from "../../support/parquetUtils.js";
+
+/**
+ * Contains an information inferred from the parquet files.
+ *
+ * @see [getParquetLayerInfo()](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-parquetUtils.html#getParquetLayerInfo)
+ */
+export interface ParquetLayerInfo {
+  /** The fields derived from the parquet files. */
+  fields?: Field[];
+  /**
+   * The encoding format used to store geometries in the parquet files.
+   *  See [ParquetLayer#geometryEncoding](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-ParquetLayer.html#geometryEncoding) for more information.
+   */
+  geometryEncoding?: ParquetGeometryEncodingUnion | null;
+  /** The geometry type of the features in the layer. */
+  geometryType?: ParquetGeometryType | null;
+  /** The spatial reference of the layer. */
+  spatialReference?: SpatialReference;
+  /** A collection of URLs pointing to the parquet files. */
+  urls: Collection<string>;
+}