refactor: unify Language enum across all layers

- EngineConfig.language: Language (was lang_code: str = 'a')
- Engine owns _KOKORO_LANG_MAP, engine_language(), supported_languages()
- Engine provides language_for_voice_id() for voice catalog
- Plugins/kokoro/__init__.py calls engine_language() internally
- create_pipeline(plugin_id, language=Language) — no kokoro codes
- pipeline_factory.py clean of kokoro-specific code
- Domain functions raise TypeError if non-enum passed
- WebUI api.py: _parse_language() helper at API boundary
- Voice catalog returns ISO codes (lang.value)
- Constants: LANGUAGE_DESCRIPTIONS keyed by Language enum
- All tests updated for Language enum
- 1414 tests pass

plugins/kokoro/__init__.py

@@ -165,6 +165,7 @@ def create_engine(
     """
     try:
         KPipeline = _load_kpipeline()
+        from plugins.kokoro.engine import engine_language
 
         # Determine repo_id from model_path or use default
         repo_id = "hexgrad/Kokoro-82M"
@@ -172,8 +173,9 @@ def create_engine(
             # If a specific model path is provided, use it as repo_id
             repo_id = str(model_path)
 
+        kokoro_code = engine_language(config.language)
         pipeline = KPipeline(
-            lang_code=config.lang_code,
+            lang_code=kokoro_code,
             repo_id=repo_id,
             device=config.device,
         )

plugins/kokoro/engine.py

@@ -2,6 +2,10 @@
 
 This module adapts the existing Kokoro backend to the new Engine/EngineSession
 protocol. It wraps the KokoroBackend without modifying it.
+
+Language mapping: this is the engine's responsibility. The engine knows
+which languages it supports and converts Language enum → internal format.
+Callers outside this module never see engine-specific codes.
 """
 
 from __future__ import annotations
@@ -11,6 +15,7 @@ from typing import Any
 
 import numpy as np
 
+from abogen.domain.enums import Language
 from abogen.tts_plugin.capabilities import VoiceLister
 from abogen.tts_plugin.engine import Engine, EngineSession
 from abogen.tts_plugin.errors import EngineError
@@ -27,6 +32,59 @@ logger = logging.getLogger(__name__)
 # Sample rate for Kokoro audio
 _KOKORO_SAMPLE_RATE = 24000
 
+# Engine-internal language mapping: Language enum → kokoro code.
+# ONLY visible inside this module — callers never see kokoro codes.
+_KOKORO_LANG_MAP: dict[Language, str] = {
+    Language.EN_US: "a",
+    Language.EN_GB: "b",
+    Language.ES: "e",
+    Language.FR: "f",
+    Language.HI: "h",
+    Language.IT: "i",
+    Language.JA: "j",
+    Language.PT_BR: "p",
+    Language.ZH: "z",
+}
+
+# Reverse mapping: engine-internal code → Language enum.
+# Used by voice catalog and other places that need to convert
+# engine codes back to Language enum (e.g. voice ID prefix extraction).
+_CODE_TO_LANGUAGE: dict[str, Language] = {v: k for k, v in _KOKORO_LANG_MAP.items()}
+
+
+def supported_languages() -> list[Language]:
+    """Return the list of Language enum values this engine supports.
+
+    This is the engine's responsibility — the engine knows which
+    languages it supports and exposes them as Language enum values.
+    UI layers query this to populate language selectors.
+    """
+    return list(_KOKORO_LANG_MAP.keys())
+
+
+def engine_language(lang: Language) -> str:
+    """Map a Language enum to the engine's internal code.
+
+    This is the engine's responsibility — the engine owns the mapping
+    between Language enum and its internal format. Callers pass Language
+    enum; the engine converts internally. The returned string is ONLY
+    used inside the engine implementation.
+    """
+    return _KOKORO_LANG_MAP.get(lang, "a")
+
+
+def language_for_voice_id(voice_id: str) -> Language:
+    """Determine which Language a voice belongs to from its voice ID.
+
+    Kokoro voice IDs encode language as a prefix (e.g. "af_heart" → "a" → EN_US).
+    This is kokoro-specific knowledge that stays inside the engine.
+    Callers pass a voice ID string; the engine returns a Language enum.
+    """
+    prefix = str(voice_id or "").strip()[:1].lower()
+    if prefix in _CODE_TO_LANGUAGE:
+        return _CODE_TO_LANGUAGE[prefix]
+    return Language.EN_US
+
 
 class KokoroSession:
     """EngineSession implementation for Kokoro.