/**
 * ARIA attribute utilities for WCAG compliance
 */
import type { LabelConfig, ValidationConfig, InteractiveStateConfig, WidgetConfig } from '../../types/index.js';
/**
 * Builds ARIA attributes object from a partial record, filtering out undefined values
 * and converting boolean/number/undefined values to strings for HTML attributes
 *
 * @example
 * ```ts
 * const attrs = buildAriaAttrs({
 *   'aria-label': 'Close',
 *   'aria-expanded': false,
 *   'aria-valuenow': 50,
 *   'aria-hidden': undefined
 * });
 * // { 'aria-label': 'Close', 'aria-expanded': 'false', 'aria-valuenow': '50' }
 * ```
 */
export declare function buildAriaAttrs(attrs: Record<string, string | number | boolean | undefined>): Record<string, string>;
/**
 * Creates ARIA attributes for labeling and describing elements
 *
 * @example
 * ```svelte
 * <Input
 *   id="email"
 *   {...labelAttrs({ label: 'Email address' })}
 * />
 * ```
 */
export declare function labelAttrs(options?: LabelConfig): Record<string, string>;
/**
 * Creates ARIA attributes for form validation states
 *
 * @example
 * ```svelte
 * <Input
 *   bind:value={email}
 *   {...validationAttrs({ invalid: !isValid, errormessage: 'email-error' })}
 * />
 * <p id="email-error" role="alert">{error}</p>
 * ```
 */
export declare function validationAttrs(options?: ValidationConfig): Record<string, string>;
/**
 * Creates ARIA attributes for interactive element states
 *
 * @example
 * ```svelte
 * <Button
 *   onclick={() => pressed = !pressed}
 *   {...interactiveStateAttrs({ pressed })}
 * >
 *   Toggle
 * </Button>
 * ```
 */
export declare function interactiveStateAttrs(options?: InteractiveStateConfig): Record<string, string>;
/**
 * Creates ARIA attributes for complex widgets and roles
 *
 * @example
 * ```svelte
 * <div role="slider" {...widgetAttrs({
 *   valuenow: value,
 *   valuemin: 0,
 *   valuemax: 100
 * })} />
 * ```
 */
export declare function widgetAttrs(options?: WidgetConfig): Record<string, string>;
/**
 * Combines multiple ARIA attribute objects into one
 * Useful for composing different accessibility patterns
 *
 * @example
 * ```svelte
 * <button {...mergeAttrs(
 *   labelAttrs({ label: 'Menu' }),
 *   interactiveStateAttrs({ expanded: isOpen }),
 *   widgetAttrs({ haspopup: 'menu', controls: 'menu-id' })
 * )}>
 *   Menu
 * </button>
 * ```
 */
export declare function mergeAttrs(...attrSets: Record<string, string>[]): Record<string, string>;