import type GraphicOrigin from "./GraphicOrigin.js";
import type GeoJSONLayer from "../layers/GeoJSONLayer.js";

/**
 * Provides information about the [GeoJSONLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/GeoJSONLayer/) from which a graphic originates.
 * 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).
 *
 * @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 [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;
 *    }
 *  });
 */
export default class GeoJSONGraphicOrigin extends GraphicOrigin {
  constructor(layer: GeoJSONLayer);
  /** A layer from which a graphic originates. */
  readonly layer: GeoJSONLayer;
  /**
   * Indicates the type of layer the graphic originated from.
   *
   * @default "geojson"
   */
  readonly type: GeoJSONLayer["type"];
}