@arcgis/core 5.0.0-next.61 → 5.0.0-next.63

package/config.js

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

package/core/Loadable.d.ts

@@ -4,7 +4,13 @@ import type { AbortOptions } from "./promiseUtils.js";
 
 export interface LoadableMixinProperties {}
 
-/** @since 4.0 */
+/**
+ * Loadable is a mixin class that provides a standardized way to load resources
+ * asynchronously. Many classes in the API that load resources from a remote
+ * source extend this class.
+ *
+ * @since 4.0
+ */
 export abstract class LoadableMixin {
   constructor(...args: any[]);
   /** The Error object returned if an error occurred while loading. */
@@ -41,7 +47,7 @@ export abstract class LoadableMixin {
    * When the signal is aborted, the instance does not stop its loading process, only [cancelLoad()](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-Loadable.html#cancelLoad) can abort it.
    *
    * @param options - Additional options.
-   * @returns Resolves when the resources have {@link core/Loadable#loaded}.
+   * @returns Resolves when the resources have [loaded](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-Loadable.html#loadStatus).
    */
   load(options?: AbortOptions | null | undefined): Promise<this>;
 }

package/core/reactiveUtils.d.ts

@@ -1,5 +1,5 @@
 /**
- * * {@link core/reactiveUtils#overview}
+ * * [Overview](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-reactiveUtils.html#overview)
  * * [Using reactiveUtils](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-reactiveUtils.html#using-reactiveutils)
  * * [Working with collections](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-reactiveUtils.html#working-with-collections)
  * * [Working with objects](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-reactiveUtils.html#working-with-objects)

package/form/FormTemplate.d.ts

@@ -3,7 +3,7 @@ import type Field from "../layers/support/Field.js";
 import type FieldsIndex from "../layers/support/FieldsIndex.js";
 import type Relationship from "../layers/support/Relationship.js";
 import type { JSONSupport, JSONSupportMixinProperties } from "../core/JSONSupport.js";
-import type { Element as FormElementType } from "./elements.js";
+import type { FormElementUnion } from "./types.js";
 import type { AttachmentElementProperties } from "./elements/AttachmentElement.js";
 import type { FieldElementProperties } from "./elements/FieldElement.js";
 import type { GroupElementProperties } from "./elements/GroupElement.js";
@@ -225,7 +225,7 @@ export default class FormTemplate extends JSONSupport {
    *   }]
    * });
    */
-  get elements(): FormElementType[] | null | undefined;
+  get elements(): FormElementUnion[] | null | undefined;
   set elements(value: ((AttachmentElementProperties & {
       type: "attachment";
   }) | (FieldElementProperties & {

package/form/elements/AttachmentElement.d.ts

@@ -1,6 +1,6 @@
 import type Element from "./Element.js";
 import type { ElementProperties } from "./Element.js";
-import type { AttachmentElementInput } from "./inputs/attachments/support/inputs.js";
+import type { AttachmentInputUnion } from "./inputs/attachments/types.js";
 import type { VideoInputProperties } from "./inputs/attachments/VideoInput.js";
 import type { SignatureInputProperties } from "./inputs/attachments/SignatureInput.js";
 import type { ImageInputProperties } from "./inputs/attachments/ImageInput.js";
@@ -74,7 +74,7 @@ export default class AttachmentElement extends Element {
    */
   accessor filenameExpression: string | null | undefined;
   /** The input user interface to use for the attachment. */
-  get input(): AttachmentElementInput | null | undefined;
+  get input(): AttachmentInputUnion | null | undefined;
   set input(value: ((AttachmentInputProperties & { type: "attachment" }) | (AudioInputProperties & { type: "audio" }) | (DocumentInputProperties & { type: "document" }) | (ImageInputProperties & { type: "image" }) | (SignatureInputProperties & { type: "signature" }) | (VideoInputProperties & { type: "video" })) | null | undefined);
   /** Defines the maximum number of attachments allowed for this element. If not specified, there is no maximum number required. */
   accessor maxAttachmentCount: number | null | undefined;

package/form/elements/GroupElement.d.ts

@@ -1,11 +1,11 @@
 import type Element from "./Element.js";
+import type { NestableFormElementUnion } from "../types.js";
 import type { AttachmentElementProperties } from "./AttachmentElement.js";
 import type { ElementProperties } from "./Element.js";
 import type { FieldElementProperties } from "./FieldElement.js";
 import type { RelationshipElementProperties } from "./RelationshipElement.js";
 import type { TextElementProperties } from "./TextElement.js";
 import type { UtilityNetworkAssociationsElementProperties } from "./UtilityNetworkAssociationsElement.js";
-import type { NestedElement } from "../support/formUtils.js";
 import type { GroupState } from "../../portal/jsonTypes.js";
 
 export interface GroupElementProperties extends ElementProperties, Partial<Pick<GroupElement, "initialState">> {
@@ -102,7 +102,7 @@ export default class GroupElement extends Element {
    * >
    * > Nested group elements are not supported.
    */
-  get elements(): NestedElement[];
+  get elements(): NestableFormElementUnion[];
   set elements(value: ((AttachmentElementProperties & {
       type: "attachment";
   }) | (FieldElementProperties & {

package/form/elements/inputs/attachments/AttachmentInput.d.ts

@@ -3,14 +3,16 @@ import type { AudioInputProperties } from "./AudioInput.js";
 import type { DocumentInputProperties } from "./DocumentInput.js";
 import type { ImageInputProperties } from "./ImageInput.js";
 import type { SignatureInputProperties } from "./SignatureInput.js";
+import type { NestableAttachmentInputUnion } from "./types.js";
 import type { VideoInputProperties } from "./VideoInput.js";
-import type { NestableInput } from "./support/inputs.js";
 import type { FormAttachmentAssociationType } from "../../../../portal/jsonTypes.js";
 
+/** @experimental */
 export interface AttachmentInputProperties extends Partial<Pick<AttachmentInput, "attachmentAssociationType">> {
   /**
    * Available inputs to add an attachment.
    *
+   * @experimental
    * @see [AudioInput](https://developers.arcgis.com/javascript/latest/api-reference/esri-form-elements-inputs-attachments-AudioInput.html)
    * @see [DocumentInput](https://developers.arcgis.com/javascript/latest/api-reference/esri-form-elements-inputs-attachments-DocumentInput.html)
    * @see [ImageInput](https://developers.arcgis.com/javascript/latest/api-reference/esri-form-elements-inputs-attachments-ImageInput.html)
@@ -37,6 +39,7 @@ export interface AttachmentInputProperties extends Partial<Pick<AttachmentInput,
  * >
  * > This class is not yet fully supported within the SDK and is not intended for use in development. Support will be added in an upcoming release.
  *
+ * @experimental
  * @since 4.31
  * @see {@link form/elements/inputs/attachments/AttachmentElement}
  * @example
@@ -55,6 +58,7 @@ export interface AttachmentInputProperties extends Partial<Pick<AttachmentInput,
  * });
  */
 export default class AttachmentInput extends Input {
+  /** @experimental */
   constructor(properties?: AttachmentInputProperties);
   /**
    * String value which indicates if existing attachments should be associated with the element and how they should be associated. This property is used in conjunction with the [AttachmentElement#attachmentKeyword](https://developers.arcgis.com/javascript/latest/api-reference/esri-form-elements-AttachmentElement.html#attachmentKeyword) property.
@@ -68,19 +72,21 @@ export default class AttachmentInput extends Input {
    * `exactOrNone` | Associates only attachments that have the keyword specified by `attachmentKeyword` and any attachments with no keyword defined.
    *
    * @default "exact"
+   * @experimental
    * @see [AttachmentElement#attachmentKeyword](https://developers.arcgis.com/javascript/latest/api-reference/esri-form-elements-AttachmentElement.html#attachmentKeyword)
    */
   accessor attachmentAssociationType: FormAttachmentAssociationType;
   /**
    * Available inputs to add an attachment.
    *
+   * @experimental
    * @see [AudioInput](https://developers.arcgis.com/javascript/latest/api-reference/esri-form-elements-inputs-attachments-AudioInput.html)
    * @see [DocumentInput](https://developers.arcgis.com/javascript/latest/api-reference/esri-form-elements-inputs-attachments-DocumentInput.html)
    * @see [ImageInput](https://developers.arcgis.com/javascript/latest/api-reference/esri-form-elements-inputs-attachments-ImageInput.html)
    * @see [SignatureInput](https://developers.arcgis.com/javascript/latest/api-reference/esri-form-elements-inputs-attachments-SignatureInput.html)
    * @see [VideoInput](https://developers.arcgis.com/javascript/latest/api-reference/esri-form-elements-inputs-attachments-VideoInput.html)
    */
-  get inputTypes(): NestableInput[] | null;
+  get inputTypes(): NestableAttachmentInputUnion[] | null;
   set inputTypes(value: ((AudioInputProperties & {
       type: "audio";
   }) | (DocumentInputProperties & {
@@ -96,6 +102,7 @@ export default class AttachmentInput extends Input {
    * The input type identifier. Valid value of this property is "attachment"
    *
    * @default "attachment"
+   * @experimental
    */
   get type(): "attachment";
 }

package/form/elements/inputs/attachments/AudioInput.d.ts

@@ -1,6 +1,7 @@
 import type Input from "./Input.js";
 import type { InputMethod } from "../../../../portal/jsonTypes.js";
 
+/** @experimental */
 export interface AudioInputProperties extends Partial<Pick<AudioInput, "inputMethod" | "maxDuration">> {}
 
 /**
@@ -10,6 +11,7 @@ export interface AudioInputProperties extends Partial<Pick<AudioInput, "inputMet
  * >
  * > This class is not yet fully supported within the SDK and is not intended for use in development. Support will be added in an upcoming release.
  *
+ * @experimental
  * @since 4.31
  * @see [AudioInput](https://developers.arcgis.com/javascript/latest/api-reference/esri-form-elements-inputs-attachments-AudioInput.html)
  * @example
@@ -20,19 +22,26 @@ export interface AudioInputProperties extends Partial<Pick<AudioInput, "inputMet
  * });
  */
 export default class AudioInput extends Input {
+  /** @experimental */
   constructor(properties?: AudioInputProperties);
   /**
    * The supported input methods used to attach an audio file.
    *
    * @default "any"
+   * @experimental
    */
   accessor inputMethod: InputMethod;
-  /** Defines the maximum length of an attachment for this element in seconds. If not specified, there is no maximum length. */
+  /**
+   * Defines the maximum length of an attachment for this element in seconds. If not specified, there is no maximum length.
+   *
+   * @experimental
+   */
   accessor maxDuration: number | null | undefined;
   /**
    * The input type identifier. Valid value of this property is "audio"
    *
    * @default "audio"
+   * @experimental
    */
   get type(): "audio";
 }

package/form/elements/inputs/attachments/DocumentInput.d.ts

@@ -1,5 +1,6 @@
 import type Input from "./Input.js";
 
+/** @experimental */
 export interface DocumentInputProperties extends Partial<Pick<DocumentInput, "maxFileSize">> {}
 
 /**
@@ -9,6 +10,7 @@ export interface DocumentInputProperties extends Partial<Pick<DocumentInput, "ma
  * >
  * > This class is not yet fully supported within the SDK and is not intended for use in development. Support will be added in an upcoming release.
  *
+ * @experimental
  * @since 4.31
  * @see [DocumentInput](https://developers.arcgis.com/javascript/latest/api-reference/esri-form-elements-inputs-attachments-DocumentInput.html)
  * @example
@@ -18,13 +20,19 @@ export interface DocumentInputProperties extends Partial<Pick<DocumentInput, "ma
  * });
  */
 export default class DocumentInput extends Input {
+  /** @experimental */
   constructor(properties?: DocumentInputProperties);
-  /** Defines the maximum length of an attachment for this element in megabytes. If not specified, there is no maximum file size. */
+  /**
+   * Defines the maximum length of an attachment for this element in megabytes. If not specified, there is no maximum file size.
+   *
+   * @experimental
+   */
   accessor maxFileSize: number | null | undefined;
   /**
    * The input type identifier. Valid value of this property is "document"
    *
    * @default "document"
+   * @experimental
    */
   get type(): "document";
 }

package/form/elements/inputs/attachments/ImageInput.d.ts

@@ -1,6 +1,7 @@
 import type Input from "./Input.js";
 import type { InputMethod } from "../../../../portal/jsonTypes.js";
 
+/** @experimental */
 export interface ImageInputProperties extends Partial<Pick<ImageInput, "inputMethod" | "maxImageSize">> {}
 
 /**
@@ -10,6 +11,7 @@ export interface ImageInputProperties extends Partial<Pick<ImageInput, "inputMet
  * >
  * > This class is not yet fully supported within the SDK and is not intended for use in development. Support will be added in an upcoming release.
  *
+ * @experimental
  * @since 4.31
  * @see [ImageInput](https://developers.arcgis.com/javascript/latest/api-reference/esri-form-elements-inputs-attachments-ImageInput.html)
  * @example
@@ -20,19 +22,26 @@ export interface ImageInputProperties extends Partial<Pick<ImageInput, "inputMet
  * });
  */
 export default class ImageInput extends Input {
+  /** @experimental */
   constructor(properties?: ImageInputProperties);
   /**
    * The supported input methods used to attach an image.
    *
    * @default "any"
+   * @experimental
    */
   accessor inputMethod: InputMethod;
-  /** Number of pixels on the longest edge depending on orientation. Larger images will be resized and aspect ratio is maintained. If `maxImageSize` is not specified, images will not be resized. */
+  /**
+   * Number of pixels on the longest edge depending on orientation. Larger images will be resized and aspect ratio is maintained. If `maxImageSize` is not specified, images will not be resized.
+   *
+   * @experimental
+   */
   accessor maxImageSize: number | null | undefined;
   /**
    * The input type identifier. Valid value of this property is "image"
    *
    * @default "image"
+   * @experimental
    */
   get type(): "image";
 }

package/form/elements/inputs/attachments/Input.d.ts

@@ -1,5 +1,23 @@
 import type { ClonableMixin } from "../../../../core/Clonable.js";
 import type { JSONSupport } from "../../../../core/JSONSupport.js";
+import type { AttachmentInputType } from "./types.js";
 
-export default abstract class Input extends InputSuperclass {}
+/** @experimental */
+export default abstract class Input extends InputSuperclass {
+  /**
+   * The type of {@link module:esri/form/elements/AttachmentElement#input input} used in {@link module:esri/form/elements/AttachmentElement attachment elements}. These elements are set within a {@link module:esri/layers/FeatureLayer#formTemplate feature layer's} or {@link module:esri/widgets/FeatureForm#formTemplate form's} `formTemplate`. The configured `formTemplate` automatically displays within the {@link module:esri/widgets/Editor} widget when editing attribute features.
+   *
+   * Possible Value | Description
+   * ---------------|-------------
+   * attachment | The user interface for an input to attach multiple different types of files.
+   * audio | The user interface for an {@link module:esri/form/elements/inputs/attachments/AudioInput audio} input.
+   * document | The user interface for a {@link module:esri/form/elements/inputs/attachments/DocumentInput document} input.
+   * image | The user interface for an {@link module:esri/form/elements/inputs/attachments/ImageInput image} input.
+   * signature | The user interface for a {@link module:esri/form/elements/inputs/attachments/SignatureInput signature} input.
+   * video | The user interface for a {@link module:esri/form/elements/inputs/attachments/VideoInput video} input.
+   *
+   * @experimental
+   */
+  get type(): AttachmentInputType | null;
+}
 declare const InputSuperclass: typeof JSONSupport & typeof ClonableMixin

package/form/elements/inputs/attachments/SignatureInput.d.ts

@@ -1,6 +1,7 @@
 import type Input from "./Input.js";
 import type { InputMethod } from "../../../../portal/jsonTypes.js";
 
+/** @experimental */
 export interface SignatureInputProperties extends Partial<Pick<SignatureInput, "inputMethod">> {}
 
 /**
@@ -10,6 +11,7 @@ export interface SignatureInputProperties extends Partial<Pick<SignatureInput, "
  * >
  * > This class is not yet fully supported within the SDK and is not intended for use in development. Support will be added in an upcoming release.
  *
+ * @experimental
  * @since 4.31
  * @see [SignatureInput](https://developers.arcgis.com/javascript/latest/api-reference/esri-form-elements-inputs-attachments-SignatureInput.html)
  * @example
@@ -19,17 +21,20 @@ export interface SignatureInputProperties extends Partial<Pick<SignatureInput, "
  * });
  */
 export default class SignatureInput extends Input {
+  /** @experimental */
   constructor(properties?: SignatureInputProperties);
   /**
    * The supported input methods used to attach a signature.
    *
    * @default "any"
+   * @experimental
    */
   accessor inputMethod: InputMethod;
   /**
    * The input type identifier. Valid value of this property is "signature"
    *
    * @default "signature"
+   * @experimental
    */
   get type(): "signature";
 }

package/form/elements/inputs/attachments/VideoInput.d.ts

@@ -1,6 +1,7 @@
 import type Input from "./Input.js";
 import type { InputMethod } from "../../../../portal/jsonTypes.js";
 
+/** @experimental */
 export interface VideoInputProperties extends Partial<Pick<VideoInput, "inputMethod" | "maxDuration">> {}
 
 /**
@@ -10,6 +11,7 @@ export interface VideoInputProperties extends Partial<Pick<VideoInput, "inputMet
  * >
  * > This class is not yet fully supported within the SDK and is not intended for use in development. Support will be added in an upcoming release.
  *
+ * @experimental
  * @since 4.31
  * @see [VideoInput](https://developers.arcgis.com/javascript/latest/api-reference/esri-form-elements-inputs-attachments-VideoInput.html)
  * @example
@@ -20,19 +22,26 @@ export interface VideoInputProperties extends Partial<Pick<VideoInput, "inputMet
  * });
  */
 export default class VideoInput extends Input {
+  /** @experimental */
   constructor(properties?: VideoInputProperties);
   /**
    * The supported input methods used to attach a video.
    *
    * @default "any"
+   * @experimental
    */
   accessor inputMethod: InputMethod;
-  /** Defines the maximum length of an attachment for this element in seconds. If not specified, there is no maximum length. */
+  /**
+   * Defines the maximum length of an attachment for this element in seconds. If not specified, there is no maximum length.
+   *
+   * @experimental
+   */
   accessor maxDuration: number | null | undefined;
   /**
    * The input type identifier. Valid value of this property is "video"
    *
    * @default "video"
+   * @experimental
    */
   get type(): "video";
 }

package/form/elements/inputs/attachments/types.d.ts

@@ -0,0 +1,15 @@
+import type AttachmentInput from "./AttachmentInput.js";
+import type AudioInput from "./AudioInput.js";
+import type DocumentInput from "./DocumentInput.js";
+import type ImageInput from "./ImageInput.js";
+import type SignatureInput from "./SignatureInput.js";
+import type VideoInput from "./VideoInput.js";
+
+/** @experimental */
+export type AttachmentInputUnion = AttachmentInput | AudioInput | DocumentInput | ImageInput | SignatureInput | VideoInput;
+
+/** @experimental */
+export type AttachmentInputType = AttachmentInputUnion["type"];
+
+/** @experimental */
+export type NestableAttachmentInputUnion = Exclude<AttachmentInputUnion, AttachmentInput>;

package/form/elements.d.ts

@@ -48,15 +48,6 @@ import type RelationshipElementClass from "./elements/RelationshipElement.js";
 import type TextElementClass from "./elements/TextElement.js";
 import type UtilityNetworkAssociationsElementClass from "./elements/UtilityNetworkAssociationsElement.js";
 
-/**
- * Form element types.
- *
- * > [!CAUTION]
- * >
- * > The `AttachmentElement` is not yet fully supported within the SDK and is not intended for use in development. Support will be added in an upcoming release.
- */
-export type Element = AttachmentElement | FieldElement | GroupElement | RelationshipElement | TextElement | UtilityNetworkAssociationsElement;
-
 /** `FieldElement` defines how a feature layer's field participates in the form. */
 export const FieldElement: typeof FieldElementClass;
 

package/form/types.d.ts

@@ -0,0 +1,17 @@
+import type AttachmentElement from "./elements/AttachmentElement.js";
+import type FieldElement from "./elements/FieldElement.js";
+import type GroupElement from "./elements/GroupElement.js";
+import type RelationshipElement from "./elements/RelationshipElement.js";
+import type TextElement from "./elements/TextElement.js";
+import type UtilityNetworkAssociationsElement from "./elements/UtilityNetworkAssociationsElement.js";
+
+/**
+ * Form element types.
+ *
+ * > [!CAUTION]
+ * >
+ * > The `AttachmentElement` is not yet fully supported within the SDK and is not intended for use in development. Support will be added in an upcoming release.
+ */
+export type FormElementUnion = AttachmentElement | FieldElement | GroupElement | RelationshipElement | TextElement | UtilityNetworkAssociationsElement;
+
+export type NestableFormElementUnion = Exclude<FormElementUnion, GroupElement>;