/**
 * DOM helpers for inert siblings, scroll-locking the body, and reliable
 * mount-time autofocus.
 *
 * @module bquery/a11y
 * @since 1.14.0
 */
/**
 * Handle returned by {@link inert} and {@link scrollLock}.
 *
 * @since 1.14.0
 */
export type DisposableHandle = {
    /** Releases the effect, restoring previous DOM state. */
    release: () => void;
};
/**
 * Marks every sibling of `target` as `inert` and `aria-hidden`, hiding the
 * surrounding UI from assistive technologies and pointer/keyboard input while
 * a modal-like overlay is active. The previous values of those attributes are
 * restored when the handle's `release()` is called.
 *
 * Works against the immediate siblings within `target.parentElement`. For
 * shadow-root or portal scenarios, call once for each affected sibling root.
 *
 * @since 1.14.0
 *
 * @example
 * ```ts
 * import { inert } from '@bquery/bquery/a11y';
 *
 * const handle = inert(modalEl);
 * // ...later
 * handle.release();
 * ```
 */
export declare const inert: (target: Element) => DisposableHandle;
export declare const scrollLock: () => DisposableHandle;
/**
 * Internal — resets the scroll-lock ref count. Tests only.
 * @internal
 */
export declare const _resetScrollLockForTests: () => void;
/**
 * Reliable mount-time focus helper that defers focus to the next animation
 * frame (or `setTimeout(0)` when rAF is unavailable). Optionally selects the
 * text content of `<input>`/`<textarea>` elements.
 *
 * Passes `preventScroll` through to `HTMLElement.focus()` when the runtime
 * supports focus options.
 *
 * @since 1.14.0
 *
 * @example
 * ```ts
 * import { autoFocus } from '@bquery/bquery/a11y';
 * autoFocus(inputEl, { select: true });
 * ```
 */
export declare const autoFocus: (target: HTMLElement, options?: {
    select?: boolean;
    preventScroll?: boolean;
}) => {
    cancel: () => void;
};
//# sourceMappingURL=dom-helpers.d.ts.map