refactor: rename SCContentFilter::build() to builder() for consistency

- Add SCContentFilter::builder() as the primary API
- Deprecate SCContentFilter::build()
- Update all examples and README to use builder()

Author: 1313

README.md

@@ -17,7 +17,7 @@ Capture screen content, windows, and applications with high performance and low
 - 🎥 **Screen & Window Capture** - Capture displays, windows, or specific applications
 - 🔊 **Audio Capture** - Capture system audio and microphone input
 - ⚡ **Real-time Processing** - High-performance frame callbacks with custom dispatch queues
-- 🏗️ **Builder Pattern API** - Clean, type-safe configuration with `::builder()` and `::build()`
+- 🏗️ **Builder Pattern API** - Clean, type-safe configuration with `::builder()`
 - 🔄 **Async Support** - Runtime-agnostic async API (works with Tokio, async-std, smol, etc.)
 - 🎨 **IOSurface Access** - Zero-copy GPU texture access for Metal/OpenGL
 - 🛡️ **Memory Safe** - Proper reference counting and leak-free by design
@@ -67,7 +67,7 @@ fn main() -> Result<(), Box<dyn std::error::Error>> {
     let display = &content.displays()[0];
 
     // Configure capture
-    let filter = SCContentFilter::build()
+    let filter = SCContentFilter::builder()
         .display(display)
         .exclude_windows(&[])
         .build();
@@ -104,7 +104,7 @@ async fn main() -> Result<(), Box<dyn std::error::Error>> {
     let display = &content.displays()[0];
 
     // Create filter and config
-    let filter = SCContentFilter::build()
+    let filter = SCContentFilter::builder()
         .display(display)
         .exclude_windows(&[])
         .build();
@@ -145,7 +145,7 @@ fn main() -> Result<(), Box<dyn std::error::Error>> {
         .ok_or("Safari window not found")?;
 
     // Capture window with audio
-    let filter = SCContentFilter::build()
+    let filter = SCContentFilter::builder()
         .window(window)
         .build();
 
@@ -173,7 +173,7 @@ All types use a consistent builder pattern with a final `.build()` call:
 
 ```rust
 // Content filters
-let filter = SCContentFilter::build()
+let filter = SCContentFilter::builder()
     .display(&display)
     .exclude_windows(&windows)
     .build();
@@ -401,7 +401,7 @@ screencapturekit/
 
 Contributions welcome! Please:
 
-1. Follow existing code patterns (builder pattern with `::builder()` and `::build()`)
+1. Follow existing code patterns (builder pattern with `::builder()`)
 2. Add tests for new functionality
 3. Run `cargo test` and `cargo clippy`
 4. Update documentation

examples/01_basic_capture.rs

@@ -37,7 +37,7 @@ fn main() -> Result<(), Box<dyn std::error::Error>> {
     println!("Display: {}x{}", display.width(), display.height());
 
     // 2. Create content filter (what to capture)
-    let filter = SCContentFilter::build()
+    let filter = SCContentFilter::builder()
         .display(&display)
         .exclude_windows(&[])
         .build();

examples/02_window_capture.rs

@@ -55,7 +55,7 @@ fn main() -> Result<(), Box<dyn std::error::Error>> {
     println!("\nCapturing: {}\n", window.title().unwrap_or_default());
 
     // 4. Create window filter
-    let filter = SCContentFilter::build()
+    let filter = SCContentFilter::builder()
         .window(window)
         .build();
 

examples/03_audio_capture.rs

@@ -46,7 +46,7 @@ fn main() -> Result<(), Box<dyn std::error::Error>> {
         .ok_or("No displays found")?;
 
     // 2. Create filter
-    let filter = SCContentFilter::build()
+    let filter = SCContentFilter::builder()
         .display(&display)
         .exclude_windows(&[])
         .build();

examples/04_pixel_access.rs

@@ -69,7 +69,7 @@ fn main() -> Result<(), Box<dyn std::error::Error>> {
     let display = content.displays().into_iter().next()
         .ok_or("No displays found")?;
 
-    let filter = SCContentFilter::build()
+    let filter = SCContentFilter::builder()
         .display(&display)
         .exclude_windows(&[])
         .build();

examples/05_screenshot.rs

@@ -29,7 +29,7 @@ fn main() -> Result<(), Box<dyn std::error::Error>> {
     println!("Display: {}x{}", display.width(), display.height());
 
     // 2. Create filter
-    let filter = SCContentFilter::build()
+    let filter = SCContentFilter::builder()
         .display(&display)
         .exclude_windows(&[])
         .build();

examples/06_iosurface.rs

@@ -59,7 +59,7 @@ fn main() -> Result<(), Box<dyn std::error::Error>> {
     let display = content.displays().into_iter().next()
         .ok_or("No displays found")?;
 
-    let filter = SCContentFilter::build()
+    let filter = SCContentFilter::builder()
         .display(&display)
         .exclude_windows(&[])
         .build();

examples/08_async.rs

@@ -141,7 +141,7 @@ async fn async_stream_iteration() -> Result<(), Box<dyn std::error::Error>> {
     let displays = content.displays();
 
     if let Some(display) = displays.first() {
-        let filter = SCContentFilter::build()
+        let filter = SCContentFilter::builder()
             .display(display)
             .exclude_windows(&[])
             .build();

examples/09_closure_handlers.rs

@@ -24,7 +24,7 @@ fn main() -> Result<(), Box<dyn std::error::Error>> {
     println!("Display: {}x{}\n", display.width(), display.height());
 
     // Create filter and config
-    let filter = SCContentFilter::build()
+    let filter = SCContentFilter::builder()
         .display(&display)
         .exclude_windows(&[])
         .build();

src/stream/content_filter.rs

@@ -91,14 +91,21 @@ impl SCContentFilter {
     /// let content = SCShareableContent::get()?;
     /// let display = &content.displays()[0];
     /// 
-    /// let filter = SCContentFilter::build()
+    /// let filter = SCContentFilter::builder()
     ///     .display(display)
     ///     .exclude_windows(&[])
     ///     .build();
     /// # Ok(())
     /// # }
     /// ```
     #[must_use]
+    pub fn builder() -> SCContentFilterBuilder {
+        SCContentFilterBuilder::new()
+    }
+
+    /// Creates a new content filter builder (deprecated alias)
+    #[deprecated(since = "1.0.0", note = "Use `builder()` instead")]
+    #[must_use]
     pub fn build() -> SCContentFilterBuilder {
         SCContentFilterBuilder::new()
     }