Fix pronouncation

Author: gavinhenderson

scripts/generate-tts/README.md

@@ -15,7 +15,9 @@ cd scripts/generate-tts
 npm run voices          # list available macOS voices
 npm run generate        # generate WAV files into sd-card/
 npm run generate -- --voice Alex --rate 170
-npm run generate -- --force   # regenerate existing files
+npm run generate -- --force   # regenerate existing files (needed after voice/TTS fixes)
 ```
 
+Single letters and digits use macOS `[[char U+....]]` notation so `say` pronounces "A" instead of "Capital A". Optional per-entry `"speak"` in the manifest overrides that text.
+
 Copy the generated `sd-card/` folder contents to the root of a FAT32 microSD card, then insert the card into the CoreS3.

scripts/generate-tts/generate.js

@@ -43,10 +43,29 @@ function usageToFilename(usageHex) {
   return `u${value.toString(16).padStart(3, "0")}.wav`;
 }
 
-function runSay(label, voice, rate, aiffPath) {
+/** Text passed to macOS `say` (avoids e.g. "Capital A" for label "A"). */
+function speakTextForEntry(entry) {
+  if (entry.speak) {
+    return entry.speak;
+  }
+  const { label } = entry;
+  if (label.length === 1) {
+    const code = label.toUpperCase().charCodeAt(0);
+    if (
+      (code >= 0x41 && code <= 0x5a) ||
+      (code >= 0x30 && code <= 0x39)
+    ) {
+      return `[[char U+${code.toString(16).padStart(4, "0").toUpperCase()}]]`;
+    }
+  }
+  return label;
+}
+
+function runSay(entry, voice, rate, aiffPath) {
+  const text = speakTextForEntry(entry);
   spawnSync(
     "say",
-    ["-v", voice, "-r", String(rate), "-o", aiffPath, label],
+    ["-v", voice, "-r", String(rate), "-o", aiffPath, text],
     { stdio: "inherit" }
   );
 }
@@ -95,7 +114,7 @@ function main() {
 
     const aiffPath = path.join(tmpDir, `${filename}.aiff`);
     console.log(`Generating ${entry.label} -> ${filename}`);
-    runSay(entry.label, args.voice, args.rate, aiffPath);
+    runSay(entry, args.voice, args.rate, aiffPath);
     convertToWav(aiffPath, wavPath);
     fs.unlinkSync(aiffPath);
     created += 1;