export type DragAndDropOptions = {
    /**
     * - CSS class applied to the target element while files are being dragged over it.
     */
    hoverClass?: string;
    /**
     * - Callback function executed when files are dropped onto the target.
     */
    onDrop?: (files: FileList, event: DragEvent) => void;
    /**
     * - Optional callback triggered when dragging enters the target area.
     */
    onEnter?: (event: DragEvent) => void;
    /**
     * - Optional callback triggered when dragging leaves the target area.
     */
    onLeave?: (event: DragEvent) => void;
};
/**
 * @typedef {Object} DragAndDropOptions
 * @property {string} [hoverClass="dnd-hover"] - CSS class applied to the target element while files are being dragged over it.
 * @property {(files: FileList, event: DragEvent) => void} [onDrop] - Callback function executed when files are dropped onto the target.
 * @property {(event: DragEvent) => void} [onEnter] - Optional callback triggered when dragging enters the target area.
 * @property {(event: DragEvent) => void} [onLeave] - Optional callback triggered when dragging leaves the target area.
 */
/**
 * TinyDragDropDetector
 *
 * A lightweight utility to detect drag-and-drop file operations on a specific DOM element or the entire page.
 * It handles the drag lifecycle (enter, over, leave, drop) and provides hooks for developers to handle file uploads or UI changes.
 *
 * @class
 * @template {HTMLElement} HTMLTarget
 */
declare class TinyDragDropDetector<HTMLTarget extends HTMLElement> {
    #private;
    /**
     * Gets the current destruction status of the instance.
     *
     * @returns {boolean} True if the instance is destroyed, false otherwise.
     */
    get destroyed(): boolean;
    /**
     * Creates a new instance of TinyDragDropDetector to handle drag-and-drop file detection.
     *
     * @param {HTMLTarget} target - The DOM element where drag listeners will be attached.
     * @param {DragAndDropOptions} options - Configuration options for the detector.
     * @throws {TypeError} If `target` is not an HTMLElement.
     * @throws {TypeError} If `hoverClass` is not a string.
     * @throws {TypeError} If `onDrop` is defined but not a function.
     * @throws {TypeError} If `onEnter` is defined but not a function.
     * @throws {TypeError} If `onLeave` is defined but not a function.
     */
    constructor(target: HTMLTarget, options: DragAndDropOptions);
    /**
     * Returns the current target DOM element where the listeners are attached.
     * @returns {HTMLTarget}
     */
    getTarget(): HTMLTarget;
    /**
     * Returns the CSS class applied during drag hover.
     * @returns {string}
     */
    getHoverClass(): string;
    /**
     * Returns whether a drag operation is currently active over the target.
     * @returns {boolean}
     */
    isDragging(): boolean;
    /**
     * Returns whether the event listeners are currently bound to the target.
     * @returns {boolean}
     */
    bound(): boolean;
    /**
     * Handles the `dragenter` event.
     * Adds the hover CSS class and triggers the `onEnter` callback if provided.
     * @private
     * @param {DragEvent} event - The dragenter event.
     * @returns {void}
     */
    private _handleDragEnter;
    /**
     * Handles the `dragover` event.
     * Prevents default to allow drop and sets the drop effect.
     * @private
     * @param {DragEvent} event - The dragover event.
     * @returns {void}
     */
    private _handleDragOver;
    /**
     * Handles the `dragleave` event.
     * Removes the hover class and triggers the `onLeave` callback if provided.
     * @private
     * @param {DragEvent} event - The dragleave event.
     * @returns {void}
     */
    private _handleDragLeave;
    /**
     * Handles the `drop` event.
     * Removes the hover class, resets dragging state, and triggers the `onDrop` callback.
     * @private
     * @param {DragEvent} event - The drop event.
     * @returns {void}
     */
    private _handleDrop;
    /**
     * Destroys the detector instance, unbinding all event listeners and cleaning up.
     * Should be called when the detector is no longer needed to avoid memory leaks.
     * @returns {void}
     */
    destroy(): void;
}
export default TinyDragDropDetector;
//# sourceMappingURL=TinyDragDropDetector.d.mts.map