Update type stubs and fix test type annotations to satisfy mypy linting

Author: kevin-hua-kraken

src/rustfluent.pyi

@@ -3,13 +3,55 @@ from pathlib import Path
 
 Variable = str | int | date
 
+class ParseErrorDetail:
+    """Parse time: syntax errors in .ftl files (invalid FTL syntax, malformed messages)"""
+
+    message: str
+    line: int
+    column: int
+    byte_start: int
+    byte_end: int
+    filename: str | None
+
+class ValidationError:
+    """Load time: semantic errors during Bundle() init (unknown refs, cycles, duplicate IDs)"""
+
+    error_type: (
+        str  # DuplicateMessageId, UnknownMessage, UnknownTerm, UnknownAttribute, CyclicReference
+    )
+    message: str
+    message_id: str | None
+    reference: str | None
+
+class FormatError:
+    """Runtime: errors during get_translation() (missing variables, invalid variable types)"""
+
+    error_type: str  # MissingVariable, InvalidVariableType
+    message: str
+    message_id: str | None
+    variable_name: str | None
+    expected_type: str | None
+    actual_type: str | None
+
 class Bundle:
     def __init__(
-        self, language: str, ftl_filenames: list[str | Path], strict: bool = False
+        self,
+        language: str,
+        ftl_filenames: list[str | Path],
+        strict: bool = False,
+        validate_references: bool = True,
     ) -> None: ...
     def get_translation(
         self,
         identifier: str,
         variables: dict[str, Variable] | None = None,
         use_isolating: bool = True,
+        errors: list[FormatError] | None = None,
     ) -> str: ...
+    def get_parse_errors(self) -> list[ParseErrorDetail]: ...
+    def get_validation_errors(self) -> list[ValidationError]: ...
+    def get_all_compile_errors(
+        self,
+    ) -> list[tuple[str, ParseErrorDetail | ValidationError]]: ...
+    def get_compile_errors(self) -> list[ValidationError]: ...
+    def get_required_variables(self, identifier: str) -> list[str]: ...

tests/test_python_interface.py

@@ -844,7 +844,7 @@ def test_validate_references_false_with_duplicates():
 def test_get_translation_errors_missing_variable():
     """Test that missing variables are reported via errors parameter."""
     bundle = fluent.Bundle("en", [data_dir / "variables.ftl"])
-    errors = []
+    errors: list[fluent.FormatError] = []
 
     # Call get_translation without providing required variable
     result = bundle.get_translation("greeting", errors=errors)
@@ -864,11 +864,13 @@ def test_get_translation_errors_missing_variable():
 def test_get_translation_errors_invalid_variable_type():
     """Test that invalid variable types are reported via errors parameter."""
     bundle = fluent.Bundle("en", [data_dir / "variables.ftl"])
-    errors = []
+    errors: list[fluent.FormatError] = []
 
     # Pass a list instead of a string
     result = bundle.get_translation(
-        "greeting", variables={"name": ["not", "a", "string"]}, errors=errors
+        "greeting",
+        variables={"name": ["not", "a", "string"]},  # type: ignore[dict-item]
+        errors=errors,
     )
 
     # Result should use fallback (the variable key itself)
@@ -887,7 +889,7 @@ def test_get_translation_errors_invalid_variable_type():
 def test_get_translation_errors_multiple_missing_variables():
     """Test that multiple missing variables are all reported."""
     bundle = fluent.Bundle("en", [data_dir / "variables.ftl"])
-    errors = []
+    errors: list[fluent.FormatError] = []
 
     # user-info needs both $username and $count
     result = bundle.get_translation("user-info", errors=errors)
@@ -906,7 +908,7 @@ def test_get_translation_errors_multiple_missing_variables():
 def test_get_translation_errors_partial_variables():
     """Test errors when only some variables are provided."""
     bundle = fluent.Bundle("en", [data_dir / "variables.ftl"])
-    errors = []
+    errors: list[fluent.FormatError] = []
 
     # Provide only username, not count
     result = bundle.get_translation("user-info", variables={"username": "Alice"}, errors=errors)
@@ -932,7 +934,7 @@ def test_get_translation_errors_none_parameter():
 def test_get_translation_errors_with_attributes():
     """Test error collection with message attributes."""
     bundle = fluent.Bundle("en", [data_dir / "variables.ftl"])
-    errors = []
+    errors: list[fluent.FormatError] = []
 
     # email-template.subject needs $recipient
     result = bundle.get_translation("email-template.subject", errors=errors)