Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog,
and this project adheres to Semantic Versioning.

[1.1.4] - 2026-03-17

Added WAV embedded metadata round-trip handling (RIFF LIST/INFO) in WavParser and engine metadata flow in StubCodecMediaEngine.
Added internal Java sampled playback route (java-sampled) for WAV/AIFF-family playback in StubCodecMediaEngine.
Added playback routing regression coverage in StubCodecMediaEnginePlaybackRoutingTest.

Replaced temporary WAV/PCM stub converter with production path via WavPcmConverter, including real wav -> pcm data-chunk extraction and pcm -> wav container wrapping.
Updated conversion hub wiring in DefaultConversionHub to route WAV/PCM through the renamed real converter.
Added preset-driven PCM->WAV parameter parsing in WavPcmConverter.parsePcmWavParams() supporting sr=, ch=, and bits=.
Updated facade regression behavior in CodecMediaFacadeTest to assert real re-encode behavior and preset-based output stream properties for WAV/PCM route.
Updated metadata behavior to use embedded WAV LIST/INFO read/write for WAV inputs while keeping sidecar (.codecmedia.properties) persistence for non-WAV formats in StubCodecMediaEngine.
Updated playback behavior in CodecMediaEngine.play() implementation path to prioritize internal Java sampled playback for WAV/AIFF family before desktop-open fallback.

Added defensive bounds checks for little-endian reads in WavPcmConverter.readLeInt() and WavPcmConverter.readLeUnsignedShort().
Added WAV fmt validation before payload extraction in WavPcmConverter.extractWavDataChunk(), rejecting non-PCM WAV payload extraction.
Hardened chunk traversal and container construction against arithmetic overflow in WavPcmConverter.extractWavDataChunk() and WavPcmConverter.wrapPcmAsWav().
Fixed WAV metadata flow so write/read operations no longer rely on sidecar-only behavior for WAV files, improving in-file metadata persistence consistency.
Fixed playback routing so WAV/AIFF-family inputs no longer depend solely on desktop integration when internal sampled playback is available.

Confirmed facade regression coverage with mvn -Dtest=CodecMediaFacadeTest test.
Confirmed WAV metadata parser behavior with mvn -Dtest=WavParserTest test.
Confirmed engine metadata and playback routing behavior with mvn -Dtest=CodecMediaFacadeTest,StubCodecMediaEnginePlaybackRoutingTest test.