import type GraphicOrigin from "./GraphicOrigin.js";
import type KMLLayer from "../layers/KMLLayer.js";
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 [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).
 *
 * @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;
 *    }
 *  });
 */
export default class KMLGraphicOrigin extends GraphicOrigin {
  constructor(layer: KMLLayer, sublayer: KMLSublayer);
  /** A layer from which a graphic originates. */
  readonly layer: KMLLayer;
  /** The [KMLSublayer](https://developers.arcgis.com/javascript/latest/references/core/layers/support/KMLSublayer/) from which a graphic originates. */
  readonly sublayer: KMLSublayer;
  /**
   * Indicates the type of layer the graphic originated from.
   *
   * @default "kml"
   */
  readonly type: KMLLayer["type"];
}