@arcgis/core 5.1.0-next.100 → 5.1.0-next.102

package/layers/support/FeatureReductionBinning.d.ts

@@ -23,9 +23,49 @@ export interface FeatureReductionBinningProperties extends Partial<Pick<FeatureR
    *
    * > [!WARNING]
    * >
-   * > Support is limited in version 5.0. For details, see the [FieldConfiguration](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FieldConfiguration/) documentation.
+   * > Support is limited in version 5.1. For details, see the [FieldConfiguration](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FieldConfiguration/) documentation.
    *
    * @since 5.0
+   * @see [FeatureReductionBinning.getFieldConfiguration](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureReductionBinning/#getFieldConfiguration)
+   * @see [FeatureReductionBinning.getFieldAlias](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureReductionBinning/#getFieldAlias)
+   * @example
+   * // Adding a new field configuration
+   * const addNewConfig = (layer, fieldName, alias, fieldFormat) => {
+   *   // Check if there is already an existing configuration for fieldName
+   *   const existingConfig = layer.getFieldConfiguration(fieldName);
+   *   if (!existingConfig) {
+   *     const newConfig = new FieldConfiguration({ name: fieldName, alias, fieldFormat });
+   *     const newConfigs = clone(layer.fieldConfigurations);
+   *     newConfigs.push(newConfig);
+   *     layer.fieldConfigurations = newConfigs;
+   *   }
+   * };
+   * @example
+   * // Updating an existing field configuration
+   * const updateConfig = (layer, fieldName, alias, fieldFormat) => {
+   *   const existingConfig = layer.getFieldConfiguration(fieldName);
+   *   if (existingConfig) {
+   *     const newConfig = existingConfig.clone();
+   *     newConfig.alias = alias;
+   *     newConfig.fieldFormat = fieldFormat;
+   *
+   *     const index = layer.fieldConfigurations.indexOf(existingConfig);
+   *     const newConfigs = clone(layer.fieldConfigurations);
+   *     newConfigs[index] = newConfig;
+   *     layer.fieldConfigurations = newConfigs;
+   *   }
+   * };
+   * @example
+   * // Deleting an existing field configuration
+   * const deleteConfig = (layer, fieldName) => {
+   *   const existingConfig = layer.getFieldConfiguration(fieldName);
+   *   if (existingConfig) {
+   *     const index = layer.fieldConfigurations.indexOf(existingConfig);
+   *     var newConfigs = clone(layer.fieldConfigurations);
+   *     newConfigs.splice(index, 1);
+   *     layer.fieldConfigurations = newConfigs;
+   *   }
+   * };
    */
   fieldConfigurations?: FieldConfigurationProperties[] | null;
   /**
@@ -333,9 +373,49 @@ export default class FeatureReductionBinning extends FeatureReductionBinningSupe
    *
    * > [!WARNING]
    * >
-   * > Support is limited in version 5.0. For details, see the [FieldConfiguration](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FieldConfiguration/) documentation.
+   * > Support is limited in version 5.1. For details, see the [FieldConfiguration](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FieldConfiguration/) documentation.
    *
    * @since 5.0
+   * @see [FeatureReductionBinning.getFieldConfiguration](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureReductionBinning/#getFieldConfiguration)
+   * @see [FeatureReductionBinning.getFieldAlias](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureReductionBinning/#getFieldAlias)
+   * @example
+   * // Adding a new field configuration
+   * const addNewConfig = (layer, fieldName, alias, fieldFormat) => {
+   *   // Check if there is already an existing configuration for fieldName
+   *   const existingConfig = layer.getFieldConfiguration(fieldName);
+   *   if (!existingConfig) {
+   *     const newConfig = new FieldConfiguration({ name: fieldName, alias, fieldFormat });
+   *     const newConfigs = clone(layer.fieldConfigurations);
+   *     newConfigs.push(newConfig);
+   *     layer.fieldConfigurations = newConfigs;
+   *   }
+   * };
+   * @example
+   * // Updating an existing field configuration
+   * const updateConfig = (layer, fieldName, alias, fieldFormat) => {
+   *   const existingConfig = layer.getFieldConfiguration(fieldName);
+   *   if (existingConfig) {
+   *     const newConfig = existingConfig.clone();
+   *     newConfig.alias = alias;
+   *     newConfig.fieldFormat = fieldFormat;
+   *
+   *     const index = layer.fieldConfigurations.indexOf(existingConfig);
+   *     const newConfigs = clone(layer.fieldConfigurations);
+   *     newConfigs[index] = newConfig;
+   *     layer.fieldConfigurations = newConfigs;
+   *   }
+   * };
+   * @example
+   * // Deleting an existing field configuration
+   * const deleteConfig = (layer, fieldName) => {
+   *   const existingConfig = layer.getFieldConfiguration(fieldName);
+   *   if (existingConfig) {
+   *     const index = layer.fieldConfigurations.indexOf(existingConfig);
+   *     var newConfigs = clone(layer.fieldConfigurations);
+   *     newConfigs.splice(index, 1);
+   *     layer.fieldConfigurations = newConfigs;
+   *   }
+   * };
    */
   get fieldConfigurations(): FieldConfiguration[] | null | undefined;
   set fieldConfigurations(value: FieldConfigurationProperties[] | null | undefined);
@@ -648,22 +728,20 @@ export default class FeatureReductionBinning extends FeatureReductionBinningSupe
    * @param fieldName - The name of the field.
    * @returns The field alias of the specified field.
    * @since 5.0
-   * @see [fieldConfigurations](#fieldConfigurations)
-   * @see [getFieldConfiguration()](#getFieldConfiguration)
-   * @see [getField()](#getField)
+   * @see [FeatureReductionBinning.fieldConfigurations](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureReductionBinning/#fieldConfigurations)
+   * @see [FeatureReductionBinning.getFieldConfiguration](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureReductionBinning/#getFieldConfiguration)
    */
   getFieldAlias(fieldName: string): string | null | undefined;
   /**
    * Returns the [FieldConfigurations](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FieldConfiguration/) for the specified field. The field configuration provides optional formatting and display information for the field.
    *
-   * Previously, field formatting was commonly retrieved from [FeatureLayer.popupTemplate.fieldInfos[x].format](https://developers.arcgis.com/javascript/latest/references/core/popup/FieldInfo/#format). This is no longer needed, instead use [FeatureReductionBinning.getFieldConfiguration(fieldname).fieldFormat](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FieldConfiguration/#fieldFormat) to retrieve the field configuration formatting.
+   * Previously, field formatting was commonly retrieved from [Layer.popupTemplate.fieldInfos[x].format](https://developers.arcgis.com/javascript/latest/references/core/popup/FieldInfo/#format). This is no longer needed, instead use [Layer.getFieldConfiguration(fieldname).fieldFormat](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FieldConfiguration/#fieldFormat) to retrieve the field configuration formatting.
    *
    * @param fieldName - The name of the field.
    * @returns The field configuration of the specified field.
    * @since 5.0
-   * @see [fieldConfigurations](#fieldConfigurations)
-   * @see [getFieldAlias()](#getFieldAlias)
-   * @see [getField()](#getField)
+   * @see [FeatureReductionBinning.fieldConfigurations](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureReductionBinning/#fieldConfigurations)
+   * @see [FeatureReductionBinning.getFieldAlias](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureReductionBinning/#getFieldAlias)
    */
   getFieldConfiguration(fieldName: string): FieldConfiguration | null | undefined;
 }

package/layers/support/FeatureReductionCluster.d.ts

@@ -111,9 +111,49 @@ export interface FeatureReductionClusterProperties extends Partial<Pick<FeatureR
    *
    * > [!WARNING]
    * >
-   * > Support is limited in version 5.0. For details, see the [FieldConfiguration](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FieldConfiguration/) documentation.
+   * > Support is limited in version 5.1. For details, see the [FieldConfiguration](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FieldConfiguration/) documentation.
    *
    * @since 5.0
+   * @see [FeatureReductionCluster.getFieldConfiguration](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureReductionCluster/#getFieldConfiguration)
+   * @see [FeatureReductionCluster.getFieldAlias](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureReductionCluster/#getFieldAlias)
+   * @example
+   * // Adding a new field configuration
+   * const addNewConfig = (layer, fieldName, alias, fieldFormat) => {
+   *   // Check if there is already an existing configuration for fieldName
+   *   const existingConfig = layer.getFieldConfiguration(fieldName);
+   *   if (!existingConfig) {
+   *     const newConfig = new FieldConfiguration({ name: fieldName, alias, fieldFormat });
+   *     const newConfigs = clone(layer.fieldConfigurations);
+   *     newConfigs.push(newConfig);
+   *     layer.fieldConfigurations = newConfigs;
+   *   }
+   * };
+   * @example
+   * // Updating an existing field configuration
+   * const updateConfig = (layer, fieldName, alias, fieldFormat) => {
+   *   const existingConfig = layer.getFieldConfiguration(fieldName);
+   *   if (existingConfig) {
+   *     const newConfig = existingConfig.clone();
+   *     newConfig.alias = alias;
+   *     newConfig.fieldFormat = fieldFormat;
+   *
+   *     const index = layer.fieldConfigurations.indexOf(existingConfig);
+   *     const newConfigs = clone(layer.fieldConfigurations);
+   *     newConfigs[index] = newConfig;
+   *     layer.fieldConfigurations = newConfigs;
+   *   }
+   * };
+   * @example
+   * // Deleting an existing field configuration
+   * const deleteConfig = (layer, fieldName) => {
+   *   const existingConfig = layer.getFieldConfiguration(fieldName);
+   *   if (existingConfig) {
+   *     const index = layer.fieldConfigurations.indexOf(existingConfig);
+   *     var newConfigs = clone(layer.fieldConfigurations);
+   *     newConfigs.splice(index, 1);
+   *     layer.fieldConfigurations = newConfigs;
+   *   }
+   * };
    */
   fieldConfigurations?: FieldConfigurationProperties[] | null;
   /**
@@ -730,9 +770,49 @@ export default class FeatureReductionCluster extends FeatureReductionClusterSupe
    *
    * > [!WARNING]
    * >
-   * > Support is limited in version 5.0. For details, see the [FieldConfiguration](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FieldConfiguration/) documentation.
+   * > Support is limited in version 5.1. For details, see the [FieldConfiguration](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FieldConfiguration/) documentation.
    *
    * @since 5.0
+   * @see [FeatureReductionCluster.getFieldConfiguration](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureReductionCluster/#getFieldConfiguration)
+   * @see [FeatureReductionCluster.getFieldAlias](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureReductionCluster/#getFieldAlias)
+   * @example
+   * // Adding a new field configuration
+   * const addNewConfig = (layer, fieldName, alias, fieldFormat) => {
+   *   // Check if there is already an existing configuration for fieldName
+   *   const existingConfig = layer.getFieldConfiguration(fieldName);
+   *   if (!existingConfig) {
+   *     const newConfig = new FieldConfiguration({ name: fieldName, alias, fieldFormat });
+   *     const newConfigs = clone(layer.fieldConfigurations);
+   *     newConfigs.push(newConfig);
+   *     layer.fieldConfigurations = newConfigs;
+   *   }
+   * };
+   * @example
+   * // Updating an existing field configuration
+   * const updateConfig = (layer, fieldName, alias, fieldFormat) => {
+   *   const existingConfig = layer.getFieldConfiguration(fieldName);
+   *   if (existingConfig) {
+   *     const newConfig = existingConfig.clone();
+   *     newConfig.alias = alias;
+   *     newConfig.fieldFormat = fieldFormat;
+   *
+   *     const index = layer.fieldConfigurations.indexOf(existingConfig);
+   *     const newConfigs = clone(layer.fieldConfigurations);
+   *     newConfigs[index] = newConfig;
+   *     layer.fieldConfigurations = newConfigs;
+   *   }
+   * };
+   * @example
+   * // Deleting an existing field configuration
+   * const deleteConfig = (layer, fieldName) => {
+   *   const existingConfig = layer.getFieldConfiguration(fieldName);
+   *   if (existingConfig) {
+   *     const index = layer.fieldConfigurations.indexOf(existingConfig);
+   *     var newConfigs = clone(layer.fieldConfigurations);
+   *     newConfigs.splice(index, 1);
+   *     layer.fieldConfigurations = newConfigs;
+   *   }
+   * };
    */
   get fieldConfigurations(): FieldConfiguration[] | null | undefined;
   set fieldConfigurations(value: FieldConfigurationProperties[] | null | undefined);
@@ -1218,22 +1298,20 @@ export default class FeatureReductionCluster extends FeatureReductionClusterSupe
    * @param fieldName - The name of the field.
    * @returns The field alias of the specified field.
    * @since 5.0
-   * @see [fieldConfigurations](#fieldConfigurations)
-   * @see [getFieldConfiguration()](#getFieldConfiguration)
-   * @see [getField()](#getField)
+   * @see [FeatureReductionCluster.fieldConfigurations](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureReductionCluster/#fieldConfigurations)
+   * @see [FeatureReductionCluster.getFieldConfiguration](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureReductionCluster/#getFieldConfiguration)
    */
   getFieldAlias(fieldName: string): string | null | undefined;
   /**
    * Returns the [FieldConfigurations](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FieldConfiguration/) for the specified field. The field configuration provides optional formatting and display information for the field.
    *
-   * Previously, field formatting was commonly retrieved from [FeatureLayer.popupTemplate.fieldInfos[x].format](https://developers.arcgis.com/javascript/latest/references/core/popup/FieldInfo/#format). This is no longer needed, instead use [FeatureReductionCluster.getFieldConfiguration(fieldname).fieldFormat](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FieldConfiguration/#fieldFormat) to retrieve the field configuration formatting.
+   * Previously, field formatting was commonly retrieved from [Layer.popupTemplate.fieldInfos[x].format](https://developers.arcgis.com/javascript/latest/references/core/popup/FieldInfo/#format). This is no longer needed, instead use [Layer.getFieldConfiguration(fieldname).fieldFormat](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FieldConfiguration/#fieldFormat) to retrieve the field configuration formatting.
    *
    * @param fieldName - The name of the field.
    * @returns The field configuration of the specified field.
    * @since 5.0
-   * @see [fieldConfigurations](#fieldConfigurations)
-   * @see [getFieldAlias()](#getFieldAlias)
-   * @see [getField()](#getField)
+   * @see [FeatureReductionCluster.fieldConfigurations](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureReductionCluster/#fieldConfigurations)
+   * @see [FeatureReductionCluster.getFieldAlias](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureReductionCluster/#getFieldAlias)
    */
   getFieldConfiguration(fieldName: string): FieldConfiguration | null | undefined;
 }

package/layers/support/FieldConfiguration.d.ts

@@ -37,7 +37,7 @@ export interface FieldConfigurationProperties extends Partial<Pick<FieldConfigur
  * > [!WARNING]
  * >
  * > **Known Limitations and Considerations:**
- * > - Field configuration support is currently limited to feature service-based [FeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/) instances, including tables. Additional layer types and data sources, such as client-side graphics or feature collections, are not supported at this time. Support for additional layer types is planned for future releases.
+ * > - Field configuration support is currently limited to feature service-based [FeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/) instances, including tables, [OrientedImageryLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/OrientedImageryLayer/), [SubtypeSublayer](https://developers.arcgis.com/javascript/latest/references/core/layers/support/SubtypeSublayer/), and [CatalogFootprintLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/catalog/CatalogFootprintLayer/). Setting field configurations for aggregate fields ([binning](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureReductionBinning/) and [clustering](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureReductionCluster/)) is also supported. Additional layer types and data sources, such as client-side graphics or feature collections, are not supported at this time. Support for additional layer types is planned for future releases.
  * > - Field configurations are not supported in expression or relationship contexts in Arcade expressions. For example, fields referenced as `expression/abc123` or `relationships/0/field` do not currently support field configurations.
  * > - The [FieldInfo.format](https://developers.arcgis.com/javascript/latest/references/core/popup/FieldInfo/#format) property is used for date and number formatting when applied to unsupported layer types or contexts.
  * > - When displaying [date/time fields](https://developers.arcgis.com/javascript/latest/references/core/layers/support/DateTimeFieldFormat/), set the [DateTimeFieldFormat.timeStyle](https://developers.arcgis.com/javascript/latest/references/core/layers/support/DateTimeFieldFormat/#timeStyle) property to either `long` or `full` if the view’s [MapView.timeZone](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#timeZone) is set to `unknown` and the field includes time information.

package/layers/support/ParquetFilesData.d.ts

@@ -0,0 +1,46 @@
+import type Collection from "../../core/Collection.js";
+import type { Clonable } from "../../core/Clonable.js";
+import type { JSONSupportMixin } from "../../core/JSONSupport.js";
+import type { ReadonlyArrayOrCollection } from "../../core/Collection.js";
+
+export interface ParquetFilesDataProperties {
+  /**
+   * Collection of urls for Parquet files.
+   *
+   * @deprecated since 5.1. Use [data](https://developers.arcgis.com/javascript/latest/references/core/layers/ParquetLayer/#data) with [ParquetFilesData](https://developers.arcgis.com/javascript/latest/references/core/layers/support/ParquetFilesData/) instead.
+   * @example
+   * // Legacy file-backed alias
+   * const layer = new ParquetLayer({
+   *   urls: [
+   *     "https://example.com/path/to/parquetfile1.parquet",
+   *     "https://example.com/path/to/parquetfile2.parquet"
+   *   ]
+   * });
+   */
+  urls?: ReadonlyArrayOrCollection<string>;
+}
+
+/**
+ * File-backed data source configuration for a [ParquetLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/ParquetLayer/).
+ *
+ * @see [ParquetLayer.data](https://developers.arcgis.com/javascript/latest/references/core/layers/ParquetLayer/#data)
+ */
+export default class ParquetFilesData extends ParquetFilesDataSuperclass {
+  constructor(properties?: ParquetFilesDataProperties);
+  /**
+   * Collection of urls for Parquet files.
+   *
+   * @deprecated since 5.1. Use [data](https://developers.arcgis.com/javascript/latest/references/core/layers/ParquetLayer/#data) with [ParquetFilesData](https://developers.arcgis.com/javascript/latest/references/core/layers/support/ParquetFilesData/) instead.
+   * @example
+   * // Legacy file-backed alias
+   * const layer = new ParquetLayer({
+   *   urls: [
+   *     "https://example.com/path/to/parquetfile1.parquet",
+   *     "https://example.com/path/to/parquetfile2.parquet"
+   *   ]
+   * });
+   */
+  get urls(): Collection<string>;
+  set urls(value: ReadonlyArrayOrCollection<string>);
+}
+declare const ParquetFilesDataSuperclass: typeof Clonable & typeof JSONSupportMixin

package/layers/support/ParquetFilesData.js

@@ -0,0 +1,2 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
+import{__decorate as r}from"tslib";import{Clonable as o}from"../../core/Clonable.js";import s from"../../core/Collection.js";import e from"../../core/Error.js";import{JSONSupportMixin as t}from"../../core/JSONSupport.js";import{property as i}from"../../core/accessorSupport/decorators.js";import{subclass as p}from"../../core/accessorSupport/decorators/subclass.js";import{t as l}from"../../chunks/persistableUrlUtils.js";import{writer as a}from"../../core/accessorSupport/decorators/writer.js";let c=class extends(t(o)){constructor(r){super(r),this.type="files",this.urls=new s}writeUrls(r,o,s,t){const i=r.toArray().map(r=>l(r,t)).filter(r=>!!r);i.length?o.urls=i:t.messages?.push(new e("parquet-layer:missing-urls","Missing or empty 'urls'",{data:this}))}};r([i({type:["files"],readOnly:!0,json:{read:!1,write:{ignoreOrigin:!0}}})],c.prototype,"type",void 0),r([i({type:s.ofType(String),json:{write:{isRequired:!0}}})],c.prototype,"urls",void 0),r([a("urls")],c.prototype,"writeUrls",null),c=r([p("esri.layers.support.ParquetFilesData")],c);export{c as default};

package/layers/support/ParquetPortalItemData.d.ts

@@ -0,0 +1,25 @@
+import type PortalItem from "../../portal/PortalItem.js";
+import type { Clonable } from "../../core/Clonable.js";
+import type { JSONSupportMixin } from "../../core/JSONSupport.js";
+import type { PortalItemProperties } from "../../portal/PortalItem.js";
+
+export interface ParquetPortalItemDataProperties {
+  /** The portal item containing the Parquet data. */
+  portalItem?: PortalItemProperties;
+}
+
+/**
+ * Portal-item-backed data source configuration for a [ParquetLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/ParquetLayer/).
+ *
+ * @beta
+ * @see [ParquetLayer.data](https://developers.arcgis.com/javascript/latest/references/core/layers/ParquetLayer/#data)
+ */
+export default class ParquetPortalItemData extends ParquetPortalItemDataSuperclass {
+  constructor(properties?: ParquetPortalItemDataProperties);
+  /** The portal item containing the Parquet data. */
+  get portalItem(): PortalItem;
+  set portalItem(value: PortalItemProperties);
+  /** The type of data source. */
+  get type(): "portal-item";
+}
+declare const ParquetPortalItemDataSuperclass: typeof Clonable & typeof JSONSupportMixin

package/layers/support/ParquetPortalItemData.js

@@ -0,0 +1,2 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
+import{__decorate as r}from"tslib";import{Clonable as t}from"../../core/Clonable.js";import{JSONSupportMixin as o}from"../../core/JSONSupport.js";import{property as e}from"../../core/accessorSupport/decorators.js";import{subclass as p}from"../../core/accessorSupport/decorators/subclass.js";import s from"../../portal/PortalItem.js";import{reader as a}from"../../core/accessorSupport/decorators/reader.js";import{writer as i}from"../../core/accessorSupport/decorators/writer.js";let m=class extends(o(t)){constructor(r){super(r),this.type="portal-item"}readPortalItem(r,t,o){if(t.itemId)return new s({id:t.itemId,portal:o?.portal})}writePortalItem(r,t){r?.id&&(t.itemId=r.id)}};r([e({type:["portal-item"],nonNullable:!0,readOnly:!0,json:{read:!1,write:{isRequired:!0}}})],m.prototype,"type",void 0),r([e({type:s,json:{write:{isRequired:!0}}})],m.prototype,"portalItem",void 0),r([a("portalItem",["itemId"])],m.prototype,"readPortalItem",null),r([i("portalItem",{itemId:{type:String}})],m.prototype,"writePortalItem",null),m=r([p("esri.layers.support.ParquetPortalItemData")],m);const l=m;export{l as default};

package/layers/support/SubtypeSublayer.d.ts

@@ -5,6 +5,7 @@ import type SpatialReference from "../../geometry/SpatialReference.js";
 import type SubtypeGroupLayer from "../SubtypeGroupLayer.js";
 import type FeatureTemplate from "./FeatureTemplate.js";
 import type Field from "./Field.js";
+import type FieldConfiguration from "./FieldConfiguration.js";
 import type FieldsIndex from "./FieldsIndex.js";
 import type LabelClass from "./LabelClass.js";
 import type Relationship from "./Relationship.js";
@@ -29,6 +30,7 @@ import type { QueryProperties } from "../../rest/support/Query.js";
 import type { RelationshipQueryProperties } from "../../rest/support/RelationshipQuery.js";
 import type { CreatePopupTemplateOptions } from "../../support/popupUtils.js";
 import type { AttributeTableTemplateProperties } from "../../tables/AttributeTableTemplate.js";
+import type { FieldConfigurationProperties } from "./FieldConfiguration.js";
 import type { FormTemplateProperties } from "../../form/FormTemplate.js";
 import type { LabelClassProperties } from "./LabelClass.js";
 import type { PopupTemplateProperties } from "../../PopupTemplate.js";
@@ -48,6 +50,58 @@ export interface SubtypeSublayerProperties extends LoadableMixinProperties, Iden
    * @since 4.31
    */
   attributeTableTemplate?: AttributeTableTemplateProperties | null;
+  /**
+   * An array of [FieldConfiguration](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FieldConfiguration/) objects that control how fields are displayed in popups and other UI elements. Each object specifies options for an individual field, such as its display name, via `alias`, and formatting rules, via `fieldFormat`. Assign this property before the layer loads to ensure the configurations take effect. For more information, see the [FieldConfiguration](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FieldConfiguration/) documentation.
+   * If no field configurations are provided, they are automatically created when a [popupTemplate](https://developers.arcgis.com/javascript/latest/references/core/layers/support/SubtypeSublayer/#popupTemplate) is assigned to the layer. If no [popupTemplate](https://developers.arcgis.com/javascript/latest/references/core/layers/support/SubtypeSublayer/#popupTemplate) is set, you can manually define field configurations to customize how fields are shown.
+   * > [!WARNING]
+   * >
+   * > Support is limited in version 5.1. For details, see the [FieldConfiguration](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FieldConfiguration/) documentation.
+   *
+   * To modify field configurations, clone [fieldConfigurations](https://developers.arcgis.com/javascript/latest/references/core/layers/support/SubtypeSublayer/#fieldConfigurations), make the changes, and then reassign the updated clone back to [fieldConfigurations](https://developers.arcgis.com/javascript/latest/references/core/layers/support/SubtypeSublayer/#fieldConfigurations).
+   *
+   * @since 5.1
+   * @see [SubtypeSublayer.getFieldConfiguration](https://developers.arcgis.com/javascript/latest/references/core/layers/support/SubtypeSublayer/#getFieldConfiguration)
+   * @see [SubtypeSublayer.getFieldAlias](https://developers.arcgis.com/javascript/latest/references/core/layers/support/SubtypeSublayer/#getFieldAlias)
+   * @example
+   * // Adding a new field configuration
+   * const addNewConfig = (layer, fieldName, alias, fieldFormat) => {
+   *   // Check if there is already an existing configuration for fieldName
+   *   const existingConfig = layer.getFieldConfiguration(fieldName);
+   *   if (!existingConfig) {
+   *     const newConfig = new FieldConfiguration({ name: fieldName, alias, fieldFormat });
+   *     const newConfigs = clone(layer.fieldConfigurations);
+   *     newConfigs.push(newConfig);
+   *     layer.fieldConfigurations = newConfigs;
+   *   }
+   * };
+   * @example
+   * // Updating an existing field configuration
+   * const updateConfig = (layer, fieldName, alias, fieldFormat) => {
+   *   const existingConfig = layer.getFieldConfiguration(fieldName);
+   *   if (existingConfig) {
+   *     const newConfig = existingConfig.clone();
+   *     newConfig.alias = alias;
+   *     newConfig.fieldFormat = fieldFormat;
+   *
+   *     const index = layer.fieldConfigurations.indexOf(existingConfig);
+   *     const newConfigs = clone(layer.fieldConfigurations);
+   *     newConfigs[index] = newConfig;
+   *     layer.fieldConfigurations = newConfigs;
+   *   }
+   * };
+   * @example
+   * // Deleting an existing field configuration
+   * const deleteConfig = (layer, fieldName) => {
+   *   const existingConfig = layer.getFieldConfiguration(fieldName);
+   *   if (existingConfig) {
+   *     const index = layer.fieldConfigurations.indexOf(existingConfig);
+   *     var newConfigs = clone(layer.fieldConfigurations);
+   *     newConfigs.splice(index, 1);
+   *     layer.fieldConfigurations = newConfigs;
+   *   }
+   * };
+   */
+  fieldConfigurations?: FieldConfigurationProperties[] | null;
   /**
    * The [template](https://developers.arcgis.com/javascript/latest/references/core/form/FormTemplate/) used in an associated layer's [FeatureForm](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureForm/). All of the properties and field configurations set on the layer's [FeatureForm](https://developers.arcgis.com/javascript/latest/references/core/widgets/FeatureForm/) are handled via the [FormTemplate](https://developers.arcgis.com/javascript/latest/references/core/form/FormTemplate/).
    *
@@ -230,6 +284,59 @@ export default class SubtypeSublayer extends SubtypeSublayerSuperclass {
    * @since 4.26
    */
   get effectiveEditingEnabled(): boolean;
+  /**
+   * An array of [FieldConfiguration](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FieldConfiguration/) objects that control how fields are displayed in popups and other UI elements. Each object specifies options for an individual field, such as its display name, via `alias`, and formatting rules, via `fieldFormat`. Assign this property before the layer loads to ensure the configurations take effect. For more information, see the [FieldConfiguration](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FieldConfiguration/) documentation.
+   * If no field configurations are provided, they are automatically created when a [popupTemplate](https://developers.arcgis.com/javascript/latest/references/core/layers/support/SubtypeSublayer/#popupTemplate) is assigned to the layer. If no [popupTemplate](https://developers.arcgis.com/javascript/latest/references/core/layers/support/SubtypeSublayer/#popupTemplate) is set, you can manually define field configurations to customize how fields are shown.
+   * > [!WARNING]
+   * >
+   * > Support is limited in version 5.1. For details, see the [FieldConfiguration](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FieldConfiguration/) documentation.
+   *
+   * To modify field configurations, clone [fieldConfigurations](https://developers.arcgis.com/javascript/latest/references/core/layers/support/SubtypeSublayer/#fieldConfigurations), make the changes, and then reassign the updated clone back to [fieldConfigurations](https://developers.arcgis.com/javascript/latest/references/core/layers/support/SubtypeSublayer/#fieldConfigurations).
+   *
+   * @since 5.1
+   * @see [SubtypeSublayer.getFieldConfiguration](https://developers.arcgis.com/javascript/latest/references/core/layers/support/SubtypeSublayer/#getFieldConfiguration)
+   * @see [SubtypeSublayer.getFieldAlias](https://developers.arcgis.com/javascript/latest/references/core/layers/support/SubtypeSublayer/#getFieldAlias)
+   * @example
+   * // Adding a new field configuration
+   * const addNewConfig = (layer, fieldName, alias, fieldFormat) => {
+   *   // Check if there is already an existing configuration for fieldName
+   *   const existingConfig = layer.getFieldConfiguration(fieldName);
+   *   if (!existingConfig) {
+   *     const newConfig = new FieldConfiguration({ name: fieldName, alias, fieldFormat });
+   *     const newConfigs = clone(layer.fieldConfigurations);
+   *     newConfigs.push(newConfig);
+   *     layer.fieldConfigurations = newConfigs;
+   *   }
+   * };
+   * @example
+   * // Updating an existing field configuration
+   * const updateConfig = (layer, fieldName, alias, fieldFormat) => {
+   *   const existingConfig = layer.getFieldConfiguration(fieldName);
+   *   if (existingConfig) {
+   *     const newConfig = existingConfig.clone();
+   *     newConfig.alias = alias;
+   *     newConfig.fieldFormat = fieldFormat;
+   *
+   *     const index = layer.fieldConfigurations.indexOf(existingConfig);
+   *     const newConfigs = clone(layer.fieldConfigurations);
+   *     newConfigs[index] = newConfig;
+   *     layer.fieldConfigurations = newConfigs;
+   *   }
+   * };
+   * @example
+   * // Deleting an existing field configuration
+   * const deleteConfig = (layer, fieldName) => {
+   *   const existingConfig = layer.getFieldConfiguration(fieldName);
+   *   if (existingConfig) {
+   *     const index = layer.fieldConfigurations.indexOf(existingConfig);
+   *     var newConfigs = clone(layer.fieldConfigurations);
+   *     newConfigs.splice(index, 1);
+   *     layer.fieldConfigurations = newConfigs;
+   *   }
+   * };
+   */
+  get fieldConfigurations(): FieldConfiguration[] | null | undefined;
+  set fieldConfigurations(value: FieldConfigurationProperties[] | null | undefined);
   /**
    * An array of fields in the layer. Each field represents an attribute
    * that may contain a value for each feature in the layer. For example,
@@ -638,6 +745,19 @@ export default class SubtypeSublayer extends SubtypeSublayerSuperclass {
    * }
    */
   applyEdits(edits: Edits, options?: EditOptions): Promise<EditsResult>;
+  /**
+   * Creates default field configuration objects that define the display properties of fields.
+   * These field configurations are generated from the layer's [fields](https://developers.arcgis.com/javascript/latest/references/core/layers/support/SubtypeSublayer/#fields) property.
+   *
+   * @returns An array of field configuration objects, or `null` if the layer does not have any fields that require formatting.
+   * @since 5.1
+   * @see [SubtypeSublayer.fieldConfigurations](https://developers.arcgis.com/javascript/latest/references/core/layers/support/SubtypeSublayer/#fieldConfigurations)
+   * @returns An array of field configuration objects, or `null` if the layer does not have any fields that require formatting.
+   * @example
+   * const fieldConfigs = layer.createFieldConfigurations();
+   * layer.fieldConfigurations = fieldConfigs;
+   */
+  createFieldConfigurations(): FieldConfiguration[] | null | undefined;
   /**
    * Creates a popup template for the layer, populated with all the fields of the layer.
    *
@@ -708,6 +828,33 @@ export default class SubtypeSublayer extends SubtypeSublayerSuperclass {
    * @see [fields](https://developers.arcgis.com/javascript/latest/references/core/layers/support/SubtypeSublayer/#fields)
    */
   getField(fieldName: string): Field | null | undefined;
+  /**
+   * Returns the alias of the specified field. Previously, this value was commonly retrieved from [Layer.popupTemplate.fieldInfos[x].label](https://developers.arcgis.com/javascript/latest/references/core/popup/FieldInfo/#label) or [Layer.fields[x].alias](https://developers.arcgis.com/javascript/latest/references/core/layers/support/Field/#alias). While these properties are still supported, this method is now the recommended approach for obtaining a field's alias.
+   *
+   * The alias is resolved in the following order:
+   *
+   * 1. [Field configuration alias](https://developers.arcgis.com/javascript/latest/references/core/layers/support/SubtypeSublayer/#fieldConfigurations)
+   * 2. [Field alias](https://developers.arcgis.com/javascript/latest/references/core/layers/support/SubtypeSublayer/#fields) defined on the field.
+   *
+   * @param fieldName - The name of the field for which to get the alias.
+   * @returns The alias of the specified field.
+   * @since 5.1
+   * @see [SubtypeSublayer.fieldConfigurations](https://developers.arcgis.com/javascript/latest/references/core/layers/support/SubtypeSublayer/#fieldConfigurations)
+   * @see [SubtypeSublayer.getFieldConfiguration](https://developers.arcgis.com/javascript/latest/references/core/layers/support/SubtypeSublayer/#getFieldConfiguration)
+   */
+  getFieldAlias(fieldName: string): string | null | undefined;
+  /**
+   * Returns the [FieldConfigurations](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FieldConfiguration/) for the specified field. The field configuration provides optional formatting and display information for the field.
+   *
+   * Previously, field formatting was commonly retrieved from [Layer.popupTemplate.fieldInfos[x].format](https://developers.arcgis.com/javascript/latest/references/core/popup/FieldInfo/#format). This is no longer needed, instead use [Layer.getFieldConfiguration(fieldname).fieldFormat](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FieldConfiguration/#fieldFormat) to retrieve the field configuration formatting.
+   *
+   * @param fieldName - The name of the field for which to get the configuration.
+   * @returns The field configuration of the specified field.
+   * @since 5.1
+   * @see [SubtypeSublayer.fieldConfigurations](https://developers.arcgis.com/javascript/latest/references/core/layers/support/SubtypeSublayer/#fieldConfigurations)
+   * @see [SubtypeSublayer.getFieldAlias](https://developers.arcgis.com/javascript/latest/references/core/layers/support/SubtypeSublayer/#getFieldAlias)
+   */
+  getFieldConfiguration(fieldName: string): FieldConfiguration | null | undefined;
   /**
    * Returns the [Domain](https://developers.arcgis.com/javascript/latest/references/core/layers/support/Domain/) associated with the given field name. The domain can be either a
    * [CodedValueDomain](https://developers.arcgis.com/javascript/latest/references/core/layers/support/CodedValueDomain/) or [RangeDomain](https://developers.arcgis.com/javascript/latest/references/core/layers/support/RangeDomain/).

package/layers/support/TelemetryData.d.ts

@@ -16,6 +16,8 @@ export interface TelemetryDataProperties {
   lineOfSight?: PolylineProperties | null;
   /** The location of the sensor. */
   sensorLocation?: PointProperties | null;
+  /** The path that the moving sensor follows through the duration of the video collection. */
+  sensorPath?: PolylineProperties | null;
   /** The trail of the sensor. */
   sensorTrail?: PolylineProperties | null;
 }
@@ -41,6 +43,9 @@ export default class TelemetryData extends TelemetryDataSuperclass {
   /** The location of the sensor. */
   get sensorLocation(): Point | null | undefined;
   set sensorLocation(value: PointProperties | null | undefined);
+  /** The path that the moving sensor follows through the duration of the video collection. */
+  get sensorPath(): Polyline | null | undefined;
+  set sensorPath(value: PolylineProperties | null | undefined);
   /** The trail of the sensor. */
   get sensorTrail(): Polyline | null | undefined;
   set sensorTrail(value: PolylineProperties | null | undefined);

package/layers/support/TelemetryData.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
-import{__decorate as o}from"tslib";import{ClonableMixin as t}from"../../core/Clonable.js";import{JSONSupport as e}from"../../core/JSONSupport.js";import{property as r,subclass as s}from"../../core/accessorSupport/decorators.js";import i from"../../geometry/Point.js";import p from"../../geometry/Polygon.js";import l from"../../geometry/Polyline.js";let n=class extends(t(e)){constructor(o){super(o),this.frameCenter=null,this.frameOutline=null,this.lineOfSight=null,this.sensorLocation=null,this.sensorTrail=null}};o([r({type:i})],n.prototype,"frameCenter",void 0),o([r({type:p})],n.prototype,"frameOutline",void 0),o([r({type:l})],n.prototype,"lineOfSight",void 0),o([r({type:i})],n.prototype,"sensorLocation",void 0),o([r({type:l})],n.prototype,"sensorTrail",void 0),n=o([s("esri.layers.support.TelemetryData")],n);export{n as default};
+import{__decorate as o}from"tslib";import{ClonableMixin as t}from"../../core/Clonable.js";import{JSONSupport as e}from"../../core/JSONSupport.js";import{property as r,subclass as s}from"../../core/accessorSupport/decorators.js";import i from"../../geometry/Point.js";import p from"../../geometry/Polygon.js";import l from"../../geometry/Polyline.js";let n=class extends(t(e)){constructor(o){super(o),this.frameCenter=null,this.frameOutline=null,this.lineOfSight=null,this.sensorLocation=null,this.sensorPath=null,this.sensorTrail=null}};o([r({type:i})],n.prototype,"frameCenter",void 0),o([r({type:p})],n.prototype,"frameOutline",void 0),o([r({type:l})],n.prototype,"lineOfSight",void 0),o([r({type:i})],n.prototype,"sensorLocation",void 0),o([r({type:l})],n.prototype,"sensorPath",void 0),o([r({type:l})],n.prototype,"sensorTrail",void 0),n=o([s("esri.layers.support.TelemetryData")],n);export{n as default};

package/layers/support/TelemetryDisplay.d.ts

@@ -1,11 +1,12 @@
 import type { ClonableMixin } from "../../core/Clonable.js";
 import type { JSONSupport } from "../../core/JSONSupport.js";
 
-export interface TelemetryDisplayProperties extends Partial<Pick<TelemetryDisplay, "frame" | "frameCenter" | "frameOutline" | "lineOfSight" | "sensorLocation" | "sensorTrail">> {}
+export interface TelemetryDisplayProperties extends Partial<Pick<TelemetryDisplay, "frame" | "frameCenter" | "frameOutline" | "lineOfSight" | "sensorLocation" | "sensorPath" | "sensorTrail">> {}
 
 /**
  * The TelemetryDisplay class is used to choose what telemetry data to display on the map.
- * The class contains options for the frame center, frame outline, line of sight, sensor location, and sensor trail.
+ * The class contains options for the frame center, frame outline, line of sight, sensor location,
+ * sensor path and sensor trail.
  *
  * @since 4.30
  * @see [VideoLayer.telemetryDisplay](https://developers.arcgis.com/javascript/latest/references/core/layers/VideoLayer/#telemetryDisplay)
@@ -42,6 +43,13 @@ export default class TelemetryDisplay extends TelemetryDisplaySuperclass {
    * @default true
    */
   accessor sensorLocation: boolean;
+  /**
+   * Determines if the sensor path is displayed.
+   *
+   * @default true
+   * @since 5.1
+   */
+  accessor sensorPath: boolean;
   /**
    * Determines if the sensor trail is displayed.
    *

package/layers/support/TelemetryDisplay.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
-import{__decorate as o}from"tslib";import{ClonableMixin as r}from"../../core/Clonable.js";import{JSONSupport as t}from"../../core/JSONSupport.js";import{property as e,subclass as s}from"../../core/accessorSupport/decorators.js";const i={type:Boolean,json:{write:!0}};let p=class extends(r(t)){constructor(o){super(o),this.frame=!1,this.frameCenter=!1,this.frameOutline=!0,this.lineOfSight=!0,this.sensorLocation=!0,this.sensorTrail=!0}};o([e(i)],p.prototype,"frame",void 0),o([e(i)],p.prototype,"frameCenter",void 0),o([e(i)],p.prototype,"frameOutline",void 0),o([e(i)],p.prototype,"lineOfSight",void 0),o([e(i)],p.prototype,"sensorLocation",void 0),o([e(i)],p.prototype,"sensorTrail",void 0),p=o([s("esri.layers.support.TelemetryDisplay")],p);export{p as default};
+import{__decorate as o}from"tslib";import{ClonableMixin as t}from"../../core/Clonable.js";import{JSONSupport as r}from"../../core/JSONSupport.js";import{property as e,subclass as s}from"../../core/accessorSupport/decorators.js";const i={type:Boolean,json:{write:!0}};let p=class extends(t(r)){constructor(o){super(o),this.frame=!1,this.frameCenter=!1,this.frameOutline=!0,this.lineOfSight=!0,this.sensorLocation=!0,this.sensorPath=!0,this.sensorTrail=!0}};o([e(i)],p.prototype,"frame",void 0),o([e(i)],p.prototype,"frameCenter",void 0),o([e(i)],p.prototype,"frameOutline",void 0),o([e(i)],p.prototype,"lineOfSight",void 0),o([e(i)],p.prototype,"sensorLocation",void 0),o([e(i)],p.prototype,"sensorPath",void 0),o([e(i)],p.prototype,"sensorTrail",void 0),p=o([s("esri.layers.support.TelemetryDisplay")],p);export{p as default};