ITerminalReflowProvider

Namespace: Hex1b.Reflow

Assembly: Hex1b.dll

Opt-in interface that presentation adapters can implement to provide terminal-emulator-specific reflow behavior during resize operations.

public interface ITerminalReflowProvider

Properties

ReflowEnabled

Gets whether reflow is enabled. When false, the terminal uses standard crop-and-extend resize behavior even though the adapter implements this interface. Defaults to true.

Returns: Boolean

bool ReflowEnabled { get; }

ShouldClearSoftWrapOnAbsolutePosition

Gets whether absolute cursor positioning (CUP, HVP) should clear the flag on the current row's last cell.

Returns: Boolean

bool ShouldClearSoftWrapOnAbsolutePosition { get; }

Methods

Reflow(ReflowContext)

Performs reflow of terminal content during a resize operation.

Parameters:

• context (ReflowContext): The current terminal state including screen buffer, scrollback, and cursor position.

Returns: ReflowResult

The reflowed terminal state with new buffer, scrollback, and cursor position.

ReflowResult Reflow(ReflowContext context)

Remarks

When resizes, it checks if its presentation adapter implements this interface. If so, it calls with the current buffer state and applies the returned result. If the adapter does not implement this interface, the terminal falls back to simple crop-and-extend behavior.

Different terminal emulators (xterm, kitty, alacritty) handle reflow differently. The adapter controls the reflow algorithm — is fully decoupled from how reflow works.

Pre-built strategies are available for adapters to delegate to.