This commit is contained in:
LZX committed 2026-09-16 11:58:58 +08:00
1 parent b5328277ab
commit 1ab5d52449
89 files changed
+14197 -65

No files matched your search

+110
View File
@@ -0,0 +1,110 @@
// 守护测试:验证内置(vendored)xterm 的 IndexAwareCircularBuffer.trimStart() 补丁。
//
// 上游 4.0.0 的 trimStart() 只调整 _startIndex/_length,导致:
// ① 存活行 index 偏移“被裁掉的行数” → CellAnchor.offset 错位、选区画不出、复制为空;
// ② 被裁掉的行从不 _detach → 僵尸锚点(attached 仍为 true,静默指向别的行)。
// 触发链:shell 的 clear / Ctrl+L → ESC[3J → Buffer.clearScrollback() → trimStart()。
//
// 若将来升级 xterm 后本文件失败,说明补丁丢失(或上游改动了实现),
// 处理方式见 packages/xterm/PATCHES.md。
import 'package:flutter_test/flutter_test.dart';
import 'package:xterm/xterm.dart' as xterm;
/// 核心不变量:列表中第 i 行的 `index` 必须等于 i(`CellAnchor.y` 依赖它当行号用)。
void expectIndexInvariant(xterm.Terminal terminal) {
final buffer = terminal.buffer;
for (var i = 0; i < buffer.height; i++) {
expect(
buffer.lines[i].index,
i,
reason: '第 $i 行的 index 与行号不一致 —— trimStart 补丁失效',
);
}
}
/// 当前可见视口(不含回滚缓冲)的文本快照。
String visibleText(xterm.Terminal terminal) {
final buffer = terminal.buffer;
final scrollBack = buffer.scrollBack;
final builder = StringBuffer();
for (var i = 0; i < buffer.viewHeight; i++) {
builder.writeln(buffer.lines[scrollBack + i].getText().trimRight());
}
return builder.toString();
}
xterm.Terminal buildFilledTerminal() {
final terminal = xterm.Terminal(maxLines: 30);
terminal.resize(80, 10);
for (var i = 0; i < 40; i++) {
terminal.write('L$i\r\n');
}
return terminal;
}
void main() {
group('vendored xterm trimStart 补丁守护测试', () {
test('push 溢出裁剪(maxLines 上限)保持行索引不变式', () {
final terminal = buildFilledTerminal();
// 溢出裁剪由 push 完成,本身维持不变式,作为对照组
expect(terminal.buffer.height, 30);
expect(terminal.buffer.scrollBack, greaterThan(0));
expectIndexInvariant(terminal);
});
test('ESC[3J 清空回滚缓冲后行索引归一、可见画面保留', () {
final terminal = buildFilledTerminal();
final heightBefore = terminal.buffer.height;
final visibleBefore = visibleText(terminal);
terminal.write('\x1b[3J');
expect(terminal.buffer.height, lessThan(heightBefore));
expect(terminal.buffer.height, terminal.buffer.viewHeight);
expect(terminal.buffer.scrollBack, 0);
// 补丁前:lines[0].index == 20(被裁掉的行数)
expectIndexInvariant(terminal);
expect(visibleText(terminal), visibleBefore, reason: '清除回滚不得改动可见画面');
});
test('被裁掉行上的锚点被正确失效,存活行上的锚点重新对齐', () {
final terminal = buildFilledTerminal();
final buffer = terminal.buffer;
final droppedAnchor = buffer.createAnchorFromOffset(const xterm.CellOffset(0, 0));
final survivingAnchor =
buffer.createAnchorFromOffset(xterm.CellOffset(0, buffer.height - 1));
expect(droppedAnchor.attached, isTrue);
expect(survivingAnchor.attached, isTrue);
terminal.write('\x1b[3J');
// ① 被裁掉的行走 _dropChild -> detach,旧锚点不再“僵尸”存活
expect(droppedAnchor.attached, isFalse, reason: '被裁掉的行必须被 detach');
// ② 存活下来的行索引重新对齐到新行号
expect(survivingAnchor.attached, isTrue);
expect(survivingAnchor.offset.y, buffer.height - 1);
expect(survivingAnchor.line, same(buffer.lines[buffer.height - 1]));
});
test('清空回滚缓冲后新建选区落在可见行范围内且能读出文本', () {
final terminal = buildFilledTerminal();
// 真实 clear 命令序列(xterm-256color 带 E3 能力)
terminal.write('\x1b[H\x1b[2J\x1b[3J');
terminal.write('\x1b[31mERROR\x1b[0m hello world\r\nsecond line\r\n');
expectIndexInvariant(terminal);
final begin = terminal.buffer.createAnchorFromOffset(const xterm.CellOffset(0, 0));
final end = terminal.buffer.createAnchorFromOffset(const xterm.CellOffset(5, 0));
expect(begin.offset.y, 0);
expect(end.offset.y, 0);
expect(begin.offset.y, lessThan(terminal.buffer.height));
final range = xterm.BufferRangeLine(begin.offset, end.offset).normalized;
expect(terminal.buffer.getText(range), 'ERROR');
});
});
}