feat: migrate color / cfa / pixel_format / frame primitives to videoframe 0.2

[uqio]

Summary

Wires mediadecode to consume duplicate type definitions from the
new `videoframe` crate
(crates.io). videoframe is
the lowest-layer shared vocabulary crate; mediadecode keeps its
decoder/codec abstractions and consumes the pixel-format / color
types via re-exports.

Changes

• Cargo.toml: adds `videoframe = { version = "0.2", default-features = false, features = ["frame"] }`
  at the workspace root; the `mediadecode` core member consumes it
  via `videoframe = { workspace = true }`.

• Replaces `mediadecode/src/{color,cfa,pixel_format}.rs` with
  thin re-exports from `videoframe::{color,cfa,pixel_format}` (~725
  LoC of duplicated definitions deleted).

• `mediadecode/src/frame.rs`: removes the local `Dimensions`,
  `Rect`, `Plane` definitions in favor of
  `videoframe::frame::{Dimensions, Rect, Plane}` re-exports.
  Decoder-output types (`VideoFrame<P, E, D>`, `AudioFrame<S, C, E, D>`,
  `SubtitleFrame<E, D>`) stay in mediadecode — they carry timestamp +
  backend-extras / sample-format / channel-layout, which is mediadecode's
  domain.

PixelFormat::Unknown shape change

videoframe's `PixelFormat::Unknown(u32)` is a tuple variant
(lossless wire round-trip), unlike the prior unit-variant `Unknown`.
Updated 17 sites in `mediadecode-ffmpeg` and `mediadecode-webcodecs`:

• Boundary mapping fallback: `_ => PixelFormat::Unknown` →
  `_ => PixelFormat::Unknown(raw as u32)` (preserves the raw FFmpeg /
  WebCodecs identifier through the cast).
• Test assertions: `assert_eq!(x, PixelFormat::Unknown)` →
  `assert!(matches!(x, PixelFormat::Unknown(_)))`.
• Default-frame placeholders / function-argument bare-`Unknown` sites:
  → `PixelFormat::Unknown(0)`.

Tests

• `mediadecode` core: 47 + 71 tests pass (workspace lib + mediadecode-ffmpeg lib)
• `cargo fmt --check`: clean
• `cargo clippy --workspace --all-features -- -D warnings`: clean
• `cargo doc`: clean

Breaking changes (pre-publish, acceptable)

• `PixelFormat::Unknown` is now `Unknown(u32)` — downstream callers
  matching on it must use `Unknown(_)` or `Unknown(raw)`.
• Existing import paths (`mediadecode::color::ColorMatrix`,
  `mediadecode::PixelFormat`, etc.) continue to resolve via the
  re-exports.

🤖 Generated with Claude Code

[codecov]

Codecov Report

❌ Patch coverage is 24.17582% with 69 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
mediadecode-ffmpeg/src/error.rs	0.00%	32 Missing ⚠️
mediadecode-ffmpeg/src/decoder.rs	0.00%	14 Missing ⚠️
mediadecode/src/frame.rs	60.00%	14 Missing ⚠️
mediadecode-ffmpeg/src/video.rs	0.00%	8 Missing ⚠️
mediadecode-ffmpeg/src/boundary.rs	50.00%	1 Missing ⚠️

📢 Thoughts on this report? Let us know!

[Copilot]

Pull request overview

Migrates mediadecode's pixel-vocabulary primitives (PixelFormat, color enums, BayerPattern, Dimensions/Rect/Plane) to re-exports from the new videoframe 0.2 crate so that colconv, mediadecode, and scenesdetect share one canonical definition. Adapts the FFmpeg and WebCodecs adapters to the new PixelFormat::Unknown(u32) tuple variant, and reshapes Error/FrameError variants into newtype-tuple form wrapping payload structs (with accessors and into_* methods to preserve owning-move ergonomics for non-seekable callers replaying rescued packets).

Changes:

• Replace mediadecode/src/{color,cfa,pixel_format}.rs and the structural bits of frame.rs with thin re-exports from videoframe::{color,cfa,pixel_format,frame}; bump mediadecode to 0.2.0 and mediadecode-ffmpeg to 0.2.0.
• Update 17 boundary / test / default-frame sites in mediadecode-ffmpeg and mediadecode-webcodecs to the new PixelFormat::Unknown(u32) shape (Unknown(raw as u32) at adapter fallbacks; matches!(_, Unknown(_)) in tests).
• Reshape Error::{HwDeviceInitFailed, AllBackendsFailed, FallbackFailed} into newtype-tuple variants over payload structs with accessor + into_parts methods; add a parallel FrameError + VideoFrame::try_new / AudioFrame::try_new panic-free constructors; add #[must_use] on every consuming with_* builder.

Reviewed changes

Copilot reviewed 30 out of 30 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
Cargo.toml	Adds videoframe = "0.2" workspace dep, bumps mediadecode to 0.2.
mediadecode/Cargo.toml	Bumps to 0.2.0, adds videoframe dep.
mediadecode/src/{color,cfa,pixel_format}.rs	Replace local definitions with videoframe::* re-exports.
mediadecode/src/frame.rs	Re-export structural primitives; add FrameError + try_new constructors; add #[must_use] on builders.
mediadecode/src/{packet,channel}.rs	Add #[must_use] on consuming builders.
mediadecode/{README,CHANGELOG}.md	Document the videoframe migration.
mediadecode-ffmpeg/src/error.rs	Reshape error variants into newtype-tuple form over payload structs; move hand-written Debug onto payloads.
mediadecode-ffmpeg/src/{decoder,video,boundary,frame,extras}.rs	Adapt to new Error shape and PixelFormat::Unknown(u32); add #[must_use] on builders.
mediadecode-ffmpeg/{tests,examples,benches}/*	Update destructuring to new Error::AllBackendsFailed(p) shape.
mediadecode-ffmpeg/{README,CHANGELOG}.md, Cargo.toml	Document migration; bump to 0.2.0.
mediadecode-webcodecs/src/{boundary,extras}.rs	Adapt Unknown fallback to Unknown(0); add #[must_use].
mediadecode-webcodecs/tests/native_stub.rs	New non-wasm stub-linkage test.
mediadecode-webcodecs/{README,CHANGELOG}.md	Document scaffolded status and migration.
.github/workflows/ci-ffmpeg.yml	Bump cache key prefix to -v2- and add cargo clean -p ffmpeg-sys-next step to work around stale brew-FFmpeg path baked into the sys crate.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.