/**
 * File-search hook — @-token detection, file search, and file picker
 * selection handler. Extracted from app.tsx (Issue #23, PR 4).
 *
 * Drives the <FilePicker /> component: watches buffer/cursor for an
 * active `@<query>` token, calls searchFiles(), dispatches matches,
 * and on Enter/click registers the picked file as an attachment.
 */
import type { InputBuilder } from '@wrongstack/core/agent';
import type { Action, State } from '../app-reducer.js';
import { type TokenPreviewStore } from '../token-previews.js';
/**
 * Keystroke coalescing window for `@`-file search. Long enough to swallow a
 * burst of typing, short enough that the results feel attached to the keys.
 */
export declare const FILE_SEARCH_DEBOUNCE_MS = 150;
/**
 * Find an active `@<query>` token at the cursor. The token starts at the
 * last `@` not preceded by a non-whitespace char, and runs up to the cursor
 * (no whitespace allowed inside). Returns null if no active token.
 */
export declare function detectAtToken(buffer: string, cursor: number): {
    start: number;
    end: number;
    query: string;
} | null;
export interface UseFileSearchOptions {
    state: State;
    dispatch: React.Dispatch<Action>;
    projectRoot: string;
    builderRef: React.MutableRefObject<InputBuilder | null>;
    draftRef: React.MutableRefObject<{
        buffer: string;
        cursor: number;
    }>;
    setDraft: (buffer: string, cursor: number) => void;
    tokenPreviewsRef: React.MutableRefObject<TokenPreviewStore>;
}
export interface FileSearchResult {
    /** Called from the host's Enter handler when the file picker is open. */
    onPickerEnter: () => Promise<void>;
}
/**
 * Watches buffer/cursor for `@<query>` tokens, drives file search, and
 * provides the Enter handler for the <FilePicker> component.
 */
export declare function useFileSearch(options: UseFileSearchOptions): FileSearchResult;
//# sourceMappingURL=use-file-search.d.ts.map