Diagnostics

[sebmck]

Diagnostics are an extremely powerful feature of Rome that allow the generic construction and presentation of errors in source code.

• Types can be found in packages/@romejs/diagnostics/types.ts.
• Diagnostics can take two forms. The PartialDiagnostic type, which has a lot of optional properties and allows building up diagnostics in a more raw manner. The Diagnostic type has required properties that during normalization from PartialDiagnostic are inferred if necessary. This format is what is exposed to consumers and formatting logic.
• The package @romejs/diagnostics contains the type definitions, normalization logic, and other utilities.
• The package @romejs/cli-diagnostics contains the terminal formatting logic.