@arcgis/core 5.2.0-next.163 → 5.2.0-next.165

package/layers/SceneLayer.d.ts

@@ -266,21 +266,33 @@ export interface SceneLayerProperties extends LayerProperties, APIKeyMixinProper
    */
   timeExtent?: TimeExtentProperties | null;
   /**
-   * TimeInfo provides information such as date fields that store
-   * [start](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#startField)
-   * and [end](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#endField) time
-   * for each feature and the [TimeInfo.fullTimeExtent](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#fullTimeExtent)
-   * for the layer.
+   * Defines temporal information for a layer, such as [start](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#startField) and [end](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#endField)
+   * date fields used to track when features remain visible, as well as the layer's [full time extent](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#fullTimeExtent).
+   * If `timeInfo` is configured on the underlying service, it is automatically read and used by the layer.
    *
-   * If timeInfo configuration exists on the service it gets read and used from there. A developer
-   * can overwrite or create a timeInfo configuration on initialization.
-   * The timeInfo parameters cannot be changed after the layer is [loaded](https://developers.arcgis.com/javascript/latest/references/core/layers/SceneLayer/#load).
+   * The `timeInfo` property can be set or overridden in the scene layer constructor or at runtime.
+   * When overriding `timeInfo`, ensure that `startField` and `endField` correspond to valid date fields in the layer's schema.
+   * To calculate a `fullTimeExtent` that covers all dates in the configured `startField` and `endField`, call
+   * the [getTimeExtentFromLayers()](https://developers.arcgis.com/javascript/latest/references/core/support/timeUtils/#getTimeExtentFromLayers) function. Then assign the result to `layer.timeInfo.fullTimeExtent`.
    *
    * TimeInfo's [startField](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#startField) and [endField](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#endField)
    * can be `date`, `date-only` or `timestamp-offset` [field type](https://developers.arcgis.com/javascript/latest/references/core/layers/support/Field/#type) for [SceneLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/SceneLayer/)
    * and [BuildingComponentSublayer](https://developers.arcgis.com/javascript/latest/references/core/layers/buildingSublayers/BuildingComponentSublayer/).
    *
    * @since 4.30
+   * @example
+   * // update layer's timeInfo at runtime
+   * sceneLayer.timeInfo = {
+   *   startField: "DateField",
+   *   timeZone: "UTC"
+   * };
+   *
+   * // calculate the fullTimeExtent based on startField
+   * const fullTimeExtent = getTimeExtentFromLayers([sceneLayer]);
+   * sceneLayer.timeInfo.fullTimeExtent = fullTimeExtent;
+   * @example
+   * // set layer's timeInfo to null
+   * sceneLayer.timeInfo = null;
    */
   timeInfo?: TimeInfoProperties | null;
   /**
@@ -1043,21 +1055,33 @@ export default class SceneLayer extends SceneLayerSuperclass {
   get timeExtent(): TimeExtent | null | undefined;
   set timeExtent(value: TimeExtentProperties | null | undefined);
   /**
-   * TimeInfo provides information such as date fields that store
-   * [start](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#startField)
-   * and [end](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#endField) time
-   * for each feature and the [TimeInfo.fullTimeExtent](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#fullTimeExtent)
-   * for the layer.
+   * Defines temporal information for a layer, such as [start](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#startField) and [end](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#endField)
+   * date fields used to track when features remain visible, as well as the layer's [full time extent](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#fullTimeExtent).
+   * If `timeInfo` is configured on the underlying service, it is automatically read and used by the layer.
    *
-   * If timeInfo configuration exists on the service it gets read and used from there. A developer
-   * can overwrite or create a timeInfo configuration on initialization.
-   * The timeInfo parameters cannot be changed after the layer is [loaded](https://developers.arcgis.com/javascript/latest/references/core/layers/SceneLayer/#load).
+   * The `timeInfo` property can be set or overridden in the scene layer constructor or at runtime.
+   * When overriding `timeInfo`, ensure that `startField` and `endField` correspond to valid date fields in the layer's schema.
+   * To calculate a `fullTimeExtent` that covers all dates in the configured `startField` and `endField`, call
+   * the [getTimeExtentFromLayers()](https://developers.arcgis.com/javascript/latest/references/core/support/timeUtils/#getTimeExtentFromLayers) function. Then assign the result to `layer.timeInfo.fullTimeExtent`.
    *
    * TimeInfo's [startField](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#startField) and [endField](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#endField)
    * can be `date`, `date-only` or `timestamp-offset` [field type](https://developers.arcgis.com/javascript/latest/references/core/layers/support/Field/#type) for [SceneLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/SceneLayer/)
    * and [BuildingComponentSublayer](https://developers.arcgis.com/javascript/latest/references/core/layers/buildingSublayers/BuildingComponentSublayer/).
    *
    * @since 4.30
+   * @example
+   * // update layer's timeInfo at runtime
+   * sceneLayer.timeInfo = {
+   *   startField: "DateField",
+   *   timeZone: "UTC"
+   * };
+   *
+   * // calculate the fullTimeExtent based on startField
+   * const fullTimeExtent = getTimeExtentFromLayers([sceneLayer]);
+   * sceneLayer.timeInfo.fullTimeExtent = fullTimeExtent;
+   * @example
+   * // set layer's timeInfo to null
+   * sceneLayer.timeInfo = null;
    */
   get timeInfo(): TimeInfo | null | undefined;
   set timeInfo(value: TimeInfoProperties | null | undefined);

package/layers/ViewshedLayer.d.ts

@@ -84,16 +84,22 @@ export interface ViewshedLayerProperties extends LayerProperties, OperationalLay
  *
  * > [!WARNING]
  * >
- * > **Known Limitations**
- * >
- * > This layer is only supported in a 3D [SceneView](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/).
- * > The results of the tool vary depending on the zoom level, as changes in zoom level affect the level of detail (LOD) of the scene geometry.
+ * > **Things to consider:**
+ * > * This analysis is only supported in a 3D [SceneView](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/).
+ * > * The results of the tool vary depending on the zoom level, as changes in zoom level affect the level of detail (LOD) of the scene geometry.
+ * > * Snapping, tooltips, display units, and input units used during interactive placement and editing are inherited from
+ * [ViewOptions](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/options/ViewOptions/).
+ * >   * Snapping is enabled by default. This can be temporarily disabled by holding the `CTRL` key.
+ * >   * Layer types currently supported for snapping are: [FeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/), [GraphicsLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/GraphicsLayer/) (except Mesh geometries),
+ * > [GeoJSONLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/GeoJSONLayer/), [WFSLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/WFSLayer/), [CSVLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/CSVLayer/),
+ * > [3D Object SceneLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/SceneLayer/), and [BuildingSceneLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/BuildingSceneLayer/).
  *
  * @since 4.31
  * @see [ViewshedLayerView](https://developers.arcgis.com/javascript/latest/references/core/views/layers/ViewshedLayerView/)
  * @see [Viewshed](https://developers.arcgis.com/javascript/latest/references/core/analysis/Viewshed/)
  * @see [ViewshedAnalysis](https://developers.arcgis.com/javascript/latest/references/core/analysis/ViewshedAnalysis/)
  * @see [ViewshedAnalysisView3D](https://developers.arcgis.com/javascript/latest/references/core/views/3d/analysis/ViewshedAnalysisView3D/)
+ * @see [ViewOptions](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/options/ViewOptions/)
  * @see [Sample - ViewshedLayer in slides](https://developers.arcgis.com/javascript/latest/sample-code/layers-viewshed/)
  */
 export default class ViewshedLayer extends ViewshedLayerSuperclass {

package/layers/WMSLayer.d.ts

@@ -3,7 +3,6 @@ import type Collection from "../core/Collection.js";
 import type Extent from "../geometry/Extent.js";
 import type SpatialReference from "../geometry/SpatialReference.js";
 import type Layer from "./Layer.js";
-import type TimeInfo from "./support/TimeInfo.js";
 import type WMSSublayer from "./support/WMSSublayer.js";
 import type TimeExtent from "../time/TimeExtent.js";
 import type TimeInterval from "../time/TimeInterval.js";
@@ -17,7 +16,6 @@ import type { PortalLayer, PortalLayerProperties } from "./mixins/PortalLayer.js
 import type { RefreshableLayer, RefreshableLayerEvents, RefreshableLayerProperties } from "./mixins/RefreshableLayer.js";
 import type { ScaleRangeLayer, ScaleRangeLayerProperties } from "./mixins/ScaleRangeLayer.js";
 import type { TemporalLayer, TemporalLayerProperties } from "./mixins/TemporalLayer.js";
-import type { TimeInfoProperties } from "./support/TimeInfo.js";
 import type { WMSDimension } from "./wms/types.js";
 import type { TimeExtentProperties } from "../time/TimeExtent.js";
 import type { TimeIntervalProperties } from "../time/TimeInterval.js";
@@ -150,39 +148,6 @@ export interface WMSLayerProperties extends LayerProperties, PortalLayerProperti
    * });
    */
   timeExtent?: TimeExtentProperties | null;
-  /**
-   * TimeInfo provides information such as date fields that store
-   * [start](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#startField)
-   * and [end](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#endField) time
-   * for each feature and the [TimeInfo.fullTimeExtent](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#fullTimeExtent)
-   * for the layer. The `timeInfo` property is automatically set at layer initialization if the layer has one or more time dimensions.
-   * The [TimeInfo.fullTimeExtent](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#fullTimeExtent) for `timeInfo` is
-   * automatically set to the union of all time dimension extents.
-   * The timeInfo parameters cannot be changed after the layer is [loaded](https://developers.arcgis.com/javascript/latest/references/core/layers/WMSLayer/#load).
-   *
-   * @since 4.17
-   * @example
-   * // create geojson layer from usgs earthquakes geojson feed
-   * const geojsonLayer = new GeoJSONLayer({
-   *   url: "https://earthquake.usgs.gov/earthquakes/feed/v1.0/summary/all_month.geojson",
-   *   copyright: "USGS Earthquakes",
-   *   fields: [
-   *     { "name": "mag", "type": "double" },
-   *     { "name": "place", "type": "string" },
-   *     { "name": "time", "type": "date" }, // date field
-   *     { "name": "depth", "type": "double" }
-   *   ],
-   *   // timeInfo can be used to do temporal queries
-   *   // set the startField and endField.
-   *   // timeExtent is automatically calculated from the
-   *   // the start and end date fields
-   *   // The date values must be in milliseconds number from the UNIX epoch specified in UTC.
-   *   timeInfo: {
-   *     startField: "time"
-   *   }
-   * });
-   */
-  timeInfo?: TimeInfoProperties | null;
   /**
    * A temporary offset of the time data based on a certain [TimeInterval](https://developers.arcgis.com/javascript/latest/references/core/time/TimeInterval/). This allows
    * users to overlay features from two or more time-aware layers with different time extents.
@@ -215,6 +180,7 @@ export interface WMSLayerProperties extends LayerProperties, PortalLayerProperti
    *     }
    *   }
    * });
+   * @see [Sample - Time Bar with actions and layer timeOffset](https://developers.arcgis.com/javascript/latest/sample-code/time-bar-time-offset/)
    * @example
    * // Offset a CSV Layer containing hurricanes from 2015 so that they appear in 2019 (+4 years).
    * let layer = new CSVLayer({
@@ -678,40 +644,6 @@ export default class WMSLayer extends WMSLayerSuperclass {
    */
   get timeExtent(): TimeExtent | null | undefined;
   set timeExtent(value: TimeExtentProperties | null | undefined);
-  /**
-   * TimeInfo provides information such as date fields that store
-   * [start](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#startField)
-   * and [end](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#endField) time
-   * for each feature and the [TimeInfo.fullTimeExtent](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#fullTimeExtent)
-   * for the layer. The `timeInfo` property is automatically set at layer initialization if the layer has one or more time dimensions.
-   * The [TimeInfo.fullTimeExtent](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#fullTimeExtent) for `timeInfo` is
-   * automatically set to the union of all time dimension extents.
-   * The timeInfo parameters cannot be changed after the layer is [loaded](https://developers.arcgis.com/javascript/latest/references/core/layers/WMSLayer/#load).
-   *
-   * @since 4.17
-   * @example
-   * // create geojson layer from usgs earthquakes geojson feed
-   * const geojsonLayer = new GeoJSONLayer({
-   *   url: "https://earthquake.usgs.gov/earthquakes/feed/v1.0/summary/all_month.geojson",
-   *   copyright: "USGS Earthquakes",
-   *   fields: [
-   *     { "name": "mag", "type": "double" },
-   *     { "name": "place", "type": "string" },
-   *     { "name": "time", "type": "date" }, // date field
-   *     { "name": "depth", "type": "double" }
-   *   ],
-   *   // timeInfo can be used to do temporal queries
-   *   // set the startField and endField.
-   *   // timeExtent is automatically calculated from the
-   *   // the start and end date fields
-   *   // The date values must be in milliseconds number from the UNIX epoch specified in UTC.
-   *   timeInfo: {
-   *     startField: "time"
-   *   }
-   * });
-   */
-  get timeInfo(): TimeInfo | null | undefined;
-  set timeInfo(value: TimeInfoProperties | null | undefined);
   /**
    * A temporary offset of the time data based on a certain [TimeInterval](https://developers.arcgis.com/javascript/latest/references/core/time/TimeInterval/). This allows
    * users to overlay features from two or more time-aware layers with different time extents.
@@ -744,6 +676,7 @@ export default class WMSLayer extends WMSLayerSuperclass {
    *     }
    *   }
    * });
+   * @see [Sample - Time Bar with actions and layer timeOffset](https://developers.arcgis.com/javascript/latest/sample-code/time-bar-time-offset/)
    * @example
    * // Offset a CSV Layer containing hurricanes from 2015 so that they appear in 2019 (+4 years).
    * let layer = new CSVLayer({

package/layers/mixins/ReloadableLayer.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{__decorate as e}from"tslib";import{abortHandle as t}from"../../core/handleUtils.js";import{debounce as n,throwIfAbortError as r}from"../../core/promiseUtils.js";import{property as i,subclass as a}from"../../core/accessorSupport/decorators.js";import{getOwningPortalUrl as o}from"../support/layerUtils.js";import s from"../../portal/Portal.js";import c from"../../portal/PortalItem.js";const l=`reload`,u=u=>{let d=u,f=class extends d{constructor(...e){super(...e),this._loadTimestamp=0,this._pendingReloadCount=0,this._serviceItemModified=null,this._debounceReload=n(async()=>{if(this.destroyed||!this.loaded||!this.canReload())return!1;let e=new AbortController;this.addHandles(t(e),l);try{let t=null,n;if(this.portalItem?.id&&this.portalItem.id===this.serviceItemId)n=await this.reloadFromPortal({supportedTypes:this.supportedPortalItemTypes},{signal:e.signal});else{let r=await this._shouldReloadFromServiceItem(e.signal);n=r.updated,t=r.modified}return n&&await this.reloadFromService(e.signal),e.signal.throwIfAborted(),t!=null&&(this._serviceItemModified=t),n}finally{this.removeHandles(l)}}),this.when().then(()=>{this._loadTimestamp=Date.now()},()=>{})}get reloading(){return this._pendingReloadCount>0}reload(){return this.destroyed||!this.loaded||!this.canReload()?Promise.resolve(!1):(this._pendingReloadCount++,this._debounceReload().finally(()=>{this._pendingReloadCount--}))}canReload(){return this.url!=null}async _shouldReloadFromServiceItem(e){let{serviceItemId:t,url:n}=this;if(!t||!n)return{modified:null,updated:!0};try{let r=await o(n,{signal:e});if(!r)return{modified:null,updated:!0};let i=new s({url:r}),a=new c({apiKey:this.apiKey,id:t,portal:i});await a.load({signal:e});let l=a.modified?.getTime();if(l==null)return{modified:null,updated:!0};let u=this._serviceItemModified;return{modified:l,updated:u==null?l>this._loadTimestamp:u<l}}catch(e){return r(e),{modified:null,updated:!0}}}};return e([i({clonable:!1})],f.prototype,`_pendingReloadCount`,void 0),e([i({readOnly:!0})],f.prototype,`reloading`,null),f=e([a(`esri.layers.mixins.ReloadableLayer`)],f),f};export{u as ReloadableLayer};
+import{__decorate as e}from"tslib";import{abortHandle as t}from"../../core/handleUtils.js";import{debounce as n,throwIfAbortError as r}from"../../core/promiseUtils.js";import{property as i,subclass as a}from"../../core/accessorSupport/decorators.js";import{getOwningPortalUrl as o}from"../support/layerUtils.js";import s from"../../portal/Portal.js";import c from"../../portal/PortalItem.js";const l=`reload`,u=u=>{let d=u,f=class extends d{constructor(...e){super(...e),this._loadTimestamp=0,this._pendingReloadCount=0,this._serviceItemModified=null,this._debounceReload=n(async()=>{if(this.destroyed||!this.loaded||!this.canReload())return!1;let e=new AbortController;this.addHandles(t(e),l);try{let t=null,n=!!this.portalItem?.id&&this.portalItem.id===this.serviceItemId,r=this.portalItem?.id?await this.reloadFromPortal({supportedTypes:this.supportedPortalItemTypes},{signal:e.signal}):!1,i;if(n)i=r;else{let n=await this._shouldReloadFromServiceItem(e.signal);i=n.updated,t=n.modified}return i&&await this.reloadFromService(e.signal),e.signal.throwIfAborted(),t!=null&&(this._serviceItemModified=t),i||r}finally{this.removeHandles(l)}}),this.when().then(()=>{this._loadTimestamp=Date.now()},()=>{})}get reloading(){return this._pendingReloadCount>0}reload(){return this.destroyed||!this.loaded||!this.canReload()?Promise.resolve(!1):(this._pendingReloadCount++,this._debounceReload().finally(()=>{this._pendingReloadCount--}))}canReload(){return this.url!=null}async _shouldReloadFromServiceItem(e){let{serviceItemId:t,url:n}=this;if(!t||!n)return{modified:null,updated:!0};try{let r=await o(n,{signal:e});if(!r)return{modified:null,updated:!0};let i=new s({url:r}),a=new c({apiKey:this.apiKey,id:t,portal:i});await a.load({signal:e});let l=a.modified?.getTime();if(l==null)return{modified:null,updated:!0};let u=this._serviceItemModified;return{modified:l,updated:u==null?l>this._loadTimestamp:u<l}}catch(e){return r(e),{modified:null,updated:!0}}}};return e([i({clonable:!1})],f.prototype,`_pendingReloadCount`,void 0),e([i({readOnly:!0})],f.prototype,`reloading`,null),f=e([a(`esri.layers.mixins.ReloadableLayer`)],f),f};export{u as ReloadableLayer};

package/layers/mixins/SublayersOwner.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{__decorate as e}from"tslib";import t from"../../core/Collection.js";import n from"../../core/CollectionFlattener.js";import r from"../../core/Error.js";import i from"../../core/Logger.js";import{watch as a,sync as o}from"../../core/reactiveUtils.js";import{property as s,subclass as c}from"../../core/accessorSupport/decorators.js";import{nameToId as l,idToName as u}from"../../core/accessorSupport/PropertyOrigin.js";import{getProperties as d}from"../../core/accessorSupport/utils.js";import f from"../support/Sublayer.js";import{isSublayerOverhaul as p}from"../support/sublayerUtils.js";function m(e,t){let n=[],r={};return e&&e.forEach(e=>{let i=new f;if(i.read(e,t),r[i.id]=i,e.parentLayerId!=null&&e.parentLayerId!==-1){let t=r[e.parentLayerId];t.sublayers||=[],t.sublayers.unshift(i)}else n.unshift(i)}),n}const h=t.ofType(f);function g(e,t){e&&e.forEach(e=>{t(e),e.sublayers&&e.sublayers.length&&g(e.sublayers,t)})}const _=_=>{let v=_,y=class extends v{constructor(...e){super(...e),this.allSublayers=new n({getCollections:()=>[this.sublayers],getChildrenFunction(e){return e.sublayers}}),this.sublayersSourceJSON={2:{},3:{},4:{},5:{},6:{}},this.subtables=null,this.addHandles([a(()=>this.sublayers,(e,t)=>this._handleSublayersChange(e,t),o),a(()=>this.subtables,(e,t)=>this._handleSublayersChange(e,t),o)])}destroy(){this.allSublayers.destroy()}readSublayers(e,t){if(!t||!e)return;let{sublayersSourceJSON:n}=this,r=l(t.origin);if(r<2||(n[r]={context:t,visibleLayers:e.visibleLayers||n[r].visibleLayers,layers:e.layers||n[r].layers},r>2))return;this._set(`serviceSublayers`,this.createSublayersForOrigin(`service`).sublayers);let{sublayers:i,origin:a}=this.createSublayersForOrigin(`web-document`),o=d(this);o.setDefaultOrigin(a),this._set(`sublayers`,new h(i)),o.setDefaultOrigin(`user`)}findSublayerById(e){return this.allSublayers.find(t=>t.id===e)}createServiceSublayers(){return this.createSublayersForOrigin(`service`).sublayers}createSublayersForOrigin(e){let t,n=l(e===`web-document`?`web-map`:e),r=2,i=this.sublayersSourceJSON[2].layers,a=this.sublayersSourceJSON[2].context,o=null,s=[3,4,5].filter(e=>e<=n);for(let e of s){let t=this.sublayersSourceJSON[e];p(t.layers)&&(r=e,i=t.layers,a=t.context,t.visibleLayers&&(o={visibleLayers:t.visibleLayers,context:t.context}))}let c=[3,4,5].filter(e=>e>r&&e<=n),d=null;for(let e of c){let{layers:n,visibleLayers:r,context:i}=this.sublayersSourceJSON[e];n&&(d={layers:n,context:i},t??=e),r&&(o={visibleLayers:r,context:i})}let f=m(i,a),_=new Map,v=new Set;if(d)for(let e of d.layers)_.set(e.id,e);if(o?.visibleLayers)for(let e of o.visibleLayers)v.add(e);return g(f,e=>{d&&e.read(_.get(e.id),d.context),o&&e.read({defaultVisibility:v.has(e.id)},o.context)}),{origin:u(r),originWithPartialOverrides:t?u(t):null,sublayers:new h({items:f})}}read(e,t){super.read(e,t),this.readSublayers(e,t)}_handleSublayersChange(e,t){t&&(t.forEach(e=>{e.parent=null,e.layer=null}),this.removeHandles(`sublayers-owner`)),e&&(e.forEach(e=>{e.parent=this,e.layer=this}),this.addHandles([e.on(`after-add`,({item:e})=>{e.parent=this,e.layer=this}),e.on(`after-remove`,({item:e})=>{e.parent=null,e.layer=null})],`sublayers-owner`),this.type===`tile`&&this.addHandles(e.on(`before-changes`,e=>{i.getLogger(`esri.layers.TileLayer`).error(new r(`tilelayer:sublayers-non-modifiable`,`Sublayer can't be added, moved, or removed from the layer's sublayers`,{layer:this})),e.preventDefault()}),`sublayers-owner`))}};return e([s({readOnly:!0})],y.prototype,`allSublayers`,void 0),e([s({readOnly:!0})],y.prototype,`effectiveScaleRange`,void 0),e([s({readOnly:!0,type:t.ofType(f)})],y.prototype,`serviceSublayers`,void 0),e([s({value:null,type:h,json:{read:!1,write:{allowNull:!0,ignoreOrigin:!0}}})],y.prototype,`sublayers`,void 0),e([s({readOnly:!0})],y.prototype,`sublayersSourceJSON`,void 0),e([s({type:h,json:{read:{source:`tables`}}})],y.prototype,`subtables`,void 0),y=e([c(`esri.layers.mixins.SublayersOwner`)],y),y};export{_ as SublayersOwner,g as forEachSublayer};
+import{__decorate as e}from"tslib";import t from"../../core/Collection.js";import n from"../../core/CollectionFlattener.js";import r from"../../core/Error.js";import i from"../../core/Logger.js";import{watch as a,sync as o}from"../../core/reactiveUtils.js";import{property as s,subclass as c}from"../../core/accessorSupport/decorators.js";import{nameToId as l,idToName as u}from"../../core/accessorSupport/PropertyOrigin.js";import{getProperties as d}from"../../core/accessorSupport/utils.js";import f from"../support/Sublayer.js";import{isSublayerOverhaul as p}from"../support/sublayerUtils.js";function m(e,t){let n=[],r={};return e&&e.forEach(e=>{let i=new f;if(i.read(e,t),r[i.id]=i,e.parentLayerId!=null&&e.parentLayerId!==-1){let t=r[e.parentLayerId];t.sublayers||=[],t.sublayers.unshift(i)}else n.unshift(i)}),n}const h=t.ofType(f);function g(e,t){e&&e.forEach(e=>{t(e),e.sublayers&&e.sublayers.length&&g(e.sublayers,t)})}const _=_=>{let v=_,y=class extends v{constructor(...e){super(...e),this.allSublayers=new n({getCollections:()=>[this.sublayers],getChildrenFunction(e){return e.sublayers}}),this.sublayersSourceJSON={2:{},3:{},4:{},5:{},6:{}},this.subtables=null,this.addHandles([a(()=>this.sublayers,(e,t)=>this._handleSublayersChange(e,t),o),a(()=>this.subtables,(e,t)=>this._handleSublayersChange(e,t),o)])}destroy(){this.allSublayers.destroy()}readSublayers(e,t){if(!t||!e)return;let{sublayersSourceJSON:n}=this,r=l(t.origin);if(r<2||(n[r]={context:t,visibleLayers:e.visibleLayers||n[r].visibleLayers,layers:e.layers||n[r].layers},r>2))return;this._set(`serviceSublayers`,this.createSublayersForOrigin(`service`).sublayers);let{sublayers:i,origin:a}=this.createSublayersForOrigin(`web-document`),o=d(this);o.setDefaultOrigin(a),this._set(`sublayers`,new h(i)),o.setDefaultOrigin(`user`)}findSublayerById(e){return this.allSublayers.find(t=>t.id===e)}createServiceSublayers(){return this.createSublayersForOrigin(`service`).sublayers}createSublayersForOrigin(e){let t,n=l(e===`web-document`?`web-map`:e),r=2,i=this.sublayersSourceJSON[2].layers,a=this.sublayersSourceJSON[2].context,o=null,s=[3,4,5].filter(e=>e<=n);for(let e of s){let t=this.sublayersSourceJSON[e];p(t.layers)&&(r=e,i=t.layers,a=t.context,t.visibleLayers&&(o={visibleLayers:t.visibleLayers,context:t.context}))}let c=[3,4,5].filter(e=>e>r&&e<=n),d=null;for(let e of c){let{layers:n,visibleLayers:r,context:i}=this.sublayersSourceJSON[e];n&&(d={layers:n,context:i},t??=e),r&&(o={visibleLayers:r,context:i})}let f=m(i,a),_=new Map,v=new Set;if(d)for(let e of d.layers)_.set(e.id,e);if(o?.visibleLayers)for(let e of o.visibleLayers)v.add(e);return g(f,e=>{d&&e.read(_.get(e.id),d.context),o&&e.read({defaultVisibility:v.has(e.id)},o.context)}),{origin:u(r),originWithPartialOverrides:t?u(t):null,sublayers:new h({items:f})}}read(e,t){super.read(e,t),this.readSublayers(e,t)}_handleSublayersChange(e,t){t&&(t.forEach(e=>{e.parent=null,e.layer=null}),this.removeHandles(`sublayers-owner`)),e&&(e.forEach(e=>{e.parent=this,e.layer=this}),this.addHandles([e.on(`after-add`,({item:e})=>{e.parent=this,e.layer=this}),e.on(`after-remove`,({item:e})=>{e.parent=null,e.layer=null})],`sublayers-owner`),this.type===`tile`&&this.addHandles(e.on(`before-changes`,e=>{i.getLogger(`esri.layers.TileLayer`).error(new r(`tilelayer:sublayers-non-modifiable`,`Sublayer can't be added, moved, or removed from the layer's sublayers`,{layer:this})),e.preventDefault()}),`sublayers-owner`))}};return e([s({readOnly:!0})],y.prototype,`allSublayers`,void 0),e([s({readOnly:!0})],y.prototype,`effectiveScaleRange`,void 0),e([s({readOnly:!0})],y.prototype,`effectiveVisible`,void 0),e([s({readOnly:!0,type:t.ofType(f)})],y.prototype,`serviceSublayers`,void 0),e([s({value:null,type:h,json:{read:!1,write:{allowNull:!0,ignoreOrigin:!0}}})],y.prototype,`sublayers`,void 0),e([s({readOnly:!0})],y.prototype,`sublayersSourceJSON`,void 0),e([s({type:h,json:{read:{source:`tables`}}})],y.prototype,`subtables`,void 0),y=e([c(`esri.layers.mixins.SublayersOwner`)],y),y};export{_ as SublayersOwner,g as forEachSublayer};

package/layers/mixins/TemporalLayer.d.ts

@@ -57,28 +57,24 @@ export interface TemporalLayerProperties extends Partial<Pick<TemporalLayer, "us
    */
   timeExtent?: TimeExtentProperties | null;
   /**
-   * TimeInfo provides information such as date fields that store
-   * [start](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#startField)
-   * and [end](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#endField) time
-   * for each feature and the [fullTimeExtent](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#fullTimeExtent)
-   * for the layer. The `timeInfo` property, along with its `startField` and `endField` properties, must be set at the
-   * time of layer initialization if it is being set for a
-   * [CSVLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/CSVLayer/),
-   * [GeoJSONLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/GeoJSONLayer/),
-   * [OGCFeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/OGCFeatureLayer/) or
-   * [FeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/)
-   * initialized from [client-side features](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#creating-a-featurelayer).
-   * The [fullTimeExtent](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#fullTimeExtent) for `timeInfo` is
-   * automatically calculated based on its `startField` and `endField` properties.
-   * The timeInfo parameters cannot be changed after the layer is [loaded](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#load).
+   * Defines temporal information for a layer, such as [start](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#startField) and [end](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#endField)
+   * date fields used to track when features remain visible, as well as the layer's [full time extent](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#fullTimeExtent).
+   * If `timeInfo` is configured on the underlying service, it is automatically read and used by the layer.
    *
-   * TimeInfo's [TimeInfo.startField](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#startField) and [endField](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#startField)
-   * can be `date`, `date-only` or `timestamp-offset` [field type](https://developers.arcgis.com/javascript/latest/references/core/layers/support/Field/#type) for [FeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/)
-   * and [MapImageLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/MapImageLayer/).
+   * The `timeInfo` can be set or overridden on the following feature based layers in the layer constructor or at runtime: [AnnotationFeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/AnnotationFeatureLayer/),
+   * [CSVLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/CSVLayer/), [CatalogLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/CatalogLayer/), [DimensionFeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/DimensionFeatureLayer/), [FeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/),
+   * [GeoJSONLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/GeoJSONLayer/), [OGCFeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/OGCFeatureLayer/), [OrientedImageryLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/OrientedImageryLayer/), [SceneLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/SceneLayer/),
+   * [StreamLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/StreamLayer/), and [SubtypeGroupLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/SubtypeGroupLayer/).
    *
-   * @since 4.11
+   * When overriding a layer's `timeInfo`, ensure that `startField` and `endField` correspond to valid date fields in the layer's schema.
+   * To calculate a `fullTimeExtent` that covers all dates in the configured `startField` and `endField`, call
+   * [getTimeExtentFromLayers()](https://developers.arcgis.com/javascript/latest/references/core/support/timeUtils/#getTimeExtentFromLayers) method. Then assign the result to `layer.timeInfo.fullTimeExtent`.
+   *
+   * The `startField` and `endField` properties accept `date`, `date-only`, or `timestamp-offset` field types.
+   *
+   * @see [Samples using time-aware layers](https://developers.arcgis.com/javascript/latest/sample-code/?tagged=arcgis-time-bar)
    * @example
-   * // create geojson layer from usgs earthquakes geojson feed
+   * // create geojson layer from USGS earthquakes GeoJSON feed
    * const geojsonLayer = new GeoJSONLayer({
    *   url: "https://earthquake.usgs.gov/earthquakes/feed/v1.0/summary/all_month.geojson",
    *   copyright: "USGS Earthquakes",
@@ -89,14 +85,28 @@ export interface TemporalLayerProperties extends Partial<Pick<TemporalLayer, "us
    *     { "name": "depth", "type": "double" }
    *   ],
    *   // timeInfo can be used to do temporal queries
-   *   // set the startField and endField.
-   *   // timeExtent is automatically calculated from the
-   *   // the start and end date fields
-   *   // The date values must be in milliseconds number from the UNIX epoch specified in UTC.
    *   timeInfo: {
-   *     startField: "time"
+   *     startField: "time",
+   *     fullTimeExtent: {
+   *       start: new Date(1970, 0, 1),
+   *       end: new Date(2000, 11, 31)
+   *     },
+   *     timeZone: "UTC"
    *   }
    * });
+   * @example
+   * // update layer's timeInfo at runtime after the feature layer is loaded
+   * featureLayer.timeInfo = {
+   *   startField: "DateField",
+   *   timeZone: "UTC"
+   * };
+   *
+   * // calculate the fullTimeExtent based on startField
+   * const fullTimeExtent = getTimeExtentFromLayers([featureLayer]);
+   * featureLayer.timeInfo.fullTimeExtent = fullTimeExtent;
+   * @example
+   * // set layer's timeInfo to null
+   * layer.timeInfo = null;
    */
   timeInfo?: TimeInfoProperties | null;
   /**
@@ -107,6 +117,7 @@ export interface TemporalLayerProperties extends Partial<Pick<TemporalLayer, "us
    * A time offset can be used for display purposes only. The query and selection are not affected by the offset.
    *
    * @since 4.14
+   * @see [Sample - Time Bar with actions and layer timeOffset](https://developers.arcgis.com/javascript/latest/sample-code/time-bar-time-offset/)
    * @example
    * // Offset a CSV Layer containing hurricanes from 2015 so that they appear in 2019 (+4 years).
    * let layer = new CSVLayer({
@@ -195,28 +206,24 @@ export abstract class TemporalLayer {
   get timeExtent(): TimeExtent | null | undefined;
   set timeExtent(value: TimeExtentProperties | null | undefined);
   /**
-   * TimeInfo provides information such as date fields that store
-   * [start](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#startField)
-   * and [end](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#endField) time
-   * for each feature and the [fullTimeExtent](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#fullTimeExtent)
-   * for the layer. The `timeInfo` property, along with its `startField` and `endField` properties, must be set at the
-   * time of layer initialization if it is being set for a
-   * [CSVLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/CSVLayer/),
-   * [GeoJSONLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/GeoJSONLayer/),
-   * [OGCFeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/OGCFeatureLayer/) or
-   * [FeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/)
-   * initialized from [client-side features](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#creating-a-featurelayer).
-   * The [fullTimeExtent](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#fullTimeExtent) for `timeInfo` is
-   * automatically calculated based on its `startField` and `endField` properties.
-   * The timeInfo parameters cannot be changed after the layer is [loaded](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#load).
+   * Defines temporal information for a layer, such as [start](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#startField) and [end](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#endField)
+   * date fields used to track when features remain visible, as well as the layer's [full time extent](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#fullTimeExtent).
+   * If `timeInfo` is configured on the underlying service, it is automatically read and used by the layer.
    *
-   * TimeInfo's [TimeInfo.startField](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#startField) and [endField](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#startField)
-   * can be `date`, `date-only` or `timestamp-offset` [field type](https://developers.arcgis.com/javascript/latest/references/core/layers/support/Field/#type) for [FeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/)
-   * and [MapImageLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/MapImageLayer/).
+   * The `timeInfo` can be set or overridden on the following feature based layers in the layer constructor or at runtime: [AnnotationFeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/AnnotationFeatureLayer/),
+   * [CSVLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/CSVLayer/), [CatalogLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/CatalogLayer/), [DimensionFeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/DimensionFeatureLayer/), [FeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/),
+   * [GeoJSONLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/GeoJSONLayer/), [OGCFeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/OGCFeatureLayer/), [OrientedImageryLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/OrientedImageryLayer/), [SceneLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/SceneLayer/),
+   * [StreamLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/StreamLayer/), and [SubtypeGroupLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/SubtypeGroupLayer/).
    *
-   * @since 4.11
+   * When overriding a layer's `timeInfo`, ensure that `startField` and `endField` correspond to valid date fields in the layer's schema.
+   * To calculate a `fullTimeExtent` that covers all dates in the configured `startField` and `endField`, call
+   * [getTimeExtentFromLayers()](https://developers.arcgis.com/javascript/latest/references/core/support/timeUtils/#getTimeExtentFromLayers) method. Then assign the result to `layer.timeInfo.fullTimeExtent`.
+   *
+   * The `startField` and `endField` properties accept `date`, `date-only`, or `timestamp-offset` field types.
+   *
+   * @see [Samples using time-aware layers](https://developers.arcgis.com/javascript/latest/sample-code/?tagged=arcgis-time-bar)
    * @example
-   * // create geojson layer from usgs earthquakes geojson feed
+   * // create geojson layer from USGS earthquakes GeoJSON feed
    * const geojsonLayer = new GeoJSONLayer({
    *   url: "https://earthquake.usgs.gov/earthquakes/feed/v1.0/summary/all_month.geojson",
    *   copyright: "USGS Earthquakes",
@@ -227,14 +234,28 @@ export abstract class TemporalLayer {
    *     { "name": "depth", "type": "double" }
    *   ],
    *   // timeInfo can be used to do temporal queries
-   *   // set the startField and endField.
-   *   // timeExtent is automatically calculated from the
-   *   // the start and end date fields
-   *   // The date values must be in milliseconds number from the UNIX epoch specified in UTC.
    *   timeInfo: {
-   *     startField: "time"
+   *     startField: "time",
+   *     fullTimeExtent: {
+   *       start: new Date(1970, 0, 1),
+   *       end: new Date(2000, 11, 31)
+   *     },
+   *     timeZone: "UTC"
    *   }
    * });
+   * @example
+   * // update layer's timeInfo at runtime after the feature layer is loaded
+   * featureLayer.timeInfo = {
+   *   startField: "DateField",
+   *   timeZone: "UTC"
+   * };
+   *
+   * // calculate the fullTimeExtent based on startField
+   * const fullTimeExtent = getTimeExtentFromLayers([featureLayer]);
+   * featureLayer.timeInfo.fullTimeExtent = fullTimeExtent;
+   * @example
+   * // set layer's timeInfo to null
+   * layer.timeInfo = null;
    */
   get timeInfo(): TimeInfo | null | undefined;
   set timeInfo(value: TimeInfoProperties | null | undefined);
@@ -246,6 +267,7 @@ export abstract class TemporalLayer {
    * A time offset can be used for display purposes only. The query and selection are not affected by the offset.
    *
    * @since 4.14
+   * @see [Sample - Time Bar with actions and layer timeOffset](https://developers.arcgis.com/javascript/latest/sample-code/time-bar-time-offset/)
    * @example
    * // Offset a CSV Layer containing hurricanes from 2015 so that they appear in 2019 (+4 years).
    * let layer = new CSVLayer({

package/layers/mixins/TiledImagery.d.ts

@@ -4,7 +4,6 @@ import type SpatialReference from "../../geometry/SpatialReference.js";
 import type DimensionalDefinition from "../support/DimensionalDefinition.js";
 import type MultidimensionalSubset from "../support/MultidimensionalSubset.js";
 import type RasterInfo from "../support/RasterInfo.js";
-import type TimeInfo from "../support/TimeInfo.js";
 import type ImageSampleParameters from "../../rest/support/ImageSampleParameters.js";
 import type ImageSampleResult from "../../rest/support/ImageSampleResult.js";
 import type TimeExtent from "../../time/TimeExtent.js";
@@ -273,16 +272,6 @@ export abstract class TiledImagery {
    * });
    */
   abstract accessor timeExtent: TimeExtent | null | undefined;
-  /**
-   * TimeInfo provides information such as date fields that store
-   * [start](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#startField)
-   * and [end](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#endField) time
-   * for each feature and the [TimeInfo.fullTimeExtent](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TimeInfo/#fullTimeExtent)
-   * for the layer.
-   *
-   * @since 4.22
-   */
-  abstract accessor timeInfo: TimeInfo | null | undefined;
   /**
    * A temporary offset of the time data based on a certain [TimeInterval](https://developers.arcgis.com/javascript/latest/references/core/time/TimeInterval/). This allows
    * users to overlay features from two or more time-aware layers with different time extents.

package/layers/orientedImagery/transformations/utils.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import e from"../../../core/Error.js";import{rad2deg as t,deg2rad as n}from"../../../core/mathUtils.js";import{create as r}from"../../../core/libs/gl-matrix-2/factories/mat3f64.js";import{create as i,fromValues as a}from"../../../core/libs/gl-matrix-2/factories/mat4f64.js";import{zeros as o,create as s}from"../../../core/libs/gl-matrix-2/factories/vec3f64.js";import{fromArray as c}from"../../../core/libs/gl-matrix-2/factories/vec4f64.js";import{transpose as l,multiply as u}from"../../../core/libs/gl-matrix-2/math/mat3.js";import{invertOrIdentity as d,mul as f}from"../../../core/libs/gl-matrix-2/math/mat4.js";import{scale as p,sub as m,add as h}from"../../../core/libs/gl-matrix-2/math/vec3.js";import{isSerializable as g}from"../../../core/support/jsonUtils.js";import _ from"../../../geometry/Point.js";import{projectAsync as v}from"../../../geometry/projectionUtils.js";import{earth as y}from"../../../geometry/support/Ellipsoid.js";import{isWebMercator as b}from"../../../geometry/support/spatialReferenceUtils.js";import{a as x}from"../../../chunks/vec3.js";import{isConstantElevation as S,ConstantElevation as C,isElevationSource as w}from"../core/ElevationSourceDefinitions.js";import{getMetersPerUnitOfSR as T}from"../core/utils.js";import{getElevationSampler as ee}from"./updateElevationUtils.js";import{isNumber as E}from"../../../support/guards.js";import{defaultImageSphereSize as D}from"../../../widgets/PanoramicViewer/constants.js";function O(e,t,n){let[r,a,o,s]=t,[c,l,u,p]=n;k(r,a,o,s);let m=k(c,l,u,p),h=A(r,a,o,s),g=A(c,l,u,p),_=d(i(),h),[v,y,b,x]=ne(e,f(i(),_,g));return[v/x,y/x,m?0:b/x]}function k(e,t,n,r){return e[2]===0&&t[2]===0&&n[2]===0&&r[2]===0&&(e[2]=t[2]=n[2]=r[2]=1,!0)}function te(e){return e===0?1:e}function ne(e,t){let[n,r,i]=e,a=[0,0,0,0];return a[0]=n*t[0]+r*t[1]+i*t[2]+t[3],a[1]=n*t[4]+r*t[5]+i*t[6]+t[7],a[2]=n*t[8]+r*t[9]+i*t[10]+t[11],a[3]=te(n*t[12]+r*t[13]+i*t[14]+t[15]),a}function A(e,t,n,r){let o=re(c([...r,1]),d(Array(16),a(e[0],t[0],n[0],0,e[1],t[1],n[1],0,e[2],t[2],n[2],0,1,1,1,1))),s=o[0],l=o[1],u=o[2],f=i();return f[0]=s*e[0],f[1]=l*t[0],f[2]=u*n[0],f[3]=0,f[4]=s*e[1],f[5]=l*t[1],f[6]=u*n[1],f[7]=0,f[8]=s*e[2],f[9]=l*t[2],f[10]=u*n[2],f[11]=0,f[12]=s,f[13]=l,f[14]=u,f[15]=1,f}function j(e,t,n,r,i=o()){return i[0]=e[0]+t[0]*n,i[1]=e[1]+t[1]*n,i[2]=e[2]+t[2]*(n/r),i}function M(e,t,n){let r=o();return r[0]=e[0]*t,r[1]=e[1]*t,r[2]=e[2]*(t/n),r}function N(e,t){let[n,r,i]=e,a=o();return a[0]=n*t[0]+r*t[3]+i*t[6],a[1]=n*t[1]+r*t[4]+i*t[7],a[2]=n*t[2]+r*t[5]+i*t[8],a}function re(e,t){let[n,r,i,a]=e,o=[,,,,];return o[0]=n*t[0]+r*t[1]+i*t[2]+a*t[3],o[1]=n*t[4]+r*t[5]+i*t[6]+a*t[7],o[2]=n*t[8]+r*t[9]+i*t[10]+a*t[11],o[3]=n*t[12]+r*t[13]+i*t[14]+a*t[15],o}function ie(t,i,a,o=!0){if(!Number.isFinite(t))throw new e(`InvalidRotationAngle`,`Please specify a valid angle for rotation`);let s=a*(o?n(t):t),c=Math.cos(s),l=Math.sin(s),u=r();switch(i){case 0:u[4]=c,u[5]=-l,u[7]=l,u[8]=c;break;case 1:u[0]=c,u[2]=l,u[6]=-l,u[8]=c;break;case 2:u[0]=c,u[1]=-l,u[3]=l,u[4]=c;break;default:throw new e(`InvalidRotationAxis`,`Please specify either 0, 1 or 2 for X, Y or Z axis respectively`)}return u}const P={HPR:[[2,-1],[0,1],[2,-1]],OPK:[[0,1],[1,1],[2,1]],YPR:[[0,-1],[1,-1],[2,-1]]};function F(t,n,i=!0){if(t?.length!==3||n?.length!==3)throw new e(`InvalidRotationAngles`,`Please specify three angles with config for rotation`);let a=r();for(let e=0;e<3;e++){let[r,o]=n[e],s=ie(t[e],r,o,i);u(a,s,a)}return a}function I(e,t=!0){return F(e,P.OPK,t)}function L(e,t=!0){return F(e,P.HPR,t)}function ae(e,t,r){let i=Math.sin(n(r)),a=Math.cos(n(r)),o=[[e,0],[e,t],[0,t]];o.forEach((e,t)=>{o[t]=[a*e[0]-i*e[1],i*e[0]+a*e[1]]});let s={xmin:Math.min(0,o[0][0],o[1][0],o[2][0]),xmax:Math.max(0,o[0][0],o[1][0],o[2][0]),ymin:Math.min(0,o[0][1],o[1][1],o[2][1]),ymax:Math.max(0,o[0][1],o[1][1],o[2][1])};return{hfov:Math.abs(s.xmax-s.xmin),vfov:Math.abs(s.ymax-s.ymin)}}function oe(e,r){let i=Number(e[0]),a=Number(e[1]),o=Number(e[2]),[s,c,l,u]=r,d=n(s),f=n(c),p=l/Math.sqrt(1-u*Math.sin(d)**2),m=i/p,h=a/p,g=o/p,_=Math.cos(d)-Math.sin(d)*h+Math.cos(d)*g,v=Math.sin(d)+Math.cos(d)*h+Math.sin(d)*g,y=Math.sqrt(_**2+m**2),b=u*p*Math.sin(d),x=(e,t=5)=>{if(t===0)return e;let n=x(e,t-1);return Math.atan(v/y-(b-u*(l/Math.sqrt(1-u*Math.sin(n)**2))*Math.sin(n))/(p*y))},S=x(d),C=Math.atan(i/(p*_))+f,w=t(S);return[t(C),w,i/(Math.cos(S)*Math.sin(C-f))-l/Math.sqrt(1-u*Math.sin(S)**2)]}function R(e,t,n){let r=360/t,i=180/n,a=e.x-t/2,o=e.y-n/2;return{heading:a*r,pitch:90-o*i}}function se(e,t,n,r,i=D/2){let{heading:a,pitch:o}=B(e,i),s=r?$(a,o,r):[a,o];return{heading:a,pitch:o,...z(s[0],s[1],t,n)}}function z(e,t,n,r){let i=360/n,a=180/r,o=e%360,s=o<-180?o+360:o>180?o-360:o;return{x:n/2+s/i,y:r-t/a}}function B(e,n){let r=t(Math.acos(-e.z/n));return{heading:t(Math.atan2(e.x,e.y)),pitch:r}}function V(e,t){return[Math.sin(n(e))*Math.sin(n(t)),Math.cos(n(e))*Math.sin(n(t)),Math.cos(n(180-t))]}function H(e,t,n,r=D/2){let i=n?$(e,t,n,!0):[e,t];return p(s(),V(i[0],i[1]),r)}function ce(e,t,n,r,i=D/2){let{heading:a,pitch:o}=R(e,t,n);return H(a,o,r,i)}async function le(e,n,r){let i=await v(n,e.spatialReference,r),a=t(Math.atan2(i.y-e.y,i.x-e.x));return a=a>=0&&a<=90?90-a:a>90&&a<=180?360-a+90:90+Math.abs(a),a}function ue(e,t,n){let r=Math.cos(n),i=Math.sin(n),a=[1,0,0,1,0,0],o=a[0]*r+a[2]*i,s=a[1]*r+a[3]*i,c=-a[0]*i+a[2]*r,l=-a[1]*i+a[3]*r;return a[0]=o,a[1]=s,a[2]=c,a[3]=l,[e*a[0]+t*a[2]+a[4],e*a[1]+t*a[3]+a[5]]}const de=e=>e.toArray(),U=(...e)=>e.some(e=>e);function fe(e,t){if(U(e.length===0,e.some(({x:e,y:t})=>U(e==null,t==null)),!t.hasZ))throw Error(`Input pixels must have x, y and camera location must have z value`)}function pe(e,t){if(e.some(e=>e.z==null)||t.z==null)throw Error(`Input points and camera location must have z value`)}function me(e){if(e?.length!==9)throw Error(`Rotation matrix is not provided or is not a valid 3x3 matrix`)}function he(e,t){return b(t)?1/Math.cos(Math.PI/2-2*Math.atan(Math.exp(-1*e/y.radius))):1}const ge=e=>t=>new _({x:t[0],y:t[1],z:t[2],spatialReference:e});function _e(e,t,n,r){return[[-t,-t],[+t,-t],[+t,+t],[-t,+t]].map(([t,i])=>O(x(o(),n,[t,i,0]),r,e))}function W({a0:e,a1:t,a2:n,b0:r,b1:i,b2:a},o,s,c){let l=[e??o/2-.5,t,n??0,r??s/2-.5,i??0,a].map(ve);return c!=null&&G(l)?{affines:l,focalLength:c}:{affines:[o/2-.5,1,0,s/2-.5,0,-1]}}function ve(e,t){if(e==null)return null;let n=parseFloat(`${e}`);return isNaN(n)?null:n}function G(e){return e[1]!=null&&e[5]!=null}function ye(e,t,n){let{cameraHeight:r,cameraPitch:i,cameraRoll:a,elevation:o,farDistance:s,horizontalFieldOfView:c,location:l,verticalFieldOfView:u}=Q(e,e.location.spatialReference),d=o??(l.z??0)-r;return{...K(e,t,n),averageElevation:d,cameraPitch:i,cameraRoll:a??0,farDistance:s,horizontalFieldOfView:c,verticalFieldOfView:u}}function be(e,t,n,r){return X(r)?I([r.omega,r.phi,r.kappa]):Z(r)?L([r.heading,r.pitch,r.roll]):L([e,t,n??0])}function xe(e,t,n){let{cameraHeading:r,cameraHeight:i,farDistance:a,horizontalFieldOfView:o,location:s,verticalFieldOfView:c}=Q(e,e.location.spatialReference),l=(s.z??0)-i,u=-r,d=0,f=0;if(e?.matrix){let{matrix:t}=e;[d,f,u]=Ee(t)}return{averageElevation:l,cameraLocation:s,cameraHeading:r,farDistance:a,horizontalFieldOfView:o,imageHeight:n,imageWidth:t,verticalFieldOfView:c,horizonYaw:u,horizonPitch:d,horizonRoll:f}}function K(e,t,n){let{a0:r,a1:i,a2:a,b0:o,b1:s,b2:c,cameraHeading:l,cameraOrientation:u,cameraPitch:d,cameraRoll:f,focalLength:p,horizontalFieldOfView:m,location:h,matrix:g,principalX:_,principalY:v,radial:y,tangential:b,verticalFieldOfView:x}=e,{affines:S,focalLength:C}=W({a0:r,a1:i,a2:a,b0:o,b1:s,b2:c},t,n,p),w=g??be(l,d,f,u),T=_!=null&&v!=null?[_,v]:void 0;return{affineTransformations:u?.affineTransformations??S,cameraLocation:h.clone(),focalLength:u?.focalLength??C,horizontalFieldOfView:m,imageHeight:n,imageWidth:t,principalOffsetPoint:u?.principalOffsetPoint??T,radialDistortionCoefficients:u?.radialDistortionCoefficients??y,rotationMatrix:w,tangentialDistortionCoefficients:u?.tangentialDistortionCoefficients??b,verticalFieldOfView:x}}const q=e=>e!=null&&`elevationSample`in e&&e.elevationSample!=null,J=e=>w(e?.elevationSource)&&e?.extent!=null,Y=e=>S(e?.elevationSource),Se=async(e,t,n,r,i)=>{let a=T(e),o=t-n/a;return q(r)?r:Y(r)?(r.elevationSource=new C({constantElevation:r.elevationSource.constantElevation/a}),r):J(r)?{elevationSample:await ee({...g(r.elevationSource)?r.elevationSource.toJSON():r.elevationSource,extent:r.extent},i),elevationSource:new C({constantElevation:o})}:{averageGroundElevation:o,spatialReference:e}},Ce=e=>E(e?.heading)&&E(e?.pitch),we=(e,t)=>[[-e,-t],[e,-t],[e,t],[-e,t]];function Te(e){let{cameraLocation:t,farDistance:i,horizontalFieldOfView:a,rotationMatrix:s,scalingFactor:c,verticalFieldOfView:u}=e,d=r();l(d,s);let f=2*Math.tan(n(u)/2)*i*c,p=2*Math.tan(n(a)/2)*i*c,g=N([0,0,-1],d),_=j([t.x,t.y,t.z],g,e.farDistance*c,c),v=N([0,1,0],d),y=N([1,0,0],d),b=M(v,f/2,c),x=M(y,p/2,c),S=m(o(),b,x),C=h(o(),b,x);return[h(o(),_,S),h(o(),_,C),m(o(),_,S),m(o(),_,C)]}const X=e=>e?.type===2,Z=e=>e?.type===1;function Q(e,t,n=!0){let r=T(t),i=n?e.clone():e;return i.cameraHeight/=r,i.farDistance/=r,i.nearDistance/=r,S(i.elevationSource)&&(i.elevationSource.constantElevation/=r),i}function Ee(e){return[t(Math.asin(-e[6])),t(Math.atan(e[7]/e[8])),t(Math.atan2(e[3],e[0]))]}function $(e,t,n,r=!1){return De(V(e,t),n,r)}function De(e,n,i=!1){let a=i?l(r(),F(n,P.YPR)):F(n,P.YPR),o=e[0]*a[0]+e[1]*a[1]+e[2]*a[2],s=e[0]*a[3]+e[1]*a[4]+e[2]*a[5],c=e[0]*a[6]+e[1]*a[7]+e[2]*a[8],u=t(Math.acos(-c));return[t(Math.atan2(o,s)),u]}export{$ as adjustHorizonAngles,De as adjustHorizonAnglesVec3,Te as computeFarplaneVertices,ae as computeHFOVAndVFOV,_e as computeNewReferenceCoordinates,H as convertHeadingPitchToSphereVertex,z as convertOrientationToPixelLocation,ce as convertPixelLocationToSphereVertex,R as convertPixelToHeadingPitch,B as convertSphereVertexToOrientation,se as convertSphereVertexToPixelLocation,Q as convertToSRUnits,V as createMeshSpaceVector,F as createRotationMatrix,L as createRotationMatrixFromHPR,I as createRotationMatrixFromOPK,Ee as extractHorizonAngles,W as getAffinesAndFocalLength,xe as getImageToWorldPanoramicProperties,ye as getImageToWorldProperties,le as getInitialAngle,Se as getUpdateElevationProps,he as getWebMercatorScalingFactor,K as getWorldToImageProperties,Ce as hasAngles,Z as hasHeadingPitchRoll,X as hasOmegaPhiKappa,q as isUpdateElevationWithElevationSampler,J as isUpdateElevationWithElevationSource,Y as isUpdateUsingConstantElevation,G as isValidAffines,A as linearEquationSolve,oe as ltpToGeographic,U as or,de as pointToArray,O as projectiveTransform,we as reducerFn,ue as rotatePixel,j as scaleAndAddWithFactor,M as scaleWithFactor,N as transformMat3,re as transformMat4,fe as validatePixelsToTransform,pe as validatePointsToTransform,me as validateRotationMatrix,ge as vecToPoint};
+import e from"../../../core/Error.js";import{deg2rad as t,rad2deg as n}from"../../../core/mathUtils.js";import{create as r}from"../../../core/libs/gl-matrix-2/factories/mat3f64.js";import{create as i,fromValues as a}from"../../../core/libs/gl-matrix-2/factories/mat4f64.js";import{zeros as o,create as s}from"../../../core/libs/gl-matrix-2/factories/vec3f64.js";import{fromArray as c}from"../../../core/libs/gl-matrix-2/factories/vec4f64.js";import{multiply as l,transpose as u}from"../../../core/libs/gl-matrix-2/math/mat3.js";import{invertOrIdentity as d,mul as f}from"../../../core/libs/gl-matrix-2/math/mat4.js";import{scale as p,sub as m,add as h}from"../../../core/libs/gl-matrix-2/math/vec3.js";import{isSerializable as g}from"../../../core/support/jsonUtils.js";import _ from"../../../geometry/Point.js";import{projectAsync as v}from"../../../geometry/projectionUtils.js";import{earth as y}from"../../../geometry/support/Ellipsoid.js";import{isWebMercator as b}from"../../../geometry/support/spatialReferenceUtils.js";import{a as x}from"../../../chunks/vec3.js";import{isConstantElevation as S,ConstantElevation as C,isElevationSource as w}from"../core/ElevationSourceDefinitions.js";import{getMetersPerUnitOfSR as T}from"../core/utils.js";import{getElevationSampler as ee}from"./updateElevationUtils.js";import{isNumber as E}from"../../../support/guards.js";import{defaultImageSphereSize as D}from"../../../widgets/PanoramicViewer/constants.js";function O(e,t,n){let[r,a,o,s]=t,[c,l,u,p]=n;k(r,a,o,s);let m=k(c,l,u,p),h=A(r,a,o,s),g=A(c,l,u,p),_=d(i(),h),[v,y,b,x]=ne(e,f(i(),_,g));return[v/x,y/x,m?0:b/x]}function k(e,t,n,r){return e[2]===0&&t[2]===0&&n[2]===0&&r[2]===0&&(e[2]=t[2]=n[2]=r[2]=1,!0)}function te(e){return e===0?1:e}function ne(e,t){let[n,r,i]=e,a=[0,0,0,0];return a[0]=n*t[0]+r*t[1]+i*t[2]+t[3],a[1]=n*t[4]+r*t[5]+i*t[6]+t[7],a[2]=n*t[8]+r*t[9]+i*t[10]+t[11],a[3]=te(n*t[12]+r*t[13]+i*t[14]+t[15]),a}function A(e,t,n,r){let o=re(c([...r,1]),d(Array(16),a(e[0],t[0],n[0],0,e[1],t[1],n[1],0,e[2],t[2],n[2],0,1,1,1,1))),s=o[0],l=o[1],u=o[2],f=i();return f[0]=s*e[0],f[1]=l*t[0],f[2]=u*n[0],f[3]=0,f[4]=s*e[1],f[5]=l*t[1],f[6]=u*n[1],f[7]=0,f[8]=s*e[2],f[9]=l*t[2],f[10]=u*n[2],f[11]=0,f[12]=s,f[13]=l,f[14]=u,f[15]=1,f}function j(e,t,n,r,i=o()){return i[0]=e[0]+t[0]*n,i[1]=e[1]+t[1]*n,i[2]=e[2]+t[2]*(n/r),i}function M(e,t,n){let r=o();return r[0]=e[0]*t,r[1]=e[1]*t,r[2]=e[2]*(t/n),r}function N(e,t){let[n,r,i]=e,a=o();return a[0]=n*t[0]+r*t[3]+i*t[6],a[1]=n*t[1]+r*t[4]+i*t[7],a[2]=n*t[2]+r*t[5]+i*t[8],a}function re(e,t){let[n,r,i,a]=e,o=[,,,,];return o[0]=n*t[0]+r*t[1]+i*t[2]+a*t[3],o[1]=n*t[4]+r*t[5]+i*t[6]+a*t[7],o[2]=n*t[8]+r*t[9]+i*t[10]+a*t[11],o[3]=n*t[12]+r*t[13]+i*t[14]+a*t[15],o}function ie(n,i,a,o=!0){if(!Number.isFinite(n))throw new e(`InvalidRotationAngle`,`Please specify a valid angle for rotation`);let s=a*(o?t(n):n),c=Math.cos(s),l=Math.sin(s),u=r();switch(i){case 0:u[4]=c,u[5]=-l,u[7]=l,u[8]=c;break;case 1:u[0]=c,u[2]=l,u[6]=-l,u[8]=c;break;case 2:u[0]=c,u[1]=-l,u[3]=l,u[4]=c;break;default:throw new e(`InvalidRotationAxis`,`Please specify either 0, 1 or 2 for X, Y or Z axis respectively`)}return u}const P={HPR:[[2,-1],[0,1],[2,-1]],OPK:[[0,1],[1,1],[2,1]],YPR:[[0,-1],[1,-1],[2,-1]]};function F(t,n,i=!0){if(t?.length!==3||n?.length!==3)throw new e(`InvalidRotationAngles`,`Please specify three angles with config for rotation`);let a=r();for(let e=0;e<3;e++){let[r,o]=n[e],s=ie(t[e],r,o,i);l(a,s,a)}return a}function I(e,t=!0){return F(e,P.OPK,t)}function L(e,t=!0){return F(e,P.HPR,t)}function ae(e,n,r){let i=Math.sin(t(r)),a=Math.cos(t(r)),o=[[e,0],[e,n],[0,n]];o.forEach((e,t)=>{o[t]=[a*e[0]-i*e[1],i*e[0]+a*e[1]]});let s={xmin:Math.min(0,o[0][0],o[1][0],o[2][0]),xmax:Math.max(0,o[0][0],o[1][0],o[2][0]),ymin:Math.min(0,o[0][1],o[1][1],o[2][1]),ymax:Math.max(0,o[0][1],o[1][1],o[2][1])};return{hfov:Math.abs(s.xmax-s.xmin),vfov:Math.abs(s.ymax-s.ymin)}}function oe(e,r){let i=Number(e[0]),a=Number(e[1]),o=Number(e[2]),[s,c,l,u]=r,d=t(s),f=t(c),p=l/Math.sqrt(1-u*Math.sin(d)**2),m=i/p,h=a/p,g=o/p,_=Math.cos(d)-Math.sin(d)*h+Math.cos(d)*g,v=Math.sin(d)+Math.cos(d)*h+Math.sin(d)*g,y=Math.sqrt(_**2+m**2),b=u*p*Math.sin(d),x=(e,t=5)=>{if(t===0)return e;let n=x(e,t-1);return Math.atan(v/y-(b-u*(l/Math.sqrt(1-u*Math.sin(n)**2))*Math.sin(n))/(p*y))},S=x(d),C=Math.atan(i/(p*_))+f,w=n(S);return[n(C),w,i/(Math.cos(S)*Math.sin(C-f))-l/Math.sqrt(1-u*Math.sin(S)**2)]}function R(e,t,n){let r=360/t,i=180/n,a=e.x-t/2,o=e.y-n/2;return{heading:a*r,pitch:90-o*i}}function se(e,t,n,r,i=D/2){let{heading:a,pitch:o}=B(e,i),s=r?$(a,o,r):[a,o];return{heading:a,pitch:o,...z(s[0],s[1],t,n)}}function z(e,t,n,r){let i=360/n,a=180/r,o=e%360,s=o<-180?o+360:o>180?o-360:o;return{x:n/2+s/i,y:r-t/a}}function B(e,t){let r=n(Math.acos(-e.z/t));return{heading:n(Math.atan2(e.x,e.y)),pitch:r}}function V(e,n){return[Math.sin(t(e))*Math.sin(t(n)),Math.cos(t(e))*Math.sin(t(n)),Math.cos(t(180-n))]}function H(e,t,n,r=D/2){let i=n?$(e,t,n,!0):[e,t];return p(s(),V(i[0],i[1]),r)}function ce(e,t,n,r,i=D/2){let{heading:a,pitch:o}=R(e,t,n);return H(a,o,r,i)}async function le(e,t,r){let i=await v(t,e.spatialReference,r),a=n(Math.atan2(i.y-e.y,i.x-e.x));return a=a>=0&&a<=90?90-a:a>90&&a<=180?360-a+90:90+Math.abs(a),a}function ue(e,t,n){let r=Math.cos(n),i=Math.sin(n),a=[1,0,0,1,0,0],o=a[0]*r+a[2]*i,s=a[1]*r+a[3]*i,c=-a[0]*i+a[2]*r,l=-a[1]*i+a[3]*r;return a[0]=o,a[1]=s,a[2]=c,a[3]=l,[e*a[0]+t*a[2]+a[4],e*a[1]+t*a[3]+a[5]]}const de=e=>e.toArray(),U=(...e)=>e.some(e=>e);function fe(e,t){if(U(e.length===0,e.some(({x:e,y:t})=>U(e==null,t==null)),!t.hasZ))throw Error(`Input pixels must have x, y and camera location must have z value`)}function pe(e,t){if(e.some(e=>e.z==null)||t.z==null)throw Error(`Input points and camera location must have z value`)}function me(e){if(e?.length!==9)throw Error(`Rotation matrix is not provided or is not a valid 3x3 matrix`)}function he(e,t){return b(t)?1/Math.cos(Math.PI/2-2*Math.atan(Math.exp(-1*e/y.radius))):1}const ge=e=>t=>new _({x:t[0],y:t[1],z:t[2],spatialReference:e});function _e(e,t,n,r){return[[-t,-t],[+t,-t],[+t,+t],[-t,+t]].map(([t,i])=>O(x(o(),n,[t,i,0]),r,e))}function W({a0:e,a1:t,a2:n,b0:r,b1:i,b2:a},o,s,c){let l=[e??o/2-.5,t,n??0,r??s/2-.5,i??0,a].map(ve);return c!=null&&G(l)?{affines:l,focalLength:c}:{affines:[o/2-.5,1,0,s/2-.5,0,-1]}}function ve(e,t){if(e==null)return null;let n=parseFloat(`${e}`);return isNaN(n)?null:n}function G(e){return e[1]!=null&&e[5]!=null}function ye(e,t,n){let{cameraHeight:r,cameraPitch:i,cameraRoll:a,elevation:o,farDistance:s,horizontalFieldOfView:c,location:l,verticalFieldOfView:u}=Q(e,e.location.spatialReference),d=o??(l.z??0)-r;return{...K(e,t,n),averageElevation:d,cameraPitch:i,cameraRoll:a??0,farDistance:s,horizontalFieldOfView:c,verticalFieldOfView:u}}function be(e,t,n,r){return X(r)?I([r.omega,r.phi,r.kappa]):Z(r)?L([r.heading,r.pitch,r.roll]):L([e,t,n??0])}function xe(e,t,n){let{cameraHeading:r,cameraHeight:i,farDistance:a,horizontalFieldOfView:o,location:s,verticalFieldOfView:c}=Q(e,e.location.spatialReference),l=(s.z??0)-i,u=-r,d=0,f=0;if(e?.matrix){let{matrix:t}=e;[d,f,u]=Ee(t)}return{averageElevation:l,cameraLocation:s,cameraHeading:r,farDistance:a,horizontalFieldOfView:o,imageHeight:n,imageWidth:t,verticalFieldOfView:c,horizonYaw:u,horizonPitch:d,horizonRoll:f}}function K(e,t,n){let{a0:r,a1:i,a2:a,b0:o,b1:s,b2:c,cameraHeading:l,cameraOrientation:u,cameraPitch:d,cameraRoll:f,focalLength:p,horizontalFieldOfView:m,location:h,matrix:g,principalX:_,principalY:v,radial:y,tangential:b,verticalFieldOfView:x}=e,{affines:S,focalLength:C}=W({a0:r,a1:i,a2:a,b0:o,b1:s,b2:c},t,n,p),w=g??be(l,d,f,u),T=_!=null&&v!=null?[_,v]:void 0;return{affineTransformations:u?.affineTransformations??S,cameraLocation:h.clone(),focalLength:u?.focalLength??C,horizontalFieldOfView:m,imageHeight:n,imageWidth:t,principalOffsetPoint:u?.principalOffsetPoint??T,radialDistortionCoefficients:u?.radialDistortionCoefficients??y,rotationMatrix:w,tangentialDistortionCoefficients:u?.tangentialDistortionCoefficients??b,verticalFieldOfView:x}}const q=e=>e!=null&&`elevationSample`in e&&e.elevationSample!=null,J=e=>w(e?.elevationSource)&&e?.extent!=null,Y=e=>S(e?.elevationSource),Se=async(e,t,n,r,i)=>{let a=T(e),o=t-n/a;return q(r)?r:Y(r)?(r.elevationSource=new C({constantElevation:r.elevationSource.constantElevation/a}),r):J(r)?{elevationSample:await ee({...g(r.elevationSource)?r.elevationSource.toJSON():r.elevationSource,extent:r.extent},i),elevationSource:new C({constantElevation:o})}:{averageGroundElevation:o,spatialReference:e}},Ce=e=>E(e?.heading)&&E(e?.pitch),we=(e,t)=>[[-e,-t],[e,-t],[e,t],[-e,t]];function Te(e){let{cameraLocation:n,farDistance:i,horizontalFieldOfView:a,rotationMatrix:s,scalingFactor:c,verticalFieldOfView:l}=e,d=r();u(d,s);let f=2*Math.tan(t(l)/2)*i*c,p=2*Math.tan(t(a)/2)*i*c,g=N([0,0,-1],d),_=j([n.x,n.y,n.z],g,e.farDistance*c,c),v=N([0,1,0],d),y=N([1,0,0],d),b=M(v,f/2,c),x=M(y,p/2,c),S=m(o(),b,x),C=h(o(),b,x);return[h(o(),_,S),h(o(),_,C),m(o(),_,S),m(o(),_,C)]}const X=e=>e?.type===2,Z=e=>e?.type===1;function Q(e,t,n=!0){let r=T(t),i=n?e.clone():e;return i.cameraHeight/=r,i.farDistance/=r,i.nearDistance/=r,S(i.elevationSource)&&(i.elevationSource.constantElevation/=r),i}function Ee(e){return[n(Math.asin(-e[6])),n(Math.atan(e[7]/e[8])),n(Math.atan2(e[3],e[0]))]}function $(e,t,n,r=!1){return De(V(e,t),n,r)}function De(e,t,i=!1){let a=i?u(r(),F(t,P.YPR)):F(t,P.YPR),o=e[0]*a[0]+e[1]*a[1]+e[2]*a[2],s=e[0]*a[3]+e[1]*a[4]+e[2]*a[5],c=e[0]*a[6]+e[1]*a[7]+e[2]*a[8],l=n(Math.acos(-c));return[n(Math.atan2(o,s)),l]}export{$ as adjustHorizonAngles,De as adjustHorizonAnglesVec3,Te as computeFarplaneVertices,ae as computeHFOVAndVFOV,_e as computeNewReferenceCoordinates,H as convertHeadingPitchToSphereVertex,z as convertOrientationToPixelLocation,ce as convertPixelLocationToSphereVertex,R as convertPixelToHeadingPitch,B as convertSphereVertexToOrientation,se as convertSphereVertexToPixelLocation,Q as convertToSRUnits,V as createMeshSpaceVector,F as createRotationMatrix,L as createRotationMatrixFromHPR,I as createRotationMatrixFromOPK,Ee as extractHorizonAngles,W as getAffinesAndFocalLength,xe as getImageToWorldPanoramicProperties,ye as getImageToWorldProperties,le as getInitialAngle,Se as getUpdateElevationProps,he as getWebMercatorScalingFactor,K as getWorldToImageProperties,Ce as hasAngles,Z as hasHeadingPitchRoll,X as hasOmegaPhiKappa,q as isUpdateElevationWithElevationSampler,J as isUpdateElevationWithElevationSource,Y as isUpdateUsingConstantElevation,G as isValidAffines,A as linearEquationSolve,oe as ltpToGeographic,U as or,de as pointToArray,O as projectiveTransform,we as reducerFn,ue as rotatePixel,j as scaleAndAddWithFactor,M as scaleWithFactor,N as transformMat3,re as transformMat4,fe as validatePixelsToTransform,pe as validatePointsToTransform,me as validateRotationMatrix,ge as vecToPoint};

package/layers/save/featureLayerUtils.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{isSome as e,equals as t,difference as n}from"../../core/arrayUtils.js";import r from"../../core/Error.js";import{updateOrigins as i}from"../../core/accessorSupport/originUtils.js";import{saveAs as a,save as o,getLayerJSON as s,getPortalItem as c,addItem as l,ensureLayerConfig as u,ensureItemConfig as d,setCommonItemProperties as f,validateItemType as ee,createErrorMessage as p}from"./utils.js";import{parse as m}from"../support/arcgisLayerUrl.js";import{fetchFeatureServiceWithAllResources as te,getFeatureServiceItemLayerType as h,getLayerModuleTypeStrict as g}from"../support/fetchService.js";import _ from"../../portal/Portal.js";import ne from"../../portal/PortalItem.js";import{createForItemWrite as re}from"../../portal/support/jsonContext.js";import{getWGS84ExtentForItem as v,toggleTypeKeyword as y,typeKeyword as b,removeTypeKeyword as ie,hasTypeKeyword as ae}from"../../portal/support/portalItemUtils.js";const x=`Feature Service`,S=`feature-layer-utils`,C=`${S}-save`,w=`${S}-save-as`,T=`${S}-saveall`,E=`${S}-saveall-as`;function D(e){let t=e?.type;return(t===`feature`||t===`subtype-group`||t===`oriented-imagery`||t===`dimension-feature`||t===`annotation-feature`)&&e?.source?.type===`feature-layer`}function O(e){return{isValid:D(e)&&(`dynamicDataSource`in e?!e.dynamicDataSource:!0),errorMessage:`Feature layer should be a layer or table in a map or feature service`}}function k(e,t){let n=re(e,`portal-item`);return t?.isTable&&(n.layerContainerType=`tables`),n}function A(e){let t=k(e),n=k(e);return n.layerContainerType=`tables`,{forLayers:t,forTables:n}}function j(e){let t=[],n=[];for(let{layer:r,layerJSON:i}of e)oe(r)?n.push(i):t.push(i);return{layers:t,tables:n}}function oe(e,t){return e.isTable}function M(e){return j([e])}async function N(e,t){return/\/\d+\/?$/.test(e.url)?M(t[0]):P(t,e)}async function P(e,t){if(e.reverse(),!t)return j(e);let n=await F(t,e);for(let t of e)G(t.layer,t.layerJSON,n);return R(n,e),n}async function F(e,t){let n=await e.fetchData(`json`),r;if(!I(n)||ae(e,b.HOSTED_SERVICE))r=!0;else if(q(n))return n;else r=!1;n??={},L(n);let{layer:{url:i,customParameters:a,apiKey:o}}=t[0];return await V(n,{url:i??``,customParameters:a,apiKey:o},t.map(e=>e.layer.layerId),r),n}function I(e){return!!(e&&Array.isArray(e.layers)&&Array.isArray(e.tables))}function L(e){e.layers??=[],e.tables??=[]}function R(e,t){let n=[],r=[];for(let{layer:e}of t){let{isTable:t,layerId:i}=e;t?r.push(i):n.push(i)}z(e.layers,n),z(e.tables,r)}function z(e,n){if(e.length<2)return;let r=[];for(let{id:t}of e)r.push(t);t(r.sort(B),n.slice().sort(B))&&e.sort((e,t)=>{let r=n.indexOf(e.id),i=n.indexOf(t.id);return r<i?-1:+(r>i)})}function B(e,t){return e<t?-1:+(e>t)}async function V(e,t,n,r){let{url:i,customParameters:a,apiKey:o}=t,{serviceJSON:s,layersJSON:c}=await te(i,{customParameters:a,apiKey:o});if(!r){J(e,s);return}let l=H(e.layers,s.layers,n),u=H(e.tables,s.tables,n);e.layers=l.itemResources,e.tables=u.itemResources,J(e,s),await U(e,[...l.added,...u.added],i,c?[...c.layers,...c.tables]:[])}function H(e,t,r){let i=n(e,t,(e,t)=>e.id===t.id);e=e.filter(e=>!i.removed.some(t=>t.id===e.id));let a=i.added;for(let{id:t}of a)e.push({id:t});return{itemResources:e,added:a.filter(({id:e})=>!r.includes(e))}}async function U(e,t,n,r){let i=await W(t),a=[];for(let{id:e,type:o}of t){let t=i.get(o);t&&a.push(new t({url:n,layerId:e,sourceJSON:r.find(({id:t})=>t===e)}))}await Promise.allSettled(a.map(e=>e.load()));for(let t of a){let{layerId:n,loaded:r}=t;if(!r||!(`defaultPopupTemplate`in t)||!t.defaultPopupTemplate)continue;let i={id:n,popupInfo:t.defaultPopupTemplate.toJSON()};G(t,t.operationalLayerType===`ArcGISFeatureLayer`?i:{...i,layerType:t.operationalLayerType},e)}}async function W(e){let t=new Set,n=[];for(let{type:r}of e){let e=g(r);if(e&&!t.has(r))switch(t.add(r),e){case`AnnotationFeatureLayer`:n.push(import(`../AnnotationFeatureLayer.js`).then(e=>e.default));break;case`CatalogLayer`:n.push(import(`../CatalogLayer.js`).then(e=>e.default));break;case`DimensionFeatureLayer`:n.push(import(`../DimensionFeatureLayer.js`).then(e=>e.default));break;case`FeatureLayer`:n.push(import(`../FeatureLayer.js`).then(e=>e.default));break;case`OrientedImageryLayer`:n.push(import(`../OrientedImageryLayer.js`).then(e=>e.default))}}let r=await Promise.all(n),i=new Map;return Array.from(t).forEach((e,t)=>{i.set(e,r[t])}),i}function G(e,t,n){e.isTable?K(n.tables,t):K(n.layers,t)}function K(e,t){let n=e.findIndex(({id:e})=>e===t.id);n===-1?e.push(t):e[n]=t}function q(e){return[...e.layers,...e.tables].every(e=>`layerType`in e&&!!e.layerType)}function J(e,t){let n=e.layers??[],r=e.tables??[],i=[...t.layers??[],...t.tables??[]];for(let e of[...n,...r]){let{id:t}=e;if(`layerType`in e&&e.layerType)continue;let n=i.find(({id:e})=>e===t);if(!n)continue;let a=h(n.type,r.includes(e));a&&se(e,a)&&ce(a)&&(e.layerType=a)}}function se(e,t){return t!==`ArcGISFeatureLayer`&&t!==`Table`}function ce(e){return e!==`ArcGISFeatureLayer`&&e!==`Table`}function Y(e,t){if(!e.length)throw new r(`${t}:missing-parameters`,`'layers' array should contain at least one feature layer`)}function le(e,t){let n=e.map(e=>e.portalItem.id);if(new Set(n).size>1)throw new r(`${t}:invalid-parameters`,`All layers in the 'layers' array should be loaded from the same portal item`)}function X(e,t){let n=e.map(e=>e.layerId);if(new Set(n).size!==n.length)throw new r(`${t}:invalid-parameters`,`'layers' array should contain only one instance each of layer or table in a feature service`)}async function ue(e){Y(e,T),await Promise.all(e.map(e=>e.load()));for(let t of e)u(t,T,O),d({layer:t,itemType:x,errorNamePrefix:T});le(e,T),X(e,T)}function de(e){if(!(`layerType`in e))return!!e.charts?.length;switch(e.layerType){case`CatalogLayer`:return!!e.footprintLayer?.charts?.length;case`OrientedImageryLayer`:return!!e.charts?.length;case`SubtypeGroupLayer`:return!!e.layers.some(e=>!!e.charts?.length);case`SubtypeGroupTable`:return!!e.tables.some(e=>!!e.charts?.length)}return!1}function Z(e,t){let n=0,r=0,i=0,a=0,o=0,s=0,c=0;for(let e of[...t.layers,...t.tables])if(de(e)&&c++,`layerType`in e)switch(e.layerType){case`CatalogLayer`:n++;break;case`OrientedImageryLayer`:r++;break;case`ParcelLayer`:o++;break;case`SubtypeGroupLayer`:i++;break;case`SubtypeGroupTable`:a++;break;case`UtilityNetworkLayer`:s++}y(e,b.CATALOG_LAYER,n>0),y(e,b.ORIENTED_IMAGERY_LAYER,r>0),y(e,b.PARCEL_FABRIC,o>0),y(e,b.SUBTYPE_GROUP_LAYER,i>0),y(e,b.SUBTYPE_GROUP_TABLE,a>0),y(e,b.UTILITY_NETWORK,s>0),y(e,b.CHARTS,c>0)}function Q(e,t,n){ie(t,b.METADATA),y(t,b.MULTI_LAYER,e.length>1),y(t,b.SINGLE_LAYER,e.length===1),y(t,b.TABLE,n.tables.length>0&&n.layers.length===0),Z(t,n)}function $(e,t,n){Z(t,n)}async function fe(e,t,n){let{url:r,layerId:i,title:a,fullExtent:o,isTable:s}=e;t.url=(m(r)?.serverType===`FeatureServer`?r:`${r}/${i}`)??null,t.title||=a,t.extent=null,!s&&o!=null&&(t.extent=await v(o)),Q([e],t,n)}function pe(e,t,n){for(let t of e){let i=t.parsedUrl.path,a=m(i);if(!a?.url.path)throw new r(`${n}:invalid-parameters`,p(t,`has unsupported url pattern: ${i}`),{layer:t});let o=a?.serverType;if(o!==`FeatureServer`&&o!==`MapServer`)throw new r(`${n}:invalid-parameters`,p(t,`has unsupported server type: ${o}`),{layer:t});if(o===`MapServer`&&e.length>1)throw new r(`${n}:invalid-parameters`,`Only one layer or table in a map service can be saved`)}let i=m(e[0].parsedUrl.path)?.url.path;if(!e.every(e=>m(e.parsedUrl.path)?.url.path===i))throw new r(`${n}:invalid-parameters`,`'layers' array should only contain layers or tables that belong to the same feature service`);if(t&&m(t.url)?.url.path!==i)throw new r(`${n}:invalid-parameters`,`'sourcePortalItem.url' and 'layers' should belong to the same service`)}async function me(e,t){let n=t?ne.from(t):null;n&&(n.portal??=_.getDefault()),Y(e,E),await Promise.all([...e.map(e=>e.load()),n?.load()]),n&&ee({item:n,itemType:x,errorNamePrefix:E});for(let t of e)u(t,E,O);return pe(e,n,E),X(e,E),n}function he(e,t){Z(e,t),f(e)}async function ge(t,n,r){let i=0;for(let{isTable:e}of t)e||i++;let a=t[0].parsedUrl.path,o=m(a);if(n.url=o?.serverType===`FeatureServer`?o.url.path:a,n.title||=o.title,n.extent=null,i>0){let r=t.map(e=>e.fullExtent).filter(e).reduce((e,t)=>e.clone().union(t));r&&(n.extent=await v(r))}Q(t,n,r),f(n)}async function _e(e,t){return o({layer:e,itemType:x,validateLayer:O,createJSONContext:t=>k(t,e),createItemData:(e,t)=>N(t,[e]),errorNamePrefix:C,setItemProperties:$},t)}async function ve(e,t){await ue(e);let n=e[0].portalItem,r=A(n),a=await Promise.all(e.map(e=>s(e,e.isTable?r.forTables:r.forLayers,t))),o=await N(n,e.map((e,t)=>({layer:e,layerJSON:a[t]})));return he(n,o),await n.update({data:o}),await Promise.all(e.slice(1).map(e=>e.portalItem.reload())),i(r.forLayers),i(r.forTables),n.clone()}async function ye(e,t,n){return a({layer:e,itemType:x,validateLayer:O,createJSONContext:t=>k(t,e),createItemData:(e,t)=>Promise.resolve(M(e)),errorNamePrefix:w,newItem:t,setItemProperties:fe},n)}async function be(e,t,n){let r=await me(e,n?.sourcePortalItem),a=c({itemType:x,errorNamePrefix:E,newItem:t}),o=A(a),u=await Promise.all(e.map(e=>s(e,e.isTable?o.forTables:o.forLayers,n))),d=await P(e.map((e,t)=>({layer:e,layerJSON:u[t]})),r);await ge(e,a,d),await l(a,d,n);for(let t of e)t.portalItem=a.clone();return i(o.forLayers),i(o.forTables),a}export{_e as save,ve as saveAll,be as saveAllAs,ye as saveAs};
+import{equals as e,difference as t,isSome as n}from"../../core/arrayUtils.js";import r from"../../core/Error.js";import{updateOrigins as i}from"../../core/accessorSupport/originUtils.js";import{saveAs as a,save as o,getLayerJSON as s,getPortalItem as c,addItem as l,ensureLayerConfig as u,ensureItemConfig as d,setCommonItemProperties as f,validateItemType as ee,createErrorMessage as p}from"./utils.js";import{parse as m}from"../support/arcgisLayerUrl.js";import{fetchFeatureServiceWithAllResources as te,getFeatureServiceItemLayerType as h,getLayerModuleTypeStrict as g}from"../support/fetchService.js";import _ from"../../portal/Portal.js";import v from"../../portal/PortalItem.js";import{createForItemWrite as ne}from"../../portal/support/jsonContext.js";import{getWGS84ExtentForItem as y,removeTypeKeyword as re,typeKeyword as b,toggleTypeKeyword as x,hasTypeKeyword as ie}from"../../portal/support/portalItemUtils.js";const S=`Feature Service`,C=`feature-layer-utils`,ae=`${C}-save`,w=`${C}-save-as`,T=`${C}-saveall`,E=`${C}-saveall-as`;function D(e){let t=e?.type;return(t===`feature`||t===`subtype-group`||t===`oriented-imagery`||t===`dimension-feature`||t===`annotation-feature`)&&e?.source?.type===`feature-layer`}function O(e){return{isValid:D(e)&&(`dynamicDataSource`in e?!e.dynamicDataSource:!0),errorMessage:`Feature layer should be a layer or table in a map or feature service`}}function k(e,t){let n=ne(e,`portal-item`);return t?.isTable&&(n.layerContainerType=`tables`),n}function A(e){let t=k(e),n=k(e);return n.layerContainerType=`tables`,{forLayers:t,forTables:n}}function j(e){let t=[],n=[];for(let{layer:r,layerJSON:i}of e)oe(r)?n.push(i):t.push(i);return{layers:t,tables:n}}function oe(e,t){return e.isTable}function M(e){return j([e])}async function N(e,t){return/\/\d+\/?$/.test(e.url)?M(t[0]):P(t,e)}async function P(e,t){if(e.reverse(),!t)return j(e);let n=await F(t,e);for(let t of e)G(t.layer,t.layerJSON,n);return R(n,e),n}async function F(e,t){let n=await e.fetchData(`json`),r;if(!I(n)||ie(e,b.HOSTED_SERVICE))r=!0;else if(q(n))return n;else r=!1;n??={},L(n);let{layer:{url:i,customParameters:a,apiKey:o}}=t[0];return await V(n,{url:i??``,customParameters:a,apiKey:o},t.map(e=>e.layer.layerId),r),n}function I(e){return!!(e&&Array.isArray(e.layers)&&Array.isArray(e.tables))}function L(e){e.layers??=[],e.tables??=[]}function R(e,t){let n=[],r=[];for(let{layer:e}of t){let{isTable:t,layerId:i}=e;t?r.push(i):n.push(i)}z(e.layers,n),z(e.tables,r)}function z(t,n){if(t.length<2)return;let r=[];for(let{id:e}of t)r.push(e);e(r.sort(B),n.slice().sort(B))&&t.sort((e,t)=>{let r=n.indexOf(e.id),i=n.indexOf(t.id);return r<i?-1:+(r>i)})}function B(e,t){return e<t?-1:+(e>t)}async function V(e,t,n,r){let{url:i,customParameters:a,apiKey:o}=t,{serviceJSON:s,layersJSON:c}=await te(i,{customParameters:a,apiKey:o});if(!r){J(e,s);return}let l=H(e.layers,s.layers,n),u=H(e.tables,s.tables,n);e.layers=l.itemResources,e.tables=u.itemResources,J(e,s),await U(e,[...l.added,...u.added],i,c?[...c.layers,...c.tables]:[])}function H(e,n,r){let i=t(e,n,(e,t)=>e.id===t.id);e=e.filter(e=>!i.removed.some(t=>t.id===e.id));let a=i.added;for(let{id:t}of a)e.push({id:t});return{itemResources:e,added:a.filter(({id:e})=>!r.includes(e))}}async function U(e,t,n,r){let i=await W(t),a=[];for(let{id:e,type:o}of t){let t=i.get(o);t&&a.push(new t({url:n,layerId:e,sourceJSON:r.find(({id:t})=>t===e)}))}await Promise.allSettled(a.map(e=>e.load()));for(let t of a){let{layerId:n,loaded:r}=t;if(!r||!(`defaultPopupTemplate`in t)||!t.defaultPopupTemplate)continue;let i={id:n,popupInfo:t.defaultPopupTemplate.toJSON()};G(t,t.operationalLayerType===`ArcGISFeatureLayer`?i:{...i,layerType:t.operationalLayerType},e)}}async function W(e){let t=new Set,n=[];for(let{type:r}of e){let e=g(r);if(e&&!t.has(r))switch(t.add(r),e){case`AnnotationFeatureLayer`:n.push(import(`../AnnotationFeatureLayer.js`).then(e=>e.default));break;case`CatalogLayer`:n.push(import(`../CatalogLayer.js`).then(e=>e.default));break;case`DimensionFeatureLayer`:n.push(import(`../DimensionFeatureLayer.js`).then(e=>e.default));break;case`FeatureLayer`:n.push(import(`../FeatureLayer.js`).then(e=>e.default));break;case`OrientedImageryLayer`:n.push(import(`../OrientedImageryLayer.js`).then(e=>e.default))}}let r=await Promise.all(n),i=new Map;return Array.from(t).forEach((e,t)=>{i.set(e,r[t])}),i}function G(e,t,n){e.isTable?K(n.tables,t):K(n.layers,t)}function K(e,t){let n=e.findIndex(({id:e})=>e===t.id);n===-1?e.push(t):e[n]=t}function q(e){return[...e.layers,...e.tables].every(e=>`layerType`in e&&!!e.layerType)}function J(e,t){let n=e.layers??[],r=e.tables??[],i=[...t.layers??[],...t.tables??[]];for(let e of[...n,...r]){let{id:t}=e;if(`layerType`in e&&e.layerType)continue;let n=i.find(({id:e})=>e===t);if(!n)continue;let a=h(n.type,r.includes(e));a&&se(e,a)&&ce(a)&&(e.layerType=a)}}function se(e,t){return t!==`ArcGISFeatureLayer`&&t!==`Table`}function ce(e){return e!==`ArcGISFeatureLayer`&&e!==`Table`}function Y(e,t){if(!e.length)throw new r(`${t}:missing-parameters`,`'layers' array should contain at least one feature layer`)}function le(e,t){let n=e.map(e=>e.portalItem.id);if(new Set(n).size>1)throw new r(`${t}:invalid-parameters`,`All layers in the 'layers' array should be loaded from the same portal item`)}function X(e,t){let n=e.map(e=>e.layerId);if(new Set(n).size!==n.length)throw new r(`${t}:invalid-parameters`,`'layers' array should contain only one instance each of layer or table in a feature service`)}async function ue(e){Y(e,T),await Promise.all(e.map(e=>e.load()));for(let t of e)u(t,T,O),d({layer:t,itemType:S,errorNamePrefix:T});le(e,T),X(e,T)}function de(e){if(!(`layerType`in e))return!!e.charts?.length;switch(e.layerType){case`CatalogLayer`:return!!e.footprintLayer?.charts?.length;case`OrientedImageryLayer`:return!!e.charts?.length;case`SubtypeGroupLayer`:return!!e.layers.some(e=>!!e.charts?.length);case`SubtypeGroupTable`:return!!e.tables.some(e=>!!e.charts?.length)}return!1}function Z(e,t){let n=0,r=0,i=0,a=0,o=0,s=0,c=0;for(let e of[...t.layers,...t.tables])if(de(e)&&c++,`layerType`in e)switch(e.layerType){case`CatalogLayer`:n++;break;case`OrientedImageryLayer`:r++;break;case`ParcelLayer`:o++;break;case`SubtypeGroupLayer`:i++;break;case`SubtypeGroupTable`:a++;break;case`UtilityNetworkLayer`:s++}x(e,b.CATALOG_LAYER,n>0),x(e,b.ORIENTED_IMAGERY_LAYER,r>0),x(e,b.PARCEL_FABRIC,o>0),x(e,b.SUBTYPE_GROUP_LAYER,i>0),x(e,b.SUBTYPE_GROUP_TABLE,a>0),x(e,b.UTILITY_NETWORK,s>0),x(e,b.CHARTS,c>0)}function Q(e,t,n){re(t,b.METADATA),x(t,b.MULTI_LAYER,e.length>1),x(t,b.SINGLE_LAYER,e.length===1),x(t,b.TABLE,n.tables.length>0&&n.layers.length===0),Z(t,n)}function $(e,t,n){Z(t,n)}async function fe(e,t,n){let{url:r,layerId:i,title:a,fullExtent:o,isTable:s}=e;t.url=(m(r)?.serverType===`FeatureServer`?r:`${r}/${i}`)??null,t.title||=a,t.extent=null,!s&&o!=null&&(t.extent=await y(o)),Q([e],t,n)}function pe(e,t,n){for(let t of e){let i=t.parsedUrl.path,a=m(i);if(!a?.url.path)throw new r(`${n}:invalid-parameters`,p(t,`has unsupported url pattern: ${i}`),{layer:t});let o=a?.serverType;if(o!==`FeatureServer`&&o!==`MapServer`)throw new r(`${n}:invalid-parameters`,p(t,`has unsupported server type: ${o}`),{layer:t});if(o===`MapServer`&&e.length>1)throw new r(`${n}:invalid-parameters`,`Only one layer or table in a map service can be saved`)}let i=m(e[0].parsedUrl.path)?.url.path;if(!e.every(e=>m(e.parsedUrl.path)?.url.path===i))throw new r(`${n}:invalid-parameters`,`'layers' array should only contain layers or tables that belong to the same feature service`);if(t&&m(t.url)?.url.path!==i)throw new r(`${n}:invalid-parameters`,`'sourcePortalItem.url' and 'layers' should belong to the same service`)}async function me(e,t){let n=t?v.from(t):null;n&&(n.portal??=_.getDefault()),Y(e,E),await Promise.all([...e.map(e=>e.load()),n?.load()]),n&&ee({item:n,itemType:S,errorNamePrefix:E});for(let t of e)u(t,E,O);return pe(e,n,E),X(e,E),n}function he(e,t){Z(e,t),f(e)}async function ge(e,t,r){let i=0;for(let{isTable:t}of e)t||i++;let a=e[0].parsedUrl.path,o=m(a);if(t.url=o?.serverType===`FeatureServer`?o.url.path:a,t.title||=o.title,t.extent=null,i>0){let r=e.map(e=>e.fullExtent).filter(n).reduce((e,t)=>e.clone().union(t));r&&(t.extent=await y(r))}Q(e,t,r),f(t)}async function _e(e,t){return o({layer:e,itemType:S,validateLayer:O,createJSONContext:t=>k(t,e),createItemData:(e,t)=>N(t,[e]),errorNamePrefix:ae,setItemProperties:$},t)}async function ve(e,t){await ue(e);let n=e[0].portalItem,r=A(n),a=await Promise.all(e.map(e=>s(e,e.isTable?r.forTables:r.forLayers,t))),o=await N(n,e.map((e,t)=>({layer:e,layerJSON:a[t]})));return he(n,o),await n.update({data:o}),await Promise.all(e.slice(1).map(e=>e.portalItem.reload())),i(r.forLayers),i(r.forTables),n.clone()}async function ye(e,t,n){return a({layer:e,itemType:S,validateLayer:O,createJSONContext:t=>k(t,e),createItemData:(e,t)=>Promise.resolve(M(e)),errorNamePrefix:w,newItem:t,setItemProperties:fe},n)}async function be(e,t,n){let r=await me(e,n?.sourcePortalItem),a=c({itemType:S,errorNamePrefix:E,newItem:t}),o=A(a),u=await Promise.all(e.map(e=>s(e,e.isTable?o.forTables:o.forLayers,n))),d=await P(e.map((e,t)=>({layer:e,layerJSON:u[t]})),r);await ge(e,a,d),await l(a,d,n);for(let t of e)t.portalItem=a.clone();return i(o.forLayers),i(o.forTables),a}export{_e as save,ve as saveAll,be as saveAllAs,ye as saveAs};

package/layers/save/imageryUtils.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{getPrimaryRasters as e}from"../raster/datasets/datasetUtils.js";import{saveAs as t,save as n}from"./utils.js";import{toggleTypeKeyword as r,typeKeyword as i,getWGS84ExtentForItem as a,removeTypeKeyword as o}from"../../portal/support/portalItemUtils.js";const s=`Image Service`;function c(t){if(t.type===`imagery`||t.type===`wcs`)return{isValid:!0};let{raster:n}=t,r=e(n)[0];return{isValid:r?.datasetFormat===`RasterTileServer`&&(r.tileType===`Raster`||r.tileType===`Map`),errorMessage:`imagery tile layer should be created from a tiled image service.`}}function l(e){let t=e.layerJSON;return Promise.resolve(t&&Object.keys(t).length?t:null)}function u(e,t){r(t,i.CHARTS,!!e.charts?.length)}async function d(e,t){let{parsedUrl:n,title:s,fullExtent:c}=e;t.url=n.path,t.title||=s;try{t.extent=await a(c)}catch{t.extent=void 0}o(t,i.METADATA),r(t,i.TILED_IMAGERY,e.type===`imagery-tile`),r(t,i.CHARTS,!!e.charts?.length)}async function f(e,t){let r=e.type===`imagery`?`imagery-layer-save`:e.type===`imagery-tile`?`imagery-tile-layer-save`:`wcs-layer-save`,i={layer:e,itemType:e.type===`wcs`?`WCS`:s,validateLayer:c,createItemData:l,errorNamePrefix:r,setItemProperties:u};return n(i,t)}async function p(e,n,r){let i=e.type===`imagery`?`imagery-layer-save-as`:e.type===`imagery-tile`?`imagery-tile-layer-save-as`:`wcs-layer-save-as`,a={layer:e,itemType:e.type===`wcs`?`WCS`:s,validateLayer:c,createItemData:l,errorNamePrefix:i,newItem:n,setItemProperties:d};return t(a,r)}export{f as save,p as saveAs};
+import{getPrimaryRasters as e}from"../raster/datasets/datasetUtils.js";import{saveAs as t,save as n}from"./utils.js";import{getWGS84ExtentForItem as r,removeTypeKeyword as i,toggleTypeKeyword as a,typeKeyword as o}from"../../portal/support/portalItemUtils.js";const s=`Image Service`;function c(t){if(t.type===`imagery`||t.type===`wcs`)return{isValid:!0};let{raster:n}=t,r=e(n)[0];return{isValid:r?.datasetFormat===`RasterTileServer`&&(r.tileType===`Raster`||r.tileType===`Map`),errorMessage:`imagery tile layer should be created from a tiled image service.`}}function l(e){let t=e.layerJSON;return Promise.resolve(t&&Object.keys(t).length?t:null)}function u(e,t){a(t,o.CHARTS,!!e.charts?.length)}async function d(e,t){let{parsedUrl:n,title:s,fullExtent:c}=e;t.url=n.path,t.title||=s;try{t.extent=await r(c)}catch{t.extent=void 0}i(t,o.METADATA),a(t,o.TILED_IMAGERY,e.type===`imagery-tile`),a(t,o.CHARTS,!!e.charts?.length)}async function f(e,t){let r=e.type===`imagery`?`imagery-layer-save`:e.type===`imagery-tile`?`imagery-tile-layer-save`:`wcs-layer-save`,i={layer:e,itemType:e.type===`wcs`?`WCS`:s,validateLayer:c,createItemData:l,errorNamePrefix:r,setItemProperties:u};return n(i,t)}async function p(e,n,r){let i=e.type===`imagery`?`imagery-layer-save-as`:e.type===`imagery-tile`?`imagery-tile-layer-save-as`:`wcs-layer-save-as`,a={layer:e,itemType:e.type===`wcs`?`WCS`:s,validateLayer:c,createItemData:l,errorNamePrefix:i,newItem:n,setItemProperties:d};return t(a,r)}export{f as save,p as saveAs};