output

type BuildSummary struct {
	Total     int           // Total number of targets
	Succeeded int           // Number that succeeded
	Failed    int           // Number that failed
	Skipped   int           // Number that were skipped
	Duration  time.Duration // Total build duration
}

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

type Color string

type ColorConfig struct {
	Enabled bool
}

type ColorLevel int

type CommandCompleted struct {
	Target   string        // Target being built
	Command  string        // Command that was executed
	ExitCode int           // Exit code (0 = success)
	Duration time.Duration // How long the command took
}

type CommandOutput struct {
	Target string // Target being built
	Stdout string // Standard output
	Stderr string // Standard error
}

type CommandStarted struct {
	Target  string // Target being built
	Command string // Command line being executed
}

type DryRunCommand struct {
	Target  string // Target this command belongs to
	Command string // Command that would be executed
}

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

type DryRunTarget struct {
	Target string // Target that would be built
	Index  int    // 1-based index
	Total  int    // Total targets
}

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

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

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

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

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

type ErrorOccurred struct {
	Category string // "parse", "semantic", "eval", "plan", "execute"
	Code     string // "E001", "E200", etc.
	Message  string // Error message
	Location string // "Buildfile:10:5" or empty
	Context  string // Source code snippet or empty
	Hint     string // Fix suggestion or empty
}

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

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

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

type OutputMode int

type OutputWriter interface {
	// WriteEvent renders an output event to the output stream.
	WriteEvent(event OutputEvent)

	// Flush ensures all buffered output is written.
	Flush()
}

type PhaseCompleted struct {
	Phase     string        // "parse", "semantic", "eval", "plan", "execute"
	Timestamp time.Time     // When the phase completed
	Duration  time.Duration // How long the phase took
}

type PhaseStarted struct {
	Phase     string    // "parse", "semantic", "eval", "plan", "execute"
	Timestamp time.Time // When the phase started
}

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

type Reporter interface {
	// BuildStarted is called when a target build begins.
	BuildStarted(target string)

	// BuildCompleted is called when a target build finishes.
	// success indicates whether the build succeeded.
	// errMsg contains the error message if success is false.
	BuildCompleted(target string, success bool, errMsg string)

	// CommandOutput is called to display command output.
	// stdout and stderr contain the respective output streams.
	CommandOutput(command, stdout, stderr string)

	// Summary is called at the end to show build summary.
	// total is the number of targets built, failed is the number that failed.
	Summary(total, failed int)

	// NothingToBuild is called when a target is already up to date.
	NothingToBuild(target string)
}

type StalenessChecked struct {
	Target string // Target being checked
	Reason string // "src/main.c is newer", "target missing", etc.
	Action string // "rebuild", "skip"
}

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

type TargetCompleted struct {
	Target   string        // Target path or name
	Success  bool          // Whether the build succeeded
	Duration time.Duration // How long the build took
	Error    string        // Error message if Success is false
}

type TargetSkipped struct {
	Target string // Target path or name
	Reason string // "up to date", "already built", etc.
}

type TargetStarted struct {
	Target string // Target path or name
	Index  int    // 1-based index for progress (e.g., 3 of 10)
	Total  int    // Total number of targets
}

type TerminalCapabilities struct {
	Width       int        // Terminal width in columns (0 if unknown)
	Height      int        // Terminal height in rows (0 if unknown)
	ColorLevel  ColorLevel // Supported color level
	Unicode     bool       // Unicode support
	Interactive bool       // Is an interactive terminal
}

type VariableEvaluated struct {
	Name   string // Variable name
	Expr   string // Original expression (if function call, empty for simple values)
	Result string // Evaluated value
}

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

type WriterConfig struct {
	// Verbose enables detailed output (variable evaluation, staleness checks)
	Verbose bool

	// Quiet suppresses non-error output
	Quiet bool

	// Color controls color output: "auto", "always", "never"
	Color string

	// Unicode controls Unicode symbol output: "auto", "always", "never"
	// When disabled, ASCII-only symbols are used.
	Unicode string

	// LogLevel sets minimum log level for headless mode: "debug", "info", "warn", "error"
	LogLevel string

	// LogFormat sets log format for headless mode: "text", "json"
	LogFormat string
}