tui

type HealthProgressOptions struct {
	Context        context.Context
	Title          string
	ShowTiming     bool
	SuccessMessage string
}

type InputValidator func(string) error

type Item struct {
	Key    string
	Label  string
	Cancel bool
}

type StatusProgressItem struct {
	Key  string
	Name string
	Kind string
}

type StatusProgressStatus struct {
	Exists  bool
	Ready   bool
	Status  string
	Message string
}

type TaskProgress func(TaskProgressEvent)

type TaskProgressEvent struct {
	// Type is the lifecycle transition or message update being reported.
	Type TaskProgressEventType

	// Key identifies the item this event updates.
	Key string

	// Name can set or replace the item label when the event creates an item not
	// present in the initial item list.
	Name string

	// Message is an optional user-facing detail rendered next to the item.
	Message string

	// Err is displayed for failed items.
	Err error
}

type TaskProgressEventType string

type TaskProgressItem struct {
	// Key is the stable identifier used by events to update this row.
	Key string

	// Name is the user-facing row label shown in the progress UI.
	Name string

	// Exclude removes this item from the progress UI entirely. Excluded items do
	// not render and do not contribute to the overall expected-time bar.
	Exclude bool

	// Success is the message shown when this item completes successfully and the
	// completion event does not provide a more specific message.
	Success string

	// Expected is the usual duration for this task. It is used only to set user
	// expectations; it is not treated as actual work completion.
	Expected time.Duration

	// Timeout is the maximum wait duration for this task when the caller has one.
	// It is displayed as a hint after Expected is exceeded.
	Timeout time.Duration
}