ketraterm-session/io.github.ketraterm.session/TerminalShellCommandLineState

TerminalShellCommandLineState

class TerminalShellCommandLineState @JvmOverloads constructor(initialValue: TerminalShellCommandLineSnapshot? = null)

Host-owned authoritative command-line projection for conditional editing. Every assignment advances a revision, including equal values and transitions through null. Publish null while the host cannot trust its editing state, including host-managed pending input. Publishing a snapshot does not acknowledge remote processing of session writes; that remains the host shell model's concern.

Assignments serialize with session edit checks and queue reservation. Publish only after the corresponding terminal output has been delivered; never deliver terminal output from inside a projection read. This object owns no coroutine scope and remains host-owned after session closure.

Constructors

@JvmOverloads

constructor(initialValue: TerminalShellCommandLineSnapshot? = null)

Properties

value

var value: TerminalShellCommandLineSnapshot?

Current snapshot, or null when editing is unavailable. Each assignment is a new revision. Throws IllegalStateException without changing the snapshot if the revision counter is exhausted.