feat: add SCContentFilterBuilder::try_build and fix CI/release flow

Code review fixes (P0-P3):
- Add non-breaking SCContentFilterBuilder::try_build() -> SCResult; build()
  is now a thin panicking wrapper.
- Fix compile breaks that failed CI: example 01 `let mut config`
  (feature-gated allow(unused_mut)), missing CGRect / CMSampleBufferSCExt
  imports in tests, gate macos_14_4-only async test.
- Document async drop-oldest delivery, swallowed interior-NUL setter
  behavior, and SCStream::drop teardown ordering.
- Enable unsafe_op_in_unsafe_fn + missing_debug_implementations lints and
  wrap the resulting unsafe ops.
- Add tests/ffi_layout_tests.rs ABI size/align assertions for repr(C) structs.
- Version drift: README/lib.rs say 6; stamp stale coverage docs; correct the
  dependency claim in README; remove stale .bak examples.

Release-plz / CI flow:
- clippy gate now uses --all-features --all-targets -- -D warnings.
- Bump release-plz/action v0.5.128 -> v0.5.129.
- Add concurrency group to the release job.
- Update deprecated Node20 actions: checkout@v4->v5, cache@v4->v5.

Verified: clippy (all features/targets, -D warnings) clean, cargo fmt --check
clean, tests green at async,macos_26_0 and async.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: 1313

.github/workflows/ci.yml

@@ -26,13 +26,13 @@ jobs:
     runs-on: macos-26
     name: Lint
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - name: Setup Rust
         uses: dtolnay/rust-toolchain@stable
         with:
           components: clippy, rustfmt
       - name: Cache cargo
-        uses: actions/cache@v4
+        uses: actions/cache@v5
         with:
           path: |
             ~/.cargo/registry
@@ -42,7 +42,7 @@ jobs:
           restore-keys: |
             ${{ runner.os }}-lint-cargo-
       - name: Run clippy
-        run: cargo clippy --all-features -- -D warnings
+        run: cargo clippy --all-features --all-targets -- -D warnings
       - name: Check formatting
         run: cargo fmt --check
 
@@ -87,13 +87,13 @@ jobs:
     env:
       TARGET_FLAG: ${{ matrix.cross_target && format('--target {0}', matrix.cross_target) || '' }}
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - name: Setup Rust
         uses: dtolnay/rust-toolchain@stable
         with:
           targets: ${{ matrix.cross_target || '' }}
       - name: Cache cargo
-        uses: actions/cache@v4
+        uses: actions/cache@v5
         with:
           path: |
             ~/.cargo/registry
@@ -137,11 +137,11 @@ jobs:
     name: Leak Check - ${{ matrix.name }}
     needs: [lint]
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - name: Setup Rust
         uses: dtolnay/rust-toolchain@stable
       - name: Cache cargo
-        uses: actions/cache@v4
+        uses: actions/cache@v5
         with:
           path: |
             ~/.cargo/registry
@@ -172,14 +172,14 @@ jobs:
       group: release-plz-${{ github.ref }}
       cancel-in-progress: false
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
         with:
           fetch-depth: 0
           token: ${{ secrets.RELEASE_PLZ_TOKEN }}
       - name: Setup Rust
         uses: dtolnay/rust-toolchain@stable
       - name: Run release-plz
-        uses: release-plz/action@v0.5.128
+        uses: release-plz/action@v0.5.129
         with:
           command: release-pr
         env:
@@ -193,15 +193,18 @@ jobs:
     environment: release
     permissions:
       contents: write
+    concurrency:
+      group: release-plz-publish-${{ github.ref }}
+      cancel-in-progress: false
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
         with:
           fetch-depth: 0
           token: ${{ secrets.RELEASE_PLZ_TOKEN }}
       - name: Setup Rust
         uses: dtolnay/rust-toolchain@stable
       - name: Run release-plz
-        uses: release-plz/action@v0.5.128
+        uses: release-plz/action@v0.5.129
         with:
           command: release
         env:

COVERAGE.md

@@ -1,5 +1,10 @@
 # ScreenCaptureKit SDK Coverage
 
+> **Snapshot — not a live coverage status.** This document records a point-in-time
+> audit performed against `screencapturekit` **v3.1.1**. It has **not** been
+> re-verified against the current crate version (6.x) and should be read as a
+> historical audit, not an up-to-date certification.
+
 This document records the `screencapturekit` v3.1.1 coverage audit against Apple's `ScreenCaptureKit.framework` from Xcode 26.2 (`MacOSX26.2.sdk`).
 
 ## Certification

COVERAGE_AUDIT.md

@@ -1,5 +1,7 @@
 # screencapturekit-rs coverage audit (vs MacOSX26.2.sdk)
 
+> Snapshot from the `screencapturekit` v3.1.1 audit pass — historical, not re-verified against 6.x.
+
 SDK_PUBLIC_SYMBOLS: 42
 VERIFIED: 41
 GAPS: 0

COVERAGE_AUDIT_V2.md

@@ -1,5 +1,7 @@
 # screencapturekit-rs coverage audit v2 (vs MacOSX26.2.sdk)
 
+> Snapshot from the `screencapturekit` v3.1.1 audit pass — historical, not re-verified against 6.x.
+
 SDK_PUBLIC_SYMBOLS: 42
 VERIFIED: 41
 GAPS: 0

Cargo.toml

@@ -26,10 +26,8 @@ include = [
 ]
 
 [lints.rust]
-# TODO: Enable after adding unsafe blocks inside unsafe fns
-# unsafe_op_in_unsafe_fn = "warn"
-# TODO: Enable after adding Debug impls to public types
-# missing_debug_implementations = "warn"
+unsafe_op_in_unsafe_fn = "warn"
+missing_debug_implementations = "warn"
 
 [lints.clippy]
 pedantic = { level = "warn", priority = -1 }

README.md

@@ -26,7 +26,7 @@
 - 📸 **Screenshots** + **direct-to-file recording** (macOS 14.0+ / 15.0+)
 - 🖱️ **System content picker** UI (macOS 14.0+)
 - 🛡️ **Memory safe** — proper retain/release, leak-tested
-- 📦 **Zero runtime dependencies**
+- 📦 **Minimal dependencies** — only the thin `apple-cf` / `apple-metal` binding crates (no heavy third-party runtime deps)
 
 ## Table of Contents
 
@@ -41,7 +41,7 @@
 
 ```toml
 [dependencies]
-screencapturekit = "5"
+screencapturekit = "6"
 ```
 
 Opt-in features (additive):
@@ -60,7 +60,7 @@ Opt-in features (additive):
 `macos_*` features are **cumulative** — enabling `macos_15_0` automatically enables every earlier version. Pick the highest version your minimum-supported macOS will satisfy:
 
 ```toml
-screencapturekit = { version = "5", features = ["async", "macos_15_0"] }
+screencapturekit = { version = "6", features = ["async", "macos_15_0"] }
 ```
 
 > **Upgrading from 1.x?** See [`docs/MIGRATION.md`](docs/MIGRATION.md#migrating-from-1x-to-20)

examples/01_basic_capture.rs

@@ -53,7 +53,8 @@ fn main() -> Result<(), Box<dyn std::error::Error>> {
     }
 
     // 3. Configure stream (how to capture)
-    let config = SCStreamConfiguration::new()
+    #[cfg_attr(not(feature = "macos_14_0"), allow(unused_mut))]
+    let mut config = SCStreamConfiguration::new()
         .with_width(1920)
         .with_height(1080)
         .with_pixel_format(PixelFormat::BGRA)

src/async_api.rs

@@ -293,7 +293,16 @@ impl AsyncSCShareableContent {
 // AsyncSCStream - Async stream with integrated frame iteration
 // ============================================================================
 
-/// Async iterator over sample buffers
+/// Async iterator over sample buffers.
+///
+/// # Delivery semantics
+///
+/// This is a **lossy, bounded** buffer. When the queue is full (`capacity`
+/// reached) and a new sample arrives faster than the consumer polls it,
+/// the **oldest** buffered sample is dropped to make room for the newest
+/// (drop-oldest policy). This keeps latency low and favors fresh frames over
+/// stale ones, but means consumers that fall behind will miss intermediate
+/// frames rather than blocking the capture callback.
 struct AsyncSampleIteratorState {
     buffer: std::collections::VecDeque<crate::cm::CMSampleBuffer>,
     waker: Option<Waker>,

src/lib.rs

@@ -27,14 +27,14 @@
 //!
 //! ```toml
 //! [dependencies]
-//! screencapturekit = "4"
+//! screencapturekit = "6"
 //! ```
 //!
 //! For async support:
 //!
 //! ```toml
 //! [dependencies]
-//! screencapturekit = { version = "4", features = ["async"] }
+//! screencapturekit = { version = "6", features = ["async"] }
 //! ```
 //!
 //! ## Quick Start

src/metal.rs

@@ -2034,6 +2034,8 @@ where
 /// }
 /// ```
 pub unsafe fn setup_metal_view(view: *mut c_void, layer: &MetalLayer) {
-    nsview_set_wants_layer(view);
-    nsview_set_layer(view, layer.as_ptr());
+    unsafe {
+        nsview_set_wants_layer(view);
+        nsview_set_layer(view, layer.as_ptr());
+    }
 }