TextInputRenderer

Single-line text input with horizontal scrolling and a fake cursor. The TUI analog of pi-tui's `Input` component. This renderer is **pure**: it paints whatever `value`/`cursor`/`placeholder` the node's props carry. Owning that state across frames (and dispatching backspace, arrows, letter keys to mutate them) is the caller's job — the `RetainedTuiLoop` root factory, a live component, or whatever builds the `TuiNode` tree each tick. That mirrors every other renderer in this namespace: pure node-in/frame-out, no hidden state, no keyboard handler inside the renderer. The cursor is a visible block cell so it survives retained composition and plain output. A zero-width {@see FocusableInterface::CURSOR_MARKER} remains immediately before it for hardware-cursor/IME positioning. Node props (all optional): - `value` string Current text. Default: ''. - `cursor` int Cursor column (offset into value, in visible cells). Default: strlen(value). - `placeholder` string Shown when value is empty. Default: ''. - `secret` bool Mask each visible cell with `*`. Default: false. - `prompt` string Prefix before the input (e.g. '> ' or '$ '). Default: ''. - `focused` bool Override focus state (otherwise read from context). Default: context.focused().

public function supports(Milpa\Live\ValueObjects\Tui\TuiNode $node): bool

True only for `text-input` nodes — dispatch is by declared node type, never by where the node came from.

Parameters

public function render(Milpa\Live\ValueObjects\Tui\TuiNode $node, Milpa\Live\ValueObjects\Tui\TuiRenderContext $context): Milpa\Live\ValueObjects\Tui\TuiFrame

Draws the visible window of the value with the fake caret, scrolling horizontally when the value is wider than the bounds.

Parameters

public function hasCaret(string $output): bool

Whether the rendered output carries the caret marker, i.e. whether this input is the node holding the caret.

Parameters

public function caretPosition(string $output): ?array

The row and column of the caret within the rendered output, or null when the output does not carry the marker.

Parameters