/**
 * Spec Provider
 *
 * Provides completion suggestions for spec names.
 * In hierarchical format, specs are completed at wordIndex === 1
 * alongside commands.
 */
import { CompletionContext, CompletionOptions, CompletionProvider, CompletionSuggestion } from "../types.d.ts";
export interface SpecDataSource {
    /** Get available spec names */
    getSpecs(): Promise<string[]>;
    /** Get available spec names with descriptions (optional method) */
    getSpecsWithDesc?(): Promise<Array<{
        name: string;
        description?: string;
    }>>;
}
export declare class SpecProvider implements CompletionProvider {
    private options;
    private dataSource;
    constructor(options: CompletionOptions, dataSource: SpecDataSource);
    canHandle(context: CompletionContext): boolean;
    provide(context: CompletionContext): Promise<CompletionSuggestion[]>;
}