fix(tests): initialize CoreGraphics for headless CI environments

Add sc_initialize_core_graphics() FFI function that calls CGMainDisplayID()
to prevent CGS_REQUIRE_INIT assertion crashes on headless systems.

Called via cg_init_for_headless_ci() in content_filter_tests.

Author: 1313

src/ffi/mod.rs

@@ -1,6 +1,13 @@
 //! Swift FFI bridge to `ScreenCaptureKit`
 use std::ffi::c_void;
 
+// MARK: - CoreGraphics Initialization
+extern "C" {
+    /// Force CoreGraphics initialization by calling CGMainDisplayID
+    /// This prevents CGS_REQUIRE_INIT crashes on headless systems
+    pub fn sc_initialize_core_graphics();
+}
+
 // MARK: - SCShareableContent
 extern "C" {
     /// Synchronous blocking call to get shareable content

swift-bridge/Sources/ScreenCaptureKitBridge/Core.swift

@@ -1,7 +1,18 @@
 // Core memory management utilities for the Swift bridge
 
+import CoreGraphics
 import Foundation
 
+// MARK: - CoreGraphics Initialization
+
+/// Force CoreGraphics initialization by calling CGMainDisplayID
+/// This prevents CGS_REQUIRE_INIT crashes on headless systems
+/// Made public so it can be called from Rust FFI
+@_cdecl("sc_initialize_core_graphics")
+public func initializeCoreGraphics() {
+    _ = CGMainDisplayID()
+}
+
 // MARK: - Error Types
 
 /// Strongly typed errors for the ScreenCaptureKit bridge

swift-bridge/Sources/ScreenCaptureKitBridge/ShareableContent.swift

@@ -4,13 +4,7 @@ import CoreGraphics
 import Foundation
 import ScreenCaptureKit
 
-// MARK: - CoreGraphics Initialization
 
-/// Force CoreGraphics initialization by calling CGMainDisplayID
-/// This prevents CGS_REQUIRE_INIT crashes on headless systems
-private func ensureCoreGraphicsInitialized() {
-    _ = CGMainDisplayID()
-}
 
 // MARK: - Thread-safe result holder
 
@@ -43,7 +37,7 @@ public func getShareableContentSync(
     errorBufferSize: Int
 ) -> OpaquePointer? {
     // Force CoreGraphics initialization
-    ensureCoreGraphicsInitialized()
+    initializeCoreGraphics()
 
     let semaphore = DispatchSemaphore(value: 0)
     let holder = ResultHolder<SCShareableContent>()

tests/content_filter_tests.rs

@@ -4,8 +4,17 @@ use screencapturekit::shareable_content::SCShareableContent;
 use screencapturekit::stream::configuration::{Point, Rect, Size};
 use screencapturekit::stream::content_filter::SCContentFilter;
 
+// Initialize CoreGraphics to prevent CGS_REQUIRE_INIT crashes in CI
+fn cg_init_for_headless_ci() {
+    extern "C" {
+        fn sc_initialize_core_graphics();
+    }
+    unsafe { sc_initialize_core_graphics() }
+}
+
 #[test]
 fn test_content_filter_builder_display() {
+    cg_init_for_headless_ci();
     let content = SCShareableContent::get().expect("Failed to get shareable content");
     let display = &content.displays()[0];
 
@@ -21,6 +30,7 @@ fn test_content_filter_builder_display() {
 
 #[test]
 fn test_content_filter_builder_window() {
+    cg_init_for_headless_ci();
     let content = SCShareableContent::get().expect("Failed to get shareable content");
 
     if let Some(window) = content.windows().first() {
@@ -32,6 +42,7 @@ fn test_content_filter_builder_window() {
 
 #[test]
 fn test_content_filter_exclude_windows() {
+    cg_init_for_headless_ci();
     let content = SCShareableContent::get().expect("Failed to get shareable content");
     let display = &content.displays()[0];
     let windows = content.windows();
@@ -50,6 +61,7 @@ fn test_content_filter_exclude_windows() {
 
 #[test]
 fn test_content_filter_include_windows() {
+    cg_init_for_headless_ci();
     let content = SCShareableContent::get().expect("Failed to get shareable content");
     let display = &content.displays()[0];
     let windows = content.windows();
@@ -68,6 +80,7 @@ fn test_content_filter_include_windows() {
 
 #[test]
 fn test_content_filter_include_applications() {
+    cg_init_for_headless_ci();
     let content = SCShareableContent::get().expect("Failed to get shareable content");
     let display = &content.displays()[0];
     let apps = content.applications();
@@ -86,6 +99,7 @@ fn test_content_filter_include_applications() {
 
 #[test]
 fn test_content_filter_content_rect() {
+    cg_init_for_headless_ci();
     let content = SCShareableContent::get().expect("Failed to get shareable content");
     let display = &content.displays()[0];
 
@@ -106,6 +120,7 @@ fn test_content_filter_content_rect() {
 
 #[test]
 fn test_content_filter_set_content_rect() {
+    cg_init_for_headless_ci();
     let content = SCShareableContent::get().expect("Failed to get shareable content");
     let display = &content.displays()[0];
 
@@ -123,6 +138,7 @@ fn test_content_filter_set_content_rect() {
 
 #[test]
 fn test_content_filter_clone() {
+    cg_init_for_headless_ci();
     let content = SCShareableContent::get().expect("Failed to get shareable content");
     let display = &content.displays()[0];
 
@@ -146,6 +162,7 @@ fn test_content_filter_send_sync() {
 
 #[test]
 fn test_content_filter_debug_display() {
+    cg_init_for_headless_ci();
     let content = SCShareableContent::get().expect("Failed to get shareable content");
     let display = &content.displays()[0];
 
@@ -163,6 +180,7 @@ fn test_content_filter_debug_display() {
 
 #[test]
 fn test_content_filter_equality() {
+    cg_init_for_headless_ci();
     let content = SCShareableContent::get().expect("Failed to get shareable content");
     let display = &content.displays()[0];
 
@@ -181,6 +199,7 @@ fn test_content_filter_equality() {
 
 #[test]
 fn test_content_filter_hash() {
+    cg_init_for_headless_ci();
     use std::collections::HashSet;
 
     let content = SCShareableContent::get().expect("Failed to get shareable content");