/// <reference types="react" />
export type ClientCoordinates = [number, number];
/**
 * Various useful coordinate values are pre-computed for you and supplied to
 * onDragMove and onDragEnd callbacks.
 */
export interface CoordinateData {
    /**
     * The client coordinates where the interaction was activated.
     */
    activation: ClientCoordinates;
    /**
     * The client coordinates of the current mouse event.
     */
    current: ClientCoordinates;
    /**
     * The difference between current and last client coordinates.
     */
    delta: ClientCoordinates;
    /**
     * The client coordinates of the previous mouse event.
     */
    last: ClientCoordinates;
    /**
     * The difference between current and activation client coordinates.
     */
    offset: ClientCoordinates;
}
export interface DragHandler {
    /**
     * Called when the mouse is pressed down. Drag and click operations may
     * be cancelled at this point by returning false from this method.
     */
    onActivate?: (event: MouseEvent) => boolean;
    /**
     * Called every time the mouse is moved after activation and before the
     * mouse is released. This method is also called on the last even when the
     * mouse is released.
     */
    onDragMove?: (event: MouseEvent, coords: CoordinateData) => void;
    /**
     * Called when the mouse is released iff the mouse was dragged after
     * activation.
     */
    onDragEnd?: (event: MouseEvent, coords: CoordinateData) => void;
    /**
     * Called when the mouse is released iff the mouse was NOT dragged after
     * activation.
     *
     * This will be called asynchronously if `onDoubleClick` is defined. See
     * that callback for more details.
     */
    onClick?: (event: MouseEvent) => void;
    /**
     * Called iff there are two click events within the timeout
     * `DragEvents.DOUBLE_CLICK_TIMEOUT_MSEC`, which defaults to 500 msec.
     *
     * NOTE: Defining this callback requires that we wait to invoke the
     * `onClick` callback until the timeout has expired and we are certain the
     * interaction was only a single click. If this callback is not defined,
     * the `onClick` callback will be invoked synchronously with the mouseup
     * event.
     */
    onDoubleClick?: (event: MouseEvent) => void;
    /**
     * This prevents mouse events from performing their default operation such
     * as text selection.
     *
     * @default true
     */
    preventDefault?: boolean;
    /**
     * This prevents the event from propagating up to parent elements.
     *
     * @default false
     */
    stopPropagation?: boolean;
}
export interface DraggableChildrenProps {
    /**
     * Single child, must be an element and not a string or fragment.
     */
    children: React.JSX.Element;
    /**
     * You must provide provide this ref so that Draggable can access its child DOM node if:
     *
     *  - You are already attaching your own `ref` to the child element
     *  - The child element is not a native DOM element
     *  - The child element _does not_ use React.forwardRef to allow refs to pass through to the DOM
     *
     * This may look something like:
     *
     *  ```tsx
     *  import * as React from "react";
     *
     *  function MyDraggableComponent() {
     *      const myRef = React.createRef<HTMLElement();
     *      return (
     *          <Draggable targetRef={myRef}>
     *              <div ref={myRef} />
     *          </Draggable>
     *      );
     *  }
     *  ```
     */
    targetRef?: React.RefObject<HTMLElement>;
}
