@shortkitsdk/react-native 0.2.30 → 0.2.31

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

@@ -59,6 +59,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 +74,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 +152,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 +339,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 +400,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
@@ -1098,6 +1159,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)?
@@ -1159,6 +1221,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,6 +1265,12 @@ 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 {}

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

@@ -59,6 +59,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 +74,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 +152,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 +339,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 +400,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
@@ -1098,6 +1159,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)?
@@ -1159,6 +1221,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,6 +1265,12 @@ 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 {}

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=
+		PYkIcNDUEgyhTyEpFbDaCBPo+UE=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.abi.json</key>
 		<data>
-		T24MZRAcHfhIQj9rhCKZ74+fGDk=
+		UaBdqrMhIeApH2d1RUSHIj0Zhu8=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface</key>
 		<data>
-		/tzpn54Ir12p9mlqhhATlo1kMxk=
+		8YGTcgWDbl8y4dDSIpll5eJ4obE=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftdoc</key>
 		<data>
-		jfLbEEzmKUw8NgxsDqMv/TI2UHA=
+		lzX6ESVjVhhWPe6DxnX73NDmZxw=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftinterface</key>
 		<data>
-		/tzpn54Ir12p9mlqhhATlo1kMxk=
+		8YGTcgWDbl8y4dDSIpll5eJ4obE=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.abi.json</key>
 		<data>
-		T24MZRAcHfhIQj9rhCKZ74+fGDk=
+		UaBdqrMhIeApH2d1RUSHIj0Zhu8=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface</key>
 		<data>
-		gMhrjSn1Z4igYb3yHfulqLRscLs=
+		H7HRD+aObjI7xoUhzCeaCSiqjmk=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftdoc</key>
 		<data>
-		feB3WtzjYFsaMexcqDUc4JGDFrg=
+		ggGgO2zWeWv56r6SC+RCZNJLMTE=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftinterface</key>
 		<data>
-		gMhrjSn1Z4igYb3yHfulqLRscLs=
+		H7HRD+aObjI7xoUhzCeaCSiqjmk=
 		</data>
 		<key>Modules/module.modulemap</key>
 		<data>
@@ -66,56 +66,56 @@
 		<dict>
 			<key>hash2</key>
 			<data>
-			uLq+hg2h3SAN1deJqLUnULXrfFwB26PttLnWxmx/cGo=
+			1d0XBLVpugO7SBVSLPAAz9em40Jjg3uSJDz2K7kZLt4=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			qlEsU4N2hUtQ04us8hP20iPW8Tx3msprPs+sZvdIxQ8=
+			3D6bnZQIYaJD/ZJLQcVC4KUbwNgvDl/iiBHyIFmY1u8=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftdoc</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			joqbkrgKjhuksU/+u2V6/QkIEKWcA9LxrnASAJZTWsg=
+			CFHa4/rm1ZPInefpRBxbmuzlobIbnb847Q0i2xy1q9A=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			qlEsU4N2hUtQ04us8hP20iPW8Tx3msprPs+sZvdIxQ8=
+			3D6bnZQIYaJD/ZJLQcVC4KUbwNgvDl/iiBHyIFmY1u8=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.abi.json</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			uLq+hg2h3SAN1deJqLUnULXrfFwB26PttLnWxmx/cGo=
+			1d0XBLVpugO7SBVSLPAAz9em40Jjg3uSJDz2K7kZLt4=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			zJA0JThfoDRwFu0/9WzU1O+cmdnkZ3kcOlW0aju3B+k=
+			+RR1yKVxk7eM89sQaZV/Ks3KftiCvYiEXqvAWayvf/s=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftdoc</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			ct73W591fp7iumAnIzZPaew7KMArg2zicdfZ4PMWPr8=
+			ppdE9CD5J+SnQP9npRDKhbCFuonZyTCN1TcUzRTdPfg=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			zJA0JThfoDRwFu0/9WzU1O+cmdnkZ3kcOlW0aju3B+k=
+			+RR1yKVxk7eM89sQaZV/Ks3KftiCvYiEXqvAWayvf/s=
 			</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.31",
   "description": "ShortKit React Native SDK — short-form video feed",
   "react-native": "src/index",
   "source": "src/index",

package/src/ShortKitWidget.tsx

@@ -1,13 +1,21 @@
-import React, { useContext, useLayoutEffect, useMemo } from 'react';
+import React, { useContext, useEffect, useLayoutEffect, useMemo, useRef } from 'react';
 import { View, StyleSheet } from 'react-native';
 import type { ShortKitWidgetProps } from './types';
 import ShortKitWidgetView from './specs/ShortKitWidgetViewNativeComponent';
+import NativeShortKitModule from './specs/NativeShortKitModule';
 import { ShortKitInitContext } from './ShortKitContext';
 import { serializeWidgetConfig } from './serialization';
 import { registerOverlayComponent } from './ShortKitOverlaySurface';
 import { registerCarouselOverlayComponent } from './ShortKitCarouselOverlaySurface';
 import { registerVideoCarouselOverlayComponent } from './ShortKitVideoCarouselOverlaySurface';
 
+// Local UUID generator. We don't pull in a runtime dep just for this; a
+// timestamp + random suffix is more than unique enough to disambiguate
+// concurrently-mounted widgets within a single app session.
+function generateWidgetId(): string {
+  return `widget-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
+}
+
 /**
  * Horizontal carousel widget component. Displays a row of video cards
  * with automatic rotation. Wraps a native Fabric view.
@@ -15,13 +23,36 @@ import { registerVideoCarouselOverlayComponent } from './ShortKitVideoCarouselOv
  * Must be rendered inside a `<ShortKitProvider>`.
  */
 export function ShortKitWidget(props: ShortKitWidgetProps) {
-  const { config, items, style } = props;
+  const { config, items, onCardTap, style } = props;
 
   const isInitialized = useContext(ShortKitInitContext);
   if (!isInitialized) {
     throw new Error('ShortKitWidget must be used within a ShortKitProvider');
   }
 
+  // Stable widget ID for the lifetime of this component, ONLY when the host
+  // wires `onCardTap`. Skipping it when unset means the native side leaves
+  // `widgetVC.onCardTap` nil, which means the SDK's existing
+  // `clickAction: 'feed'` modal-presentation path stays intact for hosts
+  // that don't opt in. Backwards compatible.
+  const widgetId = useMemo(
+    () => (onCardTap ? generateWidgetId() : undefined),
+    // We deliberately compute this once per "host wired callback" lifetime,
+    // not per render. The boolean test on first render is what matters; if
+    // the host swaps onCardTap from set → unset later we keep the same
+    // widgetId (harmless — no events will fire because the JS subscription
+    // below tears down). Going the other way (unset → set), we generate a
+    // fresh id then.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [Boolean(onCardTap)],
+  );
+
+  // Keep a stable ref to the latest onCardTap so the subscription doesn't
+  // need to tear down + rebuild every time the host re-renders with a new
+  // closure identity.
+  const onCardTapRef = useRef(onCardTap);
+  onCardTapRef.current = onCardTap;
+
   useLayoutEffect(() => {
     if (config?.overlay && config.overlay !== 'none') {
       registerOverlayComponent(config.overlay.name, config.overlay.component);
@@ -40,6 +71,19 @@ export function ShortKitWidget(props: ShortKitWidgetProps) {
     }
   }, [config?.overlay, config?.feedConfig]);
 
+  // Subscribe to the global widget-card-tap event, filtered to this
+  // instance's widgetId.
+  useEffect(() => {
+    if (!NativeShortKitModule || !onCardTap) return;
+
+    const subscription = NativeShortKitModule.onWidgetCardTap((event) => {
+      if (event.widgetId !== widgetId) return;
+      onCardTapRef.current?.(event.playbackId, event.index);
+    });
+
+    return () => subscription.remove();
+  }, [widgetId, onCardTap]);
+
   const serializedConfig = useMemo(() => {
     return serializeWidgetConfig(config ?? {});
   }, [config]);
@@ -55,6 +99,7 @@ export function ShortKitWidget(props: ShortKitWidgetProps) {
         style={styles.widget}
         config={serializedConfig}
         items={serializedItems}
+        widgetId={widgetId}
       />
     </View>
   );

package/src/specs/NativeShortKitModule.ts

@@ -127,6 +127,12 @@ type VideoCarouselCellTapEvent = Readonly<{
   pageIndex: Int32;
 }>;
 
+type WidgetCardTapEvent = Readonly<{
+  widgetId: string;
+  playbackId: string;
+  index: Int32;
+}>;
+
 type DownloadStartedEvent = Readonly<{
   itemId: string;
 }>;
@@ -329,6 +335,7 @@ export interface Spec extends TurboModule {
   readonly onDidFetchContentItems: EventEmitter<DidFetchContentItemsEvent>;
   readonly onFeedReady: EventEmitter<FeedReadyEvent>;
   readonly onVideoCarouselCellTap: EventEmitter<VideoCarouselCellTapEvent>;
+  readonly onWidgetCardTap: EventEmitter<WidgetCardTapEvent>;
 
   // --- Overlay per-surface events ---
   readonly onOverlayActiveChanged: EventEmitter<OverlayActiveEvent>;

package/src/specs/ShortKitWidgetViewNativeComponent.ts

@@ -4,6 +4,12 @@ import { codegenNativeComponent } from 'react-native';
 export interface NativeProps extends ViewProps {
   config: string;
   items?: string;
+  /**
+   * Stable per-instance widget identifier. Used to route the global
+   * `NativeShortKitModule.onWidgetCardTap` event back to the originating
+   * `<ShortKitWidget>` when multiple widgets are mounted.
+   */
+  widgetId?: string;
 }
 
 export default codegenNativeComponent<NativeProps>(

package/src/types.ts

@@ -484,6 +484,17 @@ export interface ShortKitWidgetProps {
    * how `<ShortKitFeed feedItems={...} />` works.
    */
   items?: WidgetInput[];
+  /**
+   * Per-card tap callback. When set, the SDK skips the built-in
+   * `clickAction: 'feed'` modal-presentation path and hands the tap to the
+   * host — typically used to push a feed screen via the host's navigator
+   * instead of letting the SDK present a UIKit modal that escapes the host's
+   * navigation hierarchy.
+   *
+   * Mirrors `ShortKitPlayer.onTap`. `clickAction: 'mute'` continues to work
+   * regardless (per-cell mute toggle runs alongside `onCardTap`).
+   */
+  onCardTap?: (playbackId: string, index: number) => void;
   style?: ViewStyle;
 }