/**
 * List Provider
 *
 * Provides completion suggestions for list command options (--spec, --tag).
 * When context.specName is set, spec completion is skipped (already scoped).
 */
import { CompletionContext, CompletionOptions, CompletionProvider, CompletionSuggestion } from "../types.d.ts";
export interface ListDataSource {
    /** Get available spec names */
    getSpecs(): Promise<string[]>;
    /** Get available spec names with descriptions (optional) */
    getSpecsWithDesc?(): Promise<Array<{
        name: string;
        description?: string;
    }>>;
    /** Get tags for a spec */
    getTags(specName: string): Promise<string[]>;
    /** Get tags for a spec with descriptions (optional) */
    getTagsWithDesc?(specName: string): Promise<Array<{
        name: string;
        description?: string;
    }>>;
}
export declare class ListProvider implements CompletionProvider {
    private options;
    private dataSource;
    constructor(options: CompletionOptions, dataSource: ListDataSource);
    canHandle(context: CompletionContext): boolean;
    provide(context: CompletionContext): Promise<CompletionSuggestion[]>;
    private provideSpecSuggestions;
    private provideTagSuggestions;
    /**
     * Extract specName from --spec option value in context
     */
    private extractSpecName;
}