/**
 * @-file Autocomplete
 *
 * Provides file path completion for @-references in user input,
 * supporting line range syntax and .gitignore filtering.
 */
export interface FileCompletion {
    path: string;
    display: string;
    isDirectory: boolean;
    lineRange?: string;
}
export interface AtReference {
    path: string;
    lineStart?: number;
    lineEnd?: number;
}
/**
 * FileAutocomplete provides completion suggestions for @-file references.
 */
export declare class FileAutocomplete {
    private gitignorePatterns;
    /**
     * Parse a .gitignore file and extract patterns.
     */
    private loadGitignore;
    /**
     * Check if a relative path matches any gitignore pattern.
     */
    private isIgnored;
    /**
     * Complete a partial path, returning matching files and directories.
     */
    complete(partial: string, workDir: string): FileCompletion[];
    /**
     * Parse an @-reference string into a path and optional line range.
     * Returns null if the input is not a valid @-reference.
     */
    parseAtReference(input: string): AtReference | null;
}
export declare function getFileAutocomplete(): FileAutocomplete;
export declare function resetFileAutocomplete(): void;
