Toml (#5115)

# Description of Changes

<!--
Please provide a summary of the changes, including:

- What was changed
- Why the change was made
- Any challenges encountered

Closes #(issue_number)
-->

---

## Checklist

### General

- [ ] I have read the [Contribution
Guidelines](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/CONTRIBUTING.md)
- [ ] I have read the [Stirling-PDF Developer
Guide](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/DeveloperGuide.md)
(if applicable)
- [ ] I have read the [How to add new languages to
Stirling-PDF](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/HowToAddNewLanguage.md)
(if applicable)
- [ ] I have performed a self-review of my own code
- [ ] My changes generate no new warnings

### Documentation

- [ ] I have updated relevant docs on [Stirling-PDF's doc
repo](https://github.com/Stirling-Tools/Stirling-Tools.github.io/blob/main/docs/)
(if functionality has heavily changed)
- [ ] I have read the section [Add New Translation
Tags](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/HowToAddNewLanguage.md#add-new-translation-tags)
(for new translation tags only)

### Translations (if applicable)

- [ ] I ran
[`scripts/counter_translation.py`](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/docs/counter_translation.md)

### UI Changes (if applicable)

- [ ] Screenshots or videos demonstrating the UI changes are attached
(e.g., as comments or direct attachments in the PR)

### Testing (if applicable)

- [ ] I have tested my changes locally. Refer to the [Testing
Guide](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/DeveloperGuide.md#6-testing)
for more details.

scripts/translations/compact_translator.py

@@ -2,41 +2,37 @@
 """
 Compact Translation Extractor for Character-Limited AI Translation
 Outputs untranslated entries in minimal JSON format with whitespace stripped.
+TOML format only.
 """
 
 import json
 import sys
 from pathlib import Path
 import argparse
-try:
-    import tomllib  # Python 3.11+
-except ImportError:
-    try:
-        import toml as tomllib_fallback
-        tomllib = None
-    except ImportError:
-        tomllib = None
-        tomllib_fallback = None
+import tomllib  # Python 3.11+ (stdlib)
 
 
 class CompactTranslationExtractor:
     def __init__(self, locales_dir: str = "frontend/public/locales", ignore_file: str = "scripts/ignore_translation.toml"):
         self.locales_dir = Path(locales_dir)
-        self.golden_truth_file = self.locales_dir / "en-GB" / "translation.json"
-        self.golden_truth = self._load_json(self.golden_truth_file)
+        self.golden_truth_file = self.locales_dir / "en-GB" / "translation.toml"
+        if not self.golden_truth_file.exists():
+            print(f"Error: en-GB translation file not found at {self.golden_truth_file}", file=sys.stderr)
+            sys.exit(1)
+        self.golden_truth = self._load_translation_file(self.golden_truth_file)
         self.ignore_file = Path(ignore_file)
         self.ignore_patterns = self._load_ignore_patterns()
 
-    def _load_json(self, file_path: Path) -> dict:
-        """Load JSON file with error handling."""
+    def _load_translation_file(self, file_path: Path) -> dict:
+        """Load TOML translation file."""
         try:
-            with open(file_path, 'r', encoding='utf-8') as f:
-                return json.load(f)
+            with open(file_path, 'rb') as f:
+                return tomllib.load(f)
         except FileNotFoundError:
             print(f"Error: File not found: {file_path}", file=sys.stderr)
             sys.exit(1)
-        except json.JSONDecodeError as e:
-            print(f"Error: Invalid JSON in {file_path}: {e}", file=sys.stderr)
+        except Exception as e:
+            print(f"Error: Invalid TOML file {file_path}: {e}", file=sys.stderr)
             sys.exit(1)
 
     def _load_ignore_patterns(self) -> dict:
@@ -45,40 +41,13 @@ class CompactTranslationExtractor:
             return {}
 
         try:
-            if tomllib:
-                with open(self.ignore_file, 'rb') as f:
-                    ignore_data = tomllib.load(f)
-            elif tomllib_fallback:
-                ignore_data = tomllib_fallback.load(self.ignore_file)
-            else:
-                ignore_data = self._parse_simple_toml()
-
+            with open(self.ignore_file, 'rb') as f:
+                ignore_data = tomllib.load(f)
             return {lang: set(data.get('ignore', [])) for lang, data in ignore_data.items()}
         except Exception as e:
             print(f"Warning: Could not load ignore file {self.ignore_file}: {e}", file=sys.stderr)
             return {}
 
-    def _parse_simple_toml(self) -> dict:
-        """Simple TOML parser for ignore patterns (fallback)."""
-        ignore_data = {}
-        current_section = None
-
-        with open(self.ignore_file, 'r', encoding='utf-8') as f:
-            for line in f:
-                line = line.strip()
-                if not line or line.startswith('#'):
-                    continue
-
-                if line.startswith('[') and line.endswith(']'):
-                    current_section = line[1:-1]
-                    ignore_data[current_section] = {'ignore': []}
-                elif line.strip().startswith("'") and current_section:
-                    item = line.strip().strip("',")
-                    if item:
-                        ignore_data[current_section]['ignore'].append(item)
-
-        return ignore_data
-
     def _flatten_dict(self, d: dict, parent_key: str = '', separator: str = '.') -> dict:
         """Flatten nested dictionary into dot-notation keys."""
         items = []
@@ -92,13 +61,14 @@ class CompactTranslationExtractor:
 
     def get_untranslated_entries(self, language: str) -> dict:
         """Get all untranslated entries for a language in compact format."""
-        target_file = self.locales_dir / language / "translation.json"
+        lang_dir = self.locales_dir / language
+        target_file = lang_dir / "translation.toml"
 
         if not target_file.exists():
             print(f"Error: Translation file not found for language: {language}", file=sys.stderr)
             sys.exit(1)
 
-        target_data = self._load_json(target_file)
+        target_data = self._load_translation_file(target_file)
         golden_flat = self._flatten_dict(self.golden_truth)
         target_flat = self._flatten_dict(target_data)
 
@@ -145,7 +115,9 @@ class CompactTranslationExtractor:
 
 
 def main():
-    parser = argparse.ArgumentParser(description='Extract untranslated entries in compact format for AI translation')
+    parser = argparse.ArgumentParser(
+        description='Extract untranslated entries in compact format for AI translation (TOML format only)'
+    )
     parser.add_argument('language', help='Language code (e.g., de-DE, fr-FR)')
     parser.add_argument('--locales-dir', default='frontend/public/locales', help='Path to locales directory')
     parser.add_argument('--ignore-file', default='scripts/ignore_translation.toml', help='Path to ignore patterns file')