feat(docs): validate owner structured translations

2026-08-24 01:15:30 +02:00
parent 562d278f60
commit d2e491348d
7 changed files with 98 additions and 8 deletions
@@ -12,6 +12,7 @@ from govoplan_core.core.modules import (
    ModuleManifest,
    localized_documentation_metadata,
    user_workflow_scope_condition_issues,
+    with_documentation_structured_translations,
 )
 from govoplan_core.core.registry import PlatformRegistry, RegistryError

@@ -136,6 +137,45 @@ class DocumentationTopicContractTests(unittest.TestCase):
        with self.assertRaisesRegex(RegistryError, "preserve list length"):
            registry_for(incomplete_shape).validate()

+    def test_manifest_helper_merges_and_validates_owner_translations(self) -> None:
+        topic = DocumentationTopic(
+            id="example.workflow.localized",
+            title="Run task",
+            summary="Run the task.",
+            metadata={"steps": ["Review", "Execute"]},
+        )
+        manifest = ModuleManifest(
+            id="example",
+            name="Example",
+            version="1.0.0",
+            documentation=(topic,),
+        )
+
+        localized = with_documentation_structured_translations(
+            manifest,
+            locale="de",
+            translations={
+                topic.id: {"steps": ["Prüfen", "Ausführen"]},
+            },
+        )
+
+        self.assertEqual(
+            ["Prüfen", "Ausführen"],
+            localized.documentation[0].structured_translations["de"]["steps"],
+        )
+        with self.assertRaisesRegex(ValueError, "unknown topic ids"):
+            with_documentation_structured_translations(
+                manifest,
+                locale="de",
+                translations={"missing.topic": {"steps": ["Prüfen", "Ausführen"]}},
+            )
+        with self.assertRaisesRegex(ValueError, "preserve list length"):
+            with_documentation_structured_translations(
+                manifest,
+                locale="de",
+                translations={topic.id: {"steps": ["Prüfen"]}},
+            )
+
    def test_documentation_configuration_and_source_extensions_are_validated(self) -> None:
        resolver = lambda _context, keys: {  # noqa: E731
            key: DocumentationConfigurationDecision(key=key, state="enabled")