refactor: improve metal overlay UX and mic device API

- Widen menu and config menu for better readability
- Add debug output when applying stream configuration
- Simplify microphone_capture_device_id API to take &str directly
- Add clear_microphone_capture_device_id() for reverting to default
- Update examples to use set_ methods for mutations
- Rename AsyncSCContentSharingPicker::pick to show for consistency

Author: 1313

examples/01_basic_capture.rs

@@ -71,7 +71,7 @@ fn main() -> Result<(), Box<dyn std::error::Error>> {
     #[cfg(feature = "macos_15_0")]
     {
         // Show mouse click indicators (circle around cursor when clicking)
-        config = config.with_shows_mouse_clicks(true);
+        config.set_shows_mouse_clicks(true);
         println!("Mouse click indicators: enabled");
     }
 

examples/08_async.rs

@@ -234,7 +234,7 @@ async fn async_content_picker() -> Result<(), Box<dyn std::error::Error>> {
     let config = SCContentSharingPickerConfiguration::new();
 
     // Async picker - doesn't block the executor thread
-    match AsyncSCContentSharingPicker::pick(&config).await {
+    match AsyncSCContentSharingPicker::show(&config).await {
         SCPickerOutcome::Picked(result) => {
             let (width, height) = result.pixel_size();
             let scale = result.scale();

examples/metal_overlay/main.rs

@@ -776,7 +776,7 @@ impl VertexBufferBuilder {
         ];
 
         // Calculate box dimensions - wider menu
-        let box_w = (280.0 * base_scale).min(viewport_w * 0.85);
+        let box_w = (400.0 * base_scale).min(viewport_w * 0.85);
         let box_h = (line_h * (menu_items.len() as f32 + 3.5) + padding * 2.0).min(viewport_h * 0.6);
 
         // Center the box
@@ -840,7 +840,7 @@ impl VertexBufferBuilder {
         let hint_color = [0.6, 0.6, 0.6, 1.0];
 
         let option_count = StreamConfig::option_count();
-        let box_w = (label_col_w + value_col_w + padding * 3.0).min(viewport_w * 0.6);
+        let box_w = (350.0 * base_scale).min(viewport_w * 0.7);
         let box_h = (line_h * (option_count as f32 + 3.0) + padding * 2.0).min(viewport_h * 0.5);
 
         let x = (viewport_w - box_w) / 2.0;
@@ -1275,9 +1275,12 @@ fn main() {
                                     // Apply config to running stream
                                     if capturing.load(Ordering::Relaxed) {
                                         if let Some(ref s) = stream {
+                                            println!("📝 Applying config: FPS={}, Cursor={}, Audio={}, Mic={}", 
+                                                stream_config.fps, stream_config.show_cursor, 
+                                                stream_config.captures_audio, stream_config.captures_mic);
                                             let new_config = stream_config.to_stream_config(capture_size.0, capture_size.1);
                                             match s.update_configuration(&new_config) {
-                                                Ok(()) => println!("✅ Config updated"),
+                                                Ok(()) => println!("✅ Config updated successfully"),
                                                 Err(e) => eprintln!("❌ Config update failed: {:?}", e),
                                             }
                                         }

src/stream/configuration/audio.rs

@@ -197,8 +197,7 @@ impl SCStreamConfiguration {
 
     /// Set microphone capture device ID (macOS 15.0+).
     ///
-    /// Specifies which microphone device to capture from. Use `None` for the
-    /// default system microphone.
+    /// Specifies which microphone device to capture from.
     ///
     /// # Availability
     /// macOS 15.0+. On earlier versions, this setting has no effect.
@@ -207,23 +206,16 @@ impl SCStreamConfiguration {
     /// ```rust,no_run
     /// use screencapturekit::prelude::*;
     ///
-    /// let config = SCStreamConfiguration::new()
-    ///     .with_captures_microphone(true)
-    ///     .with_microphone_capture_device_id(Some("AppleHDAEngineInput:1B,0,1,0:1"));
+    /// let mut config = SCStreamConfiguration::new()
+    ///     .with_captures_microphone(true);
+    /// config.set_microphone_capture_device_id("AppleHDAEngineInput:1B,0,1,0:1");
     /// ```
-    pub fn set_microphone_capture_device_id(&mut self, device_id: Option<&str>) -> &mut Self {
+    pub fn set_microphone_capture_device_id(&mut self, device_id: &str) -> &mut Self {
         unsafe {
-            if let Some(id) = device_id {
-                if let Ok(c_id) = std::ffi::CString::new(id) {
-                    crate::ffi::sc_stream_configuration_set_microphone_capture_device_id(
-                        self.as_ptr(),
-                        c_id.as_ptr(),
-                    );
-                }
-            } else {
+            if let Ok(c_id) = std::ffi::CString::new(device_id) {
                 crate::ffi::sc_stream_configuration_set_microphone_capture_device_id(
                     self.as_ptr(),
-                    std::ptr::null(),
+                    c_id.as_ptr(),
                 );
             }
         }
@@ -232,11 +224,22 @@ impl SCStreamConfiguration {
 
     /// Set microphone capture device ID (builder pattern)
     #[must_use]
-    pub fn with_microphone_capture_device_id(mut self, device_id: Option<&str>) -> Self {
+    pub fn with_microphone_capture_device_id(mut self, device_id: &str) -> Self {
         self.set_microphone_capture_device_id(device_id);
         self
     }
 
+    /// Clear microphone capture device ID, reverting to default system microphone
+    pub fn clear_microphone_capture_device_id(&mut self) -> &mut Self {
+        unsafe {
+            crate::ffi::sc_stream_configuration_set_microphone_capture_device_id(
+                self.as_ptr(),
+                std::ptr::null(),
+            );
+        }
+        self
+    }
+
     /// Get microphone capture device ID (macOS 15.0+).
     pub fn get_microphone_capture_device_id(&self) -> Option<String> {
         unsafe {