Closes #13

changelog.md

@@ -6,6 +6,31 @@ existing Git tag; subsequent changes are listed as unreleased.
 
 ## Unreleased
 
+### 2026-10-11
+
+#### Added
+
+- `ParseFileWithDiagnostics` and `DbcParseResult` with severity, stable error
+  code, supplied file path, physical line number, and message for each diagnostic.
+- Warnings for unregistered statements, including floating-point signal types,
+  attributes, signal type references, environment variables, and vendor extensions.
+- Quiet common DBC header handlers registered through TypeFactory; `NS_` symbol
+  declarations do not produce unsupported-statement warnings.
+- Regression tests for warning locations, header handling, immediate/deferred
+  errors, file errors, empty results on failure, and legacy exception compatibility.
+
+#### Changed
+
+- Kept `ParseFile` compatible while sharing parsing with the diagnostic API.
+  Parsing stops at the first error and never returns a partial database.
+- Deferred value-description and multiplexing errors carry structured source
+  locations without extracting them from exception messages.
+- Documented supported syntax, warning behavior, diagnostic codes, and limitations.
+- Audited diagnostic coverage and added unsupported-statement variants, namespace
+  termination, formatting/path handling, first-error stopping, deferred diagnostic
+  order, duplicate/overlap errors, and supported decoding preservation tests.
+  Linux file-read errors and legacy file-error messages are checked explicitly.
+
 ### 2026-10-07
 
 #### Added