Files
Netcatty/components/terminal/terminalReflowReadingPosition.ts
T
6c05f0b450 fix(terminal): re-anchor reading position to content across fit reflow (#3319)
* fix(#3299): automated AI fix

* fix: address Codex review on PR #3319

* fix: address Codex review on PR #3319

* fix: address Codex review on PR #3319

* fix: address Codex review on PR #3319

* fix: address Codex review on PR #3319

* fix: address Codex review on PR #3319

* fix: address Codex review on PR #3319

* fix: address Codex review on PR #3319

* fix: address Codex review on PR #3319

* fix: address Codex review on PR #3319

* fix: address Codex review on PR #3319

* fix: address Codex review on PR #3319

* fix: address Codex review on PR #3319

* fix: address Codex review on PR #3319

* fix: address Codex review on PR #3319

* fix: address Codex review on PR #3319

* fix: address Codex review on PR #3319

* fix: address Codex review on PR #3319

* fix: address Codex review on PR #3319

* fix: address Codex review on PR #3319

* fix: address Codex review on PR #3319

* fix: address Codex review on PR #3319

* fix: address Codex review on PR #3319

* fix: address Codex review on PR #3319

* fix: address Codex review on PR #3319

* fix: address Codex review on PR #3319

* fix: address Codex review on PR #3319

* fix: address Codex review on PR #3319

* fix: address Codex review on PR #3319

* fix: address Codex review on PR #3319

* fix: address Codex review on PR #3319

* fix: address Codex review on PR #3319

* fix: address Codex review on PR #3319

* fix: address Codex review on PR #3319

* fix: address Codex review on PR #3319

* fix(terminal): retain reading offset throughout resize drags

* fix(terminal): retain reflow offset beside cursor output

---------

Co-authored-by: netcatty-bot <308658023+netcatty-bot@users.noreply.github.com>
Co-authored-by: bincxz <16399091+binaricat@users.noreply.github.com>
2026-09-12 11:11:07 +08:00

52 lines
2.4 KiB
TypeScript

import { captureTerminalReflowScrollAnchor } from './terminalHelpers';
import type { TerminalReflowScrollAnchor } from './terminalHelpers';
type Buffer = Parameters<typeof captureTerminalReflowScrollAnchor>[0];
/** Keep the character within the top row across consecutive resize frames. */
export function createTerminalReflowReadingPosition() {
let previous: {
buffer: Buffer;
viewportY: number;
anchor: TerminalReflowScrollAnchor;
remainder: number;
} | null = null;
return {
capture(buffer: Buffer, limits: Parameters<typeof captureTerminalReflowScrollAnchor>[1]) {
const anchor = captureTerminalReflowScrollAnchor(buffer, limits);
const saved = previous;
previous = null;
if (!anchor || anchor.containsCursor) return anchor;
// A user scroll or changed output establishes a new reading position.
if (saved?.buffer === buffer && saved.viewportY === buffer.viewportY
&& saved.anchor.startRow === anchor.startRow
&& saved.anchor.charOffset === anchor.charOffset
&& saved.anchor.textPrefix === anchor.textPrefix
&& saved.anchor.viewedText === anchor.viewedText
&& saved.anchor.contextSuffix === anchor.contextSuffix) {
anchor.charOffset += saved.remainder;
anchor.viewedText = anchor.viewedText?.slice(saved.remainder);
}
return anchor;
},
// The caller passes null unless content resolution succeeded. A cursor
// follower may change during resize; the resolver already validates that
// tolerance. Save its new identity for the next pre-fit comparison.
remember(buffer: Buffer, anchor: TerminalReflowScrollAnchor | null) {
previous = null;
if (!anchor || anchor.containsCursor) return;
const current = captureTerminalReflowScrollAnchor(buffer, {
maxRows: Number.MAX_SAFE_INTEGER, oldCols: 1, newCols: 1,
});
// Trim, clamping and failed content resolution must not carry a stale
// offset into the next frame. Only retain the sub-row rounding loss.
if (!current || current.containsCursor || current.textPrefix !== anchor.textPrefix) return;
const remainder = anchor.charOffset - current.charOffset;
const rowLength = buffer.getLine(buffer.viewportY)?.translateToString(false).length ?? 0;
if (remainder < 0 || remainder >= rowLength) return;
previous = { buffer, viewportY: buffer.viewportY, anchor: current, remainder };
},
};
}