# Changelog

This changelog summarizes release and development history. Entries are listed
newest first. Historical dates follow the commit author dates. `v1.0` is the
existing Git tag; subsequent changes are listed as unreleased.

## Unreleased

### 2026-10-07

#### Added

- Basic `M` / `mN` multiplexing metadata in parsed, tree, and runtime definitions.
- Deferred selector and overlap validation with source locations: one unsigned
  selector, representable branch values, and overlaps only between exclusive branches.
- Selector-first decoding using exact raw values, preserving definition order and
  unconditional signals. Explicit statuses distinguish inactive branches, missing
  selector data, insufficient payloads, and malformed runtime metadata.
- Registered `SG_MUL_VAL_` rejection through TypeFactory; extended and nested
  multiplexing remain unsupported. Added parser/decoder regression coverage and
  documented supported syntax and consumer behavior.

#### Changed

- Overlapping unconditional signals are now rejected during parsing.

### 2026-10-06

#### Added

- Added non-owning TreeNode parent navigation and stable sibling positions;
  disabled node moves to preserve links while retaining unique_ptr ownership.
- Added optional read-only Qt Core DbcTreeModel with documented columns and
  metadata roles, exact VAL_ entries, exclusive tree ownership, and reset-based
  reload/clear support. Core remains independent of Qt.
- Added QAbstractItemModelTester coverage, navigation/metadata/reset tests,
  a standalone Qt-free tree test, and adapter build and usage documentation.

- Added `VAL_` signal value descriptions through the statement dispatcher and
  factory, with complete syntax validation, exact signed/unsigned 64-bit keys,
  deferred reference resolution, duplicate detection, and source error locations.
  Distinct keys from multiple statements merge; standard and extended frames
  remain distinct under existing CAN ID normalization.
- Preserved descriptions in parsed metadata, runtime decode definitions, and UI
  tree metadata. Added `DecodedSignalValue::GetValueDescription()` and
  `FindValueDescription()` for raw integer lookup before physical scaling.
  Unknown values retain normal numeric decoding.
- Added regression coverage for syntax, quoting, whitespace, integer boundaries,
  declaration order, invalid references, duplicates, scaling, and both builders;
  documented syntax, lookup behavior, and limitations in README.

### 2026-10-05

#### Changed

- Split the qmake project into a reusable static library in `core/`, a demo in
  `examples/`, and a combined regression test executable in `tests/`. Added
  shared `.pri` files and updated build instructions. (`f17ddb6`, #11)
- Added `.clang-format` and applied consistent formatting to the source code
  and tests. (`b91cf4a`, #7)
- Replaced lambdas with explicit functions and simpler code in statement
  handlers, the decoder, the demo, and regression tests. (`03dc8f2`)

#### Fixed

- Added complete validation of `SG_` signal statements, including syntax,
  receivers, numeric fields, lengths of 1–64 bits, physical ranges, and signal
  bounds within the declared frame payload for Intel and Motorola bit order.
  Invalid definitions report the file path and line number. Multiplexing
  markers are explicitly rejected. Added regression tests and documentation.
  (`8d82b13`, #6)

#### Documentation and maintenance

- Regenerated Doxygen documentation after code changes and the project
  restructuring. (`6cd9976`, `0067cb4`, `f17ddb6`)
- Removed the temporary signal-validation issue document. (`1163277`)

### 2026-10-01

#### Changed

- Moved DBC statement parsing into `TypeFactory`-registered handlers for
  `BO_`, `SG_`, and `CM_`, with a shared parse context and keyword dispatcher.
  Added tests for dispatch and handler replacement, and documented how to
  register additional handlers. (`88b5883`, #4)
- **API change:** `DecodedSignalValue::rawValue` now uses
  `std::variant<std::int64_t, std::uint64_t>` instead of `int64_t`. Consumers
  must handle the appropriate variant alternative. Physical values remain
  `double` and may lose precision for large integers. (`69074e3`, #2)

#### Fixed

- Corrected Motorola signal extraction within bytes and across byte
  boundaries using DBC sawtooth bit numbering. Added decoder regression
  tests and build instructions; introduced the `TypeFactory` utility.
  (`2c057b6`)
- Preserved the full unsigned 64-bit raw-value range, including values above
  `INT64_MAX`, and updated physical conversion and demo output. Added tests
  for signed and unsigned boundaries and numeric output. (`69074e3`, #2)
- Validated `BO_` frame syntax, CAN identifiers, payload lengths, numeric
  overflow, and unexpected trailing fields. Parsing errors now include the
  file path and physical line number. Added parser regression tests.
  (`3bd9339`, #3)

## v1.0 — 2026-06-14

Tag `v1.0` points to `38ce043` and includes the initial implementation below.

### Documentation

- Added source-file headers with author information and MIT license
  references. (`e2ffa97`)
- Added and subsequently simplified the Doxygen configuration.
  (`e2c07dd`, `4c8af9f`)
- Generated API documentation and refreshed the generated documentation.
  (`dfec39d`, `38ce043`)

### Initial implementation — 2026-03-13

#### Added

- Initialized the repository with a README and MIT license. (`4270459`)
- Added the DBC parser, frame and signal metadata, a tree representation and
  builder, a demonstration program, and a qmake project. (`2a90b2d`)
- Added runtime decoding through `DbcDecodeBuilder`, `DecodeDatabase`, and
  `DbcDecoder`, including CAN-frame lookup, Intel and Motorola extraction,
  signed and unsigned signals, and factor/offset conversion. Updated parser
  metadata and the demo to support decoding. (`a53a5df`)

#### Documentation and maintenance

- Added `.gitignore` and expanded the README with architecture, data
  structures, parsing behavior, decoding examples, and usage documentation.
  (`efc57d6`, `f2aa10c`, `cb20f5f`, `f0e7065`)