Files
Shuery 8a0924330a feat(tui): 控制台列宽表(第一轮第一块)
整个 TUI 的地基:位置、对齐、边框都靠它。而它算错了**不会报错** —— 表现只是菜单右边框歪一点、光标偏一列,所以每条边界都在断言里钉住。

为什么必须自己算:.Length 是 UTF-16 code unit 的个数(汉字 1 个 char、2 列);而 $Host.UI.RawUI.LengthInBufferCells 在 PowerShell 7 上对、在 5.1 上错(实测 中文 返回 2、字体边框字符 返回 6),且不抛错 —— 这种"一边对一边错"的 API 比两边都错更危险。

表里三个边界是实测踩过的:半角片假名 U+FF61–FF9F 是 1 列(不能划进全角区);全角拉丁 U+FF00–FF60 是 2 列;emoji 是代理对,按一个码点算。

验收:断言 8 条(含空串与控制字符);test.ps1 9/9 全绿(5.1 与 7)。
2026-09-27 15:31:26 +08:00

56 lines
3.0 KiB
PowerShell

param([Parameter(Mandatory=$true)][string]$OutFile)
$lines = New-Object System.Collections.Generic.List[string]
function L($s) { $lines.Add($s) }
function MK([int[]]$cp) { -join ($cp | ForEach-Object { [char]$_ }) }
$raw = $Host.UI.RawUI
$cases = @(
,@('8 ASCII ', 'A1b2C3d4')
,@('2 CJK ', (MK @(0x4E2D, 0x6587)))
,@('4 CJK ', (MK @(0x4E2D, 0x6587, 0x5907, 0x4EFD)))
,@('3 boxdraw ', (MK @(0x250C, 0x2500, 0x2510)))
,@('1 emoji ', [char]::ConvertFromUtf32(0x1F600))
,@('2 fullwidth', (MK @(0xFF21, 0xFF22)))
,@('2 halfkata ', (MK @(0xFF71, 0xFF72)))
,@('CJK+colon ', (MK @(0x4E2D, 0x6587, 0xFF1A, 0x0020)) + 'X')
,@('punctuation', (MK @(0x3002, 0x3001, 0xFF0C)))
,@('hangul ', (MK @(0xD55C, 0xAE00)))
,@('kana ', (MK @(0x3042, 0x3044)))
,@('cyrillic ', (MK @(0x0416, 0x0418)))
,@('accented ', (MK @(0x00E9, 0x00E8)))
,@('tabs+ctrl ', "a`tb")
)
L ("PSVersion: " + $PSVersionTable.PSVersion + " PSEdition: " + $PSVersionTable.PSEdition)
L ("IsOutputRedirected: " + [Console]::IsOutputRedirected)
L ""
L "### `$Host.UI.RawUI.LengthInBufferCells() -- BUILT-IN cell-width API ###"
L (" method present? " + [bool]($raw | Get-Member -Name LengthInBufferCells -MemberType Method))
$mi = $raw | Get-Member -Name LengthInBufferCells -MemberType Method
if ($mi) { foreach ($d in $mi) { L (" overload: " + $d.Definition) } }
L ""
L " {0,-12} {1,8} {2,14} {3,10}" -f 'case', '.Length', 'LengthInBuffer', 'expected~'
foreach ($c in $cases) {
$nm = $c[0]; $s = [string]$c[1]
$w = 'n/a'
try { $w = $raw.LengthInBufferCells($s) } catch { $w = 'THREW: ' + $_.Exception.Message }
L (" {0,-12} {1,8} {2,14} {3,10}" -f $nm, $s.Length, $w, '')
}
L ""
L "### per-character version: LengthInBufferCells(char, offset) ###"
foreach ($c in $cases) {
$nm = $c[0]; $s = [string]$c[1]
$sum = 0; $eb = ''
foreach ($ch in $s.ToCharArray()) {
try { $u = $raw.LengthInBufferCells($ch); $eb += $u } catch { $eb += '?'; $sum = -999 }
}
L (" {0,-12} sum(char overload)={1} perchar={2}" -f $nm, $sum, $eb)
}
L ""
L "### Other RawUI helpers that exist in BOTH hosts ###"
L (" NewBufferCellArray overloads: " + (((($raw | Get-Member -Name NewBufferCellArray -MemberType Method).Definition) -join ' | ')))
L (" SetBufferContents overloads : " + (((($raw | Get-Member -Name SetBufferContents -MemberType Method).Definition) -join ' | ')))
L (" GetBufferContents overloads : " + (((($raw | Get-Member -Name GetBufferContents -MemberType Method).Definition) -join ' | ')))
L (" ScrollBufferContents overloads: " + (((($raw | Get-Member -Name ScrollBufferContents -MemberType Method).Definition) -join ' | ')))
L (" ReadKey overloads : " + (((($raw | Get-Member -Name ReadKey -MemberType Method).Definition) -join ' | ')))
L (" FlushInputBuffer overloads : " + (((($raw | Get-Member -Name FlushInputBuffer -MemberType Method).Definition) -join ' | ')))
[System.IO.File]::WriteAllLines($OutFile, $lines, (New-Object System.Text.UTF8Encoding($false)))