/**
 * Configuration Validator
 *
 * Validates RAGgrep configuration for correctness and provides
 * helpful error messages for invalid configurations.
 */
import type { Config } from "../entities/config";
/**
 * Validation result for a single field or section.
 */
export interface ValidationIssue {
    /** The path to the invalid field (e.g., "modules[0].id") */
    path: string;
    /** The type of issue: error (invalid), warning (suboptimal), info (suggestion) */
    severity: "error" | "warning" | "info";
    /** Human-readable description of the issue */
    message: string;
    /** Suggested fix (optional) */
    suggestion?: string;
}
/**
 * Overall validation result.
 */
export interface ValidationResult {
    /** Whether the configuration is valid (no errors) */
    valid: boolean;
    /** List of all issues found */
    issues: ValidationIssue[];
    /** Helper method to get issues by severity */
    getErrors(): ValidationIssue[];
    getWarnings(): ValidationIssue[];
    getInfos(): ValidationIssue[];
}
/**
 * Validate a RAGgrep configuration.
 *
 * @param config - The configuration to validate
 * @returns Validation result with any issues found
 */
export declare function validateConfig(config: Config): ValidationResult;
/**
 * Format validation issues for display.
 */
export declare function formatValidationIssues(issues: ValidationIssue[]): string;