TerminalSessionPanel UI component

Purpose

TerminalSessionPanel is a terminal component. Complete terminal surface. Use for command sessions with output and input.

Inputs

Field Required Type Behavior
state yes idle, running, waiting, exited, error Session state. idle shows no active process, running shows output plus stdin controls when onSubmit exists, waiting shows output plus the fixed Waiting status label, exited shows final output plus the latest system output chunk as the exit summary, and error shows terminal error state.
sessionID no string Stable host session identifier. When omitted, the host runtime resolves the active session from route or host context before calling callbacks.
command yes string Displayed command.
output yes []TerminalChunk Ordered chunks with required Stream and Text, plus optional non-negative integer Sequence. Stream is one of stdout, stderr, stdin, or system. Chunks render in supplied order unless every chunk has Sequence, in which case ascending Sequence order is used with supplied order as the stable tie-breaker. Missing Sequence is treated as unset, not zero.
onSubmit no func(TerminalSubmitEvent) gx.Result Sends stdin when state is running or waiting. The input control appears only in those two states and only when this callback is present.
onExit no func(TerminalExitEvent) gx.Result Requests external process termination through the host runtime. The exit control appears only in running and waiting states when this callback exists; it is hidden otherwise. It does not close the panel by itself. The host runtime reads session identity and applies authorization before terminating.

Boundary

The component only renders terminal state, deterministic output order, and callback entry points. Process transport, command protocols, retry behavior, and termination authorization stay in the host runtime.

Example

var sessionPanel = <TerminalSessionPanel
    state="running"
    sessionID="test-17"
    command="make test"
    onSubmit={terminalStdin}
    onExit={terminalExit}
    output={terminalOutput}>
</TerminalSessionPanel>

type TerminalChunk struct {
	Stream string
	Text string
	Sequence *int
}

type TerminalSubmitEvent struct {
	SessionID string
	SourceID string
	Text string
}

type TerminalExitEvent struct {
	SessionID string
	SourceID string
}

SourceID is the component id or generated tree path. SessionID is copied from the sessionID prop when present; otherwise the host runtime resolves the active session from route or host context before calling the callback. If no active session can be resolved, the host does not call the callback. Text is the submitted stdin value for TerminalSubmitEvent.

Runtime Terms

Callback props documents function callback props.

Expression children document ordinary Go expressions inside markup bodies.

UI framework index

Sources