chore(release): prep 7.19.0 - a software-decoded picture and a still carry the colours playback shows

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Mf4MXgM9bqugHoe5TW4BYf

Author: Vincent Herbst

CHANGELOG.md

@@ -12,6 +12,32 @@ the public-API contract.
 
 _Nothing yet._
 
+## [7.19.0] - 2026-09-26
+
+### Fixed
+
+- **A software-decoded picture carries the colour tags VideoToolbox would give it (AE#654).** The
+  software decoder attached a tag only where the frame declared one and CoreVideo had a mapping, so
+  an untagged source reached the display layer with no primaries, transfer or matrix, while the same
+  file through VideoToolbox arrives tagged BT.709. It now fills the gaps the way VideoToolbox does,
+  measured on its output: nothing declared means BT.709 in all three at any size and codec, and a
+  lone BT.601 matrix gets SMPTE-C primaries. Affects the software route (MPEG-4 ASP, MPEG-2, VC-1,
+  VP9, AV1 without hardware decode). `ColorDescription` keeps its gaps, so the HDR gate and the
+  tone mapper still see an untagged stream as untagged.
+- **Tagged SD sources keep their tags on the software path.** `ColorAttachments` had no mapping for
+  BT.601 matrices, SMPTE-C or EBU 3213 primaries, so a correctly tagged PAL or NTSC source lost all
+  three. Added with DCI-P3, SMPTE 240M, sRGB and linear transfer.
+- **A `FrameExtractor` still is converted with the picture's own matrix and range.** The SDR still
+  path never called `sws_setColorspaceDetails`, so every still went through swscale's BT.601
+  default and a range read from the pixel format alone: HD colour bars were up to 33 levels off, and
+  a 10-bit full-range picture (no `yuvj` variant exists) was read as limited. The matrix now follows
+  the rule the displayed buffer is tagged by, so an untagged still resolves exactly as playback.
+
+### Added
+
+- **`SoftwareDecodeProbeResult.firstFrameColor`**: the colour tags the first picture reaches the
+  display layer with, as `primaries / transfer / matrix`. Printed by `aetherctl swdecode`.
+
 ## [7.18.2] - 2026-09-26
 
 ### Fixed

Examples/README.md

@@ -18,7 +18,7 @@ Three samples covering different audiences:
    ```
    https://github.com/superuser404notfound/AetherEngine
    ```
-   Dependency Rule: Up to Next Major Version, starting from `7.18.2`. Add the `AetherEngine` library product to your app target.
+   Dependency Rule: Up to Next Major Version, starting from `7.19.0`. Add the `AetherEngine` library product to your app target.
 
 3. **Drop the file in.** Replace the Xcode template's default `App.swift` (or whatever the generated `@main` file is called) with the contents of [`MinimalPlayerApp.swift`](MinimalPlayer/MinimalPlayerApp.swift). The file is self-contained: it defines both the `@main App` struct and the `ContentView`.
 

README.md

@@ -384,7 +384,7 @@ Subtitle cues land in raw source PTS; render the overlay against `player.sourceT
 Install via Swift Package Manager:
 
 ```swift
-.package(url: "https://github.com/superuser404notfound/AetherEngine", from: "7.18.2")
+.package(url: "https://github.com/superuser404notfound/AetherEngine", from: "7.19.0")
 ```
 
 Three samples ship in `Examples/`:
@@ -631,10 +631,10 @@ Browse all of this as a searchable site at **[aetherengine.superuser404.de](http
 AetherEngine uses [Semantic Versioning](https://semver.org). The public API surface, every `public` declaration in `Sources/AetherEngine/`, is the stability contract. **Major** removes / renames public symbols or breaks adopters; **Minor** adds public API or codec / format support; **Patch** fixes bugs with no public API change. `internal` types are not part of the contract.
 
 ```swift
-.package(url: "https://github.com/superuser404notfound/AetherEngine", from: "7.18.2")
+.package(url: "https://github.com/superuser404notfound/AetherEngine", from: "7.19.0")
 ```
 
-Pin to `.upToNextMinor(from: "7.18.2")` for stricter teams that prefer to opt into minor bumps explicitly.
+Pin to `.upToNextMinor(from: "7.19.0")` for stricter teams that prefer to opt into minor bumps explicitly.
 
 ## Requirements
 

Sources/AetherEngine/AetherEngine+Version.swift

@@ -11,5 +11,5 @@ extension AetherEngine {
     ///
     /// Between releases, and in a consumer that pins an unreleased commit for a device test, this
     /// names the last PUBLISHED version the checkout descends from, not every patch in it.
-    public nonisolated static let version = "7.18.2"
+    public nonisolated static let version = "7.19.0"
 }