Video Player

• First-frame poster: an AVPlayerLayer paused at time 0 (no separate thumbnail generation)
• Fullscreen uses native AVKit.VideoPlayer (controls, AirPlay, PiP)
• Playback position preserved across open/close cycles
• Silent-switch-proof audio via AVAudioSession(.playback)
• onEnterFullscreen / onExitFullscreen callbacks for the host app to manage orientation locking (no UIKit AppDelegate dependency inside the component)

// Basic usage: bundle resource
SWVideoPlayer(resource: "launch_clip")
    .aspectRatio(16 / 9, contentMode: .fit)

// Remote URL
SWVideoPlayer(url: URL(string: "https://example.com/clip.mp4")!)

// With orientation callbacks (host app unlocks landscape for fullscreen)
SWVideoPlayer(
    resource: "launch_clip",
    onEnterFullscreen: { AppDelegate.setOrientation(.allButUpsideDown) },
    onExitFullscreen:  { AppDelegate.setOrientation(.portrait) }
)

• Add video file to app bundle (Xcode → drag into project → "Copy items if needed")
• Verify in Target → Build Phases → Copy Bundle Resources
• If your app is portrait-locked, implement setOrientation via UIApplicationDelegateAdaptor + the callbacks
• Add landscapeLeft / landscapeRight to Target's Supported Interface Orientations to allow fullscreen rotation

• iOS only: uses UIViewRepresentable, AVAudioSession and fullScreenCover; the file is named SWVideoPlayer+iOS.swift so cross-platform targets can exclude it from macOS
• init(resource:) traps on a missing file: it calls fatalError if the resource is not in the main bundle; use init(url:) when the file may be absent
• Poster appears once the first frame decodes: the player is created on first appearance, so the card shows only the dimmed background for a moment until the frame at time 0 is ready
• Black frame at t=0: the poster is the frame at exactly 0s; if your clip opens on black, re-export it with a non-black first frame
• Audio session is process-global: calling .playback category here affects the whole app's audio behavior