@nice2dev/ui-tools 1.0.10

package/dist/accessibility-i18n.d.ts

@@ -0,0 +1,1017 @@
+/**
+ * @fileoverview PRO-23: Accessibility & Internationalization Types
+ *
+ * This module provides TypeScript types and interfaces for building
+ * fully accessible and internationalized applications following
+ * WCAG 2.1 AA guidelines and supporting 50+ languages.
+ *
+ * @module @nice2dev/ui-tools/accessibility-i18n
+ */
+/**
+ * WCAG compliance levels.
+ */
+export type WCAGLevel = 'A' | 'AA' | 'AAA';
+/**
+ * WCAG version.
+ */
+export type WCAGVersion = '2.0' | '2.1' | '2.2';
+/**
+ * Accessibility configuration for an application.
+ */
+export interface AccessibilityConfig {
+    /** Target WCAG level */
+    targetLevel: WCAGLevel;
+    /** WCAG version to follow */
+    wcagVersion: WCAGVersion;
+    /** Enable screen reader optimizations */
+    screenReaderOptimizations: boolean;
+    /** Enable full keyboard navigation */
+    keyboardNavigation: boolean;
+    /** Enforce minimum color contrast */
+    enforceColorContrast: boolean;
+    /** Minimum contrast ratio (4.5:1 for AA) */
+    minContrastRatio: number;
+    /** Respect prefers-reduced-motion */
+    respectReducedMotion: boolean;
+    /** Enable focus visible indicators */
+    focusVisible: boolean;
+    /** Enable high contrast mode support */
+    highContrastSupport: boolean;
+    /** Enable forced colors support */
+    forcedColorsSupport: boolean;
+    /** Run automated accessibility tests */
+    automatedTesting: boolean;
+}
+/**
+ * ARIA roles for semantic meaning.
+ */
+export type AriaRole = 'banner' | 'complementary' | 'contentinfo' | 'form' | 'main' | 'navigation' | 'region' | 'search' | 'button' | 'checkbox' | 'dialog' | 'gridcell' | 'link' | 'log' | 'marquee' | 'menuitem' | 'menuitemcheckbox' | 'menuitemradio' | 'option' | 'progressbar' | 'radio' | 'scrollbar' | 'searchbox' | 'slider' | 'spinbutton' | 'status' | 'switch' | 'tab' | 'tabpanel' | 'textbox' | 'timer' | 'tooltip' | 'treeitem' | 'article' | 'cell' | 'columnheader' | 'definition' | 'directory' | 'document' | 'figure' | 'group' | 'heading' | 'img' | 'list' | 'listitem' | 'math' | 'none' | 'note' | 'presentation' | 'row' | 'rowgroup' | 'rowheader' | 'separator' | 'table' | 'term' | 'toolbar' | 'alert' | 'alertdialog' | 'application' | 'grid' | 'listbox' | 'menu' | 'menubar' | 'radiogroup' | 'tablist' | 'tree' | 'treegrid';
+/**
+ * ARIA live region politeness.
+ */
+export type AriaLive = 'off' | 'polite' | 'assertive';
+/**
+ * ARIA pressed state for toggle buttons.
+ */
+export type AriaPressed = boolean | 'mixed';
+/**
+ * ARIA expanded state for collapsible elements.
+ */
+export type AriaExpanded = boolean;
+/**
+ * ARIA selected state.
+ */
+export type AriaSelected = boolean;
+/**
+ * ARIA checked state.
+ */
+export type AriaChecked = boolean | 'mixed';
+/**
+ * ARIA label configuration.
+ */
+export interface AriaLabelConfig {
+    /** The accessible label */
+    label?: string;
+    /** ID of element that labels this */
+    labelledBy?: string;
+    /** ID of element that describes this */
+    describedBy?: string;
+    /** ID of error message element */
+    errorMessage?: string;
+    /** Additional details for screen readers */
+    details?: string;
+}
+/**
+ * ARIA relationship configuration.
+ */
+export interface AriaRelationships {
+    /** ID of controlled element */
+    controls?: string;
+    /** IDs of owned elements */
+    owns?: string;
+    /** ID of active descendant */
+    activeDescendant?: string;
+    /** IDs of related flow elements */
+    flowTo?: string;
+    /** ID of help element */
+    help?: string;
+}
+/**
+ * ARIA state configuration.
+ */
+export interface AriaState {
+    /** Whether element is expanded */
+    expanded?: AriaExpanded;
+    /** Whether element is selected */
+    selected?: AriaSelected;
+    /** Whether element is pressed */
+    pressed?: AriaPressed;
+    /** Whether element is checked */
+    checked?: AriaChecked;
+    /** Whether element is disabled */
+    disabled?: boolean;
+    /** Whether element is hidden */
+    hidden?: boolean;
+    /** Whether element is invalid */
+    invalid?: boolean | 'grammar' | 'spelling';
+    /** Whether element is required */
+    required?: boolean;
+    /** Whether element is read-only */
+    readOnly?: boolean;
+    /** Whether element is busy */
+    busy?: boolean;
+    /** Current value for range widgets */
+    valuenow?: number;
+    /** Minimum value for range widgets */
+    valuemin?: number;
+    /** Maximum value for range widgets */
+    valuemax?: number;
+    /** Text alternative for current value */
+    valuetext?: string;
+    /** Current item position */
+    posinset?: number;
+    /** Total items in set */
+    setsize?: number;
+    /** Level in hierarchy */
+    level?: number;
+    /** Sort direction */
+    sort?: 'ascending' | 'descending' | 'none' | 'other';
+    /** Autocomplete behavior */
+    autocomplete?: 'none' | 'inline' | 'list' | 'both';
+    /** Multiselectable */
+    multiselectable?: boolean;
+    /** Orientation */
+    orientation?: 'horizontal' | 'vertical';
+}
+/**
+ * Complete accessible element configuration.
+ */
+export interface AccessibleElementConfig extends AriaLabelConfig, AriaRelationships, AriaState {
+    /** Element role */
+    role?: AriaRole;
+    /** Live region configuration */
+    live?: AriaLive;
+    /** Atomic updates for live regions */
+    atomic?: boolean;
+    /** Relevant changes for live regions */
+    relevant?: 'additions' | 'removals' | 'text' | 'all';
+    /** Tab index for keyboard navigation */
+    tabIndex?: number;
+}
+/**
+ * Keyboard shortcut definition.
+ */
+export interface KeyboardShortcut {
+    /** Shortcut identifier */
+    id: string;
+    /** Key combination (e.g., "Ctrl+S", "Alt+Shift+P") */
+    keys: string;
+    /** Description of what the shortcut does */
+    description: string;
+    /** Action category */
+    category?: string;
+    /** Whether shortcut is global */
+    global?: boolean;
+    /** Whether shortcut can be customized */
+    customizable?: boolean;
+    /** Alternative key combination */
+    alternative?: string;
+    /** Platform-specific overrides */
+    platformOverrides?: Record<string, string>;
+}
+/**
+ * Keyboard navigation configuration.
+ */
+export interface KeyboardNavigationConfig {
+    /** Enable arrow key navigation */
+    arrowNavigation: boolean;
+    /** Enable tab navigation */
+    tabNavigation: boolean;
+    /** Enable home/end navigation */
+    homeEndNavigation: boolean;
+    /** Enable page up/down navigation */
+    pageNavigation: boolean;
+    /** Enable type-ahead search */
+    typeAhead: boolean;
+    /** Type-ahead timeout in ms */
+    typeAheadTimeout?: number;
+    /** Wrap around at boundaries */
+    wrapNavigation: boolean;
+    /** Custom shortcuts */
+    shortcuts: KeyboardShortcut[];
+}
+/**
+ * Focus trap configuration.
+ */
+export interface FocusTrapConfig {
+    /** Enable focus trap */
+    enabled: boolean;
+    /** Allow escape key to exit */
+    allowEscape: boolean;
+    /** Return focus to trigger on close */
+    returnFocus: boolean;
+    /** Initial focus target selector */
+    initialFocus?: string;
+    /** Final focus target selector */
+    finalFocus?: string;
+    /** Selectors for focusable elements */
+    focusableSelectors?: string[];
+}
+/**
+ * Focus management utilities.
+ */
+export interface FocusManagement {
+    /** Currently focused element ID */
+    currentFocus?: string;
+    /** Focus history stack */
+    focusHistory: string[];
+    /** Maximum history length */
+    maxHistoryLength: number;
+    /** Focus trap configuration */
+    trap?: FocusTrapConfig;
+}
+/**
+ * Color contrast requirements.
+ */
+export interface ColorContrastRequirements {
+    /** Minimum contrast for normal text */
+    normalText: number;
+    /** Minimum contrast for large text (14pt bold or 18pt) */
+    largeText: number;
+    /** Minimum contrast for UI components */
+    uiComponents: number;
+    /** Minimum contrast for graphical objects */
+    graphicalObjects: number;
+    /** Minimum contrast for focus indicators */
+    focusIndicators: number;
+}
+/**
+ * WCAG 2.1 AA contrast requirements.
+ */
+export declare const WCAG_AA_CONTRAST: ColorContrastRequirements;
+/**
+ * WCAG 2.1 AAA contrast requirements.
+ */
+export declare const WCAG_AAA_CONTRAST: ColorContrastRequirements;
+/**
+ * Color contrast check result.
+ */
+export interface ContrastCheckResult {
+    /** Foreground color */
+    foreground: string;
+    /** Background color */
+    background: string;
+    /** Calculated contrast ratio */
+    ratio: number;
+    /** Passes AA for normal text */
+    passesAANormal: boolean;
+    /** Passes AA for large text */
+    passesAALarge: boolean;
+    /** Passes AAA for normal text */
+    passesAAANormal: boolean;
+    /** Passes AAA for large text */
+    passesAAALarge: boolean;
+    /** Suggested alternatives if failing */
+    suggestions?: ColorSuggestion[];
+}
+/**
+ * Color suggestion for improving contrast.
+ */
+export interface ColorSuggestion {
+    /** Suggested color */
+    color: string;
+    /** Resulting contrast ratio */
+    resultingRatio: number;
+    /** Whether it passes target level */
+    passesTarget: boolean;
+    /** How different from original (0-1) */
+    colorDifference: number;
+}
+/**
+ * High contrast mode configuration.
+ */
+export interface HighContrastConfig {
+    /** Detect high contrast mode automatically */
+    autoDetect: boolean;
+    /** Custom high contrast theme */
+    customTheme?: HighContrastTheme;
+    /** Respect Windows high contrast mode */
+    respectWindowsHC: boolean;
+    /** Enable forced-colors support */
+    forcedColors: boolean;
+}
+/**
+ * High contrast theme colors.
+ */
+export interface HighContrastTheme {
+    /** Background color */
+    background: string;
+    /** Foreground/text color */
+    foreground: string;
+    /** Link color */
+    link: string;
+    /** Visited link color */
+    linkVisited: string;
+    /** Button background */
+    buttonBackground: string;
+    /** Button text */
+    buttonText: string;
+    /** Disabled text */
+    disabledText: string;
+    /** Highlight background */
+    highlight: string;
+    /** Highlight text */
+    highlightText: string;
+}
+/**
+ * Reduced motion configuration.
+ */
+export interface ReducedMotionConfig {
+    /** Detect prefers-reduced-motion automatically */
+    autoDetect: boolean;
+    /** Force reduced motion regardless of system setting */
+    forceReduced: boolean;
+    /** Alternative for essential animations */
+    essentialAnimationFallback: 'none' | 'fade' | 'instant';
+    /** Maximum animation duration when reduced (ms) */
+    maxDuration: number;
+}
+/**
+ * Animation accessibility settings.
+ */
+export interface AnimationAccessibility {
+    /** Whether animations are enabled */
+    enabled: boolean;
+    /** Maximum animation duration (ms) */
+    maxDuration: number;
+    /** Disable parallax effects */
+    disableParallax: boolean;
+    /** Disable auto-playing videos */
+    disableAutoplayVideo: boolean;
+    /** Disable auto-playing audio */
+    disableAutoplayAudio: boolean;
+    /** Pause animations on focus loss */
+    pauseOnFocusLoss: boolean;
+    /** Provide animation controls */
+    showAnimationControls: boolean;
+}
+/**
+ * Screen reader announcement configuration.
+ */
+export interface ScreenReaderAnnouncement {
+    /** Message to announce */
+    message: string;
+    /** Politeness level */
+    politeness: AriaLive;
+    /** Whether to clear previous announcements */
+    clearQueue?: boolean;
+    /** Delay before announcement (ms) */
+    delay?: number;
+}
+/**
+ * Live region configuration.
+ */
+export interface LiveRegionConfig {
+    /** Region ID */
+    id: string;
+    /** Politeness level */
+    politeness: AriaLive;
+    /** Whether updates are atomic */
+    atomic: boolean;
+    /** What changes are relevant */
+    relevant: 'additions' | 'removals' | 'text' | 'all';
+    /** Role (status, log, alert, etc.) */
+    role?: 'status' | 'log' | 'alert' | 'progressbar' | 'marquee' | 'timer';
+}
+/**
+ * Screen reader hints configuration.
+ */
+export interface ScreenReaderHints {
+    /** Enable form field hints */
+    formHints: boolean;
+    /** Enable navigation hints */
+    navigationHints: boolean;
+    /** Enable state change announcements */
+    stateChangeAnnouncements: boolean;
+    /** Enable error announcements */
+    errorAnnouncements: boolean;
+    /** Enable loading announcements */
+    loadingAnnouncements: boolean;
+    /** Announce page titles */
+    announcePageTitles: boolean;
+    /** Announce focus changes */
+    announceFocusChanges: boolean;
+}
+/**
+ * Accessible form field configuration.
+ */
+export interface AccessibleFormField {
+    /** Field ID */
+    id: string;
+    /** Field name */
+    name: string;
+    /** Label text */
+    label: string;
+    /** Label position */
+    labelPosition: 'before' | 'after' | 'floating';
+    /** Whether label is visible */
+    labelVisible: boolean;
+    /** Help text */
+    helpText?: string;
+    /** Error message */
+    errorMessage?: string;
+    /** Whether field is required */
+    required: boolean;
+    /** Auto-complete attribute */
+    autocomplete?: string;
+    /** Input mode */
+    inputMode?: 'none' | 'text' | 'tel' | 'url' | 'email' | 'numeric' | 'decimal' | 'search';
+    /** Pattern validation */
+    pattern?: string;
+    /** Pattern description for screen readers */
+    patternDescription?: string;
+}
+/**
+ * Form error handling configuration.
+ */
+export interface FormErrorHandling {
+    /** Show inline errors */
+    inlineErrors: boolean;
+    /** Show error summary */
+    errorSummary: boolean;
+    /** Error summary position */
+    summaryPosition: 'top' | 'bottom';
+    /** Focus first error on submit */
+    focusFirstError: boolean;
+    /** Announce errors to screen readers */
+    announceErrors: boolean;
+    /** Error announcement politeness */
+    errorPoliteness: AriaLive;
+    /** Real-time validation */
+    realtimeValidation: boolean;
+    /** Validation delay (ms) */
+    validationDelay?: number;
+}
+/**
+ * Skip link configuration.
+ */
+export interface SkipLink {
+    /** Link text */
+    text: string;
+    /** Target element ID */
+    target: string;
+    /** Whether link is visible on focus */
+    visibleOnFocus: boolean;
+}
+/**
+ * Page landmarks configuration.
+ */
+export interface LandmarksConfig {
+    /** Main content landmark ID */
+    main?: string;
+    /** Navigation landmark ID */
+    navigation?: string;
+    /** Search landmark ID */
+    search?: string;
+    /** Banner landmark ID */
+    banner?: string;
+    /** Footer landmark ID */
+    contentinfo?: string;
+    /** Complementary/aside landmark IDs */
+    complementary?: string[];
+    /** Custom regions */
+    regions?: {
+        id: string;
+        label: string;
+    }[];
+}
+/**
+ * Accessibility test result.
+ */
+export interface AccessibilityTestResult {
+    /** Test passed */
+    passed: boolean;
+    /** Number of violations */
+    violationCount: number;
+    /** Violations found */
+    violations: AccessibilityViolation[];
+    /** Passes (optional, for reporting) */
+    passes?: AccessibilityPass[];
+    /** Incomplete checks (need manual review) */
+    incomplete?: AccessibilityIncomplete[];
+    /** Test timestamp */
+    timestamp: string;
+    /** Page/component tested */
+    target: string;
+}
+/**
+ * Accessibility violation.
+ */
+export interface AccessibilityViolation {
+    /** Rule ID */
+    ruleId: string;
+    /** Violation description */
+    description: string;
+    /** Impact severity */
+    impact: 'minor' | 'moderate' | 'serious' | 'critical';
+    /** WCAG criteria violated */
+    wcagCriteria: string[];
+    /** Help URL */
+    helpUrl: string;
+    /** Affected elements */
+    nodes: AccessibilityNode[];
+    /** How to fix */
+    fix: string;
+}
+/**
+ * Accessibility pass (rule that passed).
+ */
+export interface AccessibilityPass {
+    /** Rule ID */
+    ruleId: string;
+    /** Rule description */
+    description: string;
+    /** Elements that passed */
+    nodes: AccessibilityNode[];
+}
+/**
+ * Incomplete accessibility check.
+ */
+export interface AccessibilityIncomplete {
+    /** Rule ID */
+    ruleId: string;
+    /** What needs manual review */
+    description: string;
+    /** Elements to review */
+    nodes: AccessibilityNode[];
+}
+/**
+ * Affected DOM node.
+ */
+export interface AccessibilityNode {
+    /** Element selector */
+    selector: string;
+    /** Element HTML */
+    html: string;
+    /** Failure summary */
+    failureSummary?: string;
+}
+/**
+ * Locale identifier (BCP 47).
+ */
+export type LocaleCode = string;
+/**
+ * Text direction.
+ */
+export type TextDirection = 'ltr' | 'rtl' | 'auto';
+/**
+ * I18n configuration.
+ */
+export interface I18nConfig {
+    /** Default locale */
+    defaultLocale: LocaleCode;
+    /** Supported locales */
+    supportedLocales: LocaleCode[];
+    /** Fallback locale */
+    fallbackLocale: LocaleCode;
+    /** Enable RTL support */
+    rtlSupport: boolean;
+    /** RTL locales */
+    rtlLocales: LocaleCode[];
+    /** Load locale on demand */
+    lazyLoading: boolean;
+    /** Translation file format */
+    format: 'json' | 'yaml' | 'po' | 'xliff';
+    /** Missing translation handling */
+    missingTranslation: 'warn' | 'error' | 'fallback' | 'key';
+    /** Enable pluralization */
+    pluralization: boolean;
+    /** Enable gender agreement */
+    genderAgreement: boolean;
+    /** Date/time format configuration */
+    dateTimeFormats: Record<LocaleCode, DateTimeFormats>;
+    /** Number format configuration */
+    numberFormats: Record<LocaleCode, NumberFormats>;
+}
+/**
+ * Date/time format presets.
+ */
+export interface DateTimeFormats {
+    /** Short date format */
+    short: Intl.DateTimeFormatOptions;
+    /** Medium date format */
+    medium: Intl.DateTimeFormatOptions;
+    /** Long date format */
+    long: Intl.DateTimeFormatOptions;
+    /** Full date format */
+    full: Intl.DateTimeFormatOptions;
+    /** Time only format */
+    time: Intl.DateTimeFormatOptions;
+    /** DateTime format */
+    datetime: Intl.DateTimeFormatOptions;
+    /** Relative time format */
+    relative: Intl.RelativeTimeFormatOptions;
+}
+/**
+ * Date formatting configuration.
+ */
+export interface DateFormatConfig {
+    /** Locale for formatting */
+    locale: LocaleCode;
+    /** Calendar system */
+    calendar: CalendarSystem;
+    /** Timezone */
+    timezone: string;
+    /** Hour cycle (12 or 24) */
+    hourCycle: 'h11' | 'h12' | 'h23' | 'h24';
+    /** Week starts on */
+    weekStartsOn: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+}
+/**
+ * Supported calendar systems.
+ */
+export type CalendarSystem = 'gregory' | 'buddhist' | 'chinese' | 'coptic' | 'ethiopic' | 'hebrew' | 'indian' | 'islamic' | 'islamic-civil' | 'islamic-rgsa' | 'islamic-tbla' | 'islamic-umalqura' | 'japanese' | 'persian' | 'roc';
+/**
+ * Relative time formatting result.
+ */
+export interface RelativeTimeResult {
+    /** Formatted string */
+    formatted: string;
+    /** Unit used */
+    unit: Intl.RelativeTimeFormatUnit;
+    /** Numeric value */
+    value: number;
+    /** Whether time is in past */
+    isPast: boolean;
+}
+/**
+ * Number format presets.
+ */
+export interface NumberFormats {
+    /** Decimal format */
+    decimal: Intl.NumberFormatOptions;
+    /** Currency format */
+    currency: CurrencyFormatOptions;
+    /** Percent format */
+    percent: Intl.NumberFormatOptions;
+    /** Compact format (1K, 1M) */
+    compact: Intl.NumberFormatOptions;
+    /** Scientific format */
+    scientific: Intl.NumberFormatOptions;
+    /** Unit format */
+    unit: UnitFormatOptions;
+}
+/**
+ * Currency format options.
+ */
+export interface CurrencyFormatOptions extends Intl.NumberFormatOptions {
+    /** Currency code (ISO 4217) */
+    currency: string;
+    /** Currency display style */
+    currencyDisplay?: 'symbol' | 'narrowSymbol' | 'code' | 'name';
+    /** Accounting format for negative values */
+    currencySign?: 'standard' | 'accounting';
+}
+/**
+ * Unit format options.
+ */
+export interface UnitFormatOptions extends Intl.NumberFormatOptions {
+    /** Unit to display */
+    unit: string;
+    /** Unit display style */
+    unitDisplay?: 'short' | 'narrow' | 'long';
+}
+/**
+ * Common currency codes.
+ */
+export type CurrencyCode = 'USD' | 'EUR' | 'GBP' | 'JPY' | 'CNY' | 'CHF' | 'CAD' | 'AUD' | 'NZD' | 'SEK' | 'NOK' | 'DKK' | 'PLN' | 'CZK' | 'HUF' | 'RON' | 'BGN' | 'HRK' | 'RUB' | 'UAH' | 'TRY' | 'BRL' | 'MXN' | 'ARS' | 'INR' | 'KRW' | 'SGD' | 'HKD' | 'TWD' | 'THB' | 'MYR' | 'IDR' | 'PHP' | 'VND' | 'ZAR' | 'EGP' | 'SAR' | 'AED' | 'ILS' | 'NGN' | string;
+/**
+ * Plural categories (CLDR).
+ */
+export type PluralCategory = 'zero' | 'one' | 'two' | 'few' | 'many' | 'other';
+/**
+ * Plural rule function type.
+ */
+export type PluralRuleFunction = (n: number, ord?: boolean) => PluralCategory;
+/**
+ * Plural rules configuration.
+ */
+export interface PluralRules {
+    /** Locale */
+    locale: LocaleCode;
+    /** Cardinal plural rules */
+    cardinal: PluralRuleFunction;
+    /** Ordinal plural rules */
+    ordinal: PluralRuleFunction;
+    /** Plural categories used by this locale */
+    categories: PluralCategory[];
+    /** Ordinal categories used by this locale */
+    ordinalCategories: PluralCategory[];
+}
+/**
+ * Pluralized message.
+ */
+export interface PluralMessage {
+    /** Message for zero */
+    zero?: string;
+    /** Message for one */
+    one?: string;
+    /** Message for two (Arabic, Hebrew) */
+    two?: string;
+    /** Message for few (Slavic languages) */
+    few?: string;
+    /** Message for many (Slavic languages) */
+    many?: string;
+    /** Message for other (required) */
+    other: string;
+}
+/**
+ * Grammatical gender.
+ */
+export type GrammaticalGender = 'masculine' | 'feminine' | 'neuter' | 'common' | 'animate' | 'inanimate';
+/**
+ * Gender-aware message.
+ */
+export interface GenderedMessage {
+    /** Message for masculine */
+    masculine?: string;
+    /** Message for feminine */
+    feminine?: string;
+    /** Message for neuter */
+    neuter?: string;
+    /** Message for unknown/common gender */
+    other: string;
+}
+/**
+ * Combined plural and gender message.
+ */
+export interface PluralGenderedMessage {
+    /** Messages by gender, then by plural */
+    [gender: string]: PluralMessage;
+}
+/**
+ * Translation entry.
+ */
+export interface TranslationEntry {
+    /** Translation key */
+    key: string;
+    /** Source text */
+    source: string;
+    /** Translated text */
+    translation: string;
+    /** Context for translators */
+    context?: string;
+    /** Translator notes */
+    notes?: string;
+    /** Whether entry is reviewed */
+    reviewed: boolean;
+    /** Last modified timestamp */
+    lastModified: string;
+    /** Last modified by */
+    modifiedBy?: string;
+    /** Plural forms */
+    plurals?: PluralMessage;
+    /** Gender forms */
+    genders?: GenderedMessage;
+}
+/**
+ * Translation namespace/file.
+ */
+export interface TranslationNamespace {
+    /** Namespace name */
+    name: string;
+    /** Locale code */
+    locale: LocaleCode;
+    /** Translations in this namespace */
+    translations: Record<string, TranslationEntry | string | PluralMessage>;
+    /** Namespace version */
+    version: string;
+    /** Last updated */
+    lastUpdated: string;
+}
+/**
+ * Translation Management System (TMS) integration.
+ */
+export interface TMSIntegration {
+    /** TMS provider */
+    provider: 'crowdin' | 'lokalise' | 'phrase' | 'transifex' | 'weblate' | 'custom';
+    /** API endpoint */
+    apiEndpoint?: string;
+    /** API key (should be from env) */
+    apiKey?: string;
+    /** Project ID */
+    projectId: string;
+    /** Sync direction */
+    syncDirection: 'push' | 'pull' | 'both';
+    /** Auto-sync on build */
+    autoSync: boolean;
+}
+/**
+ * Translation memory entry.
+ */
+export interface TranslationMemoryEntry {
+    /** Source text */
+    source: string;
+    /** Source locale */
+    sourceLocale: LocaleCode;
+    /** Target text */
+    target: string;
+    /** Target locale */
+    targetLocale: LocaleCode;
+    /** Similarity score (0-100) */
+    similarity: number;
+    /** Context */
+    context?: string;
+    /** Usage count */
+    usageCount: number;
+}
+/**
+ * RTL layout configuration.
+ */
+export interface RTLConfig {
+    /** Current direction */
+    direction: TextDirection;
+    /** Flip icons in RTL */
+    flipIcons: boolean;
+    /** Icons to exclude from flipping */
+    excludeIcons: string[];
+    /** Flip animations */
+    flipAnimations: boolean;
+    /** Use logical properties (start/end vs left/right) */
+    useLogicalProperties: boolean;
+    /** Mirror entire layout */
+    mirrorLayout: boolean;
+}
+/**
+ * Bidirectional text handling.
+ */
+export interface BidiConfig {
+    /** Enable bidirectional text support */
+    enabled: boolean;
+    /** Default text direction */
+    defaultDirection: TextDirection;
+    /** Isolate mixed direction text */
+    isolateMixed: boolean;
+    /** Override algorithm for specific elements */
+    overrides?: Record<string, TextDirection>;
+}
+/**
+ * Timezone configuration.
+ */
+export interface TimezoneConfig {
+    /** User's timezone */
+    userTimezone: string;
+    /** Server/default timezone */
+    serverTimezone: string;
+    /** Display format */
+    displayFormat: 'local' | 'utc' | 'both';
+    /** Auto-detect timezone */
+    autoDetect: boolean;
+    /** Show timezone abbreviation */
+    showAbbreviation: boolean;
+}
+/**
+ * Timezone info.
+ */
+export interface TimezoneInfo {
+    /** IANA timezone ID */
+    id: string;
+    /** Display name */
+    displayName: string;
+    /** UTC offset in minutes */
+    offsetMinutes: number;
+    /** UTC offset string (e.g., "+02:00") */
+    offsetString: string;
+    /** Abbreviation (e.g., "CET", "EST") */
+    abbreviation: string;
+    /** Whether DST is currently active */
+    isDST: boolean;
+}
+/**
+ * Pseudo-localization configuration for testing.
+ */
+export interface PseudoLocalizationConfig {
+    /** Enable pseudo-localization */
+    enabled: boolean;
+    /** Pseudo-locale code */
+    pseudoLocale: string;
+    /** Expansion factor (1.3 = 30% longer) */
+    expansionFactor: number;
+    /** Use accented characters */
+    accented: boolean;
+    /** Add brackets around strings */
+    brackets: boolean;
+    /** Bracket style */
+    bracketStyle: '[{text}]' | '「{text}」' | '《{text}》';
+    /** Simulate RTL */
+    simulateRtl: boolean;
+    /** Exclamation marks at start */
+    exclamation: boolean;
+}
+/**
+ * Locale detection configuration.
+ */
+export interface LocaleDetectionConfig {
+    /** Detection order */
+    order: LocaleDetectionSource[];
+    /** Default if detection fails */
+    fallback: LocaleCode;
+    /** Cache detected locale */
+    cache: boolean;
+    /** Cache key (localStorage/cookie) */
+    cacheKey: string;
+    /** Accept partial matches (e.g., 'en' for 'en-US') */
+    partialMatch: boolean;
+}
+/**
+ * Sources for locale detection.
+ */
+export type LocaleDetectionSource = 'querystring' | 'cookie' | 'localStorage' | 'sessionStorage' | 'navigator' | 'header' | 'path' | 'subdomain' | 'custom';
+/**
+ * useTranslation hook options.
+ */
+export interface UseTranslationOptions {
+    /** Namespace to use */
+    namespace?: string | string[];
+    /** Key prefix */
+    keyPrefix?: string;
+    /** Fallback namespace */
+    fallbackNS?: string;
+    /** Use suspense for loading */
+    useSuspense?: boolean;
+}
+/**
+ * useTranslation hook return type.
+ */
+export interface UseTranslationResult {
+    /** Translation function */
+    t: TranslationFunction;
+    /** Current locale */
+    locale: LocaleCode;
+    /** Available locales */
+    locales: LocaleCode[];
+    /** Change locale */
+    changeLocale: (locale: LocaleCode) => Promise<void>;
+    /** Whether translations are loading */
+    isLoading: boolean;
+    /** Current direction */
+    dir: TextDirection;
+}
+/**
+ * Translation function type.
+ */
+export type TranslationFunction = {
+    /** Simple translation */
+    (key: string): string;
+    /** Translation with interpolation */
+    (key: string, values: Record<string, unknown>): string;
+    /** Translation with count for pluralization */
+    (key: string, options: {
+        count: number;
+        [key: string]: unknown;
+    }): string;
+    /** Translation with context */
+    (key: string, options: {
+        context: string;
+        [key: string]: unknown;
+    }): string;
+};
+/**
+ * I18n provider props.
+ */
+export interface I18nProviderProps {
+    /** I18n configuration */
+    config: I18nConfig;
+    /** Initial locale */
+    initialLocale?: LocaleCode;
+    /** Children */
+    children: React.ReactNode;
+    /** On locale change callback */
+    onLocaleChange?: (locale: LocaleCode) => void;
+}
+/**
+ * Full accessibility and i18n configuration.
+ */
+export interface A11yI18nConfig {
+    /** Accessibility configuration */
+    accessibility: AccessibilityConfig;
+    /** I18n configuration */
+    i18n: I18nConfig;
+    /** Screen reader adjustments per locale */
+    localeScreenReaderAdjustments?: Record<LocaleCode, ScreenReaderHints>;
+    /** Locale-specific keyboard shortcuts */
+    localeKeyboardShortcuts?: Record<LocaleCode, KeyboardShortcut[]>;
+}
+/**
+ * Default accessibility configuration.
+ */
+export declare const DEFAULT_ACCESSIBILITY_CONFIG: AccessibilityConfig;
+/**
+ * Common supported locales.
+ */
+export declare const COMMON_LOCALES: LocaleCode[];
+/**
+ * RTL locales.
+ */
+export declare const RTL_LOCALES: LocaleCode[];
+//# sourceMappingURL=accessibility-i18n.d.ts.map