docs(process): clarify normalized terminal row geometry

This commit is contained in:
N0zoM1z0
2026-10-10 14:37:04 +08:00
parent b118f04492
commit 44f69e655c
3 changed files with 10 additions and 8 deletions
+7 -5
View File
@@ -110,11 +110,13 @@ while comparisons and trace assertions use the normalized text. Retaining the
original adds at most `limits.output_bytes` of text, because it comes from the
same admitted PTY chunks rather than a second unbounded stream.
Rendered frame `lines` hold the visible rows after normalization, without
trailing spaces; pad a line to the frame's `columns` to restore the fixed-width
row. `serialized_state` keeps the exact terminal state. Captures commit this
line format in their comparison contract, so a capture whose lines were padded
to full width does not compare as the same contract.
Rendered frame `lines` hold the normalized visible rows with trailing U+0020
spaces removed. `columns` records the original terminal geometry. Normalization
can change text length, so restoring an earlier normalized row's padding requires
information beyond `columns`. `serialized_state` retains the normalized terminal
serialization. Captures commit this line format in their comparison contract, so
a capture whose lines were padded to full width does not compare as the same
contract.
Port normalization recognizes explicit `port`, `tcp_port`, `udp_port`, and
`listen` fields, URL authorities, IP endpoints, and `localhost` endpoints, with