import type { AnalyzeHeadingsOptions, HeadingsAnalysis } from './types.js';
/**
 * Analyzes heading structure from an HTML string.
 *
 * Checks for:
 * - missing H1
 * - multiple H1s
 * - skipped heading levels (for example, H1 -> H3)
 *
 * @param options - Heading analysis options.
 * @returns Structural heading diagnostics and warning codes.
 *
 * @example
 * analyzeHeadings({
 *   html: '<h1>Page</h1><h2>Section</h2><h4>Skipped</h4>',
 * });
 */
export declare const analyzeHeadings: ({ html, }: AnalyzeHeadingsOptions) => HeadingsAnalysis;