Merge branch 'voice-language-support-table-row-per-variant' into 'main'

docs(voice): One row per variant in Voice Language Support table

See merge request deepl-org/deepl/clapi-track/api-docs-mirror!258

Author: Patrick Schlarmann

docs/voice/supported-voice-languages.mdx

@@ -12,15 +12,18 @@ Translation is always provided by DeepL. For some languages, transcription and t
 | Arabic | ⎋ | ✓ | ⎋ |
 | Bengali | ⎋ | ✓ | — |
 | Bulgarian | ⎋ | ✓ | ⎋ |
-| Chinese (Simplified/Traditional) | ✓ | ✓ | ✓ |
+| Chinese (simplified) | ✓ | ✓ | ✓ |
+| Chinese (traditional) | ✓ | ✓ | ✓ |
 | Croatian | ⎋ | ✓ | ⎋ |
 | Czech | ✓ | ✓ | ⎋ |
 | Danish | ⎋ | ✓ | ⎋ |
 | Dutch | ✓ | ✓ | ✓ |
-| English (American/British) | ✓ | ✓ | ✓ |
+| English (American) | ✓ | ✓ | ✓ |
+| English (British) | ✓ | ✓ | ✓ |
 | Estonian | ⎋ | ✓ | — |
 | Finnish | ⎋ | ✓ | ⎋ |
-| French (France/Canada <Badge color="blue">beta</Badge>) | ✓ | ✓ | ✓/⎋ |
+| French | ✓ | ✓ | ✓ |
+| French (Canadian) <Badge color="blue">beta</Badge> | ✓ | ✓ | ⎋ |
 | German | ✓ | ✓ | ✓ |
 | Greek | ⎋ | ✓ | ⎋ |
 | Hebrew | ⎋ | ✓ | — |
@@ -37,7 +40,8 @@ Translation is always provided by DeepL. For some languages, transcription and t
 | Maltese | ⎋ | ✓ | — |
 | Norwegian (bokmål) | ⎋ | ✓ | ⎋ |
 | Polish | ✓ | ✓ | ✓ |
-| Portuguese (Brazil/Portugal) | ✓ | ✓ | ✓ |
+| Portuguese (Brazilian) | ✓ | ✓ | ✓ |
+| Portuguese (European) | ✓ | ✓ | ✓ |
 | Romanian | ✓ | ✓ | ⎋ |
 | Russian | ✓ | ✓ | ✓ |
 | Slovak | ⎋ | ✓ | ⎋ |

scripts/generate-voice-languages.mjs

@@ -8,14 +8,6 @@
 import { fileURLToPath } from 'node:url';
 import { byCode, byName, fetchLanguages, parseArgs, replaceBlock } from './lib.mjs';
 
-// The matrix folds target-only variants into their base language's row.
-const MATRIX_NAME_OVERRIDES = {
-  en: 'English (American/British)',
-  fr: 'French (France/Canada <Badge color="blue">beta</Badge>)',
-  pt: 'Portuguese (Brazil/Portugal)',
-  zh: 'Chinese (Simplified/Traditional)',
-};
-
 // feature values are objects like { status, external? }; presence means the
 // capability exists, external: true means an external partner provides it
 export const mark = (feature) => (feature ? (feature.external ? '⎋' : '✓') : '—');
@@ -25,19 +17,28 @@ export async function update({ authKey, dryRun = false }) {
   const sources = languages.filter((l) => l.usable_as_source);
   const targets = languages.filter((l) => l.usable_as_target);
 
-  // The matrix only shows source languages (variants fold into the base row),
-  // so a target-only language without a source base would silently vanish.
-  const sourceBases = new Set(sources.map((l) => l.lang.split('-')[0]));
-  for (const t of targets.filter((t) => !sourceBases.has(t.lang.split('-')[0]))) {
-    console.warn(`voice target ${t.lang} has no source base language and is missing from the matrix`);
-  }
+  const languagesByCode = new Map(languages.map((language) => [language.lang, language]));
 
-  const rows = sources
-    .map((l) => ({ ...l, name: MATRIX_NAME_OVERRIDES[l.lang] ?? l.name }))
+  const rows = languages
+    // Skip the row for a base language if variants are available
+    .filter((l) => l.lang.includes('-') || !languages.some((f) => f.lang.startsWith(`${l.lang}-`)))
     .sort(byName)
     .map((l) => {
+      const isVariant = l.lang.includes('-');
+      const baseCode = l.lang.split('-')[0];
+      const base = languagesByCode.get(baseCode);
+
+      if (isVariant && !base) {
+        console.warn(`voice variant ${l.lang} has no base language (${baseCode})`);
+      }
+
+      // Transcription for variants is determined by base language, if it exists
+      const transcription = isVariant
+        ? (base?.features?.transcription ?? l.features.transcription)
+        : l.features.transcription;
       const name = l.status !== 'stable' ? `${l.name} <Badge color="blue">beta</Badge>` : l.name;
-      return `| ${name} | ${mark(l.features.transcription)} | ✓ | ${mark(l.features.translated_speech)} |`;
+
+      return `| ${name} | ${mark(transcription)} | ✓ | ${mark(l.features.translated_speech)} |`;
     });
   const matrix = [
     '| **Language** | **Transcription** | **Translation** | **Translated Speech** |',