Files
LN-Code-Editor/test/xterm_trim_start_patch_test.dart
2026-09-16 11:58:58 +08:00

111 lines
4.5 KiB
Dart
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
// 守护测试:验证内置(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');
});
});
}