/**
 * Accessibility (a11y) utilities module for bQuery.js.
 *
 * Provides essential accessibility helpers for building inclusive
 * web applications: focus trapping, screen reader announcements,
 * keyboard navigation patterns, skip navigation, media preference
 * signals, and development-time auditing.
 *
 * Targeting **Stable** in 1.15.0: the surface is frozen for one minor cycle,
 * and the runtime audit's WCAG coverage is documented via the `auditRules`
 * catalog (and a `wcag` field on every finding), with its known limitations.
 *
 * @module bquery/a11y
 *
 * @example
 * ```ts
 * import {
 *   trapFocus,
 *   announceToScreenReader,
 *   rovingTabIndex,
 *   skipLink,
 *   prefersReducedMotion,
 *   prefersColorScheme,
 *   auditA11y,
 * } from '@bquery/bquery/a11y';
 *
 * // Trap focus in a modal
 * const trap = trapFocus(dialogElement);
 *
 * // Announce changes to screen readers
 * announceToScreenReader('Form submitted successfully');
 *
 * // Arrow key navigation in a toolbar
 * const roving = rovingTabIndex(toolbar, 'button', {
 *   orientation: 'horizontal',
 * });
 *
 * // Auto-generate skip navigation
 * const skip = skipLink('#main-content');
 *
 * // Reactive media preferences
 * const reduced = prefersReducedMotion();
 * const scheme = prefersColorScheme();
 *
 * // Development-time audit
 * const result = auditA11y();
 * if (!result.passed) console.warn(result.findings);
 * ```
 */

export { announceToScreenReader, clearAnnouncements } from './announce';
export { auditA11y, auditRules } from './audit';
export { autoFocus, inert, scrollLock, type DisposableHandle } from './dom-helpers';
export { focusVisible, keyboardUserSignal } from './keyboard-signals';
export {
  createLiveRegion,
  type CreateLiveRegionOptions,
  type LiveRegionHandle,
} from './live-region';
export { prefersColorScheme, prefersContrast, prefersReducedMotion } from './media-preferences';
export {
  forcedColors,
  prefersReducedData,
  prefersReducedTransparency,
  type ForcedColorsMode,
} from './media-preferences-extras';
export { rovingTabIndex } from './roving-tab-index';
export { skipLink } from './skip-link';
export { getFocusableElements, releaseFocus, trapFocus } from './trap-focus';

export type {
  AnnouncePriority,
  AuditFinding,
  AuditResult,
  AuditRule,
  AuditSeverity,
  ColorScheme,
  ContrastPreference,
  FocusTrapHandle,
  MediaPreferenceSignal,
  RovingTabIndexHandle,
  RovingTabIndexOptions,
  SkipLinkHandle,
  SkipLinkOptions,
  TrapFocusOptions,
} from './types';