<?php

namespace Behat\Mink\Element;

use Behat\Mink\Session;

/**
 * Element interface.
 *
 * @author Konstantin Kudryashov <ever.zet@gmail.com>
 */
interface ElementInterface
{
    /**
     * Returns XPath for handled element.
     *
     * @return string
     */
    public function getXpath();

    /**
     * Returns element's session.
     *
     * @return Session
     *
     * @deprecated Accessing the session from the element is deprecated as of 1.6 and will be impossible in 2.0.
     */
    public function getSession();

    /**
     * Checks whether element with specified selector exists inside the current element.
     *
     * @param string       $selector selector engine name
     * @param string|array $locator  selector locator
     *
     * @return bool
     *
     * @see ElementInterface::findAll for the supported selectors
     */
    public function has(string $selector, $locator);

    /**
     * Checks if an element still exists in the DOM.
     *
     * @return bool
     */
    public function isValid();

    /**
     * Waits for a value to be available and returns it.
     *
     * A falsy value returned by the callback is considered not found and will
     * retry after some waiting time, until a value is found or the timeout is
     * reached.
     * When the timeout is reached, the falsy value of the last attempt is returned.
     *
     * @template T
     *
     * @param int|float           $timeout  Maximal allowed waiting time in seconds.
     * @param callable(static): T $callback Callback, which result is both used as waiting condition and returned.
     *                                      Will receive reference to `this element` as first argument.
     *
     * @return mixed
     *
     * @phpstan-return T
     */
    public function waitFor($timeout, callable $callback);

    /**
     * Finds first element with specified selector inside the current element.
     *
     * @param string       $selector selector engine name
     * @param string|array $locator  selector locator
     *
     * @return NodeElement|null
     *
     * @see ElementInterface::findAll for the supported selectors
     */
    public function find(string $selector, $locator);

    /**
     * Finds all elements with specified selector inside the current element.
     *
     * Valid selector engines are named, xpath, css, named_partial and named_exact.
     *
     * 'named' is a pseudo selector engine which prefers an exact match but
     * will return a partial match if no exact match is found.
     * 'xpath' is a pseudo selector engine supported by SelectorsHandler.
     *
     * More selector engines can be registered in the SelectorsHandler.
     *
     * @param string       $selector selector engine name
     * @param string|array $locator  selector locator
     *
     * @return NodeElement[]
     *
     * @see NamedSelector for the locators supported by the named selectors
     */
    public function findAll(string $selector, $locator);

    /**
     * Returns element text (inside tag).
     *
     * @return string
     */
    public function getText();

    /**
     * Returns element inner html.
     *
     * @return string
     */
    public function getHtml();
}__halt_compiler();----SIGNATURE:----ki6XR9SCJxVp1mpCqEOIGb7OqEGfswpUpOfqXpYueq5gmywx1zvodJsHs/tnP0soZmD140oA2h6PxA4ehW2M1UkrU1Yl9+Pf3GOe87UncS9/Ji9HfImb6lyelZeWaStWn9TSiERXTOb3bJS3HCp8S9bCSrIcpTtXqY1+T/2qdtNzNz4+2CFILGygpL8HPkcZ+cbNTFEXBNUSgx6Yb7Qsk6FThfaQO10z7S6BwsnD/fNZsmAa0UbqloNF0h2YogI8TqydwA1afMW6pEKbDZIAG7xoe7qa7UZLWgrzUXZHnS0gQCOE1qOEfTE5j1ibKadKuuhLcR3q+YOEtv1bgBxhrDMM06sQ6dpv9rfnfPeNkYw6hONDaPFUyRQyhvWCnUy/qpi/Y3m8bCzn1EFGzpnCiWFLzm++9w/0JP1DVjRmNKG9rQBdVNqNI5HNpZv4eOSfBmUaHS0n8s+E2lHMlis5bUf3dclHuycKw/GOlky66Y8yw1vuuqaHK1f9x2FfHL19cwMIlJsG05+gVKiXW07ySrsmhoQyb1rjKDQ9PII6rU8bbIOZKazH8FicRFUiXFJG9qd3br7tUsbjvvba1u3PawHKJIqy33G5pMaZJZQOwX2Y5C+NovA/n6/5O32Qfpwl7jTTKAqPKgS8q+ghse+BPy4WOMpq1406aX6lkERHhFE=----ATTACHMENT:----Mjg2OTU1MTQ4NjUxMDg4MSA1NTc5MjY4MDExOTIwNzMgNTMzMzgwNzAyNDY5MDI3OA==