severity

const (
	// SeverityError indicates a spec violation that makes the document invalid.
	// Used primarily by the validator package for structural/semantic errors.
	SeverityError Severity = iota

	// SeverityWarning indicates lossy conversions, best-practice violations,
	// or recommendations that don't prevent processing but should be addressed.
	SeverityWarning

	// SeverityInfo indicates informational messages about processing choices.
	// These are non-actionable notices that may be useful for debugging.
	SeverityInfo

	// SeverityCritical indicates features that cannot be processed without data loss.
	// Used when conversion or generation must skip or alter functionality.
	SeverityCritical
)