KetraTerm
API · DevelopmentAll versions

text

fun text(associatedText: String, modifiers: Int = TerminalModifiers.NONE, type: TerminalKeyEventType = TerminalKeyEventType.PRESS): TerminalKeyEvent

Creates a committed text event with no known physical key identity.

In legacy and Kitty text modes, press/repeat emits the validated text as UTF-8 without reapplying modifiers; release emits nothing. Kitty report-all mode requires associated-text reporting to encode this event, otherwise it is suppressed. This event is not a paste and does not receive bracketed-paste framing.

Return

a normalized text-only key event.

Parameters

associatedText

text produced by the host or IME.

modifiers

active keyboard modifiers.

type

physical lifecycle phase reported by the host.