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

interface UseTextSelectionOptions extends ConfigurableWindow {
    /** Throttle selectionchange handler in ms. Mutually exclusive with debounce. */
    throttle?: MaybeObservable<number>;
    /** Debounce selectionchange handler in ms. Mutually exclusive with throttle. */
    debounce?: MaybeObservable<number>;
}
interface UseTextSelectionReturn {
    /** Selected text content */
    text$: ReadonlyObservable<string>;
    /** Bounding rectangles of selected ranges */
    rects$: ReadonlyObservable<DOMRect[]>;
    /** Selection ranges */
    ranges$: ReadonlyObservable<Range[]>;
    /** Current Selection object */
    selection$: ReadonlyObservable<OpaqueObject<Selection> | null>;
}
/**
 * Framework-agnostic reactive text-selection tracker. Listens to
 * `selectionchange` on the document and exposes the current selection's text,
 * ranges, rects (lazily computed), and raw `Selection` object.
 */
declare function createTextSelection(options?: DeepMaybeObservable<UseTextSelectionOptions>): UseTextSelectionReturn;

export { type UseTextSelectionOptions, type UseTextSelectionReturn, createTextSelection };