/**
 * Development-time accessibility audit utility.
 *
 * Scans DOM elements for common accessibility issues such as missing
 * alt text on images, missing labels on form inputs, empty links/buttons,
 * and incorrect ARIA usage.
 *
 * @module bquery/a11y
 */
import type { AuditResult, AuditRule } from './types';
/**
 * The complete, frozen catalog of rules the runtime audit checks, each mapped
 * to a WCAG 2.1 success criterion and annotated with what it **cannot** detect.
 *
 * This is the audit's documented scope. The runtime audit catches structural,
 * statically-determinable issues only; it does **not** evaluate colour
 * contrast, focus order, reading order, motion, timing, or any criterion that
 * requires rendering, computed styles, or human judgement. Treat it as a fast
 * development signal, never as a substitute for a manual or professional audit.
 *
 * @see {@link auditA11y}
 */
export declare const auditRules: readonly AuditRule[];
/**
 * Runs a development-time accessibility audit on a container element.
 *
 * Checks for common accessibility issues including:
 * - Missing alt text on images
 * - Missing labels on form inputs
 * - Empty buttons and links
 * - Heading hierarchy issues
 * - Invalid ARIA references
 * - Missing document landmarks
 *
 * This is intended as a development tool — not a replacement for
 * manual testing or professional accessibility audits.
 *
 * @param container - The element to audit (defaults to `document.body`)
 * @returns An audit result with findings, counts, and pass/fail status
 *
 * @example
 * ```ts
 * import { auditA11y } from '@bquery/bquery/a11y';
 *
 * const result = auditA11y();
 * if (!result.passed) {
 *   console.warn(`Found ${result.errors} accessibility errors:`);
 *   for (const f of result.findings) {
 *     console.warn(`[${f.severity}] ${f.message}`, f.element);
 *   }
 * }
 * ```
 */
export declare const auditA11y: (container?: Element) => AuditResult;
//# sourceMappingURL=audit.d.ts.map