translator.py

# translator.py - AI-Powered Translation System with Arabic Support

import os
from dotenv import load_dotenv
import json
import traceback
from typing import Dict, List, Optional, Tuple
import google.generativeai as genai
import streamlit as st

class AITranslator:
    """
    AI-powered translator using Gemini API with specialized Arabic support
    """
    
    def __init__(self):
        self.model = None
        self.init_error = None
        self.supported_languages = {
            'ar': 'Arabic (العربية)',
            'en': 'English',
            'fr': 'French (Français)', 
            'es': 'Spanish (Español)',
            'de': 'German (Deutsch)',
            'zh': 'Chinese (中文)',
            'hi': 'Hindi (हिन्दी)',
            'ur': 'Urdu (اردو)'
        }
        self._initialize_gemini()
    
    def _initialize_gemini(self):
        """Initialize Gemini AI client using the new API structure."""
        try:
            load_dotenv()
            api_key = os.getenv("GEMINI_API_KEY")
            if not api_key:
                # This error is handled by the main app now, but we keep a fallback.
                self.init_error = "GEMINI_API_KEY not found."
                return

            genai.configure(api_key=api_key)
            self.model = genai.GenerativeModel('gemini-1.5-flash')
        except Exception as e:
            self.init_error = f"FATAL ERROR during Gemini Init: {str(e)}"
            self.model = None
    
    def translate_text(self, text: str, target_language: str = 'ar', source_language: str = 'auto') -> Tuple[Optional[str], Optional[str]]:
        """
        Translate text to target language using Gemini AI
        
        Args:
            text: Text to translate
            target_language: Target language code ('ar' for Arabic)
            source_language: Source language code ('auto' for auto-detection)
        
        Returns:
            Tuple of (translated_text, error_message)
        """
        if self.init_error:
            return None, self.init_error
        
        if not self.model:
            return None, "ERROR: Gemini model is not available."
        
        if not text or not text.strip():
            return None, "ERROR: Empty text provided for translation."
        
        try:
            target_lang_name = self.supported_languages.get(target_language, target_language)
            prompt = self._create_translation_prompt(text, target_lang_name, target_language)
            
            # Use the new generate_content method on the model instance
            response = self.model.generate_content(prompt)
            
            if response and hasattr(response, 'text') and response.text:
                translated_text = response.text.strip()
                translated_text = self._clean_translation_output(translated_text)
                return translated_text, None
            else:
                return None, "WARNING: Gemini returned empty translation response."
                
        except Exception as e:
            error_msg = f"FATAL ERROR during translation: {traceback.format_exc()}"
            return None, error_msg
    
    def _create_translation_prompt(self, text: str, target_lang_name: str, target_lang_code: str) -> str:
        """Create optimized prompt for translation"""
        
        if target_lang_code == 'ar':
            # Specialized prompt for Arabic translation
            prompt = f"""
Translate the following text to Arabic (العربية) with these requirements:
1. Maintain the original meaning accurately
2. Use Modern Standard Arabic (MSA) appropriate for academic contexts
3. Preserve technical terms when appropriate
4. Make it natural and fluent for Arabic speakers
5. For educational content, use clear and accessible language
6. Return ONLY the translated text without any explanations or formatting

Text to translate:
{text}
"""
        else:
            # General prompt for other languages
            prompt = f"""
Translate the following text to {target_lang_name} accurately while:
1. Maintaining the original meaning
2. Using appropriate formal/academic tone if the content appears educational
3. Preserving any technical terms appropriately
4. Making it natural and fluent for native speakers
5. Return ONLY the translated text without explanations

Text to translate:
{text}
"""
        
        return prompt
    
    def _clean_translation_output(self, text: str) -> str:
        """Clean up translation output from any unwanted formatting"""
        # Remove common markdown artifacts
        text = text.replace('**', '').replace('*', '')
        text = text.replace('```', '').replace('`', '')
        
        # Remove any leading/trailing quotes
        text = text.strip('"\'')
        
        # Clean up extra whitespace
        text = ' '.join(text.split())
        
        return text

    def explain_text_arabic(self, text: str, source_language: str = 'auto') -> Tuple[Optional[str], Optional[str]]:
        """Generate a detailed Arabic explanation (not a literal translation)."""
        if self.init_error:
            return None, self.init_error
        if not self.model:
            return None, "ERROR: Gemini model is not available."
        if not text or not text.strip():
            return None, "ERROR: Empty text provided for explanation."

        try:
            prompt = f"""
أنت مُعلّم جامعي خبير. اشرح النص التالي باللغة العربية الفصحى المبسّطة كأنك تشرح لطلاب فصل دراسي. لا تترجم حرفياً؛ قدّم شرحاً تعليمياً منظّماً يساعد على الفهم والتطبيق.

المتطلبات:
1) تمهيد مختصر للفكرة العامة.
2) شرح تفصيلي منظّم بعناوين فرعية، وتقسيم للأفكار.
3) أمثلة تطبيقية واقعية (٣–٥) توضّح الفكرة.
4) نقاط مُلخّصة أساسية (قائمة نقاط) تُثبّت المفاهيم.
5) مصطلحات رئيسية وتعريفات موجزة إن وُجدت.
6) أسئلة للمراجعة والتحفيز على التفكير.
7) أخطاء شائعة يجب تجنّبها إن وُجدت.
8) نصائح للتذكّر والاستذكار.

إرشادات الإخراج:
- استخدم العربية الفصحى سهلة وواضحة.
- استخدم عناوين فرعية واضحة ونقاط تعداد (بدون تنسيق برمجي).
- إذا كان النص الأصلي بغير العربية، انقله ذهنياً للشرح بالعربية دون سرد ترجمة حرفية.
- أعِد الناتج كنص عربي فقط دون أكواد أو علامات Markdown إضافية.

النص:
{text}
"""
            response = self.model.generate_content(prompt)
            if response and hasattr(response, 'text') and response.text:
                out = response.text.strip()
                # لا نزيل الشرطات لأننا نريد القوائم، فقط ننظّف الرموز البرمجية
                out = out.replace('```', '').replace('`', '')
                return out, None
            return None, "WARNING: Gemini returned empty explanation response."
        except Exception:
            return None, f"FATAL ERROR during Arabic explanation: {traceback.format_exc()}"

    def summarize_text_arabic(self, text: str, source_language: str = 'auto') -> Tuple[Optional[str], Optional[str]]:
        """Generate a concise Arabic bullet-point summary tied to the provided text with relevant examples."""
        if self.init_error:
            return None, self.init_error
        if not self.model:
            return None, "ERROR: Gemini model is not available."
        if not text or not text.strip():
            return None, "ERROR: Empty text provided for summary."

        try:
            prompt = f"""
اكتب ملخصاً بالعربية الفصحى للنص التالي، يبدأ بفقرة موجزة توضّح موضوع النص وما يدور حوله (شرح موجز دقيق)، ثم يتلوها نقاط رئيسية مُنظمة، وأبرز بعد ذلك "ملاحظات مهمة" يجب الانتباه لها، مع أمثلة موجزة ذات صلة. اجعل الناتج كله ضمن نص واحد دون تنسيقات برمجية.

المخرجات ضمن نفس النص وبالترتيب:
أولاً) فقرة موجزة تُعرّف موضوع النص وتلخّصه في 2–4 جُمل.
ثانياً) نقاط رئيسية (3–7 نقاط) قصيرة وواضحة.
ثالثاً) ملاحظات مهمة يجب الانتباه لها (1–4 نقاط) مميزة لفظياً (مثلاً: ملاحظة مهمة: ...).
رابعاً) أمثلة موجزة ذات صلة (2–3) إن أمكن.
خامساً) قائمة مصطلحات رئيسية (3–8) مع تعريف عربي موجز لكل مصطلح إن وُجدت.

تعليمات الأسلوب:
- لا تُطِل؛ كن موجزاً ودقيقاً ومباشراً.
- لا تستخدم ترقيم برمجي أو Markdown؛ استخدم نصاً عادياً مع فواصل وأسطر فقط.
- لا تُدخل معلومات غير موجودة في النص.

النص:
{text}
"""
            response = self.model.generate_content(prompt)
            if response and hasattr(response, 'text') and response.text:
                out = response.text.strip()
                out = out.replace('```', '').replace('`', '')
                return out, None
            return None, "WARNING: Gemini returned empty summary response."
        except Exception:
            return None, f"FATAL ERROR during Arabic summary: {traceback.format_exc()}"

    def summarize_text(self, text: str, target_language: str = 'ar', source_language: str = 'auto') -> Tuple[Optional[str], Optional[str]]:
        """Generate a concise bullet-point summary in the requested language.

        Defaults to Arabic; mirrors the structure used in summarize_text_arabic.
        """
        if self.init_error:
            return None, self.init_error
        if not self.model:
            return None, "ERROR: Gemini model is not available."
        if not text or not text.strip():
            return None, "ERROR: Empty text provided for summary."

        try:
            target_lang_name = self.supported_languages.get(target_language, target_language)
            prompt = f"""
Write a concise summary in {target_lang_name} for the following text. Start with a brief overview paragraph (2–4 sentences), then list key bullet points, important notes (clearly marked), short relevant examples, and a small glossary of key terms with brief definitions if applicable. Keep it compact and accurate. Return plain text only (no code blocks or markdown).

Text:
{text}
"""
            response = self.model.generate_content(prompt)
            if response and hasattr(response, 'text') and response.text:
                out = response.text.strip()
                out = out.replace('```', '').replace('`', '')
                return out, None
            return None, "WARNING: Gemini returned empty summary response."
        except Exception:
            return None, f"FATAL ERROR during summary: {traceback.format_exc()}"
    
    def translate_ui_elements(self, ui_dict: Dict[str, str], target_language: str = 'ar') -> Dict[str, str]:
        """
        Translate UI elements dictionary
        
        Args:
            ui_dict: Dictionary of UI elements {key: english_text}
            target_language: Target language code
        
        Returns:
            Dictionary with translated values
        """
        translated_dict = {}
        
        for key, english_text in ui_dict.items():
            translated_text, error = self.translate_text(english_text, target_language)
            if translated_text:
                translated_dict[key] = translated_text
            else:
                # Fallback to original text if translation fails
                translated_dict[key] = english_text
                print(f"Translation failed for '{key}': {error}")
        
        return translated_dict
    
    def batch_translate(self, texts: List[str], target_language: str = 'ar') -> List[Dict[str, str]]:
        """
        Translate multiple texts in batch
        
        Args:
            texts: List of texts to translate
            target_language: Target language code
        
        Returns:
            List of dictionaries with original and translated text
        """
        results = []
        
        for i, text in enumerate(texts):
            translated_text, error = self.translate_text(text, target_language)
            
            result = {
                'index': i,
                'original': text,
                'translated': translated_text if translated_text else text,
                'success': translated_text is not None,
                'error': error
            }
            results.append(result)
        
        return results
    
    def get_supported_languages(self) -> Dict[str, str]:
        """Get list of supported languages"""
        return self.supported_languages.copy()


# UI Translations Dictionary for Common Elements
UI_TRANSLATIONS = {
    'en': {
        'start_recording': 'Start Recording',
        'stop_recording': 'Stop Recording',
        'pause_recording': 'Pause Recording',
        'resume_recording': 'Resume Recording',
        'mark_important': 'Mark Important',
        'extract_text': 'Extract Text',
        'rerecord': 'Re-record',
        'processing': 'Processing...',
        'ready_to_record': 'Ready to Record',
        'recording': 'Recording...',
        'paused': 'Paused',
        'review_recording': 'Review your recording',
        'processing_complete': 'Processing Complete!',
        'upload_file': 'Upload a File',
        'record_audio': 'Record Audio',
        'choose_audio_file': 'Choose an audio file',
        'supported_formats': 'Supported formats: MP3, WAV, M4A',
        'microphone_permission': 'Microphone permission denied.',
        'browser_not_supported': 'Your browser does not support audio recording.',
        'quality': 'Quality',
        'language': 'Language',
        'settings': 'Settings',
        'help': 'Help',
        'about': 'About',
        'simple_mode': 'Simple Mode',
        'advanced_mode': 'Advanced Mode',
        'lecture_mode': 'Lecture Mode',
        'transcription': 'Transcription',
        'translation': 'Translation',
        'markers': 'Important Markers',
        'duration': 'Duration',
        'file_size': 'File Size',
        'audio_level': 'Audio Level',
        'error_occurred': 'An error occurred',
        'try_again': 'Try Again',
        'success': 'Success',
        'failed': 'Failed',
        'loading': 'Loading...',
        'save': 'Save',
        'cancel': 'Cancel',
        'close': 'Close',
        'download': 'Download',
        'share': 'Share',
        'copy': 'Copy',
        'paste': 'Paste',
        'clear': 'Clear',
        'reset': 'Reset'
    },
    'ar': {
        'start_recording': 'بدء التسجيل',
        'stop_recording': 'إيقاف التسجيل',
        'pause_recording': 'إيقاف مؤقت',
        'resume_recording': 'استئناف التسجيل',
        'mark_important': 'تعليم مهم',
        'extract_text': 'استخراج النص',
        'rerecord': 'إعادة تسجيل',
        'processing': 'جاري المعالجة...',
        'ready_to_record': 'جاهز للتسجيل',
        'recording': 'جاري التسجيل...',
        'paused': 'متوقف مؤقتاً',
        'review_recording': 'مراجعة التسجيل',
        'processing_complete': 'اكتملت المعالجة!',
        'upload_file': 'رفع ملف',
        'record_audio': 'تسجيل صوتي',
        'choose_audio_file': 'اختر ملف صوتي',
        'supported_formats': 'التنسيقات المدعومة: MP3, WAV, M4A',
        'microphone_permission': 'تم رفض إذن الميكروفون.',
        'browser_not_supported': 'متصفحك لا يدعم التسجيل الصوتي.',
        'quality': 'الجودة',
        'language': 'اللغة',
        'settings': 'الإعدادات',
        'help': 'المساعدة',
        'about': 'حول',
        'simple_mode': 'الوضع البسيط',
        'advanced_mode': 'الوضع المتقدم',
        'lecture_mode': 'وضع المحاضرة',
        'transcription': 'النسخ النصي',
        'translation': 'الترجمة',
        'markers': 'العلامات المهمة',
        'duration': 'المدة',
        'file_size': 'حجم الملف',
        'audio_level': 'مستوى الصوت',
        'error_occurred': 'حدث خطأ',
        'try_again': 'حاول مرة أخرى',
        'success': 'نجح',
        'failed': 'فشل',
        'loading': 'جاري التحميل...',
        'save': 'حفظ',
        'cancel': 'إلغاء',
        'close': 'إغلاق',
        'download': 'تحميل',
        'share': 'مشاركة',
        'copy': 'نسخ',
        'paste': 'لصق',
        'clear': 'مسح',
        'reset': 'إعادة تعيين'
    }
}


# Helper function to get translations
def get_translation(key: str, language: str = 'en') -> str:
    """Get translation for a specific key and language"""
    return UI_TRANSLATIONS.get(language, {}).get(key, UI_TRANSLATIONS['en'].get(key, key))


@st.cache_resource
def get_translator():
    """
    Get a singleton translator instance using Streamlit's resource caching.
    This ensures the model is initialized only once per session.
    """
    return AITranslator()