output

type AuthCompleteEvent ¶ added in v0.7.0

type AuthCompleteEvent struct{}

type AuthEvent ¶ added in v0.2.0

type AuthEvent struct {
	Preamble string
	Code     string
	URL      string
}

type ContainerStatusEvent ¶

type ContainerStatusEvent struct {
	Phase     string // e.g., "pulling", "starting", "waiting", "ready"
	Container string
	Detail    string // optional extra info (e.g., container ID)
}

type DeferredEvent ¶ added in v0.13.0

type DeferredEvent struct {
	Inner Event
}

DeferredEvent wraps another event so that the TUI renders it after the interface exits rather than inline. Plain sinks format the inner event immediately.

type ErrorAction ¶ added in v0.2.0

type ErrorAction struct {
	Label string
	Value string
}

type ErrorEvent ¶ added in v0.2.0

type ErrorEvent struct {
	Title   string
	Summary string
	Detail  string
	Actions []ErrorAction
}

type Event ¶

type Event interface {
	// contains filtered or unexported methods
}

Event is a sealed marker — only event types in this package implement it, so Sink.Emit rejects unknown types at compile time.

type InputOption ¶

type InputOption struct {
	Key   string
	Label string
}

type InputResponse ¶

type InputResponse struct {
	SelectedKey string
	Cancelled   bool
}

type InstanceInfoEvent ¶ added in v0.5.0

type InstanceInfoEvent struct {
	EmulatorName  string
	Version       string
	Host          string
	ContainerName string
	Uptime        time.Duration
	Persistence   bool
}

type LogLevel ¶ added in v0.5.2

type LogLevel int

const (
	LogLevelUnknown LogLevel = iota
	LogLevelDebug
	LogLevelInfo
	LogLevelWarn
	LogLevelError
)

type LogLineEvent ¶ added in v0.4.0

type LogLineEvent struct {
	Source string
	Line   string
	Level  LogLevel
}

type MessageEvent ¶ added in v0.2.0

type MessageEvent struct {
	Severity MessageSeverity
	Text     string
}

type MessageSeverity ¶ added in v0.2.0

type MessageSeverity int

const (
	SeverityInfo      MessageSeverity = iota
	SeveritySuccess                   // positive outcome
	SeverityNote                      // informational
	SeverityWarning                   // cautionary
	SeveritySecondary                 // subdued/decorative text
)

type PlainSink ¶

type PlainSink struct {
	// contains filtered or unexported fields
}

func NewPlainSink(out io.Writer) *PlainSink

func (s *PlainSink) Emit(event Event)

func (s *PlainSink) Err() error

type PodSnapshotRemovedEvent ¶ added in v0.12.0

type PodSnapshotRemovedEvent struct {
	PodName string
}

type PodSnapshotSavedEvent ¶ added in v0.9.0

type PodSnapshotSavedEvent struct {
	PodName  string
	Version  int
	Services []string
	Size     int64
}

type ProgressEvent ¶

type ProgressEvent struct {
	Container string
	LayerID   string
	Status    string
	Current   int64
	Total     int64
}

type PullSkippableEvent ¶ added in v0.15.0

type PullSkippableEvent struct {
	Image  string
	SkipCh chan<- struct{}
}

PullSkippableEvent signals that an in-flight image pull can be abandoned in favor of an already-present local image. The domain emits it once real layer download begins (interactive mode, with a local copy present); the TUI binds ESC during the pull to send on SkipCh, which the domain selects on to cancel the pull and fall back to the local image. Never emitted in non-interactive mode, so PlainSink never needs to answer it.

type RemoteSnapshotSavedEvent ¶ added in v0.15.0

type RemoteSnapshotSavedEvent struct {
	PodName  string
	Location string
	Version  int
	Services []string
	Size     int64
}

RemoteSnapshotSavedEvent reports a snapshot saved to a remote storage backend (e.g. an S3 bucket). Location is the user-facing remote target (e.g. an s3:// URL) and PodName is the snapshot's identity within that remote.

type ResourceSummaryEvent ¶ added in v0.5.0

type ResourceSummaryEvent struct {
	Resources int
	Services  int
}

type Sender ¶

type Sender interface {
	Send(msg any)
}

Sender abstracts Bubble Tea's Program.Send to keep TUISink decoupled and testable.

type SilentError ¶ added in v0.2.0

type SilentError struct {
	Err error
}

SilentError wraps an error that has already been displayed to the user through the sink mechanism. Callers should check for this type and skip printing the error again.

func NewSilentError(err error) *SilentError

func (e *SilentError) Error() string

func (e *SilentError) Unwrap() error

type Sink ¶

type Sink interface {
	Emit(event Event)
}

type SinkFunc ¶

type SinkFunc func(event Event)

func (f SinkFunc) Emit(event Event)

type SnapshotLoadedEvent ¶ added in v0.10.0

type SnapshotLoadedEvent struct {
	Source   string   // display source shown to the user (e.g. "./snap.snapshot" or "pod:my-baseline")
	Services []string // services restored
}

type SnapshotResourceCount ¶ added in v0.13.0

type SnapshotResourceCount struct {
	Count int
	Noun  string
}

SnapshotResourceCount is a count of one resource kind, e.g. {Count: 3, Noun: "buckets"}.

type SnapshotResourceLine ¶ added in v0.13.0

type SnapshotResourceLine struct {
	Service string
	Counts  []SnapshotResourceCount
}

SnapshotResourceLine groups the resource counts of a single service.

type SnapshotShownEvent ¶ added in v0.13.0

type SnapshotShownEvent struct {
	Name              string
	Created           *time.Time
	Size              int64
	LocalStackVersion string
	Message           string
	Services          []string
	Resources         []SnapshotResourceLine
}

SnapshotShownEvent reports the metadata of a single cloud snapshot for the `snapshot show` command. Created is nil and Resources is empty when the platform has no value for them; the formatter omits those sections.

type SpinnerEvent ¶ added in v0.2.0

type SpinnerEvent struct {
	Active      bool
	Text        string
	MinDuration time.Duration // Minimum time spinner should display (0 = use default)
}

func SpinnerStart(text string) SpinnerEvent

func SpinnerStartWithDuration(text string, minDuration time.Duration) SpinnerEvent

func SpinnerStop() SpinnerEvent

type TUISink ¶

type TUISink struct {
	// contains filtered or unexported fields
}

func NewTUISink(sender Sender) *TUISink

func (s *TUISink) Emit(event Event)

type TableEvent ¶ added in v0.5.0

type TableEvent struct {
	Headers []string
	Rows    [][]string
}

type UserInputRequestEvent ¶

type UserInputRequestEvent struct {
	Prompt     string
	Options    []InputOption
	ResponseCh chan<- InputResponse
	Vertical   bool
}