Record project documentation updates

Ariver

2026-07-01 b00e64de94d7560484c8da9723761084e368ca56

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
package language
 
import (
    "testing"
 
    "voicesnap/internal/config"
    "voicesnap/internal/model"
)
 
type fakeDetector struct {
    locale string
}
 
func (f fakeDetector) Detect() string {
    return f.locale
}
 
func TestNormalizeLocale(t *testing.T) {
    tests := map[string]string{
        "zh-CN":       model.DefaultLanguageID,
        "zh_Hans_CN":  model.DefaultLanguageID,
        "en-US":       model.EnglishLanguageID,
        "en_GB.UTF-8": model.EnglishLanguageID,
        "fr-FR":       model.FrenchLanguageID,
        "de-DE":       model.GermanLanguageID,
        "es-MX":       model.SpanishLanguageID,
        "it-IT":       model.ItalianLanguageID,
        "pt-BR":       model.PortugueseLanguageID,
        "ja-JP":       model.JapaneseLanguageID,
        "ko-KR":       model.KoreanLanguageID,
        "":            model.EnglishLanguageID,
    }
    for input, want := range tests {
        if got := NormalizeLocale(input); got != want {
            t.Fatalf("NormalizeLocale(%q) = %q, want %q", input, got, want)
        }
    }
}
 
func TestResolveAutoUsesDetector(t *testing.T) {
    settings := Resolve(config.LanguageModeAuto, model.DefaultLanguageID, fakeDetector{locale: "en-US"})
    if settings.EffectiveLanguageID != model.EnglishLanguageID {
        t.Fatalf("effective language = %q, want %q", settings.EffectiveLanguageID, model.EnglishLanguageID)
    }
    if settings.UILocale != "en" {
        t.Fatalf("ui locale = %q, want en", settings.UILocale)
    }
    if settings.DefaultModelID != model.MoonshineModelID {
        t.Fatalf("default model = %q, want %q", settings.DefaultModelID, model.MoonshineModelID)
    }
}
 
func TestResolveManualIgnoresDetector(t *testing.T) {
    settings := Resolve(config.LanguageModeManual, model.DefaultLanguageID, fakeDetector{locale: "en-US"})
    if settings.EffectiveLanguageID != model.DefaultLanguageID {
        t.Fatalf("effective language = %q, want %q", settings.EffectiveLanguageID, model.DefaultLanguageID)
    }
    if settings.UILocale != "zh" {
        t.Fatalf("ui locale = %q, want zh", settings.UILocale)
    }
}
 
func TestResolveFallsBackInvalidValues(t *testing.T) {
    settings := Resolve("bad-mode", "bad-language", fakeDetector{locale: "fr-FR"})
    if settings.LanguageMode != config.LanguageModeAuto {
        t.Fatalf("mode = %q, want %q", settings.LanguageMode, config.LanguageModeAuto)
    }
    if settings.EffectiveLanguageID != model.FrenchLanguageID {
        t.Fatalf("effective language = %q, want %q", settings.EffectiveLanguageID, model.FrenchLanguageID)
    }
    if settings.DefaultModelID != model.ParakeetV3ModelID {
        t.Fatalf("default model = %q, want %q", settings.DefaultModelID, model.ParakeetV3ModelID)
    }
}
 
func TestResolveOptionsAreStable(t *testing.T) {
    settings := Resolve(config.LanguageModeAuto, model.DefaultLanguageID, fakeDetector{locale: "zh-CN"})
    if len(settings.Options) != 9 {
        t.Fatalf("options len = %d, want 9", len(settings.Options))
    }
    if settings.Options[0].ID != model.DefaultLanguageID {
        t.Fatalf("first option = %q, want %q", settings.Options[0].ID, model.DefaultLanguageID)
    }
    if settings.Options[1].ID != model.EnglishLanguageID {
        t.Fatalf("second option = %q, want %q", settings.Options[1].ID, model.EnglishLanguageID)
    }
    if settings.Options[2].ID != model.FrenchLanguageID {
        t.Fatalf("third option = %q, want %q", settings.Options[2].ID, model.FrenchLanguageID)
    }
}