added new Event boundsChanged

Author: swiftuiux

README.md

@@ -189,6 +189,8 @@ In cases where you need to re-issue a command that might appear redundant but is
 |----------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------|
 | `addVector(ShapeLayerBuilderProtocol, clear: Bool)` | Command to add a vector graphic layer over the video stream. The `builder` parameter is an instance conforming to `ShapeLayerBuilderProtocol`. The `clear` parameter specifies whether to clear existing vector layers before adding the new one.                                                                                                           |
 | `removeAllVectors`                           | Command to remove all vector graphic layers from the video stream.                                                                                    |
+### Additional Notes on the subtitles Command
+The boundsChanged event(`boundsChanged(CGRect)`) is triggered when the main layer’s bounds are updated. This approach is particularly useful when overlays or custom vector layers need to adapt dynamically to changes in video player dimensions or other layout adjustments. To handle the frequent boundsChanged events effectively and improve performance, you can use a **throttle** function to limit how often the updates occur.
 
 ### Audio & Language Commands
 
@@ -235,6 +237,7 @@ video_main.m3u8
 | `currentItemRemoved`    | Occurs when the player's `currentItem` is set to `nil`, indicating that the current media item has been removed from the player.                      |
 | `error(VPErrors)`                  | Represents an occurrence of an error within the player. The event provides a `VPErrors` enum value indicating the specific type of error encountered. |
 | `volumeChanged`         | Happens when the player's volume level is adjusted. This event provides the new volume level, which ranges from 0.0 (muted) to 1.0 (maximum volume).  |
+| `boundsChanged(CGRect)` | Triggered when the bounds of the main layer change, allowing the developer to recalculate and update all vector layers within the CompositeLayer. |
 
 
 ### Additional Notes on Adding and Removing Vector Graphics

Sources/swiftui-loop-videoplayer/enum/PlayerEvent.swift

@@ -59,6 +59,9 @@ public enum PlayerEvent: Equatable {
     ///
     /// - Parameter VPErrors: The error from the VPErrors enum associated with this case.
     case error(VPErrors)
+    
+    
+    case boundsChanged(CGRect)
 }
 
 extension PlayerEvent: CustomStringConvertible {
@@ -80,6 +83,8 @@ extension PlayerEvent: CustomStringConvertible {
             return "VolumeChanged"
         case .error(let e):
             return "\(e.description)"
+        case .boundsChanged(let bounds):
+            return "Bounds changed \(bounds)"
         }
     }
 }

Sources/swiftui-loop-videoplayer/protocol/helpers/PlayerDelegateProtocol.swift

@@ -64,4 +64,9 @@ public protocol PlayerDelegateProtocol: AnyObject {
     /// - Parameter newVolume: The new volume level, expressed as a float between 0.0 (muted) and 1.0 (maximum volume).
     func volumeDidChange(to newVolume: Float)
 
+    /// Notifies that the bounds have changed.
+    ///
+    /// - Parameter bounds: The new bounds of the main layer where we keep the video player and all vector layers. This allows a developer to recalculate and update all vector layers that lie in the CompositeLayer.
+
+    func boundsDidChange(to bounds: CGRect)
 }

Sources/swiftui-loop-videoplayer/protocol/vector/ShapeLayerBuilderProtocol.swift

@@ -28,5 +28,4 @@ public protocol ShapeLayerBuilderProtocol: Identifiable {
     /// - Returns: A configured `CAShapeLayer`.
     @MainActor
     func build(with geometry: (frame: CGRect, bounds: CGRect)) -> CAShapeLayer
-    
 }

Sources/swiftui-loop-videoplayer/view/helpers/PlayerCoordinator.swift

@@ -111,4 +111,12 @@ internal class PlayerCoordinator: NSObject, PlayerDelegateProtocol {
     func volumeDidChange(to newVolume: Float){
         eventPublisher.send(.volumeChanged(newVolume: newVolume))
     }
+    
+    /// Notifies that the bounds have changed.
+    ///
+    /// - Parameter bounds: The new bounds of the main layer where we keep the video player and all vector layers. This allows a developer to recalculate and update all vector layers that lie in the CompositeLayer.
+
+    func boundsDidChange(to bounds: CGRect) {
+        eventPublisher.send(.boundsChanged(bounds))
+    }
 }

Sources/swiftui-loop-videoplayer/view/player/ios/ExtPlayerUIView.swift

@@ -89,7 +89,23 @@ internal class ExtPlayerUIView: UIView, ExtPlayerProtocol {
     override func layoutSubviews() {
         super.layoutSubviews()
         playerLayer?.frame = bounds
-        compositeLayer?.frame = bounds
+        // Update the composite layer (and sublayers)
+        layoutCompositeLayer()
+    }
+    
+    /// Updates the composite layer and all its sublayers' frames.
+    public func layoutCompositeLayer() {
+        guard let compositeLayer = compositeLayer else { return }
+        
+        // Update the composite layer's frame to match the parent
+        compositeLayer.frame = bounds
+        
+        // Adjust each sublayer's frame (if they should fill the entire composite layer)
+        compositeLayer.sublayers?.forEach { sublayer in
+            sublayer.frame = compositeLayer.bounds
+        }
+        
+        delegate?.boundsDidChange(to: bounds)
     }
 
     func onDisappear(){

Sources/swiftui-loop-videoplayer/view/player/mac/ExtPlayerNSView.swift

@@ -16,6 +16,7 @@ import AppKit
 
 /// A NSView subclass that loops video using AVFoundation on macOS.
 /// This class handles the initialization and management of a looping video player with customizable video gravity.
+@MainActor
 internal class ExtPlayerNSView: NSView, ExtPlayerProtocol {
 
     /// This property holds an instance of `VideoSettings`
@@ -88,7 +89,23 @@ internal class ExtPlayerNSView: NSView, ExtPlayerProtocol {
     override func layout() {
         super.layout()
         playerLayer?.frame = bounds
-        compositeLayer?.frame = bounds
+        // Update the composite layer (and sublayers)
+        layoutCompositeLayer()
+    }
+    
+    /// Updates the composite layer and all its sublayers' frames.
+    public func layoutCompositeLayer() {
+        guard let compositeLayer = compositeLayer else { return }
+        
+        // Update the composite layer's frame to match the parent
+        compositeLayer.frame = bounds
+        
+        // Adjust each sublayer's frame (if they should fill the entire composite layer)
+        compositeLayer.sublayers?.forEach { sublayer in
+            sublayer.frame = compositeLayer.bounds
+        }
+        
+        delegate?.boundsDidChange(to: bounds)
     }