feat: complete culture-aware localization

Author: SysAdminDoc

CHANGELOG.md

@@ -1,5 +1,7 @@
 # Changelog
 
+- Added: the UI now selects the Windows display language by default, resolves static, runtime, tray, dialog, and automation-accessible text through invariant resource keys with English fallback, and formats displayed values with the selected culture. A `-Culture` override and expanded/accented `qps-ploc` pseudo-locale exercise localization without requiring a translated build.
+- Changed: alert severity is explicit data instead of an English-text classifier, and the 200% high-contrast smoke lane now drives pseudo-localized navigation, validation alerts, reflow, and visible-control geometry.
 - Added: a headless `list`, `get`, `set`, `profile`, and `diagnostics` command line runs without WPF, targets stable monitor identities, supports human text or a schema-v1 JSON envelope, and terminates a hung native worker at a documented timeout.
 - Added: CLI writes share capability validation, per-identity risky-write unlocks, verified readback, and rollback with the GUI; set-if-needed, relative delta, comma-list cycling, and terse percentage-brightness/input aliases cover one-shot automation without prompts.
 - Added: profile deletion now stores the exact profile and its removed application/schedule rules in bounded local Trash; the Profiles tab can restore the newest deletion across restarts or permanently empty Trash through a separate confirmation.

MonitorControlPro.ps1

@@ -31,6 +31,7 @@ param(
     [string]$Theme = "System",
     [ValidateRange(0, 200)]
     [int]$TextScalePercent = 0,
+    [string]$Culture = "",
     [string]$RenderDirectory = ""
 )
 

README.md

@@ -61,6 +61,7 @@ A comprehensive Windows GUI utility for controlling monitor settings via DDC/CI
 - **Capability Caching and a Known-Bad Model List** — A successful capability read is cached against the monitor's stable identity and replayed on later launches, so the riskiest native call runs once per monitor rather than on every refresh. Monitor models documented upstream as faulting the Windows kernel during that call are skipped before any probe and reported in diagnostics
 - **Stable Monitor Identity** — Prefers the Windows DisplayManager device-interface path and raw EDID, with the existing EDID/device-path lookup as a guarded fallback. Existing labels, profile targets, safety unlocks, capability state, timing, and brightness restore settings migrate automatically, while custom labels and saved profiles continue to follow a display after reordering
 - **System-Aware Accessibility** — Follows Windows high contrast live across the main window, the tray popup, and the identify and FPS overlays, supports 100–200% text scaling with independently scrollable content and navigation, exposes visible keyboard focus and UI Automation names, and raises native live-region events for inline errors
+- **Culture-Aware UI** — Uses the Windows display language by default with invariant resource keys and English fallback across the window, dialogs, tray, runtime status, and accessibility text. The `-Culture <name>` launch option overrides selection; `-Culture qps-ploc` enables the expanded pseudo-locale used by the 200% DPI regression lane
 - **Portable Release ZIP** — Local release builds package the script, icon, README, LICENSE, signature status, and SHA256 checksums
 - **Verified Risky Writes** — Power, input, reset, color preset, OSD lock, OSD language, auxiliary power, PiP/PbP, and arbitrary commands require a per-monitor identity unlock plus an exact code/value confirmation. The confirmation names the specific consequence for that code, and readback reports verified, mismatched, or unavailable outcomes
 - **Async Capabilities Reads** — Monitor `vcp(...)` capabilities load from a background worker after enumeration, keeping refresh responsive

src/MonitorControl.App.ps1

@@ -103,6 +103,7 @@ function Get-CliChildArguments {
         [string]$Value,
         [long]$Delta,
         [string]$Cycle,
+        [string]$Culture,
         [switch]$IfNeeded,
         [switch]$Json,
         [switch]$AllowRisky,
@@ -117,7 +118,8 @@ function Get-CliChildArguments {
         [PSCustomObject]@{ Name = "-Monitor"; Value = $Monitor },
         [PSCustomObject]@{ Name = "-Vcp"; Value = $Vcp },
         [PSCustomObject]@{ Name = "-Value"; Value = $Value },
-        [PSCustomObject]@{ Name = "-Cycle"; Value = $Cycle }
+        [PSCustomObject]@{ Name = "-Cycle"; Value = $Cycle },
+        [PSCustomObject]@{ Name = "-Culture"; Value = $Culture }
     )) {
         if (-not [string]::IsNullOrWhiteSpace([string]$pair.Value)) {
             $arguments.Add([string]$pair.Name)
@@ -146,6 +148,7 @@ function Invoke-CliChildProcess {
         [string]$Value,
         [long]$Delta,
         [string]$Cycle,
+        [string]$Culture,
         [switch]$IfNeeded,
         [switch]$Json,
         [switch]$AllowRisky,
@@ -162,7 +165,7 @@ function Invoke-CliChildProcess {
     try {
         $startInfo = New-Object System.Diagnostics.ProcessStartInfo
         $startInfo.FileName = [System.Diagnostics.Process]::GetCurrentProcess().MainModule.FileName
-        $startInfo.Arguments = Get-CliChildArguments -EntryPath $EntryPath -Command $Command -Argument $Argument -Monitor $Monitor -Vcp $Vcp -Value $Value -Delta $Delta -Cycle $Cycle -IfNeeded:$IfNeeded -Json:$Json -AllowRisky:$AllowRisky -TimeoutSeconds $TimeoutSeconds
+        $startInfo.Arguments = Get-CliChildArguments -EntryPath $EntryPath -Command $Command -Argument $Argument -Monitor $Monitor -Vcp $Vcp -Value $Value -Delta $Delta -Cycle $Cycle -Culture $Culture -IfNeeded:$IfNeeded -Json:$Json -AllowRisky:$AllowRisky -TimeoutSeconds $TimeoutSeconds
         $startInfo.UseShellExecute = $false
         $startInfo.CreateNoWindow = $true
         $startInfo.RedirectStandardOutput = $true
@@ -600,6 +603,6 @@ function Invoke-MonitorControlCli {
 }
 
 if (-not [string]::IsNullOrWhiteSpace([string]$Command) -and -not $CliWorker) {
-    $cliExitCode = Invoke-CliChildProcess -EntryPath ([string]$script:MonitorControlEntryPath) -Command $Command -Argument $Argument -Monitor $Monitor -Vcp $Vcp -Value $Value -Delta $Delta -Cycle $Cycle -IfNeeded:$IfNeeded -Json:$Json -AllowRisky:$AllowRisky -TimeoutSeconds $TimeoutSeconds
+    $cliExitCode = Invoke-CliChildProcess -EntryPath ([string]$script:MonitorControlEntryPath) -Command $Command -Argument $Argument -Monitor $Monitor -Vcp $Vcp -Value $Value -Delta $Delta -Cycle $Cycle -Culture $Culture -IfNeeded:$IfNeeded -Json:$Json -AllowRisky:$AllowRisky -TimeoutSeconds $TimeoutSeconds
     exit $cliExitCode
 }

src/MonitorControl.Cli.psm1

@@ -89,16 +89,72 @@ function Get-SystemTextScalePercent {
     }
 }
 
-function Get-StatusMessageSeverity {
-    param([string]$Message)
-    if ([string]::IsNullOrWhiteSpace($Message)) { return "Info" }
-    if ($Message -match '(?i)\b(fail(?:ed|ure)?|error|invalid|denied|blocked|offline|corrupt|mismatch(?:ed)?|newer than|not found|unavailable|could not|no (?:DDC/CI )?(?:write )?target)\b') {
-        return "Error"
+function Resolve-StatusSeverity {
+    param([string]$Severity)
+    if ($Severity -in @("Info", "Warning", "Error")) { return $Severity }
+    return "Info"
+}
+
+function Resolve-UiCultureName {
+    param([string]$RequestedCulture = "", [string]$WindowsCulture = "")
+    $candidate = if (-not [string]::IsNullOrWhiteSpace($RequestedCulture)) {
+        $RequestedCulture.Trim()
+    } elseif (-not [string]::IsNullOrWhiteSpace($WindowsCulture)) {
+        $WindowsCulture.Trim()
+    } else {
+        [System.Globalization.CultureInfo]::CurrentUICulture.Name
     }
-    if ($Message -match '(?i)\b(warn(?:ing)?|cancel(?:ed|led)?|busy|waiting|unsupported|stale|retry(?:ing)?|disabled|partly|partial(?:ly)?)\b') {
-        return "Warning"
+    if ($candidate -eq "qps-ploc") { return $candidate }
+    try { return [System.Globalization.CultureInfo]::GetCultureInfo($candidate).Name } catch {
+        throw "Unknown UI culture '$candidate'."
+    }
+}
+
+function Get-UiCultureInfo {
+    param([string]$CultureName = "")
+    $name = if ([string]::IsNullOrWhiteSpace($CultureName)) { [string]$script:UiCulture } else { $CultureName }
+    if ($name -eq "qps-ploc") { return [System.Globalization.CultureInfo]::GetCultureInfo("en-US") }
+    try { return [System.Globalization.CultureInfo]::GetCultureInfo($name) } catch {
+        return [System.Globalization.CultureInfo]::GetCultureInfo("en-US")
+    }
+}
+
+function ConvertTo-PseudoLocalizedText {
+    param([AllowEmptyString()][string]$Text)
+    if ([string]::IsNullOrEmpty($Text) -or $Text.StartsWith("[!!", [System.StringComparison]::Ordinal)) { return $Text }
+    if ($Text -cmatch "^[A-Z]{1,3}$") { return $Text }
+    if ($Text -notmatch '[A-Za-z]') { return $Text }
+    $upperCodePoints = @(0x00C0,0x0181,0x00C7,0x00D0,0x00CB,0x0191,0x011C,0x0124,0x00CF,0x0134,0x0136,0x013B,0x1E40,0x00D1,0x00D6,0x01A4,0x024A,0x0154,0x0160,0x0162,0x00DC,0x1E7C,0x0174,0x1E8C,0x0178,0x017D)
+    $lowerCodePoints = @(0x00E0,0x0180,0x00E7,0x010F,0x00EB,0x0192,0x011D,0x0125,0x00EF,0x0135,0x0137,0x013C,0x1E41,0x00F1,0x00F6,0x01A5,0x024B,0x0155,0x0161,0x0163,0x00FC,0x1E7D,0x0175,0x1E8D,0x00FF,0x017E)
+    $builder = New-Object System.Text.StringBuilder
+    $insideFormatItem = $false
+    foreach ($character in $Text.ToCharArray()) {
+        if ($character -eq '{') { $insideFormatItem = $true }
+        $characterCode = [int]$character
+        if (-not $insideFormatItem -and $characterCode -ge 65 -and $characterCode -le 90) {
+            [void]$builder.Append([char]$upperCodePoints[$characterCode - 65])
+        } elseif (-not $insideFormatItem -and $characterCode -ge 97 -and $characterCode -le 122) {
+            [void]$builder.Append([char]$lowerCodePoints[$characterCode - 97])
+        } else {
+            [void]$builder.Append($character)
+        }
+        if ($character -eq '}') { $insideFormatItem = $false }
+    }
+    $paddingLength = [Math]::Max(2, [int][Math]::Ceiling($Text.Length * 0.3))
+    return "[!! $($builder.ToString()) $('~' * $paddingLength) !!]"
+}
+
+function Get-UiResourceKey {
+    param([string]$Category, [string]$DefaultText)
+    $sha = $null
+    try {
+        $sha = [System.Security.Cryptography.SHA256]::Create()
+        $bytes = [System.Text.Encoding]::UTF8.GetBytes("$Category`n$DefaultText")
+        $hash = (($sha.ComputeHash($bytes) | ForEach-Object { $_.ToString("x2") }) -join "").Substring(0, 16)
+        return "$Category.$hash"
+    } finally {
+        if ($null -ne $sha) { $sha.Dispose() }
     }
-    return "Info"
 }
 
 function Get-NavigationShortcutTarget {
@@ -116,9 +172,43 @@ function Get-NavigationShortcutTarget {
 }
 
 function Get-UiString {
-    param([string]$Key)
-    if ($script:UiStrings.ContainsKey($Key)) { return [string]$script:UiStrings[$Key] }
-    return $Key
+    param([string]$Key, [object[]]$ArgumentList = @())
+    $text = $Key
+    if ($null -ne $script:UiCultureResources -and $script:UiCultureResources.ContainsKey([string]$script:UiCulture)) {
+        $cultureTable = $script:UiCultureResources[[string]$script:UiCulture]
+        if ($null -ne $cultureTable -and $cultureTable.ContainsKey($Key)) { $text = [string]$cultureTable[$Key] }
+    }
+    if ($text -eq $Key -and $null -ne $script:UiCultureResources -and $script:UiCultureResources.ContainsKey("en-US")) {
+        $englishTable = $script:UiCultureResources["en-US"]
+        if ($null -ne $englishTable -and $englishTable.ContainsKey($Key)) { $text = [string]$englishTable[$Key] }
+    }
+    if ([string]$script:UiCulture -eq "qps-ploc") { $text = ConvertTo-PseudoLocalizedText -Text $text }
+    if (@($ArgumentList).Count -gt 0) {
+        return [string]::Format((Get-UiCultureInfo), $text, $ArgumentList)
+    }
+    return $text
+}
+
+function Get-UiRuntimeText {
+    param([string]$Category, [string]$DefaultText, [string]$Key = "", [object[]]$ArgumentList = @())
+    $resourceKey = if ([string]::IsNullOrWhiteSpace($Key)) { Get-UiResourceKey -Category $Category -DefaultText $DefaultText } else { $Key }
+    if ($null -eq $script:UiCultureResources) { $script:UiCultureResources = @{} }
+    if (-not $script:UiCultureResources.ContainsKey("en-US")) { $script:UiCultureResources["en-US"] = @{} }
+    if (-not $script:UiCultureResources["en-US"].ContainsKey($resourceKey)) {
+        $script:UiCultureResources["en-US"][$resourceKey] = $DefaultText
+    }
+    return Get-UiString -Key $resourceKey -ArgumentList $ArgumentList
+}
+
+function Format-UiNumber {
+    param($Value, [string]$Format = "G")
+    if ($Value -is [System.IFormattable]) { return $Value.ToString($Format, (Get-UiCultureInfo)) }
+    return [string]$Value
+}
+
+function Format-UiDateTime {
+    param([DateTime]$Value, [string]$Format = "g")
+    return $Value.ToString($Format, (Get-UiCultureInfo))
 }
 
 function Get-CapabilityProbeDecision {

src/MonitorControl.Core.psm1

@@ -1097,7 +1097,7 @@ function Get-Monitors {
     }
     Sync-DisplayRecoveryInventory
     if ($script:DdcAvailabilityDiagnosis -and [string]$script:DdcAvailabilityDiagnosis.Severity -ne "None") {
-        Update-Status ([string]$script:DdcAvailabilityDiagnosis.Headline)
+        Update-Status ([string]$script:DdcAvailabilityDiagnosis.Headline) -Severity ([string]$script:DdcAvailabilityDiagnosis.Severity) -Key "Status.DdcAvailability"
     }
     } finally {
         if (-not [MonitorAPI]::ResumeVCPWrites()) {