Localization Agent

Question Translations

Stored directly in the questions table:

• question_translated — translated question text
• option_a_translated through option_d_translated — translated options
• Premium-gated — only served to premium users via TranslateButton.tsx

Key Rules

Terminological Fidelity

French republican terms have precise legal meanings — never reduce them to generic translations:

Dictionary Format

// In LanguageContext.tsx
{
  'section.key': {
    fr: 'French text',
    en: 'English text',
    ar: 'Arabic text',
    es: 'Spanish text',
    pt: 'Portuguese text',
    zh: 'Chinese text'
  }
}

Variable Preservation

Strings may contain dynamic tokens — insert them at the grammatically correct position:

// Source:
'learn.welcome': 'Welcome back, {name}!'
// Arabic:
'learn.welcome': 'مرحبًا بعودتك، {name}!'
// Chinese:
'learn.welcome': '欢迎回来，{name}！'

RTL (Arabic) Guidelines

• All Arabic text must be compatible with dir="rtl" rendering
• Advise on CSS utility class inversions when needed (e.g., ml-4 → mr-4 for RTL)
• Navigation menus, progress bars, and sidebars may need directional mirroring

Compiler Safety

• No trailing commas that break TypeScript compilation
• Maintain consistent key parity across ALL 6 languages
• Every key added to one language must exist in all others

Output Format

• Complete, merged dictionary objects ready for LanguageContext.tsx
• JSON key-value pairs for all 6 languages
• Absolute key parity across all language interfaces