@arcgis/core 5.2.0-next.164 → 5.2.0-next.166

package/graphic/SketchGraphicOrigin.d.ts

@@ -6,9 +6,52 @@ import type SketchLayer from "../layers/SketchLayer.js";
  * The [origin](https://developers.arcgis.com/javascript/latest/references/core/Graphic/#origin) information may be available when a graphic is returned from methods such as
  * [hitTest()](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#hitTest).
  *
+ * Before accessing the layer properties, use [isSketchGraphicOrigin](https://developers.arcgis.com/javascript/latest/references/core/graphic/isSketchGraphicOrigin/) to check
+ * whether the graphic's origin is a SketchGraphicOrigin.
+ *
  * @since 5.2
  * @see [MapView.hitTest()](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#hitTest)
  * @see [Map component hitTest()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#hitTest)
+ * @example
+ * Access the layer and sublayer of a graphic that originated from a MapImageLayer.
+ * ```js
+ * import { isMapImageGraphicOrigin } from "@arcgis/core/graphic/isMapImageGraphicOrigin.js";
+ *
+ * const origin = graphic.origin;
+ *
+ * // Check whether the graphic came from a MapImageLayer
+ * if (isMapImageGraphicOrigin(origin)) {
+ *   console.log(origin.layer.title);
+ *   console.log(origin.sublayer.title);
+ * }
+ * ```
+ * @example
+ * Access the vector tile style layer associated with a graphic returned by hitTest().
+ * ```js
+ * import { isVectorTileGraphicOrigin } from "@arcgis/core/graphic/isVectorTileGraphicOrigin.js";
+ *
+ * viewElement.addEventListener("arcgisViewClick", async (event) => {
+ *   // Get hit-test results from the VectorTileLayer at the clicked location
+ *   const response = await view.hitTest(event.detail, { include: vectorTileLayer });
+ *
+ *   for (const result of response.results) {
+ *     // Only graphic results contain a graphic with origin information
+ *     if (result.type !== "graphic") {
+ *       continue;
+ *     }
+ *
+ *     const graphic = result.graphic;
+ *     const origin = graphic.origin;
+ *
+ *     // Check whether the graphic came from a VectorTileLayer
+ *     if (isVectorTileGraphicOrigin(origin)) {
+ *       // layerId identifies a style layer within the VectorTileLayer
+ *       const styleLayer = origin.layer.getStyleLayer(origin.layerId);
+ *       console.log(styleLayer);
+ *     }
+ *   }
+ * });
+ * ```
  */
 export default class SketchGraphicOrigin extends GraphicOrigin {
   constructor(layer: SketchLayer);

package/graphic/StreamGraphicOrigin.d.ts

@@ -6,12 +6,55 @@ import type StreamLayer from "../layers/StreamLayer.js";
  * The [origin](https://developers.arcgis.com/javascript/latest/references/core/Graphic/#origin) information may be available when a graphic is returned from methods such as
  * [hitTest()](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#hitTest) or [queryFeatures()](https://developers.arcgis.com/javascript/latest/references/core/views/layers/StreamLayerView/#queryFeatures).
  *
+ * Before accessing the layer properties, use [isStreamGraphicOrigin](https://developers.arcgis.com/javascript/latest/references/core/graphic/isStreamGraphicOrigin/) to check
+ * whether the graphic's origin is a StreamGraphicOrigin.
+ *
  * @since 5.0
  * @see [MapView.hitTest()](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#hitTest)
  * @see [SceneView.hitTest()](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/#hitTest)
  * @see [Map component hitTest()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#hitTest)
  * @see [Scene component hitTest()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#hitTest)
  * @see [StreamLayerView.queryFeatures()](https://developers.arcgis.com/javascript/latest/references/core/views/layers/StreamLayerView/#queryFeatures)
+ * @example
+ * Access the layer and sublayer of a graphic that originated from a MapImageLayer.
+ * ```js
+ * import { isMapImageGraphicOrigin } from "@arcgis/core/graphic/isMapImageGraphicOrigin.js";
+ *
+ * const origin = graphic.origin;
+ *
+ * // Check whether the graphic came from a MapImageLayer
+ * if (isMapImageGraphicOrigin(origin)) {
+ *   console.log(origin.layer.title);
+ *   console.log(origin.sublayer.title);
+ * }
+ * ```
+ * @example
+ * Access the vector tile style layer associated with a graphic returned by hitTest().
+ * ```js
+ * import { isVectorTileGraphicOrigin } from "@arcgis/core/graphic/isVectorTileGraphicOrigin.js";
+ *
+ * viewElement.addEventListener("arcgisViewClick", async (event) => {
+ *   // Get hit-test results from the VectorTileLayer at the clicked location
+ *   const response = await view.hitTest(event.detail, { include: vectorTileLayer });
+ *
+ *   for (const result of response.results) {
+ *     // Only graphic results contain a graphic with origin information
+ *     if (result.type !== "graphic") {
+ *       continue;
+ *     }
+ *
+ *     const graphic = result.graphic;
+ *     const origin = graphic.origin;
+ *
+ *     // Check whether the graphic came from a VectorTileLayer
+ *     if (isVectorTileGraphicOrigin(origin)) {
+ *       // layerId identifies a style layer within the VectorTileLayer
+ *       const styleLayer = origin.layer.getStyleLayer(origin.layerId);
+ *       console.log(styleLayer);
+ *     }
+ *   }
+ * });
+ * ```
  */
 export default class StreamGraphicOrigin extends GraphicOrigin {
   constructor(layer: StreamLayer);

package/graphic/SubtypeGroupGraphicOrigin.d.ts

@@ -4,14 +4,62 @@ import type SubtypeSublayer from "../layers/support/SubtypeSublayer.js";
 
 /**
  * Provides information about the [SubtypeGroupLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/SubtypeGroupLayer/) from which a graphic originates.
- * Also provides access to the [SubtypeSublayer](https://developers.arcgis.com/javascript/latest/references/core/layers/support/SubtypeSublayer/) that contains the graphic.
+ * The [layer](https://developers.arcgis.com/javascript/latest/references/core/graphic/SubtypeGroupGraphicOrigin/#layer) property references the SubtypeGroupLayer, and the
+ * origin includes the [SubtypeSublayer](https://developers.arcgis.com/javascript/latest/references/core/layers/support/SubtypeSublayer/) that contains the graphic.
  * The [origin](https://developers.arcgis.com/javascript/latest/references/core/Graphic/#origin) information may be available when a graphic is returned from methods such as
  * [hitTest()](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#hitTest) or [queryFeatures()](https://developers.arcgis.com/javascript/latest/references/core/layers/support/SubtypeSublayer/#queryFeatures).
  *
+ * Before accessing the layer properties, use [isSubtypeGroupGraphicOrigin](https://developers.arcgis.com/javascript/latest/references/core/graphic/isSubtypeGroupGraphicOrigin/) to check
+ * whether the graphic's origin is a SubtypeGroupGraphicOrigin.
+ *
+ * If you only need the title of the originating subtype sublayer, use [getGraphicOriginTitle](https://developers.arcgis.com/javascript/latest/references/core/graphic/getGraphicOriginTitle/).
+ * To get the popup template applicable to the graphic, call [Graphic.getEffectivePopupTemplate()](https://developers.arcgis.com/javascript/latest/references/core/Graphic/#getEffectivePopupTemplate) on the graphic
+ * instead of accessing the subtype sublayer's template directly.
+ *
  * @since 5.0
  * @see [MapView.hitTest()](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#hitTest)
  * @see [Map component hitTest()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#hitTest)
  * @see [SubtypeSublayer.queryFeatures()](https://developers.arcgis.com/javascript/latest/references/core/layers/support/SubtypeSublayer/#queryFeatures)
+ * @example
+ * Access the layer and sublayer of a graphic that originated from a MapImageLayer.
+ * ```js
+ * import { isMapImageGraphicOrigin } from "@arcgis/core/graphic/isMapImageGraphicOrigin.js";
+ *
+ * const origin = graphic.origin;
+ *
+ * // Check whether the graphic came from a MapImageLayer
+ * if (isMapImageGraphicOrigin(origin)) {
+ *   console.log(origin.layer.title);
+ *   console.log(origin.sublayer.title);
+ * }
+ * ```
+ * @example
+ * Access the vector tile style layer associated with a graphic returned by hitTest().
+ * ```js
+ * import { isVectorTileGraphicOrigin } from "@arcgis/core/graphic/isVectorTileGraphicOrigin.js";
+ *
+ * viewElement.addEventListener("arcgisViewClick", async (event) => {
+ *   // Get hit-test results from the VectorTileLayer at the clicked location
+ *   const response = await view.hitTest(event.detail, { include: vectorTileLayer });
+ *
+ *   for (const result of response.results) {
+ *     // Only graphic results contain a graphic with origin information
+ *     if (result.type !== "graphic") {
+ *       continue;
+ *     }
+ *
+ *     const graphic = result.graphic;
+ *     const origin = graphic.origin;
+ *
+ *     // Check whether the graphic came from a VectorTileLayer
+ *     if (isVectorTileGraphicOrigin(origin)) {
+ *       // layerId identifies a style layer within the VectorTileLayer
+ *       const styleLayer = origin.layer.getStyleLayer(origin.layerId);
+ *       console.log(styleLayer);
+ *     }
+ *   }
+ * });
+ * ```
  */
 export default class SubtypeGroupGraphicOrigin extends GraphicOrigin {
   constructor(sublayer: SubtypeSublayer);

package/graphic/TileGraphicOrigin.d.ts

@@ -4,10 +4,58 @@ import type Sublayer from "../layers/support/Sublayer.js";
 
 /**
  * Provides information about the [TileLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/TileLayer/) from which a graphic originates.
- * Also provides access to the [Sublayer](https://developers.arcgis.com/javascript/latest/references/core/layers/support/Sublayer/) that contains the graphic.
+ * The [layer](https://developers.arcgis.com/javascript/latest/references/core/graphic/TileGraphicOrigin/#layer) property references the TileLayer, and the
+ * [sublayer](https://developers.arcgis.com/javascript/latest/references/core/graphic/TileGraphicOrigin/#sublayer) property references the [Sublayer](https://developers.arcgis.com/javascript/latest/references/core/layers/support/Sublayer/) that contains the graphic.
  * You can access the graphic's origin through the graphic's [origin](https://developers.arcgis.com/javascript/latest/references/core/Graphic/#origin) property.
  *
+ * Before accessing the layer properties, use [isTileGraphicOrigin](https://developers.arcgis.com/javascript/latest/references/core/graphic/isTileGraphicOrigin/) to check
+ * whether the graphic's origin is a TileGraphicOrigin.
+ *
+ * If you only need the title of the originating sublayer, use [getGraphicOriginTitle](https://developers.arcgis.com/javascript/latest/references/core/graphic/getGraphicOriginTitle/).
+ * To get the popup template applicable to the graphic, call [Graphic.getEffectivePopupTemplate()](https://developers.arcgis.com/javascript/latest/references/core/Graphic/#getEffectivePopupTemplate) on the graphic
+ * instead of accessing the sublayer's template directly.
+ *
  * @since 5.0
+ * @example
+ * Access the layer and sublayer of a graphic that originated from a MapImageLayer.
+ * ```js
+ * import { isMapImageGraphicOrigin } from "@arcgis/core/graphic/isMapImageGraphicOrigin.js";
+ *
+ * const origin = graphic.origin;
+ *
+ * // Check whether the graphic came from a MapImageLayer
+ * if (isMapImageGraphicOrigin(origin)) {
+ *   console.log(origin.layer.title);
+ *   console.log(origin.sublayer.title);
+ * }
+ * ```
+ * @example
+ * Access the vector tile style layer associated with a graphic returned by hitTest().
+ * ```js
+ * import { isVectorTileGraphicOrigin } from "@arcgis/core/graphic/isVectorTileGraphicOrigin.js";
+ *
+ * viewElement.addEventListener("arcgisViewClick", async (event) => {
+ *   // Get hit-test results from the VectorTileLayer at the clicked location
+ *   const response = await view.hitTest(event.detail, { include: vectorTileLayer });
+ *
+ *   for (const result of response.results) {
+ *     // Only graphic results contain a graphic with origin information
+ *     if (result.type !== "graphic") {
+ *       continue;
+ *     }
+ *
+ *     const graphic = result.graphic;
+ *     const origin = graphic.origin;
+ *
+ *     // Check whether the graphic came from a VectorTileLayer
+ *     if (isVectorTileGraphicOrigin(origin)) {
+ *       // layerId identifies a style layer within the VectorTileLayer
+ *       const styleLayer = origin.layer.getStyleLayer(origin.layerId);
+ *       console.log(styleLayer);
+ *     }
+ *   }
+ * });
+ * ```
  */
 export default class TileGraphicOrigin extends GraphicOrigin {
   constructor(layer: TileLayer, sublayer: Sublayer);

package/graphic/VectorTileGraphicOrigin.d.ts

@@ -11,24 +11,53 @@ import type VectorTileLayer from "../layers/VectorTileLayer.js";
  * Spatial information about the actual feature represented in the style layer is returned only
  * if the style layer is a [symbol layer](https://maplibre.org/maplibre-style-spec/layers/#symbol). Otherwise, the graphic's geometry is `null`.
  *
- * @example
- * // get screen point from view's click event
- * view.on("click", (event) => {
- *   // Search for all features only on included layers at the clicked location
- *   view.hitTest(event, {include: vectorTileLayer}).then((response) => {
- *     // if graphics are returned from vector tile layer, do something with results
- *     if (response.results.length){
- *       response.results.forEach((result, i) => {
- *         const layerId = result.graphic?.origin?.layerId;
- *         const styleLayer = vectorTileLayer.getStyleLayer(layerId);
- *         // update vector tile layer's style
- *       });
- *     }
- *   })
+ * Before accessing the layer properties, use [isVectorTileGraphicOrigin](https://developers.arcgis.com/javascript/latest/references/core/graphic/isVectorTileGraphicOrigin/) to check
+ * whether the graphic's origin is a VectorTileGraphicOrigin.
+ *
  * @since 4.34
  * @see [MapView.hitTest()](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#hitTest)
  * @see [Map component hitTest()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#hitTest)
  * @see [Sample - VectorTileLayer hitTest](https://developers.arcgis.com/javascript/latest/sample-code/layers-vectortilelayer-hittest/)
+ * @example
+ * Access the layer and sublayer of a graphic that originated from a MapImageLayer.
+ * ```js
+ * import { isMapImageGraphicOrigin } from "@arcgis/core/graphic/isMapImageGraphicOrigin.js";
+ *
+ * const origin = graphic.origin;
+ *
+ * // Check whether the graphic came from a MapImageLayer
+ * if (isMapImageGraphicOrigin(origin)) {
+ *   console.log(origin.layer.title);
+ *   console.log(origin.sublayer.title);
+ * }
+ * ```
+ * @example
+ * Access the vector tile style layer associated with a graphic returned by hitTest().
+ * ```js
+ * import { isVectorTileGraphicOrigin } from "@arcgis/core/graphic/isVectorTileGraphicOrigin.js";
+ *
+ * viewElement.addEventListener("arcgisViewClick", async (event) => {
+ *   // Get hit-test results from the VectorTileLayer at the clicked location
+ *   const response = await view.hitTest(event.detail, { include: vectorTileLayer });
+ *
+ *   for (const result of response.results) {
+ *     // Only graphic results contain a graphic with origin information
+ *     if (result.type !== "graphic") {
+ *       continue;
+ *     }
+ *
+ *     const graphic = result.graphic;
+ *     const origin = graphic.origin;
+ *
+ *     // Check whether the graphic came from a VectorTileLayer
+ *     if (isVectorTileGraphicOrigin(origin)) {
+ *       // layerId identifies a style layer within the VectorTileLayer
+ *       const styleLayer = origin.layer.getStyleLayer(origin.layerId);
+ *       console.log(styleLayer);
+ *     }
+ *   }
+ * });
+ * ```
  */
 export default class VectorTileGraphicOrigin extends GraphicOrigin {
   constructor(layer: VectorTileLayer, layerId: string, layerIndex: number);

package/graphic/VoxelGraphicOrigin.d.ts

@@ -6,9 +6,52 @@ import type VoxelLayer from "../layers/VoxelLayer.js";
  * The [origin](https://developers.arcgis.com/javascript/latest/references/core/Graphic/#origin) information may be available when a graphic is returned from methods such as
  * [hitTest()](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/#hitTest).
  *
+ * Before accessing the layer properties, use [isVoxelGraphicOrigin](https://developers.arcgis.com/javascript/latest/references/core/graphic/isVoxelGraphicOrigin/) to check
+ * whether the graphic's origin is a VoxelGraphicOrigin.
+ *
  * @since 5.0
  * @see [SceneView.hitTest()](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/#hitTest)
  * @see [Scene component hitTest()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#hitTest)
+ * @example
+ * Access the layer and sublayer of a graphic that originated from a MapImageLayer.
+ * ```js
+ * import { isMapImageGraphicOrigin } from "@arcgis/core/graphic/isMapImageGraphicOrigin.js";
+ *
+ * const origin = graphic.origin;
+ *
+ * // Check whether the graphic came from a MapImageLayer
+ * if (isMapImageGraphicOrigin(origin)) {
+ *   console.log(origin.layer.title);
+ *   console.log(origin.sublayer.title);
+ * }
+ * ```
+ * @example
+ * Access the vector tile style layer associated with a graphic returned by hitTest().
+ * ```js
+ * import { isVectorTileGraphicOrigin } from "@arcgis/core/graphic/isVectorTileGraphicOrigin.js";
+ *
+ * viewElement.addEventListener("arcgisViewClick", async (event) => {
+ *   // Get hit-test results from the VectorTileLayer at the clicked location
+ *   const response = await view.hitTest(event.detail, { include: vectorTileLayer });
+ *
+ *   for (const result of response.results) {
+ *     // Only graphic results contain a graphic with origin information
+ *     if (result.type !== "graphic") {
+ *       continue;
+ *     }
+ *
+ *     const graphic = result.graphic;
+ *     const origin = graphic.origin;
+ *
+ *     // Check whether the graphic came from a VectorTileLayer
+ *     if (isVectorTileGraphicOrigin(origin)) {
+ *       // layerId identifies a style layer within the VectorTileLayer
+ *       const styleLayer = origin.layer.getStyleLayer(origin.layerId);
+ *       console.log(styleLayer);
+ *     }
+ *   }
+ * });
+ * ```
  */
 export default class VoxelGraphicOrigin extends GraphicOrigin {
   constructor(layer: VoxelLayer);

package/graphic/WCSGraphicOrigin.d.ts

@@ -5,7 +5,50 @@ import type WCSLayer from "../layers/WCSLayer.js";
  * Provides information about the [WCSLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/WCSLayer/) from which a graphic originates.
  * You can access the graphic's origin through the graphic's [origin](https://developers.arcgis.com/javascript/latest/references/core/Graphic/#origin) property.
  *
+ * Before accessing the layer properties, use [isWCSGraphicOrigin](https://developers.arcgis.com/javascript/latest/references/core/graphic/isWCSGraphicOrigin/) to check
+ * whether the graphic's origin is a WCSGraphicOrigin.
+ *
  * @since 5.0
+ * @example
+ * Access the layer and sublayer of a graphic that originated from a MapImageLayer.
+ * ```js
+ * import { isMapImageGraphicOrigin } from "@arcgis/core/graphic/isMapImageGraphicOrigin.js";
+ *
+ * const origin = graphic.origin;
+ *
+ * // Check whether the graphic came from a MapImageLayer
+ * if (isMapImageGraphicOrigin(origin)) {
+ *   console.log(origin.layer.title);
+ *   console.log(origin.sublayer.title);
+ * }
+ * ```
+ * @example
+ * Access the vector tile style layer associated with a graphic returned by hitTest().
+ * ```js
+ * import { isVectorTileGraphicOrigin } from "@arcgis/core/graphic/isVectorTileGraphicOrigin.js";
+ *
+ * viewElement.addEventListener("arcgisViewClick", async (event) => {
+ *   // Get hit-test results from the VectorTileLayer at the clicked location
+ *   const response = await view.hitTest(event.detail, { include: vectorTileLayer });
+ *
+ *   for (const result of response.results) {
+ *     // Only graphic results contain a graphic with origin information
+ *     if (result.type !== "graphic") {
+ *       continue;
+ *     }
+ *
+ *     const graphic = result.graphic;
+ *     const origin = graphic.origin;
+ *
+ *     // Check whether the graphic came from a VectorTileLayer
+ *     if (isVectorTileGraphicOrigin(origin)) {
+ *       // layerId identifies a style layer within the VectorTileLayer
+ *       const styleLayer = origin.layer.getStyleLayer(origin.layerId);
+ *       console.log(styleLayer);
+ *     }
+ *   }
+ * });
+ * ```
  */
 export default class WCSGraphicOrigin extends GraphicOrigin {
   constructor(layer: WCSLayer);

package/graphic/WFSGraphicOrigin.d.ts

@@ -6,6 +6,9 @@ import type WFSLayer from "../layers/WFSLayer.js";
  * The [origin](https://developers.arcgis.com/javascript/latest/references/core/Graphic/#origin) information may be available when a graphic is returned from methods such as
  * [hitTest()](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#hitTest) or [queryFeatures()](https://developers.arcgis.com/javascript/latest/references/core/layers/WFSLayer/#queryFeatures).
  *
+ * Before accessing the layer properties, use [isWFSGraphicOrigin](https://developers.arcgis.com/javascript/latest/references/core/graphic/isWFSGraphicOrigin/) to check
+ * whether the graphic's origin is a WFSGraphicOrigin.
+ *
  * @since 5.0
  * @see [MapView.hitTest()](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#hitTest)
  * @see [SceneView.hitTest()](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/#hitTest)
@@ -14,15 +17,45 @@ import type WFSLayer from "../layers/WFSLayer.js";
  * @see [WFSLayer.queryFeatures()](https://developers.arcgis.com/javascript/latest/references/core/layers/WFSLayer/#queryFeatures)
  * @see [WFSLayerView.queryFeatures()](https://developers.arcgis.com/javascript/latest/references/core/views/layers/WFSLayerView/#queryFeatures)
  * @example
- * // get a point from view's click event
- *  view.on("click", async (event) => {
- *    // Search for all features only on included layer at the clicked location
- *    const response = await view.hitTest(event, {include: layer});
- *    // if graphics are returned from layer, get the layer id from graphic origin
- *    if (response.results.length > 0) {
- *      const originId = response.results[0].graphic?.origin?.layer?.id;
- *    }
- *  });
+ * Access the layer and sublayer of a graphic that originated from a MapImageLayer.
+ * ```js
+ * import { isMapImageGraphicOrigin } from "@arcgis/core/graphic/isMapImageGraphicOrigin.js";
+ *
+ * const origin = graphic.origin;
+ *
+ * // Check whether the graphic came from a MapImageLayer
+ * if (isMapImageGraphicOrigin(origin)) {
+ *   console.log(origin.layer.title);
+ *   console.log(origin.sublayer.title);
+ * }
+ * ```
+ * @example
+ * Access the vector tile style layer associated with a graphic returned by hitTest().
+ * ```js
+ * import { isVectorTileGraphicOrigin } from "@arcgis/core/graphic/isVectorTileGraphicOrigin.js";
+ *
+ * viewElement.addEventListener("arcgisViewClick", async (event) => {
+ *   // Get hit-test results from the VectorTileLayer at the clicked location
+ *   const response = await view.hitTest(event.detail, { include: vectorTileLayer });
+ *
+ *   for (const result of response.results) {
+ *     // Only graphic results contain a graphic with origin information
+ *     if (result.type !== "graphic") {
+ *       continue;
+ *     }
+ *
+ *     const graphic = result.graphic;
+ *     const origin = graphic.origin;
+ *
+ *     // Check whether the graphic came from a VectorTileLayer
+ *     if (isVectorTileGraphicOrigin(origin)) {
+ *       // layerId identifies a style layer within the VectorTileLayer
+ *       const styleLayer = origin.layer.getStyleLayer(origin.layerId);
+ *       console.log(styleLayer);
+ *     }
+ *   }
+ * });
+ * ```
  */
 export default class WFSGraphicOrigin extends GraphicOrigin {
   constructor(layer: WFSLayer);

package/graphic/getGraphicOriginTitle.d.ts

@@ -1,10 +1,28 @@
+/**
+ * Provides utility method for getting the title of the layer or sublayer a graphic came from.
+ *
+ * @since 5.2
+ */
 import type GraphicOrigin from "./GraphicOrigin.js";
 
 /**
- * Returns the title of the graphic's origin, preferring the sublayer title if available, and falling back to the layer title.
+ * Returns a title that identifies the [origin](https://developers.arcgis.com/javascript/latest/references/core/Graphic/#origin) of a graphic.
+ * Use the returned title to show users which layer or sublayer a graphic came from when displaying query or hitTest results.
+ *
+ * If the origin's sublayer has a `title` property, the function returns that value. Otherwise, it returns the origin's layer title if the layer has a `title` property.
+ * For example, for a graphic from a sublayer titled "Roads" in a layer titled "Transportation", the function returns "Roads".
  *
- * @param origin - The graphic's origin.
- * @returns The title of the origin's sublayer if available, otherwise the title of the origin's layer.
+ * @param origin - The origin information associated with a graphic. See [Graphic.origin](https://developers.arcgis.com/javascript/latest/references/core/Graphic/#origin).
+ * @returns The sublayer's title if it has a `title` property, otherwise the layer's title
+ * if it has a `title` property, or `undefined` if neither has one.
  * @since 5.2
+ * @example
+ * Get the origin title of a graphic returned by a hit test or query.
+ * ```js
+ * if (graphic.origin) {
+ *   const title = getGraphicOriginTitle(graphic.origin);
+ *   console.log(title);
+ * }
+ * ```
  */
 export function getGraphicOriginTitle(origin: GraphicOrigin): string | null | undefined;

package/kernel.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import"./core/has.js";import{addQueryParameter as e}from"./core/urlUtils.js";Symbol.dispose??=Symbol(`Symbol.dispose`),Symbol.asyncDispose??=Symbol(`Symbol.asyncDispose`);const t=`5.2`;let n=`5.2`;n=`5.2.0-next.164`;let r;function i(e){r=e}function a(t){let n=r?.findCredential(t);return n?.token?e(t,`token`,n.token):t}globalThis.$arcgis||Object.defineProperty(globalThis,"$arcgis",{configurable:!1,enumerable:!0,writable:!1,value:{}});export{a as addTokenParameter,n as fullVersion,r as id,i as setId,t as version};
+import"./core/has.js";import{addQueryParameter as e}from"./core/urlUtils.js";Symbol.dispose??=Symbol(`Symbol.dispose`),Symbol.asyncDispose??=Symbol(`Symbol.asyncDispose`);const t=`5.2`;let n=`5.2`;n=`5.2.0-next.166`;let r;function i(e){r=e}function a(t){let n=r?.findCredential(t);return n?.token?e(t,`token`,n.token):t}globalThis.$arcgis||Object.defineProperty(globalThis,"$arcgis",{configurable:!1,enumerable:!0,writable:!1,value:{}});export{a as addTokenParameter,n as fullVersion,r as id,i as setId,t as version};

package/layers/GaussianSplatLayer.d.ts

@@ -63,12 +63,13 @@ export interface GaussianSplatLayerProperties extends LayerProperties, APIKeyMix
  * Gaussian splats are optimized during a training process. When rendered together, Gaussian splats blend to form a smooth,
  * photorealistic 3D representation.
  *
- * Unlike mesh-based representations, Gaussian Splat layers represent surfaces using a large set of semi-transparent 3D Gaussians. Depending on the source data and reconstruction, the resulting surface may contain minor outliers or holes. These artifacts are often not visually prominent, but can affect analytical tools.
+ * Unlike mesh-based layers, which define surfaces through connected polygons, Gaussian Splat layers have no explicit surface representation. Depending on the source data and reconstruction, the resulting surface may contain minor outliers or holes. These artifacts are often not visually prominent, but can affect analytical tools. Analysis results reflect the underlying Gaussian Splat representation. As a result, surface noise or reconstruction artifacts that are subtle in the visualization may become more apparent and analysis boundaries may appear less sharply defined than in comparable results generated from integrated mesh layers.
  *
  * > [!WARNING]
  * >
  * > **Known Limitations**
  * >
+ * > * Currently, Volume Measurement is not supported.
  * > * When using the [Slice component](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slice/), the slice plane will, contrary to the behavior described in [`tiltEnabled`](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slice/#tiltEnabled), not automatically align to the underlying surface of a Gaussian Splat layer due to the absence of surface normals.
  * > * Gaussian splat layers are not guaranteed to always draw correctly in a local scene using WGS84 as spatial reference
  * >   (WKID 4326).

package/layers/GeospatialPDFLayer.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/Error.js";import{MultiOriginJSONSupportMixin as n}from"../core/MultiOriginJSONSupport.js";import{property as r,subclass as i}from"../core/accessorSupport/decorators.js";import{ensureClass as a}from"../core/accessorSupport/ensureType.js";import o from"../geometry/SpatialReference.js";import{getInfo as s}from"../geometry/support/spatialReferenceUtils.js";import c from"./Layer.js";import{BlendLayer as l}from"./mixins/BlendLayer.js";import{RasterJobHandlerMixin as u}from"./mixins/RasterJobHandlerMixin.js";import{ScaleRangeLayer as d}from"./mixins/ScaleRangeLayer.js";import f from"./raster/datasets/GeospatialPDFRaster.js";import{clip as p}from"./raster/functions/clipUtils.js";import m from"./support/PortalItemData.js";import h from"./support/TileInfo.js";let g=class extends l(d(u(n(c)))){constructor(e){super(e),this._frame=null,this._objectURL=null,this.clippedToNeatline=!1,this.data=null,this.raster=null,this.serviceRasterInfo=null,this.spatialReference=null,this.type=`geospatial-pdf`}load(e){return this.addResolvingPromise(this._load(e)),Promise.resolve(this)}destroy(){this._shutdownJobHandler(),this.raster?.destroy(),this._objectURL&&=(URL.revokeObjectURL(this._objectURL),null)}get fullExtent(){return this.serviceRasterInfo?.extent}async fetchImageBitmapTile(){throw new t(`geospatial-pdf-layer:fetch-image-bitmap-tile`,`GeospatialPDFLayer does not expose pre-rendered image tile URLs.`)}async fetchPixels(e,t,n,r={}){return _(this),await this._initJobHandler(),this.raster.fetchPixels(e,Math.round(t),Math.round(n),r)}async fetchTile(e,n,r,i={}){if(_(this),i.requestAsImageElement)throw new t(`geospatial-pdf-layer:fetch-tile`,`GeospatialPDFLayer does not support requestAsImageElement.`);await this._initJobHandler();let a=await this.raster.fetchTile(e,n,r,i),o=this.clippedToNeatline?this._frame?.sourceNeatlinePolygon:this._frame?.sourceMediaBoxPolygon;return o&&a.pixelBlock&&this._frame&&a.srcExtent&&(a.pixelBlock=await p(a.pixelBlock,a.srcExtent,o)),a}getCompatibleFullExtent(e){return this.loaded?(this._compatibleFullExtent?.spatialReference.equals(e)||(this._compatibleFullExtent=this.raster.computeExtent(e)),this._compatibleFullExtent):null}getCompatibleTileInfo(e,t,n=!1){if(!this.loaded||t==null)return null;if(n&&e.equals(this.spatialReference))return this.tileInfo;let r=s(e);return h.create({size:256,spatialReference:e,origin:r?{x:r.origin[0],y:r.origin[1]}:{x:t.xmin,y:t.ymax}})}getRawDisplayBandIds(){return _(this),[0,1,2]}async _initJobHandler(){if(!this._rasterJobHandler)return super._initJobHandler().then(()=>{this._rasterJobHandler&&(_(this),this.raster.rasterJobHandler=this._rasterJobHandler)}).catch(()=>{})}_shutdownJobHandler(){super._shutdownJobHandler(),this.raster&&(this.raster.rasterJobHandler=null)}async _getDataUrl(e){let{data:n}=this;if(typeof n==`string`)return n;if(n instanceof File)return this._objectURL=URL.createObjectURL(n),this._objectURL;if(n instanceof m){await n.portalItem.load({signal:e?.signal});let r=n.portalItem.url;if(!r)throw new t(`geospatial-pdf-layer:load`,`Portal item does not have a valid data URL.`);return r}throw new t(`geospatialpdf-layer:missing-data`,`A data source must be specified.`)}async _load(e){let t=await this._getDataUrl(e);await this._openRaster(t,e?.signal)}async _openRaster(e,n){let r=new f({url:e});if(await r.open({signal:n}),!r.rasterInfo)throw r.destroy(),new t(`geospatialpdf-layer:load`,`cannot load resources on `+e);let{rasterInfo:i}=r;this._set(`serviceRasterInfo`,i),this.setAtOrigin(`spatialReference`,i.spatialReference,`service`),this.setAtOrigin(`tileInfo`,i.storageInfo.tileInfo,`service`),this._frame=r.frame,this.raster=r}};e([r({clonable:!1})],g.prototype,`_compatibleFullExtent`,void 0),e([r({type:Boolean})],g.prototype,`clippedToNeatline`,void 0),e([r({cast:e=>e?typeof e==`string`||e instanceof File?e:a(m,e):null})],g.prototype,`data`,void 0),e([r({json:{read:!1}})],g.prototype,`fullExtent`,null),e([r()],g.prototype,`raster`,void 0),e([r()],g.prototype,`serviceRasterInfo`,void 0),e([r({readOnly:!0,type:o,json:{read:!1}})],g.prototype,`spatialReference`,void 0),e([r({type:h,readOnly:!0})],g.prototype,`tileInfo`,void 0),e([r({readOnly:!0,value:`geospatial-pdf`})],g.prototype,`type`,void 0),g=e([i(`esri.layers.GeospatialPDFLayer`)],g);function _(e){if(!e.raster||!e.serviceRasterInfo)throw new t(`imagery-tile`,`no raster`)}const v=g;export{v as default};
+import{__decorate as e}from"tslib";import t from"../core/Error.js";import{MultiOriginJSONSupportMixin as n}from"../core/MultiOriginJSONSupport.js";import{property as r,subclass as i}from"../core/accessorSupport/decorators.js";import{ensureClass as a}from"../core/accessorSupport/ensureType.js";import o from"../geometry/SpatialReference.js";import{getInfo as s}from"../geometry/support/spatialReferenceUtils.js";import c from"./Layer.js";import{BlendLayer as l}from"./mixins/BlendLayer.js";import{RasterJobHandlerMixin as u}from"./mixins/RasterJobHandlerMixin.js";import{ScaleRangeLayer as d}from"./mixins/ScaleRangeLayer.js";import f from"./raster/datasets/GeospatialPDFRaster.js";import{clip as p}from"./raster/functions/clipUtils.js";import m from"./support/PortalItemData.js";import h from"./support/TileInfo.js";let g=class extends l(d(u(n(c)))){constructor(e){super(e),this._frame=null,this._objectURL=null,this.clippedToNeatline=!1,this.data=null,this.raster=null,this.serviceRasterInfo=null,this.spatialReference=null,this.type=`geospatial-pdf`}load(e){return this.addResolvingPromise(this._load(e)),Promise.resolve(this)}destroy(){this._shutdownJobHandler(),this.raster?.destroy(),this._objectURL&&=(URL.revokeObjectURL(this._objectURL),null)}get fullExtent(){return this.serviceRasterInfo?.extent}createNeatline(e){if(!this._frame)throw new t(`geospatial-pdf-layer: render`,`Layer does not have valid mapframe`);return e?this._frame.createNeatline(e):this._frame.createNeatline()}async fetchImageBitmapTile(){throw new t(`geospatial-pdf-layer:fetch-image-bitmap-tile`,`GeospatialPDFLayer does not expose pre-rendered image tile URLs.`)}async fetchPixels(e,t,n,r={}){return _(this),await this._initJobHandler(),this.raster.fetchPixels(e,Math.round(t),Math.round(n),r)}async fetchTile(e,n,r,i={}){if(_(this),i.requestAsImageElement)throw new t(`geospatial-pdf-layer:fetch-tile`,`GeospatialPDFLayer does not support requestAsImageElement.`);await this._initJobHandler();let a=await this.raster.fetchTile(e,n,r,i),o=this.clippedToNeatline?this._frame?.sourceNeatlinePolygon:this._frame?.sourceMediaBoxPolygon;return o&&a.pixelBlock&&this._frame&&a.srcExtent&&(a.pixelBlock=await p(a.pixelBlock,a.srcExtent,o)),a}getCompatibleFullExtent(e){return this.loaded?(this._compatibleFullExtent?.spatialReference.equals(e)||(this._compatibleFullExtent=this.raster.computeExtent(e)),this._compatibleFullExtent):null}getCompatibleTileInfo(e,t,n=!1){if(!this.loaded||t==null)return null;if(n&&e.equals(this.spatialReference))return this.tileInfo;let r=s(e);return h.create({size:256,spatialReference:e,origin:r?{x:r.origin[0],y:r.origin[1]}:{x:t.xmin,y:t.ymax}})}getRawDisplayBandIds(){return _(this),[0,1,2]}async _initJobHandler(){if(!this._rasterJobHandler)return super._initJobHandler().then(()=>{this._rasterJobHandler&&(_(this),this.raster.rasterJobHandler=this._rasterJobHandler)}).catch(()=>{})}_shutdownJobHandler(){super._shutdownJobHandler(),this.raster&&(this.raster.rasterJobHandler=null)}async _getDataUrl(e){let{data:n}=this;if(typeof n==`string`)return n;if(n instanceof File)return this._objectURL=URL.createObjectURL(n),this._objectURL;if(n instanceof m){await n.portalItem.load({signal:e?.signal});let r=n.portalItem.url;if(!r)throw new t(`geospatial-pdf-layer:load`,`Portal item does not have a valid data URL.`);return r}throw new t(`geospatialpdf-layer:missing-data`,`A data source must be specified.`)}async _load(e){let t=await this._getDataUrl(e);await this._openRaster(t,e?.signal)}async _openRaster(e,n){let r=new f({url:e});if(await r.open({signal:n}),!r.rasterInfo)throw r.destroy(),new t(`geospatialpdf-layer:load`,`cannot load resources on `+e);let{rasterInfo:i}=r;this._set(`serviceRasterInfo`,i),this.setAtOrigin(`spatialReference`,i.spatialReference,`service`),this.setAtOrigin(`tileInfo`,i.storageInfo.tileInfo,`service`),this._frame=r.frame,this.raster=r}};e([r({clonable:!1})],g.prototype,`_compatibleFullExtent`,void 0),e([r({type:Boolean})],g.prototype,`clippedToNeatline`,void 0),e([r({cast:e=>e?typeof e==`string`||e instanceof File?e:a(m,e):null})],g.prototype,`data`,void 0),e([r({json:{read:!1}})],g.prototype,`fullExtent`,null),e([r()],g.prototype,`raster`,void 0),e([r()],g.prototype,`serviceRasterInfo`,void 0),e([r({readOnly:!0,type:o,json:{read:!1}})],g.prototype,`spatialReference`,void 0),e([r({type:h,readOnly:!0})],g.prototype,`tileInfo`,void 0),e([r({readOnly:!0,value:`geospatial-pdf`})],g.prototype,`type`,void 0),g=e([i(`esri.layers.GeospatialPDFLayer`)],g);function _(e){if(!e.raster||!e.serviceRasterInfo)throw new t(`imagery-tile`,`no raster`)}const v=g;export{v as default};

package/layers/ParquetLayer.d.ts

@@ -6,13 +6,14 @@ import type Layer from "./Layer.js";
 import type Field from "./support/Field.js";
 import type FieldsIndex from "./support/FieldsIndex.js";
 import type LabelClass from "./support/LabelClass.js";
+import type PortalItem from "../portal/PortalItem.js";
 import type FeatureSet from "../rest/support/FeatureSet.js";
 import type Query from "../rest/support/Query.js";
 import type { ClonableMixin } from "../core/Clonable.js";
 import type { MultiOriginJSONSupportMixin } from "../core/MultiOriginJSONSupport.js";
 import type { AbortOptions } from "../core/promiseUtils.js";
 import type { LayerEvents, LayerProperties } from "./Layer.js";
-import type { FeatureLayerCapabilities, FieldDomainOptions } from "./types.js";
+import type { FeatureLayerCapabilities, FieldDomainOptions, LayerSaveAsOptions, LayerSaveOptions } from "./types.js";
 import type { BlendLayer, BlendLayerProperties } from "./mixins/BlendLayer.js";
 import type { CustomParametersMixin, CustomParametersMixinProperties } from "./mixins/CustomParametersMixin.js";
 import type { DataSeriesLayer, DataSeriesLayerProperties } from "./mixins/DataSeriesLayer.js";
@@ -25,6 +26,7 @@ import type { RefreshableLayer, RefreshableLayerEvents, RefreshEvent, Refreshabl
 import type { ScaleRangeLayer, ScaleRangeLayerProperties } from "./mixins/ScaleRangeLayer.js";
 import type { ParquetGeometryType } from "./support/parquetUtils.js";
 import type { DomainUnion, ParquetDataUnion, ParquetGeometryEncodingUnion } from "./support/types.js";
+import type { PortalItemProperties } from "../portal/PortalItem.js";
 import type { RendererUnion } from "../renderers/types.js";
 import type { QueryProperties } from "../rest/support/Query.js";
 import type { CreatePopupTemplateOptions } from "../support/popupUtils.js";
@@ -1004,5 +1006,26 @@ export default class ParquetLayer extends ParquetLayerSuperclass {
    * @see [refresh event](https://developers.arcgis.com/javascript/latest/references/core/layers/mixins/RefreshableLayer/#event-refresh)
    */
   refresh(): void;
+  /**
+   * Saves the layer to its existing portal item in the [Portal](https://developers.arcgis.com/javascript/latest/references/core/portal/Portal/) authenticated within the user's current session. If the layer is not saved to a [PortalItem](https://developers.arcgis.com/javascript/latest/references/core/portal/PortalItem/), then you should use [saveAs()](https://developers.arcgis.com/javascript/latest/references/core/layers/ParquetLayer/#saveAs).
+   *
+   * @param options - Various options for saving the layer.
+   * @returns When resolved, returns the portal item to which the layer is saved.
+   * @since 5.2
+   * @example const portalItem = await layer.save();
+   */
+  save(options?: LayerSaveOptions): Promise<PortalItem>;
+  /**
+   * Saves the layer to a new portal item in the [Portal](https://developers.arcgis.com/javascript/latest/references/core/portal/Portal/) authenticated within the user's current session.
+   *
+   * @param portalItem - The portal item to which the layer will be saved.
+   * @param options - Various options for saving the layer.
+   * @returns When resolved, returns the portal item to which the layer is saved.
+   * @since 5.2
+   * @example
+   * const portalItem = new PortalItem();
+   * await layer.saveAs(portalItem);
+   */
+  saveAs(portalItem: PortalItemProperties, options?: LayerSaveAsOptions): Promise<PortalItem>;
 }
 declare const ParquetLayerSuperclass: typeof Layer & typeof ClonableMixin & typeof CustomParametersMixin & typeof MultiOriginJSONSupportMixin & typeof PortalLayer & typeof OperationalLayer & typeof RefreshableLayer & typeof ScaleRangeLayer & typeof DataSeriesLayer & typeof OrderedLayer & typeof BlendLayer & typeof FeatureEffectLayer & typeof FeatureReductionLayer