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

package/graphic/CSVGraphicOrigin.d.ts

@@ -6,6 +6,9 @@ import type CSVLayer from "../layers/CSVLayer.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/CSVLayer/#queryFeatures).
  *
+ * Before accessing the layer properties, use [isCSVGraphicOrigin](https://developers.arcgis.com/javascript/latest/references/core/graphic/isCSVGraphicOrigin/) to check
+ * whether the graphic's origin is a CSVGraphicOrigin.
+ *
  * @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 CSVLayer from "../layers/CSVLayer.js";
  * @see [CSVLayer.queryFeatures()](https://developers.arcgis.com/javascript/latest/references/core/layers/CSVLayer/#queryFeatures)
  * @see [CSVLayerView.queryFeatures()](https://developers.arcgis.com/javascript/latest/references/core/views/layers/CSVLayerView/#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 CSVGraphicOrigin extends GraphicOrigin {
   constructor(layer: CSVLayer);

package/graphic/CatalogGraphicOrigin.d.ts

@@ -7,6 +7,9 @@ import type CatalogFootprintLayer from "../layers/catalog/CatalogFootprintLayer.
  * 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/catalog/CatalogFootprintLayer/#queryFeatures).
  *
+ * Before accessing the layer properties, use [isCatalogGraphicOrigin](https://developers.arcgis.com/javascript/latest/references/core/graphic/isCatalogGraphicOrigin/) to check
+ * whether the graphic's origin is a CatalogGraphicOrigin.
+ *
  * @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)
@@ -15,15 +18,45 @@ import type CatalogFootprintLayer from "../layers/catalog/CatalogFootprintLayer.
  * @see [CatalogFootprintLayer.queryFeatures()](https://developers.arcgis.com/javascript/latest/references/core/layers/catalog/CatalogFootprintLayer/#queryFeatures)
  * @see [CatalogFootprintLayerView.queryFeatures()](https://developers.arcgis.com/javascript/latest/references/core/views/layers/CatalogFootprintLayerView/#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 CatalogGraphicOrigin extends GraphicOrigin {
   constructor(layer: CatalogFootprintLayer);

package/graphic/DimensionFeatureGraphicOrigin.d.ts

@@ -6,20 +6,53 @@ import type DimensionFeatureLayer from "../layers/DimensionFeatureLayer.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/DimensionFeatureLayer/#queryFeatures).
  *
+ * Before accessing the layer properties, use [isDimensionFeatureGraphicOrigin](https://developers.arcgis.com/javascript/latest/references/core/graphic/isDimensionFeatureGraphicOrigin/) to check
+ * whether the graphic's origin is a DimensionFeatureGraphicOrigin.
+ *
  * @since 5.1
  * @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 [DimensionFeatureLayer.queryFeatures()](https://developers.arcgis.com/javascript/latest/references/core/layers/DimensionFeatureLayer/#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 DimensionFeatureGraphicOrigin extends GraphicOrigin {
   constructor(layer: DimensionFeatureLayer);

package/graphic/FeatureGraphicOrigin.d.ts

@@ -6,6 +6,9 @@ import type FeatureLayer from "../layers/FeatureLayer.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/FeatureLayer/#queryFeatures).
  *
+ * Before accessing the layer properties, use [isFeatureGraphicOrigin](https://developers.arcgis.com/javascript/latest/references/core/graphic/isFeatureGraphicOrigin/) to check
+ * whether the graphic's origin is a FeatureGraphicOrigin.
+ *
  * @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 FeatureLayer from "../layers/FeatureLayer.js";
  * @see [FeatureLayer.queryFeatures()](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#queryFeatures)
  * @see [FeatureLayerView.queryFeatures()](https://developers.arcgis.com/javascript/latest/references/core/views/layers/FeatureLayerView/#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 FeatureGraphicOrigin extends GraphicOrigin {
   constructor(layer: FeatureLayer);

package/graphic/GeoJSONGraphicOrigin.d.ts

@@ -6,6 +6,9 @@ import type GeoJSONLayer from "../layers/GeoJSONLayer.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/GeoJSONLayer/#queryFeatures).
  *
+ * Before accessing the layer properties, use [isGeoJSONGraphicOrigin](https://developers.arcgis.com/javascript/latest/references/core/graphic/isGeoJSONGraphicOrigin/) to check
+ * whether the graphic's origin is a GeoJSONGraphicOrigin.
+ *
  * @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 GeoJSONLayer from "../layers/GeoJSONLayer.js";
  * @see [GeoJSONLayer.queryFeatures()](https://developers.arcgis.com/javascript/latest/references/core/layers/GeoJSONLayer/#queryFeatures)
  * @see [GeoJSONLayerView.queryFeatures()](https://developers.arcgis.com/javascript/latest/references/core/views/layers/GeoJSONLayerView/#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 GeoJSONGraphicOrigin extends GraphicOrigin {
   constructor(layer: GeoJSONLayer);

package/graphic/GeoRSSGraphicOrigin.d.ts

@@ -6,19 +6,52 @@ import type GeoRSSLayer from "../layers/GeoRSSLayer.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 [isGeoRSSGraphicOrigin](https://developers.arcgis.com/javascript/latest/references/core/graphic/isGeoRSSGraphicOrigin/) to check
+ * whether the graphic's origin is a GeoRSSGraphicOrigin.
+ *
  * @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)
  * @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 GeoRSSGraphicOrigin extends GraphicOrigin {
   constructor(layer: GeoRSSLayer);

package/graphic/GraphicOrigin.d.ts

@@ -1,10 +1,20 @@
 /**
- * The base class for graphic origins. This class has no constructor.
- * Provides contextual information about where a graphic originates from, when available.
+ * The base class for graphic origins, which describe where a graphic came from. This class cannot be instantiated directly.
+ * Access a graphic's origin through its [origin](https://developers.arcgis.com/javascript/latest/references/core/Graphic/#origin) property.
  * Origin details may be returned by methods such as [MapView.hitTest()](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#hitTest) or by calling `queryFeatures()` on a layer or layer view.
- * Depending on the origin type, this information may include the source layer or other origin-related metadata.
+ *
+ * The properties of an origin object depend on its type and may include the originating layer, sublayer, or other metadata.
+ * Before accessing the layer properties, use a utility such as [isMapImageGraphicOrigin](https://developers.arcgis.com/javascript/latest/references/core/graphic/isMapImageGraphicOrigin/),
+ * [isFeatureGraphicOrigin](https://developers.arcgis.com/javascript/latest/references/core/graphic/isFeatureGraphicOrigin/), or [isVectorTileGraphicOrigin](https://developers.arcgis.com/javascript/latest/references/core/graphic/isVectorTileGraphicOrigin/) to check
+ * whether the graphic's origin is a MapImageGraphicOrigin, FeatureGraphicOrigin, or VectorTileGraphicOrigin.
+ *
+ * If you only need the title of the originating layer or 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 a layer's or sublayer's template directly.
  *
  * @since 4.34
+ * @see [getGraphicOriginTitle](https://developers.arcgis.com/javascript/latest/references/core/graphic/getGraphicOriginTitle/)
+ * @see [Graphic.getEffectivePopupTemplate()](https://developers.arcgis.com/javascript/latest/references/core/Graphic/#getEffectivePopupTemplate)
  * @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)
@@ -12,14 +22,44 @@
  * @see [FeatureLayer.queryFeatures()](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#queryFeatures)
  * @see [FeatureLayerView.queryFeatures()](https://developers.arcgis.com/javascript/latest/references/core/views/layers/FeatureLayerView/#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 abstract class GraphicOrigin {}

package/graphic/ImageryGraphicOrigin.d.ts

@@ -6,18 +6,51 @@ import type ImageryLayer from "../layers/ImageryLayer.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
  * [queryRasters()](https://developers.arcgis.com/javascript/latest/references/core/layers/ImageryLayer/#queryRasters).
  *
+ * Before accessing the layer properties, use [isImageryGraphicOrigin](https://developers.arcgis.com/javascript/latest/references/core/graphic/isImageryGraphicOrigin/) to check
+ * whether the graphic's origin is an ImageryGraphicOrigin.
+ *
  * @since 5.0
  * @see [ImageryLayer.queryRasters()](https://developers.arcgis.com/javascript/latest/references/core/layers/ImageryLayer/#queryRasters)
  * @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 ImageryGraphicOrigin extends GraphicOrigin {
   constructor(layer: ImageryLayer);

package/graphic/ImageryTileGraphicOrigin.d.ts

@@ -5,17 +5,50 @@ import type ImageryTileLayer from "../layers/ImageryTileLayer.js";
  * Provides information about the [ImageryTileLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/ImageryTileLayer/) 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 [isImageryTileGraphicOrigin](https://developers.arcgis.com/javascript/latest/references/core/graphic/isImageryTileGraphicOrigin/) to check
+ * whether the graphic's origin is an ImageryTileGraphicOrigin.
+ *
  * @since 5.0
  * @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 ImageryTileGraphicOrigin extends GraphicOrigin {
   constructor(layer: ImageryTileLayer);