import { DeepMaybeObservable, Pausable, Supportable, ReadonlyObservable } from '@usels/core';
import { ConfigurableWindow } from '../../shared/configurable.mjs';
import '@legendapp/state';

interface UseElementByPointOptions<M extends boolean = false> extends ConfigurableWindow {
    /** X coordinate */
    x: number;
    /** Y coordinate */
    y: number;
    /** Whether to return multiple elements (uses elementsFromPoint) */
    multiple?: M;
}
type UseElementByPointReturn<M extends boolean = false> = Pausable & Supportable & {
    /** Element(s) at the specified point */
    element$: ReadonlyObservable<M extends true ? Element[] : Element | null>;
};
/**
 * Framework-agnostic reactive element-at-point tracker using
 * `document.elementFromPoint()` (or `elementsFromPoint()` in multiple mode).
 *
 * Runs a `requestAnimationFrame` loop that polls the current (x, y) each frame
 * and syncs the result into `element$`. Pausable via `pause()` / `resume()`.
 */
declare function createElementByPoint<M extends boolean = false>(options: DeepMaybeObservable<UseElementByPointOptions<M>>): UseElementByPointReturn<M>;

export { type UseElementByPointOptions, type UseElementByPointReturn, createElementByPoint };