import { MaybeRefOrGetter, Ref } from 'vue';
export interface FocusOptions {
    /**
     * Enable/disable focus eligibility while keeping component in focus chain.
     * When false, component won't receive focus but stays registered.
     * @default true
     */
    isActive?: MaybeRefOrGetter<boolean>;
    /**
     * Auto-focus this component if no component is currently focused.
     * @default false
     */
    autoFocus?: boolean;
    /**
     * Custom identifier for this focusable component.
     * Defaults to a random string if not provided.
     */
    id?: string;
}
export interface FocusContext {
    activeFocusId: Ref<string | undefined>;
    add: (id: string, options: {
        autoFocus: boolean;
    }) => void;
    remove: (id: string) => void;
    activate: (id: string) => void;
    deactivate: (id: string) => void;
    focus: (id: string) => void;
}
/**
 * Makes a component focusable within the focus management system.
 *
 * @example
 * ```vue
 * <script setup>
 * import { useFocus } from '@wolf-tui/vue'
 *
 * const { isFocused, focus } = useFocus({ autoFocus: true })
 * </script>
 * ```
 */
export declare const useFocus: (options?: FocusOptions) => {
    /** Whether this component currently has focus */
    isFocused: import('vue').ComputedRef<boolean>;
    /** Programmatically focus any element by ID */
    focus: (targetId: string) => void;
    /** This component's focus ID */
    id: string;
};
//# sourceMappingURL=use-focus.d.ts.map