import type { ElementTarget } from "../use-target-element/index.js";
export interface UseFocusOptions {
    /**
     * initial focus state
     *
     * @defaultValue false
     */
    initialValue?: boolean;
}
export type UseFocusReturns = readonly [
    /**
     * focus state
     */
    focused: boolean,
    /**
     * focus actions
     */
    actions: {
        /**
         * focus the target element
         */
        focus(): void;
        /**
         * blur the target element
         */
        blur(): void;
    }
];
/**
 * A React Hook that allows you to focus on an element when it is mounted.
 */
export declare function useFocus<T extends HTMLElement = HTMLElement>(target: ElementTarget<T>, options?: UseFocusOptions): UseFocusReturns;