errors

type BoundaryError struct {
	// Phase is the phase where the error occurred.
	Phase string
	// Widget is the type name of the widget that failed (for build errors).
	Widget string
	// RenderObject is the type name of the render object that failed (for layout/paint/hittest errors).
	RenderObject string
	// IsLayoutIssue indicates this is a developer layout mistake, not a crash.
	IsLayoutIssue bool
	// Recovered is the panic value (nil for regular errors).
	Recovered any
	// Err is the underlying error (nil for panics).
	Err error
	// StackTrace contains the call stack at the time of the error.
	StackTrace string
	// Timestamp is when the error occurred.
	Timestamp time.Time
}

type DriftError struct {
	// Op is the operation that failed (e.g., "graphics.DefaultFontManager").
	Op string
	// Kind categorizes the error.
	Kind ErrorKind
	// Err is the underlying error.
	Err error
	// Channel is the platform channel name, if applicable.
	Channel string
	// StackTrace contains the call stack at the time of the error.
	StackTrace string
	// Timestamp is when the error occurred.
	Timestamp time.Time
}

type ErrorHandler interface {
	// HandleError is called when an error occurs.
	HandleError(err *DriftError)
	// HandlePanic is called when a panic is recovered.
	HandlePanic(err *PanicError)
	// HandleBoundaryError is called when an ErrorBoundary catches an error
	// or a panic is caught by global recovery.
	HandleBoundaryError(err *BoundaryError)
}

type ErrorKind int

type LayoutIssue struct {
	Message string
}

type LogHandler struct {
	// Verbose enables detailed output including stack traces.
	Verbose bool
}

type PanicError struct {
	// Op is the operation that panicked (e.g., "engine.HandlePointer").
	Op string
	// Value is the value passed to panic().
	Value any
	// StackTrace contains the call stack at the time of the panic.
	StackTrace string
	// Timestamp is when the panic occurred.
	Timestamp time.Time
}

type ParseError struct {
	// Channel is the platform channel that received the event.
	Channel string
	// DataType is the expected type name.
	DataType string
	// Got is the actual data received.
	Got any
}