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

package/layers/catalog/CatalogFootprintLayer.d.ts

@@ -4,6 +4,7 @@ import type SpatialReference from "../../geometry/SpatialReference.js";
 import type Layer from "../Layer.js";
 import type DisplayFilterInfo from "../support/DisplayFilterInfo.js";
 import type Field from "../support/Field.js";
+import type FieldConfiguration from "../support/FieldConfiguration.js";
 import type FieldsIndex from "../support/FieldsIndex.js";
 import type GeometryFieldsInfo from "../support/GeometryFieldsInfo.js";
 import type LabelClass from "../support/LabelClass.js";
@@ -32,6 +33,7 @@ import type { TimeZone } from "../../time/types.js";
 import type { ObjectId } from "../../views/types.js";
 import type { AttributeTableTemplateProperties } from "../../tables/AttributeTableTemplate.js";
 import type { ElevationInfoProperties } from "../../symbols/support/ElevationInfo.js";
+import type { FieldConfigurationProperties } from "../support/FieldConfiguration.js";
 import type { LabelClassProperties } from "../support/LabelClass.js";
 import type { PopupTemplateProperties } from "../../PopupTemplate.js";
 import type { HeatmapRendererProperties } from "../../renderers/HeatmapRenderer.js";
@@ -68,6 +70,58 @@ export interface CatalogFootprintLayerProperties extends LayerProperties, BlendL
    * > If the elevation info is not specified, the effective elevation depends on the context and could vary per graphic.
    */
   elevationInfo?: ElevationInfoProperties | 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/catalog/CatalogFootprintLayer/#popupTemplate) is assigned to the layer. If no [popupTemplate](https://developers.arcgis.com/javascript/latest/references/core/layers/catalog/CatalogFootprintLayer/#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/catalog/CatalogFootprintLayer/#fieldConfigurations), make the changes, and then reassign the updated clone back to [fieldConfigurations](https://developers.arcgis.com/javascript/latest/references/core/layers/catalog/CatalogFootprintLayer/#fieldConfigurations).
+   *
+   * @since 5.1
+   * @see [CatalogFootprintLayer.getFieldConfiguration](https://developers.arcgis.com/javascript/latest/references/core/layers/catalog/CatalogFootprintLayer/#getFieldConfiguration)
+   * @see [CatalogFootprintLayer.getFieldAlias](https://developers.arcgis.com/javascript/latest/references/core/layers/catalog/CatalogFootprintLayer/#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 label definition for this layer, specified as an array of
    * [LabelClass](https://developers.arcgis.com/javascript/latest/references/core/layers/support/LabelClass/). Use this property to specify
@@ -253,6 +307,59 @@ export default class CatalogFootprintLayer extends CatalogFootprintLayerSupercla
    */
   get elevationInfo(): ElevationInfo | null | undefined;
   set elevationInfo(value: ElevationInfoProperties | null | undefined);
+  /**
+   * 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/catalog/CatalogFootprintLayer/#popupTemplate) is assigned to the layer. If no [popupTemplate](https://developers.arcgis.com/javascript/latest/references/core/layers/catalog/CatalogFootprintLayer/#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/catalog/CatalogFootprintLayer/#fieldConfigurations), make the changes, and then reassign the updated clone back to [fieldConfigurations](https://developers.arcgis.com/javascript/latest/references/core/layers/catalog/CatalogFootprintLayer/#fieldConfigurations).
+   *
+   * @since 5.1
+   * @see [CatalogFootprintLayer.getFieldConfiguration](https://developers.arcgis.com/javascript/latest/references/core/layers/catalog/CatalogFootprintLayer/#getFieldConfiguration)
+   * @see [CatalogFootprintLayer.getFieldAlias](https://developers.arcgis.com/javascript/latest/references/core/layers/catalog/CatalogFootprintLayer/#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, a field named `POP_2015`, stores information about total population as a numeric value for each feature; this value represents the total number
@@ -484,6 +591,19 @@ export default class CatalogFootprintLayer extends CatalogFootprintLayerSupercla
    * }
    */
   get useViewTime(): boolean;
+  /**
+   * 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/catalog/CatalogFootprintLayer/#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 [CatalogFootprintLayer.fieldConfigurations](https://developers.arcgis.com/javascript/latest/references/core/layers/catalog/CatalogFootprintLayer/#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.
    *
@@ -556,6 +676,33 @@ export default class CatalogFootprintLayer extends CatalogFootprintLayerSupercla
    * @see [fields](https://developers.arcgis.com/javascript/latest/references/core/layers/catalog/CatalogFootprintLayer/#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/catalog/CatalogFootprintLayer/#fieldConfigurations)
+   * 2. [Field alias](https://developers.arcgis.com/javascript/latest/references/core/layers/catalog/CatalogFootprintLayer/#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 [CatalogFootprintLayer.fieldConfigurations](https://developers.arcgis.com/javascript/latest/references/core/layers/catalog/CatalogFootprintLayer/#fieldConfigurations)
+   * @see [CatalogFootprintLayer.getFieldConfiguration](https://developers.arcgis.com/javascript/latest/references/core/layers/catalog/CatalogFootprintLayer/#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 [CatalogFootprintLayer.fieldConfigurations](https://developers.arcgis.com/javascript/latest/references/core/layers/catalog/CatalogFootprintLayer/#fieldConfigurations)
+   * @see [CatalogFootprintLayer.getFieldAlias](https://developers.arcgis.com/javascript/latest/references/core/layers/catalog/CatalogFootprintLayer/#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/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.