@shortkitsdk/react-native 0.2.30 → 0.2.32

package/ios/ShortKitSDK.xcframework/ios-arm64_x86_64-simulator/ShortKitSDK.framework/Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface

@@ -5,6 +5,9 @@
 import AVFoundation
 import Combine
 import CoreGraphics
+import CoreImage
+import CoreMedia
+import CoreVideo
 import Foundation
 import Network
 import QuartzCore
@@ -59,6 +62,7 @@ final public class BandwidthMonitor : ShortKitSDK.BandwidthMonitorProtocol {
   final public let segmentCache: any ShortKitSDK.SegmentCacheProtocol
   final public var segmentServer: ShortKitSDK.SegmentHTTPServer?
   public init(segmentCache: any ShortKitSDK.SegmentCacheProtocol, session: Foundation.URLSession = .shared)
+  @objc deinit
   final public var urlMapping: [Foundation.URL : Foundation.URL] {
     get
   }
@@ -73,7 +77,6 @@ final public class BandwidthMonitor : ShortKitSDK.BandwidthMonitorProtocol {
   final public func cachedRendition(for videoID: Swift.String) -> Swift.String?
   @objc final public func resourceLoader(_ resourceLoader: AVFoundation.AVAssetResourceLoader, shouldWaitForLoadingOfRequestedResource loadingRequest: AVFoundation.AVAssetResourceLoadingRequest) -> Swift.Bool
   @objc final public func resourceLoader(_ resourceLoader: AVFoundation.AVAssetResourceLoader, didCancel loadingRequest: AVFoundation.AVAssetResourceLoadingRequest)
-  @objc deinit
 }
 public protocol ColdStartManagerProtocol : Swift.Sendable {
   func cachedFeedItems() -> [ShortKitSDK.FeedItem]
@@ -152,15 +155,11 @@ final public class SegmentHTTPServer {
 }
 public protocol SegmentPrefetcherProtocol : AnyObject {
   func updateCurrentIndex(_ index: Swift.Int, feedItems: [ShortKitSDK.FeedItem])
-  func pause()
-  func resume()
 }
-final public class SegmentPrefetcher : ShortKitSDK.SegmentPrefetcherProtocol {
+@_hasMissingDesignatedInitializers final public class SegmentPrefetcher : ShortKitSDK.SegmentPrefetcherProtocol {
   public init(cache: any ShortKitSDK.SegmentCacheProtocol, monitor: any ShortKitSDK.BandwidthMonitorProtocol, session: Foundation.URLSession? = nil, targetRenditionHeight: Swift.Int = 720, maxCachedVideos: Swift.Int = 7)
-  final public func updateCurrentIndex(_ index: Swift.Int, feedItems: [ShortKitSDK.FeedItem])
-  final public func pause()
-  final public func resume()
   @objc deinit
+  final public func updateCurrentIndex(_ index: Swift.Int, feedItems: [ShortKitSDK.FeedItem])
 }
 public struct CarouselCompletionEvent : Swift.Equatable, Swift.Sendable {
   public let contentItem: ShortKitSDK.ContentItem
@@ -343,8 +342,46 @@ extension ShortKitSDK.LiveOverlayMode : Swift.Codable {
   public init(from decoder: any Swift.Decoder) throws
   public func encode(to encoder: any Swift.Encoder) throws
 }
+public struct DebugAlert {
+  public enum Level {
+    case warning
+    public static func == (a: ShortKitSDK.DebugAlert.Level, b: ShortKitSDK.DebugAlert.Level) -> Swift.Bool
+    public func hash(into hasher: inout Swift.Hasher)
+    public var hashValue: Swift.Int {
+      get
+    }
+  }
+  public let level: ShortKitSDK.DebugAlert.Level
+  public let compactLabel: Swift.String
+  public let priority: Swift.Int
+  public init(level: ShortKitSDK.DebugAlert.Level, compactLabel: Swift.String, priority: Swift.Int)
+}
+public enum DebugAlerts {
+  public static func compute(_ m: ShortKitSDK.DebugMetrics) -> [ShortKitSDK.DebugAlert]
+}
+public enum DebugItemStatus {
+  case unknown
+  case readyToPlay
+  case failed
+  public static func == (a: ShortKitSDK.DebugItemStatus, b: ShortKitSDK.DebugItemStatus) -> Swift.Bool
+  public func hash(into hasher: inout Swift.Hasher)
+  public var hashValue: Swift.Int {
+    get
+  }
+}
+public enum DebugTimeControl {
+  case paused
+  case waitingToPlayAtSpecifiedRate
+  case playing
+  public static func == (a: ShortKitSDK.DebugTimeControl, b: ShortKitSDK.DebugTimeControl) -> Swift.Bool
+  public func hash(into hasher: inout Swift.Hasher)
+  public var hashValue: Swift.Int {
+    get
+  }
+}
 public struct DebugMetrics {
   public var contentId: Swift.String?
+  public var playbackId: Swift.String?
   public var feedIndex: Swift.Int
   public var playerState: ShortKitSDK.PlayerState
   public var intentToFrameMs: Swift.Int?
@@ -366,8 +403,35 @@ public struct DebugMetrics {
   public var thumbnailVisible: Swift.Bool
   public var thumbsCachedAhead: Swift.Int
   public var metadataAhead: Swift.Int
+  public var itemStatus: ShortKitSDK.DebugItemStatus
+  public var playerErrorDescription: Swift.String?
+  public var failedItemUrl: Swift.String?
+  public var timeControlStatus: ShortKitSDK.DebugTimeControl
+  public var waitingReason: Swift.String?
+  public var hasCurrentItem: Swift.Bool
+  public var hasPlayerLayer: Swift.Bool?
+  public var isPlaybackBufferEmpty: Swift.Bool
+  public var isPlaybackLikelyToKeepUp: Swift.Bool
+  public var isPlaybackBufferFull: Swift.Bool
+  public var loadedTimeRangesCount: Swift.Int
+  public var loadedTimeRangesEnd: Swift.Double
+  public var poolSlotName: Swift.String?
+  public var poolReservedIndex: Swift.Int?
+  public var segmentServerPort: Swift.UInt16?
   public init(contentId: Swift.String? = nil)
 }
+@objc @_inheritsConvenienceInitializers @_Concurrency.MainActor @preconcurrency final public class DebugPanelView : UIKit.UIView {
+  @_Concurrency.MainActor @preconcurrency public static let panelWidth: CoreFoundation.CGFloat
+  @_Concurrency.MainActor @preconcurrency public static let panelHeight: CoreFoundation.CGFloat
+  @_Concurrency.MainActor @preconcurrency public static let adjacentExpandedHeight: CoreFoundation.CGFloat
+  @_Concurrency.MainActor @preconcurrency public static let diagnosticsExpandedHeight: CoreFoundation.CGFloat
+  @_Concurrency.MainActor @preconcurrency public static let expandedExtraHeight: CoreFoundation.CGFloat
+  @_Concurrency.MainActor @preconcurrency @objc override dynamic public init(frame: CoreFoundation.CGRect)
+  @_Concurrency.MainActor @preconcurrency @objc required dynamic public init?(coder: Foundation.NSCoder)
+  @_Concurrency.MainActor @preconcurrency final public func subscribe(to subject: Combine.CurrentValueSubject<ShortKitSDK.DebugMetrics, Swift.Never>)
+  @_Concurrency.MainActor @preconcurrency final public func subscribeAdjacent(prev: Combine.CurrentValueSubject<ShortKitSDK.DebugMetrics, Swift.Never>, next: Combine.CurrentValueSubject<ShortKitSDK.DebugMetrics, Swift.Never>)
+  @objc deinit
+}
 public enum SwipeCurve : Swift.Int, Swift.CaseIterable {
   case quarticOut
   case quinticOut
@@ -398,17 +462,29 @@ extension ShortKitSDK.ShortKitDelegate {
   public func shortKit(_ shortKit: ShortKitSDK.ShortKit, didTapContent contentId: Swift.String, at index: Swift.Int)
   public func shortKit(_ shortKit: ShortKitSDK.ShortKit, didFetchContentItems items: [ShortKitSDK.ContentItem])
 }
+public enum DownloadPhase : Swift.String, Swift.Sendable {
+  case downloading
+  case compositing
+  case finalizing
+  public init?(rawValue: Swift.String)
+  public typealias RawValue = Swift.String
+  public var rawValue: Swift.String {
+    get
+  }
+}
 public protocol ShortKitDownloadDelegate : AnyObject {
   func shortKit(_ shortKit: ShortKitSDK.ShortKit, didStartDownload item: ShortKitSDK.ContentItem)
   func shortKit(_ shortKit: ShortKitSDK.ShortKit, didUpdateDownloadProgress item: ShortKitSDK.ContentItem, progress: Swift.Double)
   func shortKit(_ shortKit: ShortKitSDK.ShortKit, didCompleteDownload item: ShortKitSDK.ContentItem, fileURL: Foundation.URL)
   func shortKit(_ shortKit: ShortKitSDK.ShortKit, didFailDownload item: ShortKitSDK.ContentItem, error: ShortKitSDK.ShortKitDownloadError)
+  func shortKit(_ shortKit: ShortKitSDK.ShortKit, didUpdateDownloadProgress item: ShortKitSDK.ContentItem, progress: Swift.Double, phase: ShortKitSDK.DownloadPhase)
 }
 extension ShortKitSDK.ShortKitDownloadDelegate {
   public func shortKit(_ shortKit: ShortKitSDK.ShortKit, didStartDownload item: ShortKitSDK.ContentItem)
   public func shortKit(_ shortKit: ShortKitSDK.ShortKit, didUpdateDownloadProgress item: ShortKitSDK.ContentItem, progress: Swift.Double)
   public func shortKit(_ shortKit: ShortKitSDK.ShortKit, didCompleteDownload item: ShortKitSDK.ContentItem, fileURL: Foundation.URL)
   public func shortKit(_ shortKit: ShortKitSDK.ShortKit, didFailDownload item: ShortKitSDK.ContentItem, error: ShortKitSDK.ShortKitDownloadError)
+  public func shortKit(_ shortKit: ShortKitSDK.ShortKit, didUpdateDownloadProgress item: ShortKitSDK.ContentItem, progress: Swift.Double, phase: ShortKitSDK.DownloadPhase)
 }
 public enum DownloadMode {
   case nonInterruptive
@@ -419,12 +495,26 @@ public enum DownloadMode {
     get
   }
 }
-public enum ShortKitDownloadError : Swift.Error {
+public enum DownloadOverlayMode {
+  case none
+  case staticSnapshot(source: any UIKit.UIView & ShortKitSDK.FeedOverlay)
+}
+public protocol ExportableFeedOverlay : AnyObject {
+  func prepareForExport(duration: Foundation.TimeInterval, size: CoreFoundation.CGSize) async
+  func snapshotAtTime(_ time: Foundation.TimeInterval) async -> UIKit.UIImage?
+  func tearDownAfterExport()
+}
+public enum ShortKitDownloadError : Swift.Error, Foundation.LocalizedError {
   case downloadNotAvailable
   case downloadInProgress
   case networkError(any Swift.Error)
   case httpError(statusCode: Swift.Int)
   case cancelled
+  case exportFailed(underlying: any Swift.Error)
+  case overlayNotVisibleForSnapshot
+  public var errorDescription: Swift.String? {
+    get
+  }
 }
 @_hasMissingDesignatedInitializers final public class FeedPreload : @unchecked Swift.Sendable {
   public init(immediateItems items: [ShortKitSDK.FeedInput])
@@ -492,6 +582,7 @@ public enum ShortKitFeedLifecycle {
     @objc get
   }
   @_Concurrency.MainActor @preconcurrency @objc override dynamic public func motionEnded(_ motion: UIKit.UIEvent.EventSubtype, with event: UIKit.UIEvent?)
+  @_Concurrency.MainActor @preconcurrency public func overlayView(forItemId itemId: Swift.String) -> (any UIKit.UIView & ShortKitSDK.FeedOverlay)?
 }
 extension ShortKitSDK.ShortKitFeedViewController : UIKit.UICollectionViewDelegate {
   @_Concurrency.MainActor @preconcurrency @objc dynamic public func collectionView(_ collectionView: UIKit.UICollectionView, willDisplay cell: UIKit.UICollectionViewCell, forItemAt indexPath: Foundation.IndexPath)
@@ -1098,6 +1189,7 @@ final public class ShortKit {
   final public let player: ShortKitSDK.ShortKitPlayer
   final public let carousel: ShortKitSDK.ShortKitCarousel
   final public let debugPanelEnabled: Swift.Bool
+  public static let defaultDebugPanelFactory: (_ active: Combine.CurrentValueSubject<ShortKitSDK.DebugMetrics, Swift.Never>, _ prev: Combine.CurrentValueSubject<ShortKitSDK.DebugMetrics, Swift.Never>, _ next: Combine.CurrentValueSubject<ShortKitSDK.DebugMetrics, Swift.Never>) -> UIKit.UIView
   weak final public var delegate: (any ShortKitSDK.ShortKitDelegate)?
   weak final public var downloadDelegate: (any ShortKitSDK.ShortKitDownloadDelegate)?
   final public var loadingViewProvider: (() -> UIKit.UIView)?
@@ -1109,7 +1201,7 @@ final public class ShortKit {
   final public func clearUserId()
   @_Concurrency.MainActor final public func setColdStartQueue(_ items: [ShortKitSDK.FeedInput])
   final public func clearColdStartCache()
-  final public func downloadVideo(_ item: ShortKitSDK.ContentItem, mode: ShortKitSDK.DownloadMode = .nonInterruptive) async throws -> Foundation.URL
+  final public func downloadVideo(_ item: ShortKitSDK.ContentItem, mode: ShortKitSDK.DownloadMode = .nonInterruptive, overlayMode: ShortKitSDK.DownloadOverlayMode = .none) async throws -> Foundation.URL
   final public func cancelDownload()
   @objc deinit
 }
@@ -1159,6 +1251,7 @@ extension ShortKitSDK.ShortKitPlayerViewController : UIKit.UIViewControllerTrans
 }
 @objc @_hasMissingDesignatedInitializers @_Concurrency.MainActor @preconcurrency final public class ShortKitWidgetViewController : UIKit.UIViewController {
   @_Concurrency.MainActor @preconcurrency final public var feedMask: ShortKitSDK.FeedMaskMode
+  @_Concurrency.MainActor @preconcurrency final public var onCardTap: ((Swift.String, Swift.Int) -> Swift.Void)?
   @_Concurrency.MainActor @preconcurrency public init(shortKit: ShortKitSDK.ShortKit, config: ShortKitSDK.WidgetConfig, items: [ShortKitSDK.WidgetInput] = [])
   @_Concurrency.MainActor @preconcurrency final public func configure(with inputs: [ShortKitSDK.WidgetInput])
   @_Concurrency.MainActor @preconcurrency @objc override final public func viewDidLoad()
@@ -1202,9 +1295,18 @@ extension ShortKitSDK.ScrollAxis : Swift.Hashable {}
 extension ShortKitSDK.ScrollAxis : Swift.RawRepresentable {}
 extension ShortKitSDK.FeedSource : Swift.Hashable {}
 extension ShortKitSDK.FeedSource : Swift.RawRepresentable {}
+extension ShortKitSDK.DebugAlert.Level : Swift.Equatable {}
+extension ShortKitSDK.DebugAlert.Level : Swift.Hashable {}
+extension ShortKitSDK.DebugItemStatus : Swift.Equatable {}
+extension ShortKitSDK.DebugItemStatus : Swift.Hashable {}
+extension ShortKitSDK.DebugTimeControl : Swift.Equatable {}
+extension ShortKitSDK.DebugTimeControl : Swift.Hashable {}
 extension ShortKitSDK.SwipeCurve : Swift.Equatable {}
 extension ShortKitSDK.SwipeCurve : Swift.Hashable {}
 extension ShortKitSDK.SwipeCurve : Swift.RawRepresentable {}
+extension ShortKitSDK.DownloadPhase : Swift.Equatable {}
+extension ShortKitSDK.DownloadPhase : Swift.Hashable {}
+extension ShortKitSDK.DownloadPhase : Swift.RawRepresentable {}
 extension ShortKitSDK.DownloadMode : Swift.Equatable {}
 extension ShortKitSDK.DownloadMode : Swift.Hashable {}
 extension ShortKitSDK.ShortKitFeedView : Swift.Sendable {}

package/ios/ShortKitSDK.xcframework/ios-arm64_x86_64-simulator/ShortKitSDK.framework/Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftinterface

@@ -5,6 +5,9 @@
 import AVFoundation
 import Combine
 import CoreGraphics
+import CoreImage
+import CoreMedia
+import CoreVideo
 import Foundation
 import Network
 import QuartzCore
@@ -59,6 +62,7 @@ final public class BandwidthMonitor : ShortKitSDK.BandwidthMonitorProtocol {
   final public let segmentCache: any ShortKitSDK.SegmentCacheProtocol
   final public var segmentServer: ShortKitSDK.SegmentHTTPServer?
   public init(segmentCache: any ShortKitSDK.SegmentCacheProtocol, session: Foundation.URLSession = .shared)
+  @objc deinit
   final public var urlMapping: [Foundation.URL : Foundation.URL] {
     get
   }
@@ -73,7 +77,6 @@ final public class BandwidthMonitor : ShortKitSDK.BandwidthMonitorProtocol {
   final public func cachedRendition(for videoID: Swift.String) -> Swift.String?
   @objc final public func resourceLoader(_ resourceLoader: AVFoundation.AVAssetResourceLoader, shouldWaitForLoadingOfRequestedResource loadingRequest: AVFoundation.AVAssetResourceLoadingRequest) -> Swift.Bool
   @objc final public func resourceLoader(_ resourceLoader: AVFoundation.AVAssetResourceLoader, didCancel loadingRequest: AVFoundation.AVAssetResourceLoadingRequest)
-  @objc deinit
 }
 public protocol ColdStartManagerProtocol : Swift.Sendable {
   func cachedFeedItems() -> [ShortKitSDK.FeedItem]
@@ -152,15 +155,11 @@ final public class SegmentHTTPServer {
 }
 public protocol SegmentPrefetcherProtocol : AnyObject {
   func updateCurrentIndex(_ index: Swift.Int, feedItems: [ShortKitSDK.FeedItem])
-  func pause()
-  func resume()
 }
-final public class SegmentPrefetcher : ShortKitSDK.SegmentPrefetcherProtocol {
+@_hasMissingDesignatedInitializers final public class SegmentPrefetcher : ShortKitSDK.SegmentPrefetcherProtocol {
   public init(cache: any ShortKitSDK.SegmentCacheProtocol, monitor: any ShortKitSDK.BandwidthMonitorProtocol, session: Foundation.URLSession? = nil, targetRenditionHeight: Swift.Int = 720, maxCachedVideos: Swift.Int = 7)
-  final public func updateCurrentIndex(_ index: Swift.Int, feedItems: [ShortKitSDK.FeedItem])
-  final public func pause()
-  final public func resume()
   @objc deinit
+  final public func updateCurrentIndex(_ index: Swift.Int, feedItems: [ShortKitSDK.FeedItem])
 }
 public struct CarouselCompletionEvent : Swift.Equatable, Swift.Sendable {
   public let contentItem: ShortKitSDK.ContentItem
@@ -343,8 +342,46 @@ extension ShortKitSDK.LiveOverlayMode : Swift.Codable {
   public init(from decoder: any Swift.Decoder) throws
   public func encode(to encoder: any Swift.Encoder) throws
 }
+public struct DebugAlert {
+  public enum Level {
+    case warning
+    public static func == (a: ShortKitSDK.DebugAlert.Level, b: ShortKitSDK.DebugAlert.Level) -> Swift.Bool
+    public func hash(into hasher: inout Swift.Hasher)
+    public var hashValue: Swift.Int {
+      get
+    }
+  }
+  public let level: ShortKitSDK.DebugAlert.Level
+  public let compactLabel: Swift.String
+  public let priority: Swift.Int
+  public init(level: ShortKitSDK.DebugAlert.Level, compactLabel: Swift.String, priority: Swift.Int)
+}
+public enum DebugAlerts {
+  public static func compute(_ m: ShortKitSDK.DebugMetrics) -> [ShortKitSDK.DebugAlert]
+}
+public enum DebugItemStatus {
+  case unknown
+  case readyToPlay
+  case failed
+  public static func == (a: ShortKitSDK.DebugItemStatus, b: ShortKitSDK.DebugItemStatus) -> Swift.Bool
+  public func hash(into hasher: inout Swift.Hasher)
+  public var hashValue: Swift.Int {
+    get
+  }
+}
+public enum DebugTimeControl {
+  case paused
+  case waitingToPlayAtSpecifiedRate
+  case playing
+  public static func == (a: ShortKitSDK.DebugTimeControl, b: ShortKitSDK.DebugTimeControl) -> Swift.Bool
+  public func hash(into hasher: inout Swift.Hasher)
+  public var hashValue: Swift.Int {
+    get
+  }
+}
 public struct DebugMetrics {
   public var contentId: Swift.String?
+  public var playbackId: Swift.String?
   public var feedIndex: Swift.Int
   public var playerState: ShortKitSDK.PlayerState
   public var intentToFrameMs: Swift.Int?
@@ -366,8 +403,35 @@ public struct DebugMetrics {
   public var thumbnailVisible: Swift.Bool
   public var thumbsCachedAhead: Swift.Int
   public var metadataAhead: Swift.Int
+  public var itemStatus: ShortKitSDK.DebugItemStatus
+  public var playerErrorDescription: Swift.String?
+  public var failedItemUrl: Swift.String?
+  public var timeControlStatus: ShortKitSDK.DebugTimeControl
+  public var waitingReason: Swift.String?
+  public var hasCurrentItem: Swift.Bool
+  public var hasPlayerLayer: Swift.Bool?
+  public var isPlaybackBufferEmpty: Swift.Bool
+  public var isPlaybackLikelyToKeepUp: Swift.Bool
+  public var isPlaybackBufferFull: Swift.Bool
+  public var loadedTimeRangesCount: Swift.Int
+  public var loadedTimeRangesEnd: Swift.Double
+  public var poolSlotName: Swift.String?
+  public var poolReservedIndex: Swift.Int?
+  public var segmentServerPort: Swift.UInt16?
   public init(contentId: Swift.String? = nil)
 }
+@objc @_inheritsConvenienceInitializers @_Concurrency.MainActor @preconcurrency final public class DebugPanelView : UIKit.UIView {
+  @_Concurrency.MainActor @preconcurrency public static let panelWidth: CoreFoundation.CGFloat
+  @_Concurrency.MainActor @preconcurrency public static let panelHeight: CoreFoundation.CGFloat
+  @_Concurrency.MainActor @preconcurrency public static let adjacentExpandedHeight: CoreFoundation.CGFloat
+  @_Concurrency.MainActor @preconcurrency public static let diagnosticsExpandedHeight: CoreFoundation.CGFloat
+  @_Concurrency.MainActor @preconcurrency public static let expandedExtraHeight: CoreFoundation.CGFloat
+  @_Concurrency.MainActor @preconcurrency @objc override dynamic public init(frame: CoreFoundation.CGRect)
+  @_Concurrency.MainActor @preconcurrency @objc required dynamic public init?(coder: Foundation.NSCoder)
+  @_Concurrency.MainActor @preconcurrency final public func subscribe(to subject: Combine.CurrentValueSubject<ShortKitSDK.DebugMetrics, Swift.Never>)
+  @_Concurrency.MainActor @preconcurrency final public func subscribeAdjacent(prev: Combine.CurrentValueSubject<ShortKitSDK.DebugMetrics, Swift.Never>, next: Combine.CurrentValueSubject<ShortKitSDK.DebugMetrics, Swift.Never>)
+  @objc deinit
+}
 public enum SwipeCurve : Swift.Int, Swift.CaseIterable {
   case quarticOut
   case quinticOut
@@ -398,17 +462,29 @@ extension ShortKitSDK.ShortKitDelegate {
   public func shortKit(_ shortKit: ShortKitSDK.ShortKit, didTapContent contentId: Swift.String, at index: Swift.Int)
   public func shortKit(_ shortKit: ShortKitSDK.ShortKit, didFetchContentItems items: [ShortKitSDK.ContentItem])
 }
+public enum DownloadPhase : Swift.String, Swift.Sendable {
+  case downloading
+  case compositing
+  case finalizing
+  public init?(rawValue: Swift.String)
+  public typealias RawValue = Swift.String
+  public var rawValue: Swift.String {
+    get
+  }
+}
 public protocol ShortKitDownloadDelegate : AnyObject {
   func shortKit(_ shortKit: ShortKitSDK.ShortKit, didStartDownload item: ShortKitSDK.ContentItem)
   func shortKit(_ shortKit: ShortKitSDK.ShortKit, didUpdateDownloadProgress item: ShortKitSDK.ContentItem, progress: Swift.Double)
   func shortKit(_ shortKit: ShortKitSDK.ShortKit, didCompleteDownload item: ShortKitSDK.ContentItem, fileURL: Foundation.URL)
   func shortKit(_ shortKit: ShortKitSDK.ShortKit, didFailDownload item: ShortKitSDK.ContentItem, error: ShortKitSDK.ShortKitDownloadError)
+  func shortKit(_ shortKit: ShortKitSDK.ShortKit, didUpdateDownloadProgress item: ShortKitSDK.ContentItem, progress: Swift.Double, phase: ShortKitSDK.DownloadPhase)
 }
 extension ShortKitSDK.ShortKitDownloadDelegate {
   public func shortKit(_ shortKit: ShortKitSDK.ShortKit, didStartDownload item: ShortKitSDK.ContentItem)
   public func shortKit(_ shortKit: ShortKitSDK.ShortKit, didUpdateDownloadProgress item: ShortKitSDK.ContentItem, progress: Swift.Double)
   public func shortKit(_ shortKit: ShortKitSDK.ShortKit, didCompleteDownload item: ShortKitSDK.ContentItem, fileURL: Foundation.URL)
   public func shortKit(_ shortKit: ShortKitSDK.ShortKit, didFailDownload item: ShortKitSDK.ContentItem, error: ShortKitSDK.ShortKitDownloadError)
+  public func shortKit(_ shortKit: ShortKitSDK.ShortKit, didUpdateDownloadProgress item: ShortKitSDK.ContentItem, progress: Swift.Double, phase: ShortKitSDK.DownloadPhase)
 }
 public enum DownloadMode {
   case nonInterruptive
@@ -419,12 +495,26 @@ public enum DownloadMode {
     get
   }
 }
-public enum ShortKitDownloadError : Swift.Error {
+public enum DownloadOverlayMode {
+  case none
+  case staticSnapshot(source: any UIKit.UIView & ShortKitSDK.FeedOverlay)
+}
+public protocol ExportableFeedOverlay : AnyObject {
+  func prepareForExport(duration: Foundation.TimeInterval, size: CoreFoundation.CGSize) async
+  func snapshotAtTime(_ time: Foundation.TimeInterval) async -> UIKit.UIImage?
+  func tearDownAfterExport()
+}
+public enum ShortKitDownloadError : Swift.Error, Foundation.LocalizedError {
   case downloadNotAvailable
   case downloadInProgress
   case networkError(any Swift.Error)
   case httpError(statusCode: Swift.Int)
   case cancelled
+  case exportFailed(underlying: any Swift.Error)
+  case overlayNotVisibleForSnapshot
+  public var errorDescription: Swift.String? {
+    get
+  }
 }
 @_hasMissingDesignatedInitializers final public class FeedPreload : @unchecked Swift.Sendable {
   public init(immediateItems items: [ShortKitSDK.FeedInput])
@@ -492,6 +582,7 @@ public enum ShortKitFeedLifecycle {
     @objc get
   }
   @_Concurrency.MainActor @preconcurrency @objc override dynamic public func motionEnded(_ motion: UIKit.UIEvent.EventSubtype, with event: UIKit.UIEvent?)
+  @_Concurrency.MainActor @preconcurrency public func overlayView(forItemId itemId: Swift.String) -> (any UIKit.UIView & ShortKitSDK.FeedOverlay)?
 }
 extension ShortKitSDK.ShortKitFeedViewController : UIKit.UICollectionViewDelegate {
   @_Concurrency.MainActor @preconcurrency @objc dynamic public func collectionView(_ collectionView: UIKit.UICollectionView, willDisplay cell: UIKit.UICollectionViewCell, forItemAt indexPath: Foundation.IndexPath)
@@ -1098,6 +1189,7 @@ final public class ShortKit {
   final public let player: ShortKitSDK.ShortKitPlayer
   final public let carousel: ShortKitSDK.ShortKitCarousel
   final public let debugPanelEnabled: Swift.Bool
+  public static let defaultDebugPanelFactory: (_ active: Combine.CurrentValueSubject<ShortKitSDK.DebugMetrics, Swift.Never>, _ prev: Combine.CurrentValueSubject<ShortKitSDK.DebugMetrics, Swift.Never>, _ next: Combine.CurrentValueSubject<ShortKitSDK.DebugMetrics, Swift.Never>) -> UIKit.UIView
   weak final public var delegate: (any ShortKitSDK.ShortKitDelegate)?
   weak final public var downloadDelegate: (any ShortKitSDK.ShortKitDownloadDelegate)?
   final public var loadingViewProvider: (() -> UIKit.UIView)?
@@ -1109,7 +1201,7 @@ final public class ShortKit {
   final public func clearUserId()
   @_Concurrency.MainActor final public func setColdStartQueue(_ items: [ShortKitSDK.FeedInput])
   final public func clearColdStartCache()
-  final public func downloadVideo(_ item: ShortKitSDK.ContentItem, mode: ShortKitSDK.DownloadMode = .nonInterruptive) async throws -> Foundation.URL
+  final public func downloadVideo(_ item: ShortKitSDK.ContentItem, mode: ShortKitSDK.DownloadMode = .nonInterruptive, overlayMode: ShortKitSDK.DownloadOverlayMode = .none) async throws -> Foundation.URL
   final public func cancelDownload()
   @objc deinit
 }
@@ -1159,6 +1251,7 @@ extension ShortKitSDK.ShortKitPlayerViewController : UIKit.UIViewControllerTrans
 }
 @objc @_hasMissingDesignatedInitializers @_Concurrency.MainActor @preconcurrency final public class ShortKitWidgetViewController : UIKit.UIViewController {
   @_Concurrency.MainActor @preconcurrency final public var feedMask: ShortKitSDK.FeedMaskMode
+  @_Concurrency.MainActor @preconcurrency final public var onCardTap: ((Swift.String, Swift.Int) -> Swift.Void)?
   @_Concurrency.MainActor @preconcurrency public init(shortKit: ShortKitSDK.ShortKit, config: ShortKitSDK.WidgetConfig, items: [ShortKitSDK.WidgetInput] = [])
   @_Concurrency.MainActor @preconcurrency final public func configure(with inputs: [ShortKitSDK.WidgetInput])
   @_Concurrency.MainActor @preconcurrency @objc override final public func viewDidLoad()
@@ -1202,9 +1295,18 @@ extension ShortKitSDK.ScrollAxis : Swift.Hashable {}
 extension ShortKitSDK.ScrollAxis : Swift.RawRepresentable {}
 extension ShortKitSDK.FeedSource : Swift.Hashable {}
 extension ShortKitSDK.FeedSource : Swift.RawRepresentable {}
+extension ShortKitSDK.DebugAlert.Level : Swift.Equatable {}
+extension ShortKitSDK.DebugAlert.Level : Swift.Hashable {}
+extension ShortKitSDK.DebugItemStatus : Swift.Equatable {}
+extension ShortKitSDK.DebugItemStatus : Swift.Hashable {}
+extension ShortKitSDK.DebugTimeControl : Swift.Equatable {}
+extension ShortKitSDK.DebugTimeControl : Swift.Hashable {}
 extension ShortKitSDK.SwipeCurve : Swift.Equatable {}
 extension ShortKitSDK.SwipeCurve : Swift.Hashable {}
 extension ShortKitSDK.SwipeCurve : Swift.RawRepresentable {}
+extension ShortKitSDK.DownloadPhase : Swift.Equatable {}
+extension ShortKitSDK.DownloadPhase : Swift.Hashable {}
+extension ShortKitSDK.DownloadPhase : Swift.RawRepresentable {}
 extension ShortKitSDK.DownloadMode : Swift.Equatable {}
 extension ShortKitSDK.DownloadMode : Swift.Hashable {}
 extension ShortKitSDK.ShortKitFeedView : Swift.Sendable {}

package/ios/ShortKitSDK.xcframework/ios-arm64_x86_64-simulator/ShortKitSDK.framework/_CodeSignature/CodeResources

@@ -10,39 +10,39 @@
 		</data>
 		<key>Info.plist</key>
 		<data>
-		TqCi7bLe/rBk0vusKYg3QCnChjw=
+		c83UUfp8vl8OKNZgemM5Ckeupdw=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.abi.json</key>
 		<data>
-		T24MZRAcHfhIQj9rhCKZ74+fGDk=
+		YIhDAI7GfkS3Bw8cCovcAQ/5bkc=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface</key>
 		<data>
-		/tzpn54Ir12p9mlqhhATlo1kMxk=
+		jVb2+supqwkO14hFF9JSxbmcFUI=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftdoc</key>
 		<data>
-		jfLbEEzmKUw8NgxsDqMv/TI2UHA=
+		FQPcCHhpOilSUl89AxPXIKCLN/E=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftinterface</key>
 		<data>
-		/tzpn54Ir12p9mlqhhATlo1kMxk=
+		jVb2+supqwkO14hFF9JSxbmcFUI=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.abi.json</key>
 		<data>
-		T24MZRAcHfhIQj9rhCKZ74+fGDk=
+		YIhDAI7GfkS3Bw8cCovcAQ/5bkc=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface</key>
 		<data>
-		gMhrjSn1Z4igYb3yHfulqLRscLs=
+		lr+Br5j/UDEGV7GBxg48gH/rncc=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftdoc</key>
 		<data>
-		feB3WtzjYFsaMexcqDUc4JGDFrg=
+		rTbauAd6wfGmUohCAGP+wwgmsNc=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftinterface</key>
 		<data>
-		gMhrjSn1Z4igYb3yHfulqLRscLs=
+		lr+Br5j/UDEGV7GBxg48gH/rncc=
 		</data>
 		<key>Modules/module.modulemap</key>
 		<data>
@@ -66,56 +66,56 @@
 		<dict>
 			<key>hash2</key>
 			<data>
-			uLq+hg2h3SAN1deJqLUnULXrfFwB26PttLnWxmx/cGo=
+			v/uw62M6gyB+9mO/YoZTKs+xDZr5p0ehAwX9vFBOrA0=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			qlEsU4N2hUtQ04us8hP20iPW8Tx3msprPs+sZvdIxQ8=
+			rxdNx/TSUVd/Pd8Fok5Kgwj/fUtUaq0HgqKC4JVJUx0=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftdoc</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			joqbkrgKjhuksU/+u2V6/QkIEKWcA9LxrnASAJZTWsg=
+			khqs3UMVZ5tpEkBvJa5S2d3uTs80aVX+io6b4/TDNPE=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			qlEsU4N2hUtQ04us8hP20iPW8Tx3msprPs+sZvdIxQ8=
+			rxdNx/TSUVd/Pd8Fok5Kgwj/fUtUaq0HgqKC4JVJUx0=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.abi.json</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			uLq+hg2h3SAN1deJqLUnULXrfFwB26PttLnWxmx/cGo=
+			v/uw62M6gyB+9mO/YoZTKs+xDZr5p0ehAwX9vFBOrA0=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			zJA0JThfoDRwFu0/9WzU1O+cmdnkZ3kcOlW0aju3B+k=
+			o9sGqAin0CW2u4q6wc85avBuxWQyEOnzzDME35fQ3ZY=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftdoc</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			ct73W591fp7iumAnIzZPaew7KMArg2zicdfZ4PMWPr8=
+			HACqT0qILr02nDrz4hMSwIx1+67UnBeq1ote6RrUXWs=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			zJA0JThfoDRwFu0/9WzU1O+cmdnkZ3kcOlW0aju3B+k=
+			o9sGqAin0CW2u4q6wc85avBuxWQyEOnzzDME35fQ3ZY=
 			</data>
 		</dict>
 		<key>Modules/module.modulemap</key>

package/ios/ShortKitWidgetNativeView.swift

@@ -25,6 +25,12 @@ import ShortKitSDK
         }
     }
 
+    /// Stable per-instance widget identifier set by the JS wrapper. Echoed
+    /// back on `onWidgetCardTap` events so the JS wrapper can route the
+    /// global emit to the correct `<ShortKitWidget>` instance when more than
+    /// one is mounted simultaneously.
+    @objc public var widgetId: String?
+
     // MARK: - Child VC
 
     private var widgetVC: ShortKitWidgetViewController?
@@ -66,6 +72,23 @@ import ShortKitSDK
         let vc = ShortKitWidgetViewController(shortKit: sdk, config: widgetConfig, items: parsedItems)
         self.widgetVC = vc
 
+        // Wire host-handleable card-tap callback. When the JS wrapper has
+        // an `onCardTap` prop set, it'll have given us a widgetId; we forward
+        // each tap through the bridge with that widgetId so the JS wrapper
+        // can filter to its own instance. The SDK's widget VC, when it sees
+        // a non-nil onCardTap, automatically skips the built-in
+        // `clickAction: .feed` modal-presentation path (see
+        // ShortKitWidgetViewController docs) — host code is fully in charge.
+        if let id = widgetId {
+            vc.onCardTap = { playbackId, index in
+                ShortKitBridge.shared?.emitOnMain("onWidgetCardTap", body: [
+                    "widgetId": id,
+                    "playbackId": playbackId,
+                    "index": index,
+                ])
+            }
+        }
+
         parentVC.addChild(vc)
         vc.view.frame = bounds
         vc.view.autoresizingMask = [.flexibleWidth, .flexibleHeight]

package/ios/ShortKitWidgetNativeViewManager.mm

@@ -23,5 +23,6 @@ RCT_EXPORT_MODULE(ShortKitWidgetView)
 
 RCT_EXPORT_VIEW_PROPERTY(config, NSString)
 RCT_EXPORT_VIEW_PROPERTY(items, NSString)
+RCT_EXPORT_VIEW_PROPERTY(widgetId, NSString)
 
 @end

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shortkitsdk/react-native",
-  "version": "0.2.30",
+  "version": "0.2.32",
   "description": "ShortKit React Native SDK — short-form video feed",
   "react-native": "src/index",
   "source": "src/index",

package/src/ShortKitCommands.ts

@@ -32,7 +32,17 @@ export const ShortKitCommands = {
     NativeShortKitModule?.prefetchStoryboard(playbackId),
   getStoryboardData: (playbackId: string): Promise<string | null> =>
     NativeShortKitModule?.getStoryboardData(playbackId) ?? Promise.resolve(null),
-  downloadVideo: (itemId: string, mode: 'nonInterruptive' | 'interruptive' = 'nonInterruptive'): Promise<string> =>
-    NativeShortKitModule?.downloadVideo(itemId, mode) ?? Promise.reject(new Error('ShortKit not initialized')),
+  downloadVideo: (
+    itemId: string,
+    options?: {
+      mode?: 'interruptive' | 'nonInterruptive';
+      overlayMode?: 'none' | 'static' | 'deterministic';
+    }
+  ): Promise<string> => {
+    const mode = options?.mode ?? 'nonInterruptive';
+    const overlayMode = options?.overlayMode ?? 'none';
+    return NativeShortKitModule?.downloadVideo(itemId, mode, overlayMode)
+      ?? Promise.reject(new Error('ShortKit not initialized'));
+  },
   cancelDownload: () => NativeShortKitModule?.cancelDownload(),
 } as const;