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 BackendEntry struct {
	Backend Backend
	// Config overrides the logger-level backend config. When nil, the logger's
	// configuration is used.
	Config *BackendConfig
}

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 {

	// 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 import path package when caller
	// tracking is enabled (for example: example.com/project/subsystem).
	// Loggee computes this field from the call stack and ignores caller input.
	Package string
	// File contains the base filename of the call site.
	// Loggee computes this field from the call stack and ignores caller input.
	File string
	// Line contains the source line number of the call site.
	// Loggee computes this field from the call stack and ignores caller input.
	Line int
	// Meta holds arbitrary key/value pairs to attach to the entry payload.
	Meta map[string]any
	// contains filtered or unexported fields
}

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.
	// Wrapper layers should call LogWithOffset to add their own frame depth
	// and keep package/file/line metadata accurate.
	CallerSkip int
	// Backend controls the optional fields each backend should emit.
	Backend BackendConfig
	// Gate sets the minimum severity index accepted by the logger (applied to
	// all attached backends). Defaults to zero (no filtering).
	Gate uint
}

type LoggerDefinition struct {
	Config LoggerConfig
	// Backends is kept for backward compatibility and applies the logger-level
	// backend configuration to every backend listed here.
	Backends []Backend
	// BackendEntries allow specifying backend-specific configurations.
	BackendEntries []BackendEntry
}

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
}