Add video renderer pool prewarming API

Sources/StreamVideoSwiftUI/Utils/ReusePool.swift

@@ -30,10 +30,12 @@ final class ReusePool<Element: AnyObject & Hashable> {
         self.initialCapacity = initialCapacity
         self.factory = factory
 
-        // Initialize the pool with a set number of elements
-        for _ in 0..<initialCapacity {
-            let element = factory()
-            available.append(element)
+        // Initialize the pool with a set number of elements (thread-safe)
+        queue.sync {
+            for _ in 0..<initialCapacity {
+                let element = factory()
+                available.append(element)
+            }
         }
     }
 
@@ -94,4 +96,15 @@ final class ReusePool<Element: AnyObject & Hashable> {
             }
         }
     }
+
+    /// Adds a pre-created element to the available pool.
+    /// Used for prewarming to add elements beyond initial capacity.
+    ///
+    /// - Parameter element: The pre-created element to add to the pool.
+    func addToAvailable(_ element: Element) {
+        queue.sync {
+            available.append(element)
+            log.debug("Added prewarmed \(type(of: element)):\(String(describing: element)) to available pool.")
+        }
+    }
 }

Sources/StreamVideoSwiftUI/Utils/VideoRendererPool/VideoRendererPool.swift

@@ -47,6 +47,25 @@ final class VideoRendererPool: @unchecked Sendable {
     func releaseRenderer(_ renderer: VideoRenderer) {
         pool.release(renderer)
     }
+
+    /// Configures the global video renderer pool with the specified initial capacity.
+    /// This method is intended for internal use by StreamVideo.
+    ///
+    /// - Parameter initialCapacity: The number of video renderers to pre-create.
+    @MainActor
+    static func configure(initialCapacity: Int) async {
+        // Create pool with 0 initial capacity first
+        currentValue = VideoRendererPool(initialCapacity: 0)
+
+        // Then add renderers one by one with yielding
+        for _ in 0..<initialCapacity {
+            let renderer = VideoRenderer(frame: CGRect(origin: .zero, size: .zero))
+            currentValue.pool.addToAvailable(renderer)
+
+            // Yield to allow other main thread work between renderer creations
+            await Task.yield()
+        }
+    }
 }
 
 /// - Note: I have no other way of satisfying the compiler here.

Sources/StreamVideoSwiftUI/VideoRendererConfiguration.swift

@@ -0,0 +1,29 @@
+//
+// Copyright © 2025 Stream.io Inc. All rights reserved.
+//
+
+import Foundation
+
+/// Configuration options for video rendering performance optimization.
+public enum VideoRendererConfiguration {
+
+    /// Prewarms video renderers to avoid UI blocking when video views are first created.
+    /// This should be called early in your app lifecycle, before any video views appear.
+    /// Safe to call from any thread - will never block the caller.
+    ///
+    /// - Parameter count: The number of video renderers to pre-create (default is 2).
+    ///
+    /// ## Usage
+    /// ```swift
+    /// // Early in app lifecycle - simple call, never blocks
+    /// VideoRendererConfiguration.prewarm(count: 5)
+    ///
+    /// // Then later initialize StreamVideo as usual
+    /// let streamVideo = StreamVideo(apiKey: apiKey, user: user, token: token)
+    /// ```
+    public static func prewarm(count: Int = 2) {
+        Task.detached {
+            await VideoRendererPool.configure(initialCapacity: count)
+        }
+    }
+}