log

type Backend interface {
	// Write emits the entry and returns any backend specific error.
	Write(entry *Entry) error
	// NotifyAboutSender allows a backend to adjust formatting/alignment.
	NotifyAboutSender(sender string)
	// NotifyAboutSeverity allows the backend to precalculate severity spacing.
	NotifyAboutSeverity(severity *Severity)
	// Shutdown releases backend resources.
	Shutdown()
	// SetGate configures the minimum severity accepted by the backend.
	SetGate(gate uint)
	// Configure applies backend-wide feature flags.
	Configure(cfg BackendConfig)
}

type BackendConfig struct {
	IncludeTimestamp bool
	IncludePackage   bool
	IncludeFile      bool
	IncludeLine      bool
}

type CallerInfo struct {
	Package string
	File    string
	Line    int
}

type CommonBackend struct {
	// Gate is the minimum severity index the backend will emit.
	Gate uint
	// Config stores the currently applied backend configuration.
	Config BackendConfig
	// contains filtered or unexported fields
}

type Entry struct {
	// Time captures when the event occurred. Backends may fill it in when zero.
	Time time.Time
	// Severity references the severity metadata for the event.
	Severity *Severity
	// Message is the human readable text payload.
	Message string
	// Sender identifies the logical component or subsystem.
	Sender string
	// Package contains the originating Go package when caller tracking is enabled.
	Package string
	// File contains the base filename of the call site.
	File string
	// Line contains the source line number of the call site.
	Line int
	// CustomData contains backend specific key-value pairs to include.
	CustomData map[string]any
}

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

type LoggerConfig struct {
	// Name identifies the logger when building multiple instances.
	Name string
	// QueueSize controls the channel buffer length used to serialize writes.
	// When zero, a reasonable default buffer of 64 entries is used.
	QueueSize int
	// CallerSkip controls how many stack frames to skip before resolving
	// caller information. Zero uses the default internal offset.
	CallerSkip int
	// Backend controls the optional fields each backend should emit.
	Backend BackendConfig
}

type LoggerDefinition struct {
	Config   LoggerConfig
	Backends []Backend
}

type LoggingSystemConfig struct {
	Loggers []LoggerDefinition
}

type Severity struct {
	// Representation is the printable textual label (e.g. "INFO").
	Representation string
	// Index orders severities for comparisons and gating.
	Index uint
	// Fatal indicates that logging at this level should panic after writing.
	Fatal bool
}

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