@arcgis/core 5.0.0-next.51 → 5.0.0-next.53

package/layers/IntegratedMesh3DTilesLayer.d.ts

@@ -1,4 +1,192 @@
-import "../interfaces";
+import type SpatialReference from "../geometry/SpatialReference.js";
+import type Layer from "./Layer.js";
+import type SceneModifications from "./support/SceneModifications.js";
+import type ElevationInfo from "../symbols/support/ElevationInfo.js";
+import type { MultiOriginJSONMixin, MultiOriginJSONMixinProperties } from "../core/MultiOriginJSONSupport.js";
+import type { APIKeyMixin, APIKeyMixinProperties } from "./mixins/APIKeyMixin.js";
+import type { ArcGISService, ArcGISServiceProperties } from "./mixins/ArcGISService.js";
+import type { CustomParametersMixin, CustomParametersMixinProperties } from "./mixins/CustomParametersMixin.js";
+import type { OperationalLayer, OperationalLayerProperties } from "./mixins/OperationalLayer.js";
+import type { PortalLayer, PortalLayerProperties } from "./mixins/PortalLayer.js";
+import type { ScaleRangeLayer, ScaleRangeLayerProperties } from "./mixins/ScaleRangeLayer.js";
+import type { SceneModificationsItems } from "./support/SceneModifications.js";
+import type { SpatialReferenceProperties } from "../geometry/SpatialReference.js";
+import type { ElevationInfoProperties } from "../symbols/support/ElevationInfo.js";
+import type { LayerProperties } from "./Layer.js";
 
-import IntegratedMesh3DTilesLayer = __esri.IntegratedMesh3DTilesLayer;
-export default IntegratedMesh3DTilesLayer;
+export interface IntegratedMesh3DTilesLayerProperties extends LayerProperties, APIKeyMixinProperties, CustomParametersMixinProperties, MultiOriginJSONMixinProperties, ScaleRangeLayerProperties, PortalLayerProperties, OperationalLayerProperties, ArcGISServiceProperties, Partial<Pick<IntegratedMesh3DTilesLayer, "url">> {
+  /**
+   * Specifies how the mesh is placed on the vertical axis (z). This property may only be used
+   * in a [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html). See the [ElevationInfo sample](https://developers.arcgis.com/javascript/latest/sample-code/scene-elevationinfo/)
+   * for an example of how this property may be used.
+   * > [!WARNING]
+   * >
+   * > This property only affects [IntegratedMesh3DTilesLayers](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-IntegratedMesh3DTilesLayer.html) when using the `absolute-height` mode.
+   * > [ElevationInfo#featureExpressionInfo](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-support-ElevationInfo.html#featureExpressionInfo) is not supported when the elevation info is specified for this class.
+   * > Integrated mesh 3D Tiles layers always render in front of the ground surface, so setting negative offset values will not render them below the ground.
+   * > If the elevation info is not specified, the effective elevation depends on the context and could vary per point.
+   *
+   * @since 4.29
+   */
+  elevationInfo?: ElevationInfoProperties | null;
+  /**
+   * A [SceneModification](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-SceneModification.html) collection used to apply client-side
+   * modifications to the layer. These modifications are not affected by the offset from
+   * [elevationInfo](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-IntegratedMesh3DTilesLayer.html#elevationInfo). Modifications are persisted when
+   * using [WebScene#save()](https://developers.arcgis.com/javascript/latest/api-reference/esri-WebScene.html#save), which allows you to share the modified integrated mesh
+   * through web scenes. The following types of modifications can be applied to the integrated mesh:
+   *
+   * Illustration | Modification | Description
+   * ------|------------|--------
+   * <img src="https://developers.arcgis.com/javascript/latest/assets/img/apiref/layers/modification-clip.png" alt="modification-type-clip" style="width:100px;"/>| <b>clip</b> - removes selected area | Clip-out portions of the integrated mesh to see features below. For example, utility work on gas or water lines in an area. Planners can create a scene in which the integrated mesh is clipped out at a site to expose the water or gas lines below it.
+   * <img src="https://developers.arcgis.com/javascript/latest/assets/img/apiref/layers/modification-mask.png" alt="modification-type-mask" style="width:100px;"/> | <b>mask</b> - displays only selected area |  Define an area of interest. Use a polygon and draw only parts of the integrated mesh inside that polygon. For example, if you want to show only a portion of an integrated mesh within the boundaries of a city.
+   * <img src="https://developers.arcgis.com/javascript/latest/assets/img/apiref/layers/modification-replace.png" alt="modification-type-replace" style="width:100px;"/> | <b>replace</b> - flattens selected area |Replace an area of an integrated mesh based on a 3D polygon. For example, to add constructed buildings, flatten the integrated mesh at the footprint of a building so the new building can be visualized. Create different scenarios of the new construction area and share the scenarios as a web scene to discuss with stakeholders. The integrated mesh flattens to the minimum z-vertex of the modification polygon.
+   *
+   * > [!WARNING]
+   * >
+   * > Scene modifications need to be in the same spatial reference as the layer they modify. Reprojection between WGS84
+   * > and WebMercator will be done automatically. Reprojection of the geometry to other spatial references can be done
+   * > with the [projectOperator](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-operators-projectOperator.html).
+   *
+   * @since 4.33
+   * @see [ArcGIS Pro - Modify an integrated mesh layer](https://pro.arcgis.com/en/pro-app/latest/help/mapping/layer-properties/modify-integrated-mesh-layer.htm)
+   * @see [SceneModifications](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-SceneModifications.html)
+   * @see [SceneModification](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-SceneModification.html)
+   * @see [Sample - Integrated mesh modification](https://developers.arcgis.com/javascript/latest/sample-code/layers-integratedmeshlayer-modification/)
+   * @example
+   * // create the IntegratedMesh3DTilesLayer
+   * const layer = new IntegratedMesh3DTilesLayer({ ... })
+   *
+   * // create a polygon
+   * const polygon = new Polygon({ ... });
+   *
+   * // create the modifications
+   * let modifications = new SceneModifications(
+   *   [
+   *     new SceneModification({geometry: polygon, type: 'replace'})
+   *   ]);
+   *
+   * // add the modification to the IntegratedMesh
+   * layer.modifications = modifications;
+   */
+  modifications?: SceneModificationsItems | null;
+  /** The spatial reference of the layer. */
+  spatialReference?: SpatialReferenceProperties;
+  /**
+   * The title of the layer used to identify it in places such as the [LayerList](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList.html) widget.
+   *
+   * When loading a layer by service url, the title is derived from the service name.
+   * When the layer is loaded from a portal item, the title of the portal item will be used instead.
+   * Finally, if a layer is loaded as part of a webmap or a webscene, then the title of the layer as stored in the webmap/webscene will be used.
+   */
+  title?: string | null;
+}
+
+/**
+ * The IntegratedMesh3DTilesLayer is designed for visualizing accurate representations of built and natural
+ * environments in a [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html).
+ *
+ * Integrated mesh data is typically captured by an automated process for constructing 3D features from large sets of
+ * overlapping imagery. The result integrates the original input image information as a realistic textured mesh and can
+ * include elevation information and objects such as buildings and trees. Integrated mesh layers are generally created
+ * for citywide 3D mapping; they are often captured by drone and cannot be restyled.
+ *
+ * The IntegratedMesh3DTilesLayer loads integrated mesh data based on a hierarchical data structure defined by the
+ * [3D Tiles specification](https://www.ogc.org/standard/3DTiles/). 3D Tiles are an OGC standard used to visualize large
+ * amounts of 3D content, similar to [Indexed Scene Layer (I3S)](https://www.ogc.org/standard/i3s/) scene layers. The
+ * JavaScript Maps SDK currently supports 3D Tiles data with JPEG, PNG, and KTX2/Basis textures.
+ *
+ * The 3D Tiles Service is identified by the URL of the ArcGIS Server REST resource, specifically the 3D Tiles root
+ * tileset json file:
+ *
+ * ```js
+ * const integratedMesh3DTilesLayer = new IntegratedMesh3DTilesLayer({
+ *   url: "https://tiles.arcgis.com/tiles/0z60TleH1Y2qkUzY/arcgis/rest/services/Stuttgart_WGS84/3DTilesServer/tileset.json"
+ * });
+ * ```
+ *
+ * @since 4.29
+ * @see [Sample - IntegratedMesh3DTilesLayer](https://developers.arcgis.com/javascript/latest/sample-code/layers-integratedmesh3dtileslayer/)
+ * @see [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html)
+ * @see [IntegratedMeshLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-IntegratedMeshLayer.html)
+ * @see [Map](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html)
+ */
+export default class IntegratedMesh3DTilesLayer extends IntegratedMesh3DTilesLayerSuperclass {
+  constructor(properties?: IntegratedMesh3DTilesLayerProperties);
+  /**
+   * Specifies how the mesh is placed on the vertical axis (z). This property may only be used
+   * in a [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html). See the [ElevationInfo sample](https://developers.arcgis.com/javascript/latest/sample-code/scene-elevationinfo/)
+   * for an example of how this property may be used.
+   * > [!WARNING]
+   * >
+   * > This property only affects [IntegratedMesh3DTilesLayers](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-IntegratedMesh3DTilesLayer.html) when using the `absolute-height` mode.
+   * > [ElevationInfo#featureExpressionInfo](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-support-ElevationInfo.html#featureExpressionInfo) is not supported when the elevation info is specified for this class.
+   * > Integrated mesh 3D Tiles layers always render in front of the ground surface, so setting negative offset values will not render them below the ground.
+   * > If the elevation info is not specified, the effective elevation depends on the context and could vary per point.
+   *
+   * @since 4.29
+   */
+  get elevationInfo(): ElevationInfo | null | undefined;
+  set elevationInfo(value: ElevationInfoProperties | null | undefined);
+  /**
+   * A [SceneModification](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-SceneModification.html) collection used to apply client-side
+   * modifications to the layer. These modifications are not affected by the offset from
+   * [elevationInfo](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-IntegratedMesh3DTilesLayer.html#elevationInfo). Modifications are persisted when
+   * using [WebScene#save()](https://developers.arcgis.com/javascript/latest/api-reference/esri-WebScene.html#save), which allows you to share the modified integrated mesh
+   * through web scenes. The following types of modifications can be applied to the integrated mesh:
+   *
+   * Illustration | Modification | Description
+   * ------|------------|--------
+   * <img src="https://developers.arcgis.com/javascript/latest/assets/img/apiref/layers/modification-clip.png" alt="modification-type-clip" style="width:100px;"/>| <b>clip</b> - removes selected area | Clip-out portions of the integrated mesh to see features below. For example, utility work on gas or water lines in an area. Planners can create a scene in which the integrated mesh is clipped out at a site to expose the water or gas lines below it.
+   * <img src="https://developers.arcgis.com/javascript/latest/assets/img/apiref/layers/modification-mask.png" alt="modification-type-mask" style="width:100px;"/> | <b>mask</b> - displays only selected area |  Define an area of interest. Use a polygon and draw only parts of the integrated mesh inside that polygon. For example, if you want to show only a portion of an integrated mesh within the boundaries of a city.
+   * <img src="https://developers.arcgis.com/javascript/latest/assets/img/apiref/layers/modification-replace.png" alt="modification-type-replace" style="width:100px;"/> | <b>replace</b> - flattens selected area |Replace an area of an integrated mesh based on a 3D polygon. For example, to add constructed buildings, flatten the integrated mesh at the footprint of a building so the new building can be visualized. Create different scenarios of the new construction area and share the scenarios as a web scene to discuss with stakeholders. The integrated mesh flattens to the minimum z-vertex of the modification polygon.
+   *
+   * > [!WARNING]
+   * >
+   * > Scene modifications need to be in the same spatial reference as the layer they modify. Reprojection between WGS84
+   * > and WebMercator will be done automatically. Reprojection of the geometry to other spatial references can be done
+   * > with the [projectOperator](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-operators-projectOperator.html).
+   *
+   * @since 4.33
+   * @see [ArcGIS Pro - Modify an integrated mesh layer](https://pro.arcgis.com/en/pro-app/latest/help/mapping/layer-properties/modify-integrated-mesh-layer.htm)
+   * @see [SceneModifications](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-SceneModifications.html)
+   * @see [SceneModification](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-SceneModification.html)
+   * @see [Sample - Integrated mesh modification](https://developers.arcgis.com/javascript/latest/sample-code/layers-integratedmeshlayer-modification/)
+   * @example
+   * // create the IntegratedMesh3DTilesLayer
+   * const layer = new IntegratedMesh3DTilesLayer({ ... })
+   *
+   * // create a polygon
+   * const polygon = new Polygon({ ... });
+   *
+   * // create the modifications
+   * let modifications = new SceneModifications(
+   *   [
+   *     new SceneModification({geometry: polygon, type: 'replace'})
+   *   ]);
+   *
+   * // add the modification to the IntegratedMesh
+   * layer.modifications = modifications;
+   */
+  get modifications(): SceneModifications | null | undefined;
+  set modifications(value: SceneModificationsItems | null | undefined);
+  /** The spatial reference of the layer. */
+  get spatialReference(): SpatialReference;
+  set spatialReference(value: SpatialReferenceProperties);
+  /**
+   * The title of the layer used to identify it in places such as the [LayerList](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList.html) widget.
+   *
+   * When loading a layer by service url, the title is derived from the service name.
+   * When the layer is loaded from a portal item, the title of the portal item will be used instead.
+   * Finally, if a layer is loaded as part of a webmap or a webscene, then the title of the layer as stored in the webmap/webscene will be used.
+   */
+  accessor title: string | null | undefined;
+  /**
+   * The layer type provides a convenient way to check the type of the layer
+   * without the need to import specific layer modules.
+   */
+  get type(): "integrated-mesh-3dtiles";
+  /** The URL of the root json file. */
+  accessor url: string | null | undefined;
+}
+declare const IntegratedMesh3DTilesLayerSuperclass: typeof Layer & typeof APIKeyMixin & typeof CustomParametersMixin & typeof MultiOriginJSONMixin & typeof ScaleRangeLayer & typeof PortalLayer & typeof OperationalLayer & typeof ArcGISService

package/layers/IntegratedMeshLayer.d.ts

@@ -1,4 +1,213 @@
-import "../interfaces";
+import type Layer from "./Layer.js";
+import type SceneModifications from "./support/SceneModifications.js";
+import type PortalItem from "../portal/PortalItem.js";
+import type ElevationInfo from "../symbols/support/ElevationInfo.js";
+import type { ClonableMixin, ClonableMixinProperties } from "../core/Clonable.js";
+import type { MultiOriginJSONMixin, MultiOriginJSONMixinProperties } from "../core/MultiOriginJSONSupport.js";
+import type { APIKeyMixin, APIKeyMixinProperties } from "./mixins/APIKeyMixin.js";
+import type { ArcGISService, ArcGISServiceProperties } from "./mixins/ArcGISService.js";
+import type { CustomParametersMixin, CustomParametersMixinProperties } from "./mixins/CustomParametersMixin.js";
+import type { OperationalLayer, OperationalLayerProperties } from "./mixins/OperationalLayer.js";
+import type { PortalLayer, PortalLayerProperties } from "./mixins/PortalLayer.js";
+import type { ScaleRangeLayer, ScaleRangeLayerProperties } from "./mixins/ScaleRangeLayer.js";
+import type { SaveAsOptions, SceneService, SceneServiceProperties } from "./mixins/SceneService.js";
+import type { SceneModificationsItems } from "./support/SceneModifications.js";
+import type { ElevationInfoProperties } from "../symbols/support/ElevationInfo.js";
+import type { LayerProperties } from "./Layer.js";
 
-import IntegratedMeshLayer = __esri.IntegratedMeshLayer;
-export default IntegratedMeshLayer;
+export interface IntegratedMeshLayerProperties extends LayerProperties, ClonableMixinProperties, APIKeyMixinProperties, CustomParametersMixinProperties, MultiOriginJSONMixinProperties, ScaleRangeLayerProperties, PortalLayerProperties, OperationalLayerProperties, ArcGISServiceProperties, SceneServiceProperties {
+  /**
+   * Specifies how the mesh is placed on the vertical axis (z).  This property may only be used
+   * in a [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html). See the [ElevationInfo sample](https://developers.arcgis.com/javascript/latest/sample-code/scene-elevationinfo/)
+   * for an example of how this property may be used.
+   * > [!WARNING]
+   * >
+   * > This property only affects [IntegratedMeshLayers](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-IntegratedMeshLayer.html) when using the `absolute-height` mode.
+   * > [ElevationInfo#featureExpressionInfo](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-support-ElevationInfo.html#featureExpressionInfo) is not supported when the elevation info is specified for this class.
+   * > Integrated mesh 3D Tiles layers always render in front of the ground surface, so setting negative offset values will not render them below the ground.
+   * > If the elevation info is not specified, the effective elevation depends on the context and could vary per point.
+   *
+   * @since 4.5
+   */
+  elevationInfo?: ElevationInfoProperties | null;
+  /**
+   * A [SceneModification](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-SceneModification.html) collection used to apply client-side
+   * modifications to the layer. These modifications are not affected by the offset from
+   * [elevationInfo](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-IntegratedMeshLayer.html#elevationInfo). Modifications are persisted when
+   * using [WebScene#save()](https://developers.arcgis.com/javascript/latest/api-reference/esri-WebScene.html#save), which allows you to share the modified integrated mesh
+   * through web scenes. The following types of modifications can be applied to the integrated mesh:
+   *
+   * Illustration | Modification | Description
+   * ------|------------|--------
+   * <img src="https://developers.arcgis.com/javascript/latest/assets/img/apiref/layers/modification-clip.png" alt="modification-type-clip" style="width:100px;"/>| <b>clip</b> - removes selected area | Clip-out portions of the integrated mesh to see features below. For example, utility work on gas or water lines in an area. Planners can create a scene in which the integrated mesh is clipped out at a site to expose the water or gas lines below it.
+   * <img src="https://developers.arcgis.com/javascript/latest/assets/img/apiref/layers/modification-mask.png" alt="modification-type-mask" style="width:100px;"/> | <b>mask</b> - displays only selected area |  Define an area of interest. Use a polygon and draw only parts of the integrated mesh inside that polygon. For example, if you want to show only a portion of an integrated mesh within the boundaries of a city.
+   * <img src="https://developers.arcgis.com/javascript/latest/assets/img/apiref/layers/modification-replace.png" alt="modification-type-replace" style="width:100px;"/> | <b>replace</b> - flattens selected area |Replace an area of an integrated mesh based on a 3D polygon. For example, to add constructed buildings, flatten the integrated mesh at the footprint of a building so the new building can be visualized. Create different scenarios of the new construction area and share the scenarios as a web scene to discuss with stakeholders. The integrated mesh flattens to the minimum z-vertex of the modification polygon.
+   *
+   * > [!WARNING]
+   * >
+   * > Scene modifications need to be in the same spatial reference as the layer they modify. Reprojection between WGS84
+   * > and WebMercator will be done automatically. Reprojection of the geometry to other spatial references can be done
+   * > with the [projectOperator](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-operators-projectOperator.html).
+   *
+   * @since 4.16
+   * @see [ArcGIS Pro - Modify an integrated mesh layer](https://pro.arcgis.com/en/pro-app/latest/help/mapping/layer-properties/modify-integrated-mesh-layer.htm)
+   * @see [Sample - Integrated mesh modification](https://developers.arcgis.com/javascript/latest/sample-code/layers-integratedmeshlayer-modification/)
+   * @see [SceneModifications](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-SceneModifications.html)
+   * @see [SceneModification](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-SceneModification.html)
+   * @example
+   * // create the IntegratedMeshLayer
+   * const layer = new IntegratedMeshLayer({ ... })
+   *
+   * // create a polygon
+   * const polygon = new Polygon({ ... });
+   *
+   * // create the modifications
+   * let modifications = new SceneModifications(
+   *   [
+   *     new SceneModification({geometry: polygon, type: 'replace'})
+   *   ]);
+   *
+   * // add the modification to the IntegratedMesh
+   * layer.modifications = modifications;
+   */
+  modifications?: SceneModificationsItems | null;
+  /**
+   * The title of the layer used to identify it in places such as the [LayerList](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList.html) widget.
+   *
+   * When loading a layer by service url, the title is derived from the service name.
+   * If the service has several layers, then the title of each layer will be the concatenation of the service name
+   * and the layer name.
+   * When the layer is loaded from a portal item, the title of the portal item will be used instead.
+   * Finally, if a layer is loaded as part of a webmap or a webscene, then the title of the layer as stored in the webmap/webscene will be used.
+   */
+  title?: string | null;
+}
+
+/**
+ * The IntegratedMeshLayer is designed for visualizing accurate representations of built and natural environments in a
+ * [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html).
+ *
+ * Integrated mesh data is typically captured by an automated process for constructing 3D objects from large sets of
+ * overlapping imagery. The result integrates the original input image information as a realistic textured mesh and can
+ * include elevation information and 3D objects, such as buildings and trees. Integrated mesh layers are generally
+ * created for citywide 3D mapping; they are often captured by drone and cannot be restyled.
+ *
+ * [![integratedmeshlayer](https://developers.arcgis.com/javascript/latest/assets/img/apiref/layers/integratedmeshlayer.png)](https://developers.arcgis.com/javascript/latest/sample-code/layers-integratedmeshlayer/)
+ *
+ * The Scene Service is identified by the URL of the ArcGIS Server REST resource:
+ *
+ * ```js
+ * const integratedMeshLayer = new IntegratedMeshLayer({
+ *   url: "https://tiles.arcgis.com/tiles/u0sSNqDXr7puKJrF/arcgis/rest/services/Frankfurt2017_v17/SceneServer/layers/0"
+ * });
+ * ```
+ *
+ * If the service is requested from a different domain, a [CORS enabled server](https://developers.arcgis.com/javascript/latest/cors/) or a [proxy](https://developers.arcgis.com/javascript/latest/proxies/) is
+ * required.
+ *
+ * @since 4.1
+ * @see [Sample - IntegratedMeshLayer](https://developers.arcgis.com/javascript/latest/sample-code/layers-integratedmeshlayer/)
+ * @see [SceneLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-SceneLayer.html)
+ * @see [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html)
+ * @see [Map](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html)
+ */
+export default class IntegratedMeshLayer extends IntegratedMeshLayerSuperclass {
+  constructor(properties?: IntegratedMeshLayerProperties);
+  /**
+   * Specifies how the mesh is placed on the vertical axis (z).  This property may only be used
+   * in a [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html). See the [ElevationInfo sample](https://developers.arcgis.com/javascript/latest/sample-code/scene-elevationinfo/)
+   * for an example of how this property may be used.
+   * > [!WARNING]
+   * >
+   * > This property only affects [IntegratedMeshLayers](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-IntegratedMeshLayer.html) when using the `absolute-height` mode.
+   * > [ElevationInfo#featureExpressionInfo](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-support-ElevationInfo.html#featureExpressionInfo) is not supported when the elevation info is specified for this class.
+   * > Integrated mesh 3D Tiles layers always render in front of the ground surface, so setting negative offset values will not render them below the ground.
+   * > If the elevation info is not specified, the effective elevation depends on the context and could vary per point.
+   *
+   * @since 4.5
+   */
+  get elevationInfo(): ElevationInfo | null | undefined;
+  set elevationInfo(value: ElevationInfoProperties | null | undefined);
+  /**
+   * A [SceneModification](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-SceneModification.html) collection used to apply client-side
+   * modifications to the layer. These modifications are not affected by the offset from
+   * [elevationInfo](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-IntegratedMeshLayer.html#elevationInfo). Modifications are persisted when
+   * using [WebScene#save()](https://developers.arcgis.com/javascript/latest/api-reference/esri-WebScene.html#save), which allows you to share the modified integrated mesh
+   * through web scenes. The following types of modifications can be applied to the integrated mesh:
+   *
+   * Illustration | Modification | Description
+   * ------|------------|--------
+   * <img src="https://developers.arcgis.com/javascript/latest/assets/img/apiref/layers/modification-clip.png" alt="modification-type-clip" style="width:100px;"/>| <b>clip</b> - removes selected area | Clip-out portions of the integrated mesh to see features below. For example, utility work on gas or water lines in an area. Planners can create a scene in which the integrated mesh is clipped out at a site to expose the water or gas lines below it.
+   * <img src="https://developers.arcgis.com/javascript/latest/assets/img/apiref/layers/modification-mask.png" alt="modification-type-mask" style="width:100px;"/> | <b>mask</b> - displays only selected area |  Define an area of interest. Use a polygon and draw only parts of the integrated mesh inside that polygon. For example, if you want to show only a portion of an integrated mesh within the boundaries of a city.
+   * <img src="https://developers.arcgis.com/javascript/latest/assets/img/apiref/layers/modification-replace.png" alt="modification-type-replace" style="width:100px;"/> | <b>replace</b> - flattens selected area |Replace an area of an integrated mesh based on a 3D polygon. For example, to add constructed buildings, flatten the integrated mesh at the footprint of a building so the new building can be visualized. Create different scenarios of the new construction area and share the scenarios as a web scene to discuss with stakeholders. The integrated mesh flattens to the minimum z-vertex of the modification polygon.
+   *
+   * > [!WARNING]
+   * >
+   * > Scene modifications need to be in the same spatial reference as the layer they modify. Reprojection between WGS84
+   * > and WebMercator will be done automatically. Reprojection of the geometry to other spatial references can be done
+   * > with the [projectOperator](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-operators-projectOperator.html).
+   *
+   * @since 4.16
+   * @see [ArcGIS Pro - Modify an integrated mesh layer](https://pro.arcgis.com/en/pro-app/latest/help/mapping/layer-properties/modify-integrated-mesh-layer.htm)
+   * @see [Sample - Integrated mesh modification](https://developers.arcgis.com/javascript/latest/sample-code/layers-integratedmeshlayer-modification/)
+   * @see [SceneModifications](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-SceneModifications.html)
+   * @see [SceneModification](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-SceneModification.html)
+   * @example
+   * // create the IntegratedMeshLayer
+   * const layer = new IntegratedMeshLayer({ ... })
+   *
+   * // create a polygon
+   * const polygon = new Polygon({ ... });
+   *
+   * // create the modifications
+   * let modifications = new SceneModifications(
+   *   [
+   *     new SceneModification({geometry: polygon, type: 'replace'})
+   *   ]);
+   *
+   * // add the modification to the IntegratedMesh
+   * layer.modifications = modifications;
+   */
+  get modifications(): SceneModifications | null | undefined;
+  set modifications(value: SceneModificationsItems | null | undefined);
+  /**
+   * The title of the layer used to identify it in places such as the [LayerList](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList.html) widget.
+   *
+   * When loading a layer by service url, the title is derived from the service name.
+   * If the service has several layers, then the title of each layer will be the concatenation of the service name
+   * and the layer name.
+   * When the layer is loaded from a portal item, the title of the portal item will be used instead.
+   * Finally, if a layer is loaded as part of a webmap or a webscene, then the title of the layer as stored in the webmap/webscene will be used.
+   */
+  accessor title: string | null | undefined;
+  /**
+   * The layer type provides a convenient way to check the type of the layer
+   * without the need to import specific layer modules.
+   */
+  get type(): "integrated-mesh";
+  /**
+   * Saves the layer to its existing portal item in the [Portal](https://developers.arcgis.com/javascript/latest/api-reference/esri-portal-Portal.html)
+   * authenticated within the user's current session. If the layer is not saved to a
+   * [PortalItem](https://developers.arcgis.com/javascript/latest/api-reference/esri-portal-PortalItem.html), then you should use [saveAs()](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-IntegratedMeshLayer.html#saveAs).
+   *
+   * @returns When resolved, returns the portal item to which the layer is saved.
+   * @since 4.31
+   * @see [saveAs()](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-IntegratedMeshLayer.html#saveAs)
+   * @example const portalItem = await layer.save();
+   */
+  save(): Promise<PortalItem>;
+  /**
+   * Saves the layer to a new portal item in the [Portal](https://developers.arcgis.com/javascript/latest/api-reference/esri-portal-Portal.html) authenticated within the user's current session.
+   *
+   * @param portalItem - The portal item to which the layer will be saved.
+   * @param options - additional save options
+   * @returns When resolved, returns the portal item to which the layer is saved.
+   * @since 4.31
+   * @see [save()](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-IntegratedMeshLayer.html#save)
+   * @example
+   * const portalItem = new PortalItem();
+   * await layer.saveAs(portalItem);
+   */
+  saveAs(portalItem: PortalItem, options?: SaveAsOptions): Promise<PortalItem>;
+}
+declare const IntegratedMeshLayerSuperclass: typeof Layer & typeof ClonableMixin & typeof APIKeyMixin & typeof CustomParametersMixin & typeof MultiOriginJSONMixin & typeof ScaleRangeLayer & typeof PortalLayer & typeof OperationalLayer & typeof ArcGISService & typeof SceneService

package/layers/KMLLayer.d.ts

@@ -1,4 +1,66 @@
-import "../interfaces";
+import type Collection from "../core/Collection.js";
+import type Layer from "./Layer.js";
+import type KMLSublayer from "./support/KMLSublayer.js";
+import type { MultiOriginJSONMixin, MultiOriginJSONMixinProperties } from "../core/MultiOriginJSONSupport.js";
+import type { BlendLayer, BlendLayerProperties } from "./mixins/BlendLayer.js";
+import type { OperationalLayer, OperationalLayerProperties } from "./mixins/OperationalLayer.js";
+import type { PortalLayer, PortalLayerProperties } from "./mixins/PortalLayer.js";
+import type { RefreshableLayer, RefreshableLayerProperties } from "./mixins/RefreshableLayer.js";
+import type { ScaleRangeLayer, ScaleRangeLayerProperties } from "./mixins/ScaleRangeLayer.js";
+import type { KMLSublayerProperties } from "./support/KMLSublayer.js";
+import type { ReadonlyArrayOrCollection } from "../core/Collection.js";
+import type { LayerProperties } from "./Layer.js";
 
-import KMLLayer = __esri.KMLLayer;
-export default KMLLayer;
+export interface KMLLayerProperties extends LayerProperties, MultiOriginJSONMixinProperties, PortalLayerProperties, OperationalLayerProperties, ScaleRangeLayerProperties, RefreshableLayerProperties, BlendLayerProperties, Partial<Pick<KMLLayer, "url">> {
+  /** A collection of [KMLSublayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-KMLSublayer.html)s. */
+  sublayers?: ReadonlyArrayOrCollection<KMLSublayerProperties> | null;
+  /** The title of the layer used to identify it in places such as the [LayerList](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList.html) widget. */
+  title?: string | null;
+}
+
+/**
+ * The KMLLayer class is used to create a layer based on a KML file (.kml, .kmz).
+ * KML is an XML-based file format used to represent geographic features.
+ *
+ * The KMLLayer uses a utility service from [ArcGIS.com](https://www.arcgis.com), therefore your kml/kmz files must be
+ * publicly accessible on the internet. If the kml/kmz files are behind a firewall, you must set the
+ * [esriConfig.kmlServiceUrl](https://developers.arcgis.com/javascript/latest/api-reference/esri-config.html#ConfigWithKmlServiceUrl) to your own utility service (requires ArcGIS Enterprise).
+ *
+ * > [!WARNING]
+ * >
+ * > **Known Limitations**
+ * >
+ * > Currently, the KMLLayer is not supported in SceneView.
+ * > Currently, the KMLLayer is not supported with the [LayerList](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList.html) widget.
+ * > [KMLMapImage](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-KMLMapImage.html) is only supported when the [MapView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html)'s
+ * > spatial reference is either WGS84 (wkid: 4326) or Web Mercator (wkid: 3857, 102100).
+ * > Inline styles are not supported when displaying pop-ups in KML layers.
+ * > For additional limitations, please refer to the ArcGIS Online [limitations using KML layers](https://doc.arcgis.com/en/arcgis-online/reference/kml.htm) documentation.
+ *
+ * @since 4.5
+ * @see [Sample - KMLLayer](https://developers.arcgis.com/javascript/latest/sample-code/layers-kml/)
+ * @see [KMLSublayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-KMLSublayer.html)
+ */
+export default class KMLLayer extends KMLLayerSuperclass {
+  /**
+   * @example
+   * // Typical usage
+   * KMLLayer = new KMLLayer({
+   *   url: "http://quickmap.dot.ca.gov/data/lcs.kml"// url to the service
+   * });
+   */
+  constructor(properties?: KMLLayerProperties);
+  /** A collection of [KMLSublayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-KMLSublayer.html)s. */
+  get sublayers(): Collection<KMLSublayer> | null | undefined;
+  set sublayers(value: ReadonlyArrayOrCollection<KMLSublayerProperties> | null | undefined);
+  /** The title of the layer used to identify it in places such as the [LayerList](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList.html) widget. */
+  accessor title: string | null | undefined;
+  /**
+   * The layer type provides a convenient way to check the type of the layer
+   * without the need to import specific layer modules.
+   */
+  get type(): "kml";
+  /** The publicly accessible URL for a .kml or .kmz file. */
+  accessor url: string | null | undefined;
+}
+declare const KMLLayerSuperclass: typeof Layer & typeof MultiOriginJSONMixin & typeof PortalLayer & typeof OperationalLayer & typeof ScaleRangeLayer & typeof RefreshableLayer & typeof BlendLayer