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

package/layers/OrientedImageryLayer.d.ts

@@ -2,6 +2,7 @@ import type { __FeatureLayerSansType } from "./FeatureLayer.js";
 import type SpatialReference from "../geometry/SpatialReference.js";
 import type FeatureLayer from "./FeatureLayer.js";
 import type Field from "./support/Field.js";
+import type FieldConfiguration from "./support/FieldConfiguration.js";
 import type PortalItem from "../portal/PortalItem.js";
 import type FeatureSet from "../rest/support/FeatureSet.js";
 import type { LayerSaveAsOptions, LayerSaveOptions } from "./types.js";
@@ -47,6 +48,98 @@ export interface OrientedImageryLayerProperties extends FeatureLayerProperties,
    * @since 4.29
    */
   displayField?: string | 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/OrientedImageryLayer/#popupTemplate) is assigned to the layer. If no [popupTemplate](https://developers.arcgis.com/javascript/latest/references/core/layers/OrientedImageryLayer/#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/OrientedImageryLayer/#fieldConfigurations), make the changes, and then reassign the updated clone back to [fieldConfigurations](https://developers.arcgis.com/javascript/latest/references/core/layers/OrientedImageryLayer/#fieldConfigurations).
+   *
+   * @since 5.1
+   * @see [OrientedImageryLayer.getFieldConfiguration](https://developers.arcgis.com/javascript/latest/references/core/layers/OrientedImageryLayer/#getFieldConfiguration)
+   * @see [OrientedImageryLayer.getFieldAlias](https://developers.arcgis.com/javascript/latest/references/core/layers/OrientedImageryLayer/#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;
+   *   }
+   * };
+   * @see [FeatureLayer.getFieldConfiguration](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#getFieldConfiguration)
+   * @see [FeatureLayer.getFieldAlias](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#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?: FieldConfiguration[] | null;
   /**
    * 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,
@@ -488,6 +581,98 @@ export default class OrientedImageryLayer extends __FeatureLayerSansType {
    * layer.farDistance = 60;
    */
   accessor farDistance: number | 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/OrientedImageryLayer/#popupTemplate) is assigned to the layer. If no [popupTemplate](https://developers.arcgis.com/javascript/latest/references/core/layers/OrientedImageryLayer/#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/OrientedImageryLayer/#fieldConfigurations), make the changes, and then reassign the updated clone back to [fieldConfigurations](https://developers.arcgis.com/javascript/latest/references/core/layers/OrientedImageryLayer/#fieldConfigurations).
+   *
+   * @since 5.1
+   * @see [OrientedImageryLayer.getFieldConfiguration](https://developers.arcgis.com/javascript/latest/references/core/layers/OrientedImageryLayer/#getFieldConfiguration)
+   * @see [OrientedImageryLayer.getFieldAlias](https://developers.arcgis.com/javascript/latest/references/core/layers/OrientedImageryLayer/#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;
+   *   }
+   * };
+   * @see [FeatureLayer.getFieldConfiguration](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#getFieldConfiguration)
+   * @see [FeatureLayer.getFieldAlias](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#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;
+   *   }
+   * };
+   */
+  accessor fieldConfigurations: FieldConfiguration[] | 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,
@@ -821,6 +1006,54 @@ export default class OrientedImageryLayer extends __FeatureLayerSansType {
   accessor videoPathPrefix: string | null | undefined;
   /** Suffix used to build the video url path in conjunction with the image attribute. */
   accessor videoPathSuffix: string | null | undefined;
+  /**
+   * 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/OrientedImageryLayer/#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 [OrientedImageryLayer.fieldConfigurations](https://developers.arcgis.com/javascript/latest/references/core/layers/OrientedImageryLayer/#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;
+   * @see [FeatureLayer.fieldConfigurations](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#fieldConfigurations)
+   * @example
+   * const fieldConfigs = layer.createFieldConfigurations();
+   * layer.fieldConfigurations = fieldConfigs;
+   */
+  createFieldConfigurations(): FieldConfiguration[] | 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/OrientedImageryLayer/#fieldConfigurations)
+   * 2. [Field alias](https://developers.arcgis.com/javascript/latest/references/core/layers/OrientedImageryLayer/#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 [OrientedImageryLayer.fieldConfigurations](https://developers.arcgis.com/javascript/latest/references/core/layers/OrientedImageryLayer/#fieldConfigurations)
+   * @see [OrientedImageryLayer.getFieldConfiguration](https://developers.arcgis.com/javascript/latest/references/core/layers/OrientedImageryLayer/#getFieldConfiguration)
+   * @see [FeatureLayer.fieldConfigurations](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#fieldConfigurations)
+   * @see [FeatureLayer.getFieldConfiguration](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#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 [OrientedImageryLayer.fieldConfigurations](https://developers.arcgis.com/javascript/latest/references/core/layers/OrientedImageryLayer/#fieldConfigurations)
+   * @see [OrientedImageryLayer.getFieldAlias](https://developers.arcgis.com/javascript/latest/references/core/layers/OrientedImageryLayer/#getFieldAlias)
+   * @see [FeatureLayer.fieldConfigurations](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#fieldConfigurations)
+   * @see [FeatureLayer.getFieldAlias](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#getFieldAlias)
+   */
+  getFieldConfiguration(fieldName: string): FieldConfiguration | null | undefined;
   /**
    * Executes a [Query](https://developers.arcgis.com/javascript/latest/references/core/rest/support/Query/) against the feature service and
    * returns the number of features that satisfy the query. If no parameters are specified,

package/layers/OrientedImageryLayer.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
-import{__decorate as e}from"tslib";import t from"../core/Error.js";import{clone as i}from"../core/lang.js";import{setDeepValue as r}from"../core/object.js";import{property as o,subclass as a}from"../core/accessorSupport/decorators.js";import n from"../geometry/SpatialReference.js";import s from"../graphic/OrientedImageryGraphicOrigin.js";import p from"./FeatureLayer.js";import{useViewTimeProperty as l}from"./mixins/TemporalLayer.js";import{getEffectiveElevationSource as d,parseSequenceOrderFields as m,orientedImageryTypeMap as y,timeIntervalUnitTypeMap as u,verticalMeasurementTypeMap as c,isOrientationAccuracy as h,padAccuracyArray as g}from"./orientedImagery/core/utils.js";import f from"./support/Field.js";import v from"../tables/AttributeTableTemplate.js";import j from"../time/TimeExtent.js";const S=new Set(["demPathPrefix","demPathSuffix","depthImagePathPrefix","depthImagePathSuffix","elevationSource","horizontalMeasurementUnit","imageGeometryField","imageReferenceField","referenceIDField","sequenceOrderField","verticalMeasurementUnit","videoPathPrefix","videoPathSuffix","timeAnimation","visibilityTimeExtent"]),P=new Set(["elevationSource"]),I=(e,t)=>!S.has(t)&&e,O=(e,t,i)=>{const r=`orientedImageryProperties.${e}`,o={allowNull:P.has(e),ignoreOrigin:!0};return{name:r,write:t?{...o,target:r,writer:t}:o,read:i?{ignoreOrigin:!0,source:r,reader:i}:{ignoreOrigin:!0}}};function b(e){return e.json?(e.json.origins=e.json.origins??{},e.json.origins["web-scene"]={write:!1,read:!1},e):e}function x(e,t,i,r){const{name:o,write:a,read:n}=O(e,t,i),s={name:o,write:a,read:n,origins:{service:{name:`orientedImageryInfo.${o}`,write:t,read:i},"web-scene":{name:o,write:I(a,e),read:I(n,e)},"web-map":{name:o,write:a,read:n}}};return r&&s.origins?(s.type=r,s.origins["web-map"].type=r,s.origins["web-scene"].type=r,s):s}let w=class extends p{constructor(e){super(e),this.attributeTableTemplate=null,this.cameraHeading=null,this.cameraHeight=null,this.cameraPitch=null,this.cameraRoll=null,this.coveragePercent=null,this.demPathPrefix=null,this.demPathSuffix=null,this.depthImagePathPrefix=null,this.depthImagePathSuffix=null,this.elevationSource=null,this.farDistance=null,this.geometryType="point",this.graphicOrigin=new s(this),this.horizontalFieldOfView=null,this.horizontalMeasurementUnit=null,this.imageGeometryField="ImageGeometry",this.imagePathPrefix=null,this.imagePathSuffix=null,this.imageReferenceField="OIObjectID",this.imageRotation=null,this.maximumDistance=null,this.nearDistance=null,this.operationalLayerType="OrientedImageryLayer",this.orientationAccuracy=null,this.orientedImageryType=null,this.referenceIDField="OBJECTID",this.sequenceOrderField="SequenceOrder",this.subtypeField=null,this.subtypes=null,this.supportedSourceTypes=new Set(["Oriented Imagery Layer"]),this.type="oriented-imagery",this.timeIntervalUnit="days",this.useViewTime=!0,this.verticalFieldOfView=null,this.verticalMeasurementUnit=null,this.verticalSearchRange=null,this.videoPathPrefix=null,this.videoPathSuffix=null,this.virtualCacheDirectory=null,this.dataStoreID=null,this.visibilityTimeExtent=null}get effectiveElevationSource(){const{elevationSource:e,demPathPrefix:t,demPathSuffix:i}=this;return d(e,t,i)}get effectiveSequenceOrderField(){const{sequenceOrderField:e,fields:t}=this;return m(e,t)}get portalItem(){return super.portalItem}set portalItem(e){super.portalItem=e}async save(e){return this._debouncedSaveOperations(0,e)}async saveAs(e,t){return this._debouncedSaveOperations(1,t,e)}findFirstValidLayerId(e){return e.layers?.find(({type:e})=>!!e&&this.supportedSourceTypes.has(e))?.id}_verifySource(){if(super._verifySource(),"point"!==this.geometryType)throw new t("oriented-imagery-layer:invalid-geometry-type","OrientedImageryLayer only supports point geometry type")}};e([o({type:v,json:{write:!1,read:!1}})],w.prototype,"attributeTableTemplate",void 0),e([o({type:Number,json:x("cameraHeading")})],w.prototype,"cameraHeading",void 0),e([o({type:Number,json:x("cameraHeight")})],w.prototype,"cameraHeight",void 0),e([o({type:Number,json:x("cameraPitch")})],w.prototype,"cameraPitch",void 0),e([o({type:Number,json:x("cameraRoll")})],w.prototype,"cameraRoll",void 0),e([o({type:Number,json:x("coveragePercent")})],w.prototype,"coveragePercent",void 0),e([o({type:String,json:x("demPathPrefix")})],w.prototype,"demPathPrefix",void 0),e([o({type:String,json:x("demPathSuffix")})],w.prototype,"demPathSuffix",void 0),e([o({type:String,json:x("depthImagePathPrefix")})],w.prototype,"depthImagePathPrefix",void 0),e([o({type:String,json:x("depthImagePathSuffix")})],w.prototype,"depthImagePathSuffix",void 0),e([o({type:Object,json:x("elevationSource")})],w.prototype,"elevationSource",void 0),e([o({readOnly:!0})],w.prototype,"effectiveElevationSource",null),e([o({readOnly:!0})],w.prototype,"effectiveSequenceOrderField",null),e([o({type:Number,json:x("farDistance")})],w.prototype,"farDistance",void 0),e([o({type:[f]})],w.prototype,"fields",void 0),e([o()],w.prototype,"geometryType",void 0),e([o({readOnly:!0,clonable:!1})],w.prototype,"graphicOrigin",void 0),e([o({type:Number,json:x("horizontalFieldOfView")})],w.prototype,"horizontalFieldOfView",void 0),e([o({type:String,json:x("horizontalMeasurementUnit")})],w.prototype,"horizontalMeasurementUnit",void 0),e([o({type:String,json:{...x("imageGeometryField"),default:"ImageGeometry"}})],w.prototype,"imageGeometryField",void 0),e([o({type:String,json:x("imagePathPrefix")})],w.prototype,"imagePathPrefix",void 0),e([o({type:String,json:x("imagePathSuffix")})],w.prototype,"imagePathSuffix",void 0),e([o({type:String,json:{...x("imageReferenceField"),default:"OIObjectID"}})],w.prototype,"imageReferenceField",void 0),e([o({type:Number,json:x("imageRotation")})],w.prototype,"imageRotation",void 0),e([o({type:Number,json:x("maximumDistance")})],w.prototype,"maximumDistance",void 0),e([o({type:Number,json:x("nearDistance")})],w.prototype,"nearDistance",void 0),e([o({type:["OrientedImageryLayer"],json:{origins:{"portal-item":{name:"layerType",write:{enabled:!0,ignoreOrigin:!0}}}}})],w.prototype,"operationalLayerType",void 0),e([o({json:{...x("orientationAccuracy",(e,t,i)=>{r(i,e.join(";"),t)},e=>{const t=e?.split(";")?.map(Number);return h(t)?g(t):[0,0,0,0,0,0,0,0]},String)}})],w.prototype,"orientationAccuracy",void 0),e([o({json:{...x("orientedImageryType",y.write,y.read,y.jsonValues.slice(1))}})],w.prototype,"orientedImageryType",void 0),e([o({type:String,json:{...x("referenceIDField"),default:"OBJECTID"}})],w.prototype,"referenceIDField",void 0),e([o({type:String,json:{...x("sequenceOrderField"),default:"SequenceOrder"}})],w.prototype,"sequenceOrderField",void 0),e([o({type:n})],w.prototype,"spatialReference",void 0),e([o({readOnly:!0})],w.prototype,"subtypeField",void 0),e([o({readOnly:!0})],w.prototype,"subtypes",void 0),e([o({json:{read:!1},value:"oriented-imagery",readOnly:!0})],w.prototype,"type",void 0),e([o({type:u.apiValues,json:{...x("timeIntervalUnit",u.write,u.read,u.jsonValues)}})],w.prototype,"timeIntervalUnit",void 0),e([o(b(i(l)))],w.prototype,"useViewTime",void 0),e([o({type:Number,json:x("verticalFieldOfView")})],w.prototype,"verticalFieldOfView",void 0),e([o({type:c.apiValues,json:{...x("verticalMeasurementUnit",c.write,c.read,c.jsonValues)}})],w.prototype,"verticalMeasurementUnit",void 0),e([o({type:Number,json:x("verticalSearchRange")})],w.prototype,"verticalSearchRange",void 0),e([o({type:String,json:x("videoPathPrefix")})],w.prototype,"videoPathPrefix",void 0),e([o({type:String,json:x("videoPathSuffix")})],w.prototype,"videoPathSuffix",void 0),e([o({type:String,json:{read:!1,write:!1,origins:{service:{name:"orientedImageryInfo.orientedImageryProperties.virtualCacheDirectory",read:!0}}}})],w.prototype,"virtualCacheDirectory",void 0),e([o({type:String,json:{read:!1,write:!1,origins:{service:{name:"orientedImageryInfo.dsid",read:!0}}}})],w.prototype,"dataStoreID",void 0),e([o({type:j,json:{origins:{"web-scene":{write:!1,read:!1}}}})],w.prototype,"visibilityTimeExtent",void 0),w=e([a("esri.layers.OrientedImageryLayer")],w);const F=w;export{F as default};
+import{__decorate as e}from"tslib";import t from"../core/Error.js";import{clone as i}from"../core/lang.js";import{setDeepValue as r}from"../core/object.js";import{property as o,subclass as a}from"../core/accessorSupport/decorators.js";import n from"../geometry/SpatialReference.js";import s from"../graphic/OrientedImageryGraphicOrigin.js";import p from"./FeatureLayer.js";import{useViewTimeProperty as l}from"./mixins/TemporalLayer.js";import{getEffectiveElevationSource as d,parseSequenceOrderFields as m,orientedImageryTypeMap as y,timeIntervalUnitTypeMap as u,verticalMeasurementTypeMap as c,isOrientationAccuracy as h,padAccuracyArray as g}from"./orientedImagery/core/utils.js";import f from"./support/Field.js";import v from"../tables/AttributeTableTemplate.js";import j from"../time/TimeExtent.js";const S=new Set(["demPathPrefix","demPathSuffix","depthImagePathPrefix","depthImagePathSuffix","elevationSource","horizontalMeasurementUnit","imageGeometryField","imageReferenceField","referenceIDField","sequenceOrderField","verticalMeasurementUnit","videoPathPrefix","videoPathSuffix","timeAnimation","visibilityTimeExtent"]),P=new Set(["elevationSource"]),I=(e,t)=>!S.has(t)&&e,O=(e,t,i)=>{const r=`orientedImageryProperties.${e}`,o={allowNull:P.has(e),ignoreOrigin:!0};return{name:r,write:t?{...o,target:r,writer:t}:o,read:i?{ignoreOrigin:!0,source:r,reader:i}:{ignoreOrigin:!0}}};function b(e){return e.json?(e.json.origins=e.json.origins??{},e.json.origins["web-scene"]={write:!1,read:!1},e):e}function x(e,t,i,r){const{name:o,write:a,read:n}=O(e,t,i),s={name:o,write:a,read:n,origins:{service:{name:`orientedImageryInfo.${o}`,write:t,read:i},"web-scene":{name:o,write:I(a,e),read:I(n,e)},"web-map":{name:o,write:a,read:n}}};return r&&s.origins?(s.type=r,s.origins["web-map"].type=r,s.origins["web-scene"].type=r,s):s}let w=class extends p{constructor(e){super(e),this.attributeTableTemplate=null,this.cameraHeading=null,this.cameraHeight=null,this.cameraPitch=null,this.cameraRoll=null,this.coveragePercent=null,this.demPathPrefix=null,this.demPathSuffix=null,this.depthImagePathPrefix=null,this.depthImagePathSuffix=null,this.elevationSource=null,this.farDistance=null,this.geometryType="point",this.graphicOrigin=new s(this),this.horizontalFieldOfView=null,this.horizontalMeasurementUnit=null,this.imageGeometryField="ImageGeometry",this.imagePathPrefix=null,this.imagePathSuffix=null,this.imageReferenceField="OIObjectID",this.imageRotation=null,this.maximumDistance=null,this.nearDistance=null,this.operationalLayerType="OrientedImageryLayer",this.orientationAccuracy=null,this.orientedImageryType=null,this.referenceIDField="OBJECTID",this.sequenceOrderField="SequenceOrder",this.subtypeField=null,this.subtypes=null,this.supportedSourceTypes=new Set(["Oriented Imagery Layer"]),this.type="oriented-imagery",this.timeIntervalUnit="days",this.useViewTime=!0,this.verticalFieldOfView=null,this.verticalMeasurementUnit=null,this.verticalSearchRange=null,this.videoPathPrefix=null,this.videoPathSuffix=null,this.virtualCacheDirectory=null,this.dataStoreID=null,this.visibilityTimeExtent=null}get effectiveElevationSource(){const{elevationSource:e,demPathPrefix:t,demPathSuffix:i}=this;return d(e,t,i)}get effectiveSequenceOrderField(){const{sequenceOrderField:e,fields:t}=this;return m(e,t)}get fieldConfigurations(){return super.fieldConfigurations}set fieldConfigurations(e){super.fieldConfigurations=e}get portalItem(){return super.portalItem}set portalItem(e){super.portalItem=e}async save(e){return this._debouncedSaveOperations(0,e)}async saveAs(e,t){return this._debouncedSaveOperations(1,t,e)}findFirstValidLayerId(e){return e.layers?.find(({type:e})=>!!e&&this.supportedSourceTypes.has(e))?.id}_verifySource(){if(super._verifySource(),"point"!==this.geometryType)throw new t("oriented-imagery-layer:invalid-geometry-type","OrientedImageryLayer only supports point geometry type")}};e([o({type:v,json:{write:!1,read:!1}})],w.prototype,"attributeTableTemplate",void 0),e([o({type:Number,json:x("cameraHeading")})],w.prototype,"cameraHeading",void 0),e([o({type:Number,json:x("cameraHeight")})],w.prototype,"cameraHeight",void 0),e([o({type:Number,json:x("cameraPitch")})],w.prototype,"cameraPitch",void 0),e([o({type:Number,json:x("cameraRoll")})],w.prototype,"cameraRoll",void 0),e([o({type:Number,json:x("coveragePercent")})],w.prototype,"coveragePercent",void 0),e([o({type:String,json:x("demPathPrefix")})],w.prototype,"demPathPrefix",void 0),e([o({type:String,json:x("demPathSuffix")})],w.prototype,"demPathSuffix",void 0),e([o({type:String,json:x("depthImagePathPrefix")})],w.prototype,"depthImagePathPrefix",void 0),e([o({type:String,json:x("depthImagePathSuffix")})],w.prototype,"depthImagePathSuffix",void 0),e([o({type:Object,json:x("elevationSource")})],w.prototype,"elevationSource",void 0),e([o({readOnly:!0})],w.prototype,"effectiveElevationSource",null),e([o({readOnly:!0})],w.prototype,"effectiveSequenceOrderField",null),e([o({type:Number,json:x("farDistance")})],w.prototype,"farDistance",void 0),e([o({type:[f]})],w.prototype,"fields",void 0),e([o()],w.prototype,"geometryType",void 0),e([o({readOnly:!0,clonable:!1})],w.prototype,"graphicOrigin",void 0),e([o({type:Number,json:x("horizontalFieldOfView")})],w.prototype,"horizontalFieldOfView",void 0),e([o({type:String,json:x("horizontalMeasurementUnit")})],w.prototype,"horizontalMeasurementUnit",void 0),e([o({type:String,json:{...x("imageGeometryField"),default:"ImageGeometry"}})],w.prototype,"imageGeometryField",void 0),e([o({type:String,json:x("imagePathPrefix")})],w.prototype,"imagePathPrefix",void 0),e([o({type:String,json:x("imagePathSuffix")})],w.prototype,"imagePathSuffix",void 0),e([o({type:String,json:{...x("imageReferenceField"),default:"OIObjectID"}})],w.prototype,"imageReferenceField",void 0),e([o({type:Number,json:x("imageRotation")})],w.prototype,"imageRotation",void 0),e([o({type:Number,json:x("maximumDistance")})],w.prototype,"maximumDistance",void 0),e([o({type:Number,json:x("nearDistance")})],w.prototype,"nearDistance",void 0),e([o({type:["OrientedImageryLayer"],json:{origins:{"portal-item":{name:"layerType",write:{enabled:!0,ignoreOrigin:!0}}}}})],w.prototype,"operationalLayerType",void 0),e([o({json:{...x("orientationAccuracy",(e,t,i)=>{r(i,e.join(";"),t)},e=>{const t=e?.split(";")?.map(Number);return h(t)?g(t):[0,0,0,0,0,0,0,0]},String)}})],w.prototype,"orientationAccuracy",void 0),e([o({json:{...x("orientedImageryType",y.write,y.read,y.jsonValues.slice(1))}})],w.prototype,"orientedImageryType",void 0),e([o({type:String,json:{...x("referenceIDField"),default:"OBJECTID"}})],w.prototype,"referenceIDField",void 0),e([o({type:String,json:{...x("sequenceOrderField"),default:"SequenceOrder"}})],w.prototype,"sequenceOrderField",void 0),e([o({type:n})],w.prototype,"spatialReference",void 0),e([o({readOnly:!0})],w.prototype,"subtypeField",void 0),e([o({readOnly:!0})],w.prototype,"subtypes",void 0),e([o({json:{read:!1},value:"oriented-imagery",readOnly:!0})],w.prototype,"type",void 0),e([o({type:u.apiValues,json:{...x("timeIntervalUnit",u.write,u.read,u.jsonValues)}})],w.prototype,"timeIntervalUnit",void 0),e([o(b(i(l)))],w.prototype,"useViewTime",void 0),e([o({type:Number,json:x("verticalFieldOfView")})],w.prototype,"verticalFieldOfView",void 0),e([o({type:c.apiValues,json:{...x("verticalMeasurementUnit",c.write,c.read,c.jsonValues)}})],w.prototype,"verticalMeasurementUnit",void 0),e([o({type:Number,json:x("verticalSearchRange")})],w.prototype,"verticalSearchRange",void 0),e([o({type:String,json:x("videoPathPrefix")})],w.prototype,"videoPathPrefix",void 0),e([o({type:String,json:x("videoPathSuffix")})],w.prototype,"videoPathSuffix",void 0),e([o({type:String,json:{read:!1,write:!1,origins:{service:{name:"orientedImageryInfo.orientedImageryProperties.virtualCacheDirectory",read:!0}}}})],w.prototype,"virtualCacheDirectory",void 0),e([o({type:String,json:{read:!1,write:!1,origins:{service:{name:"orientedImageryInfo.dsid",read:!0}}}})],w.prototype,"dataStoreID",void 0),e([o({type:j,json:{origins:{"web-scene":{write:!1,read:!1}}}})],w.prototype,"visibilityTimeExtent",void 0),w=e([a("esri.layers.OrientedImageryLayer")],w);const F=w;export{F as default};

package/layers/ParquetLayer.d.ts

@@ -20,7 +20,7 @@ import type { OperationalLayer, OperationalLayerProperties } from "./mixins/Oper
 import type { OrderedLayer, OrderedLayerProperties } from "./mixins/OrderedLayer.js";
 import type { ScaleRangeLayer, ScaleRangeLayerProperties } from "./mixins/ScaleRangeLayer.js";
 import type { ParquetGeometryType } from "./support/parquetUtils.js";
-import type { DomainUnion, ParquetGeometryEncodingUnion } from "./support/types.js";
+import type { DomainUnion, ParquetDataUnion, ParquetGeometryEncodingUnion } from "./support/types.js";
 import type { RendererUnion } from "../renderers/types.js";
 import type { QueryProperties } from "../rest/support/Query.js";
 import type { CreatePopupTemplateOptions } from "../support/popupUtils.js";
@@ -39,10 +39,28 @@ import type { UniqueValueRendererProperties } from "../renderers/UniqueValueRend
 import type { ClassBreaksRendererProperties } from "../renderers/ClassBreaksRenderer.js";
 import type { SimpleRendererProperties } from "../renderers/SimpleRenderer.js";
 import type { SpatialReferenceProperties } from "../geometry/SpatialReference.js";
+import type { ParquetPortalItemDataProperties } from "./support/ParquetPortalItemData.js";
+import type { ParquetFilesDataProperties } from "./support/ParquetFilesData.js";
 import type { ReadonlyArrayOrCollection } from "../core/Collection.js";
 import type { LayerProperties } from "./Layer.js";
 
 export interface ParquetLayerProperties extends LayerProperties, CustomParametersMixinProperties, OperationalLayerProperties, ScaleRangeLayerProperties, OrderedLayerProperties, BlendLayerProperties, FeatureEffectLayerProperties, FeatureReductionLayerProperties, Partial<Pick<ParquetLayer, "copyright" | "definitionExpression" | "geometryType" | "labelsVisible" | "legendEnabled" | "outFields" | "popupEnabled">> {
+  /**
+   * The data backing the layer.
+   *
+   * @since 5.1
+   * @example
+   * // Create a parquet layer from multiple Parquet files
+   * const layer = new ParquetLayer({
+   *   data: new ParquetFilesData({
+   *     urls: [
+   *       "https://example.com/path/to/parquetfile1.parquet",
+   *       "https://example.com/path/to/parquetfile2.parquet"
+   *     ]
+   *   })
+   * });
+   */
+  data?: (ParquetFilesDataProperties | (ParquetPortalItemDataProperties & { type: "portal-item" })) | null;
   /**
    * An array of fields in the layer.
    *
@@ -102,7 +120,9 @@ export interface ParquetLayerProperties extends LayerProperties, CustomParameter
    * @example
    * // ParquetLayer with WKB geometry encoding
    * const layer = new ParquetLayer({
-   *   urls: ["https://example.com/path/to/parquetfile.parquet"],
+   *   data: new ParquetFilesData({
+   *     urls: ["https://example.com/path/to/parquetfile.parquet"]
+   *   }),
    *   geometryEncoding: new ParquetGeometryEncodingWkb({
    *     field: "polyGeometry"
    *   }), // WKB geometry column
@@ -180,8 +200,9 @@ export interface ParquetLayerProperties extends LayerProperties, CustomParameter
   /**
    * 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
-   * // create parquet layer from multiple Parquet files
+   * // Create a parquet layer from multiple Parquet files
    * const layer = new ParquetLayer({
    *   urls: [
    *     "https://example.com/path/to/parquetfile1.parquet",
@@ -189,7 +210,7 @@ export interface ParquetLayerProperties extends LayerProperties, CustomParameter
    *   ]
    * });
    */
-  urls?: ReadonlyArrayOrCollection<string>;
+  urls?: ReadonlyArrayOrCollection<string> | string[] | null;
 }
 
 /**
@@ -209,18 +230,20 @@ export interface ParquetLayerProperties extends LayerProperties, CustomParameter
  * or rely on auto-detection, see the [geometryEncoding](https://developers.arcgis.com/javascript/latest/references/core/layers/ParquetLayer/#geometryEncoding) property.
  *
  * ParquetLayers may be created by either:
- * ###### Specifying the [urls](https://developers.arcgis.com/javascript/latest/references/core/layers/ParquetLayer/#urls) of the Parquet files.
+ * ###### Specifying the [data](https://developers.arcgis.com/javascript/latest/references/core/layers/ParquetLayer/#data) for the Parquet files.
  *
- * The ParquetLayer can be loaded by setting its [urls](https://developers.arcgis.com/javascript/latest/references/core/layers/ParquetLayer/#urls) property to the urls of the Parquet files.
+ * The ParquetLayer can be loaded by setting its [data](https://developers.arcgis.com/javascript/latest/references/core/layers/ParquetLayer/#data) property to file-backed data.
  * The following snippet shows how to add a new ParquetLayer to the map.
  *
  * ```js
  * // Add the Parquet files from given urls as a parquet layer.
  * const layer = new ParquetLayer({
- *   urls: [
- *     "url-to-parquet-file1.parquet",
- *     "url-to-parquet-file2.parquet"
- *   ]
+ *   data: new ParquetFilesData({
+ *     urls: [
+ *       "url-to-parquet-file1.parquet",
+ *       "url-to-parquet-file2.parquet"
+ *     ]
+ *   })
  * });
  * map.add(layer);
  * ```
@@ -277,10 +300,12 @@ export default class ParquetLayer extends ParquetLayerSuperclass {
   /**
    * @example
    * const layer = new ParquetLayer({
-   *    urls: [
-   *      "https://example.com/path/to/parquetfile1.parquet",
-   *      "https://example.com/path/to/parquetfile2.parquet"
-   *    ]
+   *   data: new ParquetFilesData({
+   *     urls: [
+   *       "https://example.com/path/to/parquetfile1.parquet",
+   *       "https://example.com/path/to/parquetfile2.parquet"
+   *     ]
+   *   })
    * });
    * mapElement.map.add(layer);  // adds the layer to the map
    */
@@ -289,6 +314,23 @@ export default class ParquetLayer extends ParquetLayerSuperclass {
   get capabilities(): FeatureLayerCapabilities | null | undefined;
   /** Copyright information for the layer. */
   accessor copyright: string | null | undefined;
+  /**
+   * The data backing the layer.
+   *
+   * @since 5.1
+   * @example
+   * // Create a parquet layer from multiple Parquet files
+   * const layer = new ParquetLayer({
+   *   data: new ParquetFilesData({
+   *     urls: [
+   *       "https://example.com/path/to/parquetfile1.parquet",
+   *       "https://example.com/path/to/parquetfile2.parquet"
+   *     ]
+   *   })
+   * });
+   */
+  get data(): ParquetDataUnion | null | undefined;
+  set data(value: (ParquetFilesDataProperties | (ParquetPortalItemDataProperties & { type: "portal-item" })) | null | undefined);
   /**
    * The SQL where clause used to filter features on the client. Only the features that satisfy the definition
    * expression are displayed in the map. Setting a definition expression is useful
@@ -301,9 +343,11 @@ export default class ParquetLayer extends ParquetLayerSuperclass {
    * @example
    * // Set definition expression in constructor to only display water wells with Status = 'Constructed'
    * const layer = new ParquetLayer({
-   *   urls: [
-   *     "https://jsapi.maps.arcgis.com/sharing/rest/content/items/6ab6f959c1684eb5a54db91644a89747/data",
-   *   ],
+   *   data: new ParquetFilesData({
+   *     urls: [
+   *       "https://jsapi.maps.arcgis.com/sharing/rest/content/items/6ab6f959c1684eb5a54db91644a89747/data",
+   *     ]
+   *   }),
    *   definitionExpression: "Status = 'Constructed'"
    * });
    * @example
@@ -385,7 +429,9 @@ export default class ParquetLayer extends ParquetLayerSuperclass {
    * @example
    * // ParquetLayer with WKB geometry encoding
    * const layer = new ParquetLayer({
-   *   urls: ["https://example.com/path/to/parquetfile.parquet"],
+   *   data: new ParquetFilesData({
+   *     urls: ["https://example.com/path/to/parquetfile.parquet"]
+   *   }),
    *   geometryEncoding: new ParquetGeometryEncodingWkb({
    *     field: "polyGeometry"
    *   }), // WKB geometry column
@@ -402,7 +448,7 @@ export default class ParquetLayer extends ParquetLayerSuperclass {
    * Non-spatial Parquet files do not have geometry object that represent geographic features.
    * The [geometryType](https://developers.arcgis.com/javascript/latest/references/core/layers/ParquetLayer/#geometryType) of the layer will be `null` if the `isTable` is `true`.
    *
-   * A non-spatial table instance can be created from the [urls](https://developers.arcgis.com/javascript/latest/references/core/layers/ParquetLayer/#urls) and the table must be loaded by calling [load()](https://developers.arcgis.com/javascript/latest/references/core/layers/ParquetLayer/#load) method.
+   * A non-spatial table instance can be created from [file-backed layer data](https://developers.arcgis.com/javascript/latest/references/core/layers/ParquetLayer/#data) and the table must be loaded by calling [load()](https://developers.arcgis.com/javascript/latest/references/core/layers/ParquetLayer/#load).
    *
    * @default false
    * @since 4.34
@@ -535,8 +581,9 @@ export default class ParquetLayer extends ParquetLayerSuperclass {
   /**
    * 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
-   * // create parquet layer from multiple Parquet files
+   * // Create a parquet layer from multiple Parquet files
    * const layer = new ParquetLayer({
    *   urls: [
    *     "https://example.com/path/to/parquetfile1.parquet",
@@ -545,7 +592,7 @@ export default class ParquetLayer extends ParquetLayerSuperclass {
    * });
    */
   get urls(): Collection<string>;
-  set urls(value: ReadonlyArrayOrCollection<string>);
+  set urls(value: ReadonlyArrayOrCollection<string> | string[] | null | undefined);
   /**
    * Creates a popup template for the layer, populated with all the fields of the layer.
    *
@@ -731,9 +778,11 @@ export default class ParquetLayer extends ParquetLayerSuperclass {
    * });
    * @example
    * const layer = new ParquetLayer({
-   *   urls: [
-   *     "parquet-file-url1.parquet"
-   *   ]
+   *   data: new ParquetFilesData({
+   *     urls: [
+   *       "parquet-file-url1.parquet"
+   *     ]
+   *   })
    * });
    *
    * const query = new Query();

package/layers/ParquetLayer.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
-import{__decorate as e}from"tslib";import r from"../PopupTemplate.js";import{ClonableMixin as t}from"../core/Clonable.js";import i from"../core/Collection.js";import o from"../core/Error.js";import has from"../core/has.js";import{MultiOriginJSONSupportMixin as s}from"../core/MultiOriginJSONSupport.js";import{setDeepValue as n}from"../core/object.js";import{watch as p}from"../core/reactiveUtils.js";import{property as a}from"../core/accessorSupport/decorators/property.js";import{reader as l}from"../core/accessorSupport/decorators/reader.js";import{subclass as u}from"../core/accessorSupport/decorators/subclass.js";import{writer as d}from"../core/accessorSupport/decorators/writer.js";import m from"../geometry/Extent.js";import y from"../geometry/SpatialReference.js";import c from"../graphic/ParquetGraphicOrigin.js";import f from"./Layer.js";import{ParquetSource as h}from"./graphics/sources/ParquetSource.js";import{BlendLayer as g}from"./mixins/BlendLayer.js";import{CustomParametersMixin as j}from"./mixins/CustomParametersMixin.js";import{FeatureEffectLayer as v}from"./mixins/FeatureEffectLayer.js";import{FeatureReductionLayer as w}from"./mixins/FeatureReductionLayer.js";import{OperationalLayer as b}from"./mixins/OperationalLayer.js";import{OrderedLayer as O}from"./mixins/OrderedLayer.js";import{ScaleRangeLayer as x}from"./mixins/ScaleRangeLayer.js";import{labelsVisible as q,legendEnabled as E,popupEnabled as F}from"./support/commonProperties.js";import I from"./support/FeatureTemplate.js";import S from"./support/Field.js";import{defineFieldProperties as T}from"./support/fieldProperties.js";import{fixRendererFields as P}from"./support/fieldUtils.js";import R from"./support/GeometryEncodingLocation.js";import L from"./support/GeometryEncodingWkb.js";import U from"./support/LabelClass.js";import{reader as _}from"./support/labelingInfo.js";import{parquetGeometryTypeKebabDict as D}from"./support/parquetUtils.js";import{rendererTypes as z}from"../renderers/support/typeUtils.js";import C from"../rest/support/Query.js";import{t as Q}from"../chunks/persistableUrlUtils.js";import{createPopupTemplate as k}from"../support/popupUtils.js";const G=T(),J="__OBJECTID",M={types:{key:"type",base:null,typeMap:{wkb:L,location:R}},json:{name:"layerDefinition.geometryEncoding",write:{ignoreOrigin:!0,isRequired:!0},origins:{service:{read:{source:"geometryEncoding"}}}}};let N=class extends(w(v(g(O(x(b(s(j(t(f)))))))))){constructor(e){super(e),this.copyright=null,this.definitionExpression=null,this.displayOptimization=null,this.fields=null,this.fieldsIndex=null,this.geometryEncoding=null,this.fullExtent=null,this.geometryType=null,this.graphicOrigin=new c(this),this.labelsVisible=!0,this.labelingInfo=null,this.objectIdField=J,this.operationalLayerType="ParquetLayer",this.outFields=null,this.persistenceEnabled=!!has("parquetlayer-persistence-enabled"),this.popupTemplate=null,this.source=null,this.spatialReference=null,this.templates=null,this.title="Parquet",this.type="parquet",this.urls=new i}destroy(){this.source?.destroy()}async load(e){return this.addResolvingPromise(this._load(e)),this.addHandles([p(()=>this.urls,e=>this.source?.updateFiles(e.items)),p(()=>this.customParameters,e=>this.source?.setCustomParameters(e))]),this}get capabilities(){return this.source?.capabilities}get defaultPopupTemplate(){return this.createPopupTemplate()}writeFields(e,r,t,i){const o=e.filter(e=>!(e.name===J&&"oid"===e.type)).map(e=>e.toJSON(i));n(t,o,r)}get isTable(){return null==this.geometryEncoding&&null==this.displayOptimization}set renderer(e){P(e,this.fieldsIndex),this._set("renderer",e)}readUrls(e){return new i("files"===e.type?e.urls:[])}writeUrls(e,r,t,i){const s=[];if(e?.length){i={blockedRelativeUrls:i?.blockedRelativeUrls};for(let r of e)r=Q(r,i),r&&s.push(r)}s.length?r.source={type:"files",urls:s}:i.messages?.push(new o("parquet-layer:missing-urls","Missing or empty 'urls'",{layer:this}))}createPopupTemplate(e){return k(this,e)}createQuery(){const e=new C;return e.returnGeometry=!0,e.outFields=["*"],e.where=this.definitionExpression||"1=1",e}async createSource(e){const r=new h({layer:this});return await r.load(e),r}getFieldDomain(e,r){return null}getField(e){return this.fieldsIndex.get(e)}async queryFeatures(e,r){await this.load();const t=await this.source.queryFeatures(this._normalizeQuery(e),r),i=this.graphicOrigin;if(t?.features)for(const o of t.features)o.layer=o.sourceLayer=this,o.origin=i;return t}async queryObjectIds(e,r){return await this.load(),this.source.queryObjectIds(this._normalizeQuery(e),r)}async queryFeatureCount(e,r){return await this.load(),this.source.queryFeatureCount(this._normalizeQuery(e),r)}async queryExtent(e,r){return await this.load(),this.source.queryExtent(this._normalizeQuery(e),r)}_normalizeQuery(e){return C.from(e)??this.createQuery()}async _load(e){const r=await this.createSource(e);this._set("source",r),this.read(r.sourceJSON,{origin:"service"}),["fields"].forEach(e=>this.revertToOrigin(e,"service")),P(this.renderer,this.fieldsIndex),null==this.spatialReference&&(this.spatialReference=y.WGS84)}};e([a({readOnly:!0,json:{read:!1,write:!1}})],N.prototype,"capabilities",null),e([a({type:String})],N.prototype,"copyright",void 0),e([a({readOnly:!0})],N.prototype,"defaultPopupTemplate",null),e([a({type:String,json:{name:"layerDefinition.definitionExpression",write:{enabled:!0,allowNull:!0}}})],N.prototype,"definitionExpression",void 0),e([a()],N.prototype,"displayOptimization",void 0),e([a({type:[S],json:{name:"layerDefinition.fields",write:{ignoreOrigin:!0,isRequired:!0},origins:{service:{name:"fields"}}}})],N.prototype,"fields",void 0),e([d("fields")],N.prototype,"writeFields",null),e([a(G.fieldsIndex)],N.prototype,"fieldsIndex",void 0),e([a(M)],N.prototype,"geometryEncoding",void 0),e([a({type:m,json:{name:"extent"}})],N.prototype,"fullExtent",void 0),e([a({type:D.apiValues,json:{name:"layerDefinition.geometryType",read:{reader:D.read},write:{writer:D.write,ignoreOrigin:!0,isRequired:!0},origins:{service:{read:{source:"geometryType",reader:D.read}}}}})],N.prototype,"geometryType",void 0),e([a({readOnly:!0,clonable:!1})],N.prototype,"graphicOrigin",void 0),e([a(q)],N.prototype,"labelsVisible",void 0),e([a({type:[U],json:{name:"layerDefinition.drawingInfo.labelingInfo",read:{reader:_},write:!0}})],N.prototype,"labelingInfo",void 0),e([a(E)],N.prototype,"legendEnabled",void 0),e([a()],N.prototype,"file",void 0),e([a({type:String,readOnly:!0})],N.prototype,"objectIdField",void 0),e([a({type:["ParquetLayer"]})],N.prototype,"operationalLayerType",void 0),e([a(G.outFields)],N.prototype,"outFields",void 0),e([a(F)],N.prototype,"popupEnabled",void 0),e([a({type:r,json:{name:"popupInfo",write:!0}})],N.prototype,"popupTemplate",void 0),e([a({types:z,json:{name:"layerDefinition.drawingInfo.renderer",write:!0,origins:{service:{read:{source:"drawingInfo.renderer"}}}}})],N.prototype,"renderer",null),e([a({type:h,readOnly:!0,cast:null,json:{read:!1}})],N.prototype,"source",void 0),e([a({type:y,json:{name:"layerDefinition.spatialReference",write:{ignoreOrigin:!0,isRequired:!0},origins:{service:{read:{source:"extent.spatialReference"}}}}})],N.prototype,"spatialReference",void 0),e([a({type:[I]})],N.prototype,"templates",void 0),e([a()],N.prototype,"title",void 0),e([a({json:{read:!1},readOnly:!0})],N.prototype,"type",void 0),e([a({type:i.ofType(String),json:{name:"source",write:{isRequired:!0,ignoreOrigin:!0}}})],N.prototype,"urls",void 0),e([l("urls")],N.prototype,"readUrls",null),e([d("urls")],N.prototype,"writeUrls",null),N=e([u("esri.layers.ParquetLayer")],N);const V=N;export{V as default};
+import{__decorate as e}from"tslib";import r from"../PopupTemplate.js";import{ClonableMixin as t}from"../core/Clonable.js";import i from"../core/Collection.js";import{deprecatedProperty as o}from"../core/deprecate.js";import s from"../core/Error.js";import has from"../core/has.js";import p from"../core/Logger.js";import{MultiOriginJSONSupportMixin as n}from"../core/MultiOriginJSONSupport.js";import{setDeepValue as a}from"../core/object.js";import{property as l}from"../core/accessorSupport/decorators/property.js";import{subclass as u}from"../core/accessorSupport/decorators/subclass.js";import{writer as d}from"../core/accessorSupport/decorators/writer.js";import m from"../geometry/Extent.js";import y from"../geometry/SpatialReference.js";import c from"../graphic/ParquetGraphicOrigin.js";import f from"./Layer.js";import{ParquetSource as h}from"./graphics/sources/ParquetSource.js";import{BlendLayer as g}from"./mixins/BlendLayer.js";import{CustomParametersMixin as j}from"./mixins/CustomParametersMixin.js";import{FeatureEffectLayer as w}from"./mixins/FeatureEffectLayer.js";import{FeatureReductionLayer as b}from"./mixins/FeatureReductionLayer.js";import{OperationalLayer as v}from"./mixins/OperationalLayer.js";import{OrderedLayer as O}from"./mixins/OrderedLayer.js";import{ScaleRangeLayer as x}from"./mixins/ScaleRangeLayer.js";import{labelsVisible as q,legendEnabled as E,popupEnabled as I}from"./support/commonProperties.js";import P from"./support/FeatureTemplate.js";import F from"./support/Field.js";import{defineFieldProperties as T}from"./support/fieldProperties.js";import{fixRendererFields as L}from"./support/fieldUtils.js";import S from"./support/GeometryEncodingLocation.js";import _ from"./support/GeometryEncodingWkb.js";import R from"./support/LabelClass.js";import{reader as D}from"./support/labelingInfo.js";import z from"./support/ParquetFilesData.js";import Q from"./support/ParquetPortalItemData.js";import{parquetGeometryTypeKebabDict as U}from"./support/parquetUtils.js";import{rendererTypes as C}from"../renderers/support/typeUtils.js";import k from"../rest/support/Query.js";import{createPopupTemplate as G}from"../support/popupUtils.js";const J=T(),M="__OBJECTID",N={types:{key:"type",base:null,typeMap:{wkb:_,location:S}},json:{name:"layerDefinition.geometryEncoding",write:{ignoreOrigin:!0,isRequired:!0},origins:{service:{read:{source:"geometryEncoding"}}}}};let V=class extends(b(w(g(O(x(v(n(j(t(f)))))))))){constructor(e){super(e),this._emptyUrls=new i,this.copyright=null,this.definitionExpression=null,this.displayOptimization=null,this.fields=null,this.fieldsIndex=null,this.geometryEncoding=null,this.fullExtent=null,this.geometryType=null,this.graphicOrigin=new c(this),this.labelsVisible=!0,this.labelingInfo=null,this.objectIdField=M,this.operationalLayerType="ParquetLayer",this.outFields=null,this.persistenceEnabled=!!has("parquetlayer-persistence-enabled"),this.popupTemplate=null,this.source=null,this.spatialReference=null,this.templates=null,this.title="Parquet",this.type="parquet",this.data=null}destroy(){this.source?.destroy()}async load(e){return this.addResolvingPromise(this._load(e)),this}get capabilities(){return this.source?.capabilities}get defaultPopupTemplate(){return this.createPopupTemplate()}writeFields(e,r,t,i){const o=e.filter(e=>!(e.name===M&&"oid"===e.type)).map(e=>e.toJSON(i));a(t,o,r)}get isTable(){return null==this.geometryEncoding&&null==this.displayOptimization}set renderer(e){L(e,this.fieldsIndex),this._set("renderer",e)}writeData(e,r,t,i){if(!e)return;const o=e.write({},i);"portal-item"!==o.type?o.urls.length&&(r.source=o):i.messages?.push(new s("parquet-layer:unsupported-data","Portal-item-backed Parquet data is not yet supported in web maps",{layer:this}))}get urls(){return"files"===this.data?.type?this.data.urls:this._emptyUrls}set urls(e){o(p.getLogger(this),"urls",{replacement:"data",version:"5.1",warnOnce:!0}),this.data=new z({urls:this._normalizeUrls(e)})}createPopupTemplate(e){return G(this,e)}createQuery(){const e=new k;return e.returnGeometry=!0,e.outFields=["*"],e.where=this.definitionExpression||"1=1",e}async createSource(e){const r=new h({layer:this});return await r.load(e),r}getFieldDomain(e,r){return null}getField(e){return this.fieldsIndex.get(e)}async queryFeatures(e,r){await this.load();const t=await this.source.queryFeatures(this._normalizeQuery(e),r),i=this.graphicOrigin;if(t?.features)for(const o of t.features)o.layer=o.sourceLayer=this,o.origin=i;return t}async queryObjectIds(e,r){return await this.load(),this.source.queryObjectIds(this._normalizeQuery(e),r)}async queryFeatureCount(e,r){return await this.load(),this.source.queryFeatureCount(this._normalizeQuery(e),r)}async queryExtent(e,r){return await this.load(),this.source.queryExtent(this._normalizeQuery(e),r)}_normalizeQuery(e){return k.from(e)??this.createQuery()}_normalizeUrls(e){return Array.isArray(e)?new i(e):e??new i}async _load(e){const r=await this.createSource(e);this._set("source",r),this.read(r.sourceJSON,{origin:"service"}),["fields"].forEach(e=>this.revertToOrigin(e,"service")),L(this.renderer,this.fieldsIndex),null==this.spatialReference&&(this.spatialReference=y.WGS84)}};e([l({readOnly:!0,json:{read:!1,write:!1}})],V.prototype,"capabilities",null),e([l({type:String})],V.prototype,"copyright",void 0),e([l({readOnly:!0})],V.prototype,"defaultPopupTemplate",null),e([l({type:String,json:{name:"layerDefinition.definitionExpression",write:{enabled:!0,allowNull:!0}}})],V.prototype,"definitionExpression",void 0),e([l()],V.prototype,"displayOptimization",void 0),e([l({type:[F],json:{name:"layerDefinition.fields",write:{ignoreOrigin:!0,isRequired:!0},origins:{service:{name:"fields"}}}})],V.prototype,"fields",void 0),e([d("fields")],V.prototype,"writeFields",null),e([l(J.fieldsIndex)],V.prototype,"fieldsIndex",void 0),e([l(N)],V.prototype,"geometryEncoding",void 0),e([l({type:m,json:{name:"extent"}})],V.prototype,"fullExtent",void 0),e([l({type:U.apiValues,json:{name:"layerDefinition.geometryType",read:{reader:U.read},write:{writer:U.write,ignoreOrigin:!0,isRequired:!0},origins:{service:{read:{source:"geometryType",reader:U.read}}}}})],V.prototype,"geometryType",void 0),e([l({readOnly:!0,clonable:!1})],V.prototype,"graphicOrigin",void 0),e([l(q)],V.prototype,"labelsVisible",void 0),e([l({type:[R],json:{name:"layerDefinition.drawingInfo.labelingInfo",read:{reader:D},write:!0}})],V.prototype,"labelingInfo",void 0),e([l(E)],V.prototype,"legendEnabled",void 0),e([l()],V.prototype,"file",void 0),e([l({type:String,readOnly:!0})],V.prototype,"objectIdField",void 0),e([l({type:["ParquetLayer"]})],V.prototype,"operationalLayerType",void 0),e([l(J.outFields)],V.prototype,"outFields",void 0),e([l(I)],V.prototype,"popupEnabled",void 0),e([l({type:r,json:{name:"popupInfo",write:!0}})],V.prototype,"popupTemplate",void 0),e([l({types:C,json:{name:"layerDefinition.drawingInfo.renderer",write:!0,origins:{service:{read:{source:"drawingInfo.renderer"}}}}})],V.prototype,"renderer",null),e([l({type:h,readOnly:!0,cast:null,json:{read:!1}})],V.prototype,"source",void 0),e([l({type:y,json:{name:"layerDefinition.spatialReference",write:{ignoreOrigin:!0,isRequired:!0},origins:{service:{read:{source:"extent.spatialReference"}}}}})],V.prototype,"spatialReference",void 0),e([l({type:[P]})],V.prototype,"templates",void 0),e([l()],V.prototype,"title",void 0),e([l({json:{read:!1},readOnly:!0})],V.prototype,"type",void 0),e([l({types:{key:"type",base:null,typeMap:{files:z,"portal-item":Q}},json:{name:"source",origins:{"web-map":{write:{target:"source",ignoreOrigin:!0}}}}})],V.prototype,"data",void 0),e([d("web-map","data")],V.prototype,"writeData",null),e([l({type:i.ofType(String),json:{read:!1,write:!1}})],V.prototype,"urls",null),V=e([u("esri.layers.ParquetLayer")],V);const A=V;export{A as default};

package/layers/SceneLayer.d.ts

@@ -344,9 +344,9 @@ export interface SceneLayerEvents extends EditBusLayerEvents, LayerEvents {}
  * [![san-francisco-buildings](https://developers.arcgis.com/javascript/latest/assets/references/core/layers/scenelayer-buildings.avif)](https://tiles.arcgis.com/tiles/z2tnIkrLQ2BRzr6P/arcgis/rest/services/SanFrancisco_Bldgs/SceneServer)
  *
  * You can find many samples of SceneLayers in ArcGIS Online by
- * [searching the gallery](https://www.arcgis.com/home/search.html?start=1&sortOrder=desc&sortField=relevance&q=&focus=layers-weblayers-scenelayers).
+ * [searching the gallery](https://www.arcgis.com/home/search.html?restrict=false&sortField=relevance&sortOrder=desc&focus=layers-weblayers-3Dlayers).
  *
- * [![city-scene-layer-guide](https://developers.arcgis.com/javascript/latest/assets/images/guide/scene-layer/city-scene-layer-guide.avif)](https://www.arcgis.com/home/search.html?start=1&sortOrder=desc&sortField=relevance&q=&focus=layers-weblayers-scenelayers)
+ * [![city-scene-layer-guide](https://developers.arcgis.com/javascript/latest/assets/references/core/layers/city-scene-layer-guide.avif)](https://www.arcgis.com/home/search.html?restrict=false&sortField=relevance&sortOrder=desc&focus=layers-weblayers-3Dlayers)
  *
  * <span id="publishing-a-scenelayer"></span>
  * ## Publishing a SceneLayer