import type { CDPSession, ElementHandle, Page } from 'playwright';
import { type TimedVector, type Vector } from './math';
import { installMouseHelper } from './mouse-helper';
export { installMouseHelper };
export interface BoundingBox {
    x: number;
    y: number;
    width: number;
    height: number;
}
export interface BoxOptions {
    /**
       * Percentage of padding to be added inside the element when determining the target point.
       * Example:
       * - `0` = may be anywhere within the element.
       * - `100` = will always be center of element.
       * @default 0
       */
    readonly paddingPercentage?: number;
    /**
       * Destination to move the cursor to, relative to the top-left corner of the element.
       * If specified, `paddingPercentage` is not used.
       * If not specified (default), destination is random point within the `paddingPercentage`.
       * @default undefined (random point)
       */
    readonly destination?: Vector;
}
export interface GetElementOptions {
    /**
       * Time to wait for the selector to appear in milliseconds.
       * Default is to not wait for selector.
       */
    readonly waitForSelector?: number;
}
export interface ScrollOptions {
    /**
       * Scroll speed. 0 to 100. 100 is instant.
       * @default 100
       */
    readonly scrollSpeed?: number;
    /**
       * Time to wait after scrolling.
       * @default 200
       */
    readonly scrollDelay?: number;
}
export interface ScrollIntoViewOptions extends ScrollOptions, GetElementOptions {
    /**
       * Scroll speed (when scrolling occurs). 0 to 100. 100 is instant.
       * @default 100
       */
    readonly scrollSpeed?: number;
    /**
       * Time to wait after scrolling (when scrolling occurs).
       * @default 200
       */
    readonly scrollDelay?: number;
    /**
       * Margin (in px) to add around the element when ensuring it is in the viewport.
       * (Does not take effect if CDP scroll fails.)
       * @default 0
       */
    readonly inViewportMargin?: number;
}
export interface MoveOptions extends BoxOptions, ScrollIntoViewOptions, Pick<PathOptions, 'moveSpeed'> {
    /**
       * Delay after moving the mouse in milliseconds. If `randomizeMoveDelay=true`, delay is randomized from 0 to `moveDelay`.
       * @default 0
       */
    readonly moveDelay?: number;
    /**
       * Randomize delay between actions from `0` to `moveDelay`. See `moveDelay` docs.
       * @default true
       */
    readonly randomizeMoveDelay?: boolean;
    /**
       * Maximum number of attempts to mouse-over the element.
       * @default 10
       */
    readonly maxTries?: number;
    /**
       * Distance from current location to destination that triggers overshoot to
       * occur. (Below this distance, no overshoot will occur).
       * @default 500
       */
    readonly overshootThreshold?: number;
}
export interface ClickOptions extends MoveOptions {
    /**
       * Delay before initiating the click action in milliseconds.
       * @default 0
       */
    readonly hesitate?: number;
    /**
       * Delay between mousedown and mouseup in milliseconds.
       * @default 0
       */
    readonly waitForClick?: number;
    /**
       * @default 2000
       */
    readonly moveDelay?: number;
    /**
       * @default "left"
       */
    readonly button?: 'left' | 'right' | 'middle';
    /**
       * @default 1
       */
    readonly clickCount?: number;
}
export interface PathOptions {
    /**
       * Override the spread of the generated path.
       */
    readonly spreadOverride?: number;
    /**
       * Speed of mouse movement.
       * Default is random.
       */
    readonly moveSpeed?: number;
    /**
       * Generate timestamps for each point in the path.
       */
    readonly useTimestamps?: boolean;
}
export interface RandomMoveOptions extends Pick<MoveOptions, 'moveDelay' | 'randomizeMoveDelay' | 'moveSpeed'> {
    /**
       * @default 2000
       */
    readonly moveDelay?: number;
}
export interface MoveToOptions extends PathOptions, Pick<MoveOptions, 'moveDelay' | 'randomizeMoveDelay'> {
    /**
       * @default 0
       */
    readonly moveDelay?: number;
}
export type ScrollToDestination = Partial<Vector> | 'top' | 'bottom' | 'left' | 'right';
export interface GhostCursor {
    toggleRandomMove: (random: boolean) => void;
    click: (selector?: string | ElementHandle, options?: ClickOptions) => Promise<void>;
    move: (selector: string | ElementHandle, options?: MoveOptions) => Promise<void>;
    moveTo: (destination: Vector, options?: MoveToOptions) => Promise<void>;
    scrollIntoView: (selector: ElementHandle, options?: ScrollIntoViewOptions) => Promise<void>;
    scrollTo: (destination: ScrollToDestination, options?: ScrollOptions) => Promise<void>;
    scroll: (delta: Partial<Vector>, options?: ScrollOptions) => Promise<void>;
    getElement: (selector: string | ElementHandle, options?: GetElementOptions) => Promise<ElementHandle<Element>>;
    getLocation: () => Vector;
    /**
       * Defined only if `visible=true` is passed.
       *
       * NOTE: Must be a promise, since we can't `await` in the constructor.
       */
    removeMouseHelper?: Promise<() => Promise<void>>;
}
/** Get CDP client for Playwright */
export declare const getCDPClient: (page: Page) => Promise<CDPSession>;
/** Get a random point on a browser window */
export declare const getRandomPagePoint: (page: Page) => Promise<Vector>;
export declare function path(point: Vector, target: Vector, options?: number | PathOptions): Vector[] | TimedVector[];
export declare function path(point: Vector, target: BoundingBox, options?: number | PathOptions): Vector[] | TimedVector[];
export declare const createCursor: (page: Page, 
/**
   * Cursor start position.
   * @default { x: 0, y: 0 }
   */
start?: Vector, 
/**
   * Initially perform random movements.
   * If `move`,`click`, etc. is performed, these random movements end.
   * @default false
   */
performRandomMoves?: boolean, defaultOptions?: {
    /**
         * Default options for the `randomMove` function that occurs when `performRandomMoves=true`
         * @default RandomMoveOptions
         */
    randomMove?: RandomMoveOptions;
    /**
         * Default options for the `move` function
         * @default MoveOptions
         */
    move?: MoveOptions;
    /**
         * Default options for the `moveTo` function
         * @default MoveToOptions
         */
    moveTo?: MoveToOptions;
    /**
         * Default options for the `click` function
         * @default ClickOptions
         */
    click?: ClickOptions;
    /**
         * Default options for the `scrollIntoView`, `scrollTo`, and `scroll` functions
         * @default ScrollIntoViewOptions
         */
    scroll?: ScrollOptions & ScrollIntoViewOptions;
    /**
         * Default options for the `getElement` function
         * @default GetElementOptions
         */
    getElement?: GetElementOptions;
}, visible?: boolean) => GhostCursor;