/**
 * Validates markdown heading hierarchy
 * Ensures no skipped levels (H1 → H3) and proper structure
 *
 * @see https://www.kapa.ai/blog/optimizing-technical-documentation-for-llms
 */
export interface HeadingViolation {
    line: number;
    level: number;
    expected: number;
    message: string;
    text: string;
}
export interface HeadingHierarchyResult {
    valid: boolean;
    errors: HeadingViolation[];
    warnings: HeadingViolation[];
    maxDepth: number;
    headingCount: number;
}
export declare class HeadingHierarchyValidator {
    private maxRecommendedDepth;
    private strictMode;
    constructor(options?: {
        maxDepth?: number;
        strict?: boolean;
    });
    /**
     * Validate heading hierarchy in markdown content
     */
    validate(content: string, filePath?: string): HeadingHierarchyResult;
    /**
     * Validate all markdown files in a directory
     */
    validateDirectory(dirPath: string, pattern?: string): Promise<Map<string, HeadingHierarchyResult>>;
    /**
     * Format validation results for display
     */
    formatResults(results: Map<string, HeadingHierarchyResult>): string;
}
//# sourceMappingURL=heading-hierarchy-validator.d.ts.map