/** * Screen reader announcement utility using ARIA live regions. * * Creates and manages off-screen live regions to announce dynamic * content changes to assistive technologies. * * @module bquery/a11y */ import type { AnnouncePriority } from './types'; /** * Announces a message to screen readers via an ARIA live region. * * The message is injected into a visually-hidden live region element. * Screen readers will pick up the change and announce it to the user. * * @param message - The text message to announce * @param priority - The urgency level: `'polite'` (default) or `'assertive'` * * @example * ```ts * import { announceToScreenReader } from '@bquery/bquery/a11y'; * * // Polite announcement (waits for idle) * announceToScreenReader('3 search results found'); * * // Assertive announcement (interrupts current speech) * announceToScreenReader('Error: Please fix the form', 'assertive'); * ``` */ export declare const announceToScreenReader: (message: string, priority?: AnnouncePriority) => void; /** * Removes all live region elements created by `announceToScreenReader`. * Useful for cleanup in tests or when unmounting an application. * * @example * ```ts * import { clearAnnouncements } from '@bquery/bquery/a11y'; * * clearAnnouncements(); * ``` */ export declare const clearAnnouncements: () => void; //# sourceMappingURL=announce.d.ts.map