@arcgis/core 6.0.0-next.23 → 6.0.0-next.25

package/graphic/KMLGraphicOrigin.d.ts

@@ -4,21 +4,58 @@ import type KMLSublayer from "../layers/support/KMLSublayer.js";
 
 /**
  * Provides information about the [KMLLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/KMLLayer/) from which a graphic originates.
- * Also provides access to the [KMLSublayer](https://developers.arcgis.com/javascript/latest/references/core/layers/support/KMLSublayer/) that contains the graphic.
+ * The [layer](https://developers.arcgis.com/javascript/latest/references/core/graphic/KMLGraphicOrigin/#layer) property references the KMLLayer, and the
+ * [sublayer](https://developers.arcgis.com/javascript/latest/references/core/graphic/KMLGraphicOrigin/#sublayer) property references the [KMLSublayer](https://developers.arcgis.com/javascript/latest/references/core/layers/support/KMLSublayer/) 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).
  *
+ * Before accessing the layer properties, use [isKMLGraphicOrigin](https://developers.arcgis.com/javascript/latest/references/core/graphic/isKMLGraphicOrigin/) to check
+ * whether the graphic's origin is a KMLGraphicOrigin.
+ *
+ * If you only need the title of the originating KMLSublayer, 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.
+ *
  * @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 KMLGraphicOrigin extends GraphicOrigin {
   constructor(layer: KMLLayer, sublayer: KMLSublayer);

package/graphic/KnowledgeGraphGraphicOrigin.d.ts

@@ -4,11 +4,59 @@ import type KnowledgeGraphSublayer from "../layers/knowledgeGraph/KnowledgeGraph
 
 /**
  * Provides information about the [KnowledgeGraphLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/KnowledgeGraphLayer/) from which a graphic originates.
- * Also provides access to the [KnowledgeGraphSublayer](https://developers.arcgis.com/javascript/latest/references/core/layers/knowledgeGraph/KnowledgeGraphSublayer/) that contains the graphic.
+ * The [layer](https://developers.arcgis.com/javascript/latest/references/core/graphic/KnowledgeGraphGraphicOrigin/#layer) property references the KnowledgeGraphLayer, and the
+ * [sublayer](https://developers.arcgis.com/javascript/latest/references/core/graphic/KnowledgeGraphGraphicOrigin/#sublayer) property references the [KnowledgeGraphSublayer](https://developers.arcgis.com/javascript/latest/references/core/layers/knowledgeGraph/KnowledgeGraphSublayer/) 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/knowledgeGraph/KnowledgeGraphSublayer/#queryFeatures).
  *
+ * Before accessing the layer properties, use [isKnowledgeGraphGraphicOrigin](https://developers.arcgis.com/javascript/latest/references/core/graphic/isKnowledgeGraphGraphicOrigin/) to check
+ * whether the graphic's origin is a KnowledgeGraphGraphicOrigin.
+ *
+ * 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 KnowledgeGraphGraphicOrigin extends GraphicOrigin {
   constructor(layer: KnowledgeGraphLayer, sublayer: KnowledgeGraphSublayer);

package/graphic/LinkChartGraphicOrigin.d.ts

@@ -4,11 +4,59 @@ import type KnowledgeGraphSublayer from "../layers/knowledgeGraph/KnowledgeGraph
 
 /**
  * Provides information about the [LinkChartLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/LinkChartLayer/) from which a graphic originates.
- * Also provides access to the [KnowledgeGraphSublayer](https://developers.arcgis.com/javascript/latest/references/core/layers/knowledgeGraph/KnowledgeGraphSublayer/) that contains the graphic.
+ * The [layer](https://developers.arcgis.com/javascript/latest/references/core/graphic/LinkChartGraphicOrigin/#layer) property references the LinkChartLayer, and the
+ * [sublayer](https://developers.arcgis.com/javascript/latest/references/core/graphic/LinkChartGraphicOrigin/#sublayer) property references the [KnowledgeGraphSublayer](https://developers.arcgis.com/javascript/latest/references/core/layers/knowledgeGraph/KnowledgeGraphSublayer/) 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/knowledgeGraph/KnowledgeGraphSublayer/#queryFeatures).
  *
+ * Before accessing the layer properties, use [isLinkChartGraphicOrigin](https://developers.arcgis.com/javascript/latest/references/core/graphic/isLinkChartGraphicOrigin/) to check
+ * whether the graphic's origin is a LinkChartGraphicOrigin.
+ *
+ * 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 LinkChartGraphicOrigin extends GraphicOrigin {
   constructor(layer: LinkChartLayer, sublayer: KnowledgeGraphSublayer);

package/graphic/MapImageGraphicOrigin.d.ts

@@ -4,10 +4,58 @@ import type Sublayer from "../layers/support/Sublayer.js";
 
 /**
  * Provides information about the [MapImageLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/MapImageLayer/) 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/MapImageGraphicOrigin/#layer) property references the MapImageLayer, and the
+ * [sublayer](https://developers.arcgis.com/javascript/latest/references/core/graphic/MapImageGraphicOrigin/#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 [isMapImageGraphicOrigin](https://developers.arcgis.com/javascript/latest/references/core/graphic/isMapImageGraphicOrigin/) to check
+ * whether the graphic's origin is a MapImageGraphicOrigin.
+ *
+ * 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 MapImageGraphicOrigin extends GraphicOrigin {
   constructor(layer: MapImageLayer, sublayer: Sublayer);

package/graphic/MapNotesGraphicOrigin.d.ts

@@ -4,13 +4,60 @@ import type MapNotesLayer from "../layers/MapNotesLayer.js";
 
 /**
  * Provides information about the [MapNotesLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/MapNotesLayer/) from which a graphic originates.
- * Also provides access to the sub [GraphicsLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/GraphicsLayer/) that contains the graphic.
+ * The [layer](https://developers.arcgis.com/javascript/latest/references/core/graphic/MapNotesGraphicOrigin/#layer) property references the MapNotesLayer, and the
+ * [sublayer](https://developers.arcgis.com/javascript/latest/references/core/graphic/MapNotesGraphicOrigin/#sublayer) property references the child [GraphicsLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/GraphicsLayer/) 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).
  *
+ * Before accessing the layer properties, use [isMapNotesGraphicOrigin](https://developers.arcgis.com/javascript/latest/references/core/graphic/isMapNotesGraphicOrigin/) to check
+ * whether the graphic's origin is a MapNotesGraphicOrigin.
+ *
+ * If you only need the title of the child GraphicsLayer, 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.
+ *
  * @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
+ * 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 MapNotesGraphicOrigin extends GraphicOrigin {
   constructor(layer: MapNotesLayer, sublayer: GraphicsLayer);

package/graphic/OGCFeatureGraphicOrigin.d.ts

@@ -6,6 +6,9 @@ import type OGCFeatureLayer from "../layers/OGCFeatureLayer.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/OGCFeatureLayerView/#queryFeatures).
  *
+ * Before accessing the layer properties, use [isOGCFeatureGraphicOrigin](https://developers.arcgis.com/javascript/latest/references/core/graphic/isOGCFeatureGraphicOrigin/) to check
+ * whether the graphic's origin is an OGCFeatureGraphicOrigin.
+ *
  * @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)
@@ -13,15 +16,45 @@ import type OGCFeatureLayer from "../layers/OGCFeatureLayer.js";
  * @see [Scene component hitTest()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#hitTest)
  * @see [OGCFeatureLayerView.queryFeatures()](https://developers.arcgis.com/javascript/latest/references/core/views/layers/OGCFeatureLayerView/#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 OGCFeatureGraphicOrigin extends GraphicOrigin {
   constructor(layer: OGCFeatureLayer);

package/graphic/OrientedImageryGraphicOrigin.d.ts

@@ -6,6 +6,9 @@ import type OrientedImageryLayer from "../layers/OrientedImageryLayer.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/OrientedImageryLayer/#queryFeatures).
  *
+ * Before accessing the layer properties, use [isOrientedImageryGraphicOrigin](https://developers.arcgis.com/javascript/latest/references/core/graphic/isOrientedImageryGraphicOrigin/) to check
+ * whether the graphic's origin is an OrientedImageryGraphicOrigin.
+ *
  * @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)
@@ -13,15 +16,45 @@ import type OrientedImageryLayer from "../layers/OrientedImageryLayer.js";
  * @see [Scene component hitTest()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#hitTest)
  * @see [OrientedImageryLayer.queryFeatures()](https://developers.arcgis.com/javascript/latest/references/core/layers/OrientedImageryLayer/#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 OrientedImageryGraphicOrigin extends GraphicOrigin {
   constructor(layer: OrientedImageryLayer);

package/graphic/ParquetGraphicOrigin.d.ts

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

package/graphic/PointCloudGraphicOrigin.d.ts

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

package/graphic/SceneGraphicOrigin.d.ts

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