@shortkitsdk/react-native 0.2.32 → 0.2.33

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

@@ -243,6 +243,7 @@ public struct FeedConfig : Swift.Codable {
   public var surveyOverlay: ShortKitSDK.SurveyOverlayMode
   public var adOverlay: ShortKitSDK.AdOverlayMode
   public var liveOverlay: ShortKitSDK.LiveOverlayMode
+  public var liveEndedOverlay: ShortKitSDK.LiveEndedOverlayMode
   public var liveRoomMask: ShortKitSDK.LiveRoomMaskMode
   public var muteOnStart: Swift.Bool
   public var autoplay: Swift.Bool
@@ -251,7 +252,7 @@ public struct FeedConfig : Swift.Codable {
   public var pullToRefreshEnabled: Swift.Bool
   public var filter: ShortKitSDK.FeedFilter?
   public var preload: ShortKitSDK.FeedPreload?
-  public init(feedHeight: ShortKitSDK.FeedHeight = .fullscreen, scrollAxis: ShortKitSDK.ScrollAxis = .vertical, videoOverlay: ShortKitSDK.VideoOverlayMode = .none, carouselOverlay: ShortKitSDK.CarouselOverlayMode = .none, videoCarouselOverlay: ShortKitSDK.VideoCarouselOverlayMode = .none, surveyOverlay: ShortKitSDK.SurveyOverlayMode = .none, adOverlay: ShortKitSDK.AdOverlayMode = .none, liveOverlay: ShortKitSDK.LiveOverlayMode = .default, liveRoomMask: ShortKitSDK.LiveRoomMaskMode = .none, muteOnStart: Swift.Bool = true, autoplay: Swift.Bool = true, feedSource: ShortKitSDK.FeedSource = .algorithmic, coldStartEnabled: Swift.Bool = false, pullToRefreshEnabled: Swift.Bool = true, filter: ShortKitSDK.FeedFilter? = nil, preload: ShortKitSDK.FeedPreload? = nil)
+  public init(feedHeight: ShortKitSDK.FeedHeight = .fullscreen, scrollAxis: ShortKitSDK.ScrollAxis = .vertical, videoOverlay: ShortKitSDK.VideoOverlayMode = .none, carouselOverlay: ShortKitSDK.CarouselOverlayMode = .none, videoCarouselOverlay: ShortKitSDK.VideoCarouselOverlayMode = .none, surveyOverlay: ShortKitSDK.SurveyOverlayMode = .none, adOverlay: ShortKitSDK.AdOverlayMode = .none, liveOverlay: ShortKitSDK.LiveOverlayMode = .default, liveEndedOverlay: ShortKitSDK.LiveEndedOverlayMode = .default, liveRoomMask: ShortKitSDK.LiveRoomMaskMode = .none, muteOnStart: Swift.Bool = true, autoplay: Swift.Bool = true, feedSource: ShortKitSDK.FeedSource = .algorithmic, coldStartEnabled: Swift.Bool = false, pullToRefreshEnabled: Swift.Bool = true, filter: ShortKitSDK.FeedFilter? = nil, preload: ShortKitSDK.FeedPreload? = nil)
   public init(from decoder: any Swift.Decoder) throws
   public func encode(to encoder: any Swift.Encoder) throws
 }
@@ -342,6 +343,20 @@ extension ShortKitSDK.LiveOverlayMode : Swift.Codable {
   public init(from decoder: any Swift.Decoder) throws
   public func encode(to encoder: any Swift.Encoder) throws
 }
+public enum LiveEndedOverlayMode {
+  case `default`
+  case custom(@Sendable () -> any UIKit.UIView & ShortKitSDK.LiveEndedOverlay)
+}
+extension ShortKitSDK.LiveEndedOverlayMode {
+  public static func swiftUI<Content>(@SwiftUICore.ViewBuilder content: @escaping @Sendable (ShortKitSDK.ContentItem) -> Content) -> ShortKitSDK.LiveEndedOverlayMode where Content : SwiftUICore.View
+}
+extension ShortKitSDK.LiveEndedOverlayMode : Swift.Equatable {
+  public static func == (lhs: ShortKitSDK.LiveEndedOverlayMode, rhs: ShortKitSDK.LiveEndedOverlayMode) -> Swift.Bool
+}
+extension ShortKitSDK.LiveEndedOverlayMode : 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
@@ -604,6 +619,9 @@ extension ShortKitSDK.ShortKitFeedViewController : ShortKitSDK.ShortKitAdDelegat
   @_Concurrency.MainActor @preconcurrency public func adDidFail(_ ad: ShortKitSDK.PreparedAd, error: ShortKitSDK.AdError)
   @_Concurrency.MainActor @preconcurrency public func adDidReceiveClick(_ ad: ShortKitSDK.PreparedAd)
 }
+public protocol LiveEndedOverlay : AnyObject {
+  func configure(with item: ShortKitSDK.ContentItem)
+}
 public enum SeedThumbnailResolver {
   public static func resolveFromMemory(url: Swift.String) -> UIKit.UIImage?
 }
@@ -702,8 +720,9 @@ public struct ContentItem : Swift.Codable, Swift.Equatable, @unchecked Swift.Sen
   public var liveStreamId: Swift.String?
   public var liveStreamStatus: ShortKitSDK.LiveStreamStatus?
   public var startedAt: Swift.String?
+  public var endedAt: Swift.String?
   public var currentViewers: Swift.Int
-  public init(id: Swift.String, playbackId: Swift.String? = nil, title: Swift.String, description: Swift.String? = nil, duration: Swift.Double, streamingUrl: Swift.String, thumbnailUrl: Swift.String, captionTracks: [ShortKitSDK.CaptionTrack] = [], customMetadata: [Swift.String : ShortKitSDK.JSONValue]? = nil, author: Swift.String? = nil, articleUrl: Swift.String? = nil, commentCount: Swift.Int? = nil, fallbackUrl: Swift.String? = nil, downloadUrl: Swift.String? = nil, isLive: Swift.Bool = false, liveStreamId: Swift.String? = nil, liveStreamStatus: ShortKitSDK.LiveStreamStatus? = nil, startedAt: Swift.String? = nil, currentViewers: Swift.Int = 0)
+  public init(id: Swift.String, playbackId: Swift.String? = nil, title: Swift.String, description: Swift.String? = nil, duration: Swift.Double, streamingUrl: Swift.String, thumbnailUrl: Swift.String, captionTracks: [ShortKitSDK.CaptionTrack] = [], customMetadata: [Swift.String : ShortKitSDK.JSONValue]? = nil, author: Swift.String? = nil, articleUrl: Swift.String? = nil, commentCount: Swift.Int? = nil, fallbackUrl: Swift.String? = nil, downloadUrl: Swift.String? = nil, isLive: Swift.Bool = false, liveStreamId: Swift.String? = nil, liveStreamStatus: ShortKitSDK.LiveStreamStatus? = nil, startedAt: Swift.String? = nil, endedAt: Swift.String? = nil, currentViewers: Swift.Int = 0)
   public init(from decoder: any Swift.Decoder) throws
   public static func == (a: ShortKitSDK.ContentItem, b: ShortKitSDK.ContentItem) -> Swift.Bool
   public func encode(to encoder: any Swift.Encoder) throws
@@ -1193,7 +1212,7 @@ final public class ShortKit {
   weak final public var delegate: (any ShortKitSDK.ShortKitDelegate)?
   weak final public var downloadDelegate: (any ShortKitSDK.ShortKitDownloadDelegate)?
   final public var loadingViewProvider: (() -> UIKit.UIView)?
-  public init(apiKey: Swift.String, userId: Swift.String? = nil, adProvider: (any ShortKitSDK.ShortKitAdProvider)? = nil, clientAppName: Swift.String? = nil, clientAppVersion: Swift.String? = nil, customDimensions: [Swift.String : Swift.String]? = nil, loadingViewProvider: (() -> UIKit.UIView)? = nil, debugPanelEnabled: Swift.Bool = false, serverTracingEnabled: Swift.Bool = false, consoleTracingEnabled: Swift.Bool = false)
+  public init(apiKey: Swift.String, userId: Swift.String? = nil, adProvider: (any ShortKitSDK.ShortKitAdProvider)? = nil, clientAppName: Swift.String? = nil, clientAppVersion: Swift.String? = nil, customDimensions: [Swift.String : Swift.String]? = nil, loadingViewProvider: (() -> UIKit.UIView)? = nil, debugPanelEnabled: Swift.Bool = false, serverTracingEnabled: Swift.Bool = false, consoleTracingEnabled: Swift.Bool = false, poolDebugEnabled: Swift.Bool = false)
   final public func preloadFeed(filter: ShortKitSDK.FeedFilter? = nil, limit: Swift.Int = 10) -> ShortKitSDK.FeedPreload
   final public func preloadFeed(items: [ShortKitSDK.FeedInput]) -> ShortKitSDK.FeedPreload
   final public func fetchContent(limit: Swift.Int = 10, filter: ShortKitSDK.FeedFilter? = nil) async throws -> [ShortKitSDK.ContentItem]
@@ -1223,7 +1242,13 @@ public struct PlayerConfig {
   public var muteOnStart: Swift.Bool
   public var videoOverlay: ShortKitSDK.VideoOverlayMode
   public var feedConfig: ShortKitSDK.FeedConfig
-  public init(cornerRadius: CoreFoundation.CGFloat = 12, clickAction: ShortKitSDK.PlayerClickAction = .feed, autoplay: Swift.Bool = true, loop: Swift.Bool = true, muteOnStart: Swift.Bool = true, videoOverlay: ShortKitSDK.VideoOverlayMode = .none, feedConfig: ShortKitSDK.FeedConfig = FeedConfig())
+  public var previewMode: ShortKitSDK.PlayerConfig.PreviewMode
+  public enum PreviewMode : Swift.Equatable, Swift.Sendable {
+    case full
+    case instantClip(seconds: Foundation.TimeInterval)
+    public static func == (a: ShortKitSDK.PlayerConfig.PreviewMode, b: ShortKitSDK.PlayerConfig.PreviewMode) -> Swift.Bool
+  }
+  public init(cornerRadius: CoreFoundation.CGFloat = 12, clickAction: ShortKitSDK.PlayerClickAction = .feed, autoplay: Swift.Bool = true, loop: Swift.Bool = true, muteOnStart: Swift.Bool = true, videoOverlay: ShortKitSDK.VideoOverlayMode = .none, feedConfig: ShortKitSDK.FeedConfig = FeedConfig(), previewMode: ShortKitSDK.PlayerConfig.PreviewMode = .full)
 }
 @_Concurrency.MainActor @preconcurrency public struct ShortKitPlayerView : SwiftUI.UIViewControllerRepresentable {
   @_Concurrency.MainActor @preconcurrency public init(shortKit: ShortKitSDK.ShortKit, config: ShortKitSDK.PlayerConfig = PlayerConfig())
@@ -1235,11 +1260,13 @@ public struct PlayerConfig {
 }
 @objc @_hasMissingDesignatedInitializers @_Concurrency.MainActor @preconcurrency final public class ShortKitPlayerViewController : UIKit.UIViewController {
   @_Concurrency.MainActor @preconcurrency final public var feedMask: ShortKitSDK.FeedMaskMode
+  @_Concurrency.MainActor @preconcurrency final public var onPreviewCompleted: (() -> Swift.Void)?
   @_Concurrency.MainActor @preconcurrency public init(shortKit: ShortKitSDK.ShortKit, config: ShortKitSDK.PlayerConfig)
   @_Concurrency.MainActor @preconcurrency @objc override final public func viewDidLoad()
   @_Concurrency.MainActor @preconcurrency @objc override final public func viewWillDisappear(_ animated: Swift.Bool)
   @_Concurrency.MainActor @preconcurrency @objc override final public func viewDidLayoutSubviews()
   @_Concurrency.MainActor @preconcurrency final public func configure(with contentItem: ShortKitSDK.ContentItem)
+  @_Concurrency.MainActor @preconcurrency final public func setFeedItems(_ inputs: [ShortKitSDK.FeedInput])
   @_Concurrency.MainActor @preconcurrency final public func activate()
   @_Concurrency.MainActor @preconcurrency final public func deactivate()
   @objc deinit
@@ -1252,8 +1279,13 @@ 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 final public var active: Swift.Bool {
+    get
+    set
+  }
   @_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 final public func setFeedItems(_ inputs: [ShortKitSDK.FeedInput])
   @_Concurrency.MainActor @preconcurrency @objc override final public func viewDidLoad()
   @_Concurrency.MainActor @preconcurrency @objc override final public func viewDidAppear(_ animated: Swift.Bool)
   @_Concurrency.MainActor @preconcurrency @objc override final public func viewWillDisappear(_ animated: Swift.Bool)
@@ -1271,6 +1303,15 @@ extension ShortKitSDK.ShortKitWidgetViewController : UIKit.UIViewControllerTrans
   @_Concurrency.MainActor @preconcurrency @objc final public func animationController(forDismissed dismissed: UIKit.UIViewController) -> (any UIKit.UIViewControllerAnimatedTransitioning)?
   @_Concurrency.MainActor @preconcurrency @objc final public func interactionControllerForDismissal(using animator: any UIKit.UIViewControllerAnimatedTransitioning) -> (any UIKit.UIViewControllerInteractiveTransitioning)?
 }
+public enum WidgetPlaybackMode : Swift.Equatable, Swift.Sendable {
+  case singleVisibleRotating
+  case allVisibleSimultaneous
+  public static func == (a: ShortKitSDK.WidgetPlaybackMode, b: ShortKitSDK.WidgetPlaybackMode) -> Swift.Bool
+  public func hash(into hasher: inout Swift.Hasher)
+  public var hashValue: Swift.Int {
+    get
+  }
+}
 public struct WidgetConfig {
   public var cardCount: Swift.Int
   public var cardSpacing: CoreFoundation.CGFloat
@@ -1283,7 +1324,9 @@ public struct WidgetConfig {
   public var cardOverlay: ShortKitSDK.VideoOverlayMode
   public var feedConfig: ShortKitSDK.FeedConfig
   public var filter: ShortKitSDK.FeedFilter?
-  public init(cardCount: Swift.Int = 3, cardSpacing: CoreFoundation.CGFloat = 8, cornerRadius: CoreFoundation.CGFloat = 12, autoplay: Swift.Bool = true, muteOnStart: Swift.Bool = true, loop: Swift.Bool = true, rotationInterval: Foundation.TimeInterval = 10, clickAction: ShortKitSDK.PlayerClickAction = .feed, cardOverlay: ShortKitSDK.VideoOverlayMode = .none, feedConfig: ShortKitSDK.FeedConfig = FeedConfig(), filter: ShortKitSDK.FeedFilter? = nil)
+  public var playbackMode: ShortKitSDK.WidgetPlaybackMode
+  public var previewDuration: Foundation.TimeInterval
+  public init(cardCount: Swift.Int = 3, cardSpacing: CoreFoundation.CGFloat = 8, cornerRadius: CoreFoundation.CGFloat = 12, autoplay: Swift.Bool = true, muteOnStart: Swift.Bool = true, loop: Swift.Bool = true, rotationInterval: Foundation.TimeInterval = 10, clickAction: ShortKitSDK.PlayerClickAction = .feed, cardOverlay: ShortKitSDK.VideoOverlayMode = .none, feedConfig: ShortKitSDK.FeedConfig = FeedConfig(), filter: ShortKitSDK.FeedFilter? = nil, playbackMode: ShortKitSDK.WidgetPlaybackMode = .singleVisibleRotating, previewDuration: Foundation.TimeInterval = 5.0)
   public func resolvedFeedConfig() -> ShortKitSDK.FeedConfig
 }
 public enum WidgetInput : Swift.Sendable {
@@ -1328,3 +1371,4 @@ extension ShortKitSDK.ContentSignal : Swift.Hashable {}
 extension ShortKitSDK.PlayerClickAction : Swift.Equatable {}
 extension ShortKitSDK.PlayerClickAction : Swift.Hashable {}
 extension ShortKitSDK.ShortKitPlayerView : Swift.Sendable {}
+extension ShortKitSDK.WidgetPlaybackMode : Swift.Hashable {}

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

@@ -243,6 +243,7 @@ public struct FeedConfig : Swift.Codable {
   public var surveyOverlay: ShortKitSDK.SurveyOverlayMode
   public var adOverlay: ShortKitSDK.AdOverlayMode
   public var liveOverlay: ShortKitSDK.LiveOverlayMode
+  public var liveEndedOverlay: ShortKitSDK.LiveEndedOverlayMode
   public var liveRoomMask: ShortKitSDK.LiveRoomMaskMode
   public var muteOnStart: Swift.Bool
   public var autoplay: Swift.Bool
@@ -251,7 +252,7 @@ public struct FeedConfig : Swift.Codable {
   public var pullToRefreshEnabled: Swift.Bool
   public var filter: ShortKitSDK.FeedFilter?
   public var preload: ShortKitSDK.FeedPreload?
-  public init(feedHeight: ShortKitSDK.FeedHeight = .fullscreen, scrollAxis: ShortKitSDK.ScrollAxis = .vertical, videoOverlay: ShortKitSDK.VideoOverlayMode = .none, carouselOverlay: ShortKitSDK.CarouselOverlayMode = .none, videoCarouselOverlay: ShortKitSDK.VideoCarouselOverlayMode = .none, surveyOverlay: ShortKitSDK.SurveyOverlayMode = .none, adOverlay: ShortKitSDK.AdOverlayMode = .none, liveOverlay: ShortKitSDK.LiveOverlayMode = .default, liveRoomMask: ShortKitSDK.LiveRoomMaskMode = .none, muteOnStart: Swift.Bool = true, autoplay: Swift.Bool = true, feedSource: ShortKitSDK.FeedSource = .algorithmic, coldStartEnabled: Swift.Bool = false, pullToRefreshEnabled: Swift.Bool = true, filter: ShortKitSDK.FeedFilter? = nil, preload: ShortKitSDK.FeedPreload? = nil)
+  public init(feedHeight: ShortKitSDK.FeedHeight = .fullscreen, scrollAxis: ShortKitSDK.ScrollAxis = .vertical, videoOverlay: ShortKitSDK.VideoOverlayMode = .none, carouselOverlay: ShortKitSDK.CarouselOverlayMode = .none, videoCarouselOverlay: ShortKitSDK.VideoCarouselOverlayMode = .none, surveyOverlay: ShortKitSDK.SurveyOverlayMode = .none, adOverlay: ShortKitSDK.AdOverlayMode = .none, liveOverlay: ShortKitSDK.LiveOverlayMode = .default, liveEndedOverlay: ShortKitSDK.LiveEndedOverlayMode = .default, liveRoomMask: ShortKitSDK.LiveRoomMaskMode = .none, muteOnStart: Swift.Bool = true, autoplay: Swift.Bool = true, feedSource: ShortKitSDK.FeedSource = .algorithmic, coldStartEnabled: Swift.Bool = false, pullToRefreshEnabled: Swift.Bool = true, filter: ShortKitSDK.FeedFilter? = nil, preload: ShortKitSDK.FeedPreload? = nil)
   public init(from decoder: any Swift.Decoder) throws
   public func encode(to encoder: any Swift.Encoder) throws
 }
@@ -342,6 +343,20 @@ extension ShortKitSDK.LiveOverlayMode : Swift.Codable {
   public init(from decoder: any Swift.Decoder) throws
   public func encode(to encoder: any Swift.Encoder) throws
 }
+public enum LiveEndedOverlayMode {
+  case `default`
+  case custom(@Sendable () -> any UIKit.UIView & ShortKitSDK.LiveEndedOverlay)
+}
+extension ShortKitSDK.LiveEndedOverlayMode {
+  public static func swiftUI<Content>(@SwiftUICore.ViewBuilder content: @escaping @Sendable (ShortKitSDK.ContentItem) -> Content) -> ShortKitSDK.LiveEndedOverlayMode where Content : SwiftUICore.View
+}
+extension ShortKitSDK.LiveEndedOverlayMode : Swift.Equatable {
+  public static func == (lhs: ShortKitSDK.LiveEndedOverlayMode, rhs: ShortKitSDK.LiveEndedOverlayMode) -> Swift.Bool
+}
+extension ShortKitSDK.LiveEndedOverlayMode : 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
@@ -604,6 +619,9 @@ extension ShortKitSDK.ShortKitFeedViewController : ShortKitSDK.ShortKitAdDelegat
   @_Concurrency.MainActor @preconcurrency public func adDidFail(_ ad: ShortKitSDK.PreparedAd, error: ShortKitSDK.AdError)
   @_Concurrency.MainActor @preconcurrency public func adDidReceiveClick(_ ad: ShortKitSDK.PreparedAd)
 }
+public protocol LiveEndedOverlay : AnyObject {
+  func configure(with item: ShortKitSDK.ContentItem)
+}
 public enum SeedThumbnailResolver {
   public static func resolveFromMemory(url: Swift.String) -> UIKit.UIImage?
 }
@@ -702,8 +720,9 @@ public struct ContentItem : Swift.Codable, Swift.Equatable, @unchecked Swift.Sen
   public var liveStreamId: Swift.String?
   public var liveStreamStatus: ShortKitSDK.LiveStreamStatus?
   public var startedAt: Swift.String?
+  public var endedAt: Swift.String?
   public var currentViewers: Swift.Int
-  public init(id: Swift.String, playbackId: Swift.String? = nil, title: Swift.String, description: Swift.String? = nil, duration: Swift.Double, streamingUrl: Swift.String, thumbnailUrl: Swift.String, captionTracks: [ShortKitSDK.CaptionTrack] = [], customMetadata: [Swift.String : ShortKitSDK.JSONValue]? = nil, author: Swift.String? = nil, articleUrl: Swift.String? = nil, commentCount: Swift.Int? = nil, fallbackUrl: Swift.String? = nil, downloadUrl: Swift.String? = nil, isLive: Swift.Bool = false, liveStreamId: Swift.String? = nil, liveStreamStatus: ShortKitSDK.LiveStreamStatus? = nil, startedAt: Swift.String? = nil, currentViewers: Swift.Int = 0)
+  public init(id: Swift.String, playbackId: Swift.String? = nil, title: Swift.String, description: Swift.String? = nil, duration: Swift.Double, streamingUrl: Swift.String, thumbnailUrl: Swift.String, captionTracks: [ShortKitSDK.CaptionTrack] = [], customMetadata: [Swift.String : ShortKitSDK.JSONValue]? = nil, author: Swift.String? = nil, articleUrl: Swift.String? = nil, commentCount: Swift.Int? = nil, fallbackUrl: Swift.String? = nil, downloadUrl: Swift.String? = nil, isLive: Swift.Bool = false, liveStreamId: Swift.String? = nil, liveStreamStatus: ShortKitSDK.LiveStreamStatus? = nil, startedAt: Swift.String? = nil, endedAt: Swift.String? = nil, currentViewers: Swift.Int = 0)
   public init(from decoder: any Swift.Decoder) throws
   public static func == (a: ShortKitSDK.ContentItem, b: ShortKitSDK.ContentItem) -> Swift.Bool
   public func encode(to encoder: any Swift.Encoder) throws
@@ -1193,7 +1212,7 @@ final public class ShortKit {
   weak final public var delegate: (any ShortKitSDK.ShortKitDelegate)?
   weak final public var downloadDelegate: (any ShortKitSDK.ShortKitDownloadDelegate)?
   final public var loadingViewProvider: (() -> UIKit.UIView)?
-  public init(apiKey: Swift.String, userId: Swift.String? = nil, adProvider: (any ShortKitSDK.ShortKitAdProvider)? = nil, clientAppName: Swift.String? = nil, clientAppVersion: Swift.String? = nil, customDimensions: [Swift.String : Swift.String]? = nil, loadingViewProvider: (() -> UIKit.UIView)? = nil, debugPanelEnabled: Swift.Bool = false, serverTracingEnabled: Swift.Bool = false, consoleTracingEnabled: Swift.Bool = false)
+  public init(apiKey: Swift.String, userId: Swift.String? = nil, adProvider: (any ShortKitSDK.ShortKitAdProvider)? = nil, clientAppName: Swift.String? = nil, clientAppVersion: Swift.String? = nil, customDimensions: [Swift.String : Swift.String]? = nil, loadingViewProvider: (() -> UIKit.UIView)? = nil, debugPanelEnabled: Swift.Bool = false, serverTracingEnabled: Swift.Bool = false, consoleTracingEnabled: Swift.Bool = false, poolDebugEnabled: Swift.Bool = false)
   final public func preloadFeed(filter: ShortKitSDK.FeedFilter? = nil, limit: Swift.Int = 10) -> ShortKitSDK.FeedPreload
   final public func preloadFeed(items: [ShortKitSDK.FeedInput]) -> ShortKitSDK.FeedPreload
   final public func fetchContent(limit: Swift.Int = 10, filter: ShortKitSDK.FeedFilter? = nil) async throws -> [ShortKitSDK.ContentItem]
@@ -1223,7 +1242,13 @@ public struct PlayerConfig {
   public var muteOnStart: Swift.Bool
   public var videoOverlay: ShortKitSDK.VideoOverlayMode
   public var feedConfig: ShortKitSDK.FeedConfig
-  public init(cornerRadius: CoreFoundation.CGFloat = 12, clickAction: ShortKitSDK.PlayerClickAction = .feed, autoplay: Swift.Bool = true, loop: Swift.Bool = true, muteOnStart: Swift.Bool = true, videoOverlay: ShortKitSDK.VideoOverlayMode = .none, feedConfig: ShortKitSDK.FeedConfig = FeedConfig())
+  public var previewMode: ShortKitSDK.PlayerConfig.PreviewMode
+  public enum PreviewMode : Swift.Equatable, Swift.Sendable {
+    case full
+    case instantClip(seconds: Foundation.TimeInterval)
+    public static func == (a: ShortKitSDK.PlayerConfig.PreviewMode, b: ShortKitSDK.PlayerConfig.PreviewMode) -> Swift.Bool
+  }
+  public init(cornerRadius: CoreFoundation.CGFloat = 12, clickAction: ShortKitSDK.PlayerClickAction = .feed, autoplay: Swift.Bool = true, loop: Swift.Bool = true, muteOnStart: Swift.Bool = true, videoOverlay: ShortKitSDK.VideoOverlayMode = .none, feedConfig: ShortKitSDK.FeedConfig = FeedConfig(), previewMode: ShortKitSDK.PlayerConfig.PreviewMode = .full)
 }
 @_Concurrency.MainActor @preconcurrency public struct ShortKitPlayerView : SwiftUI.UIViewControllerRepresentable {
   @_Concurrency.MainActor @preconcurrency public init(shortKit: ShortKitSDK.ShortKit, config: ShortKitSDK.PlayerConfig = PlayerConfig())
@@ -1235,11 +1260,13 @@ public struct PlayerConfig {
 }
 @objc @_hasMissingDesignatedInitializers @_Concurrency.MainActor @preconcurrency final public class ShortKitPlayerViewController : UIKit.UIViewController {
   @_Concurrency.MainActor @preconcurrency final public var feedMask: ShortKitSDK.FeedMaskMode
+  @_Concurrency.MainActor @preconcurrency final public var onPreviewCompleted: (() -> Swift.Void)?
   @_Concurrency.MainActor @preconcurrency public init(shortKit: ShortKitSDK.ShortKit, config: ShortKitSDK.PlayerConfig)
   @_Concurrency.MainActor @preconcurrency @objc override final public func viewDidLoad()
   @_Concurrency.MainActor @preconcurrency @objc override final public func viewWillDisappear(_ animated: Swift.Bool)
   @_Concurrency.MainActor @preconcurrency @objc override final public func viewDidLayoutSubviews()
   @_Concurrency.MainActor @preconcurrency final public func configure(with contentItem: ShortKitSDK.ContentItem)
+  @_Concurrency.MainActor @preconcurrency final public func setFeedItems(_ inputs: [ShortKitSDK.FeedInput])
   @_Concurrency.MainActor @preconcurrency final public func activate()
   @_Concurrency.MainActor @preconcurrency final public func deactivate()
   @objc deinit
@@ -1252,8 +1279,13 @@ 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 final public var active: Swift.Bool {
+    get
+    set
+  }
   @_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 final public func setFeedItems(_ inputs: [ShortKitSDK.FeedInput])
   @_Concurrency.MainActor @preconcurrency @objc override final public func viewDidLoad()
   @_Concurrency.MainActor @preconcurrency @objc override final public func viewDidAppear(_ animated: Swift.Bool)
   @_Concurrency.MainActor @preconcurrency @objc override final public func viewWillDisappear(_ animated: Swift.Bool)
@@ -1271,6 +1303,15 @@ extension ShortKitSDK.ShortKitWidgetViewController : UIKit.UIViewControllerTrans
   @_Concurrency.MainActor @preconcurrency @objc final public func animationController(forDismissed dismissed: UIKit.UIViewController) -> (any UIKit.UIViewControllerAnimatedTransitioning)?
   @_Concurrency.MainActor @preconcurrency @objc final public func interactionControllerForDismissal(using animator: any UIKit.UIViewControllerAnimatedTransitioning) -> (any UIKit.UIViewControllerInteractiveTransitioning)?
 }
+public enum WidgetPlaybackMode : Swift.Equatable, Swift.Sendable {
+  case singleVisibleRotating
+  case allVisibleSimultaneous
+  public static func == (a: ShortKitSDK.WidgetPlaybackMode, b: ShortKitSDK.WidgetPlaybackMode) -> Swift.Bool
+  public func hash(into hasher: inout Swift.Hasher)
+  public var hashValue: Swift.Int {
+    get
+  }
+}
 public struct WidgetConfig {
   public var cardCount: Swift.Int
   public var cardSpacing: CoreFoundation.CGFloat
@@ -1283,7 +1324,9 @@ public struct WidgetConfig {
   public var cardOverlay: ShortKitSDK.VideoOverlayMode
   public var feedConfig: ShortKitSDK.FeedConfig
   public var filter: ShortKitSDK.FeedFilter?
-  public init(cardCount: Swift.Int = 3, cardSpacing: CoreFoundation.CGFloat = 8, cornerRadius: CoreFoundation.CGFloat = 12, autoplay: Swift.Bool = true, muteOnStart: Swift.Bool = true, loop: Swift.Bool = true, rotationInterval: Foundation.TimeInterval = 10, clickAction: ShortKitSDK.PlayerClickAction = .feed, cardOverlay: ShortKitSDK.VideoOverlayMode = .none, feedConfig: ShortKitSDK.FeedConfig = FeedConfig(), filter: ShortKitSDK.FeedFilter? = nil)
+  public var playbackMode: ShortKitSDK.WidgetPlaybackMode
+  public var previewDuration: Foundation.TimeInterval
+  public init(cardCount: Swift.Int = 3, cardSpacing: CoreFoundation.CGFloat = 8, cornerRadius: CoreFoundation.CGFloat = 12, autoplay: Swift.Bool = true, muteOnStart: Swift.Bool = true, loop: Swift.Bool = true, rotationInterval: Foundation.TimeInterval = 10, clickAction: ShortKitSDK.PlayerClickAction = .feed, cardOverlay: ShortKitSDK.VideoOverlayMode = .none, feedConfig: ShortKitSDK.FeedConfig = FeedConfig(), filter: ShortKitSDK.FeedFilter? = nil, playbackMode: ShortKitSDK.WidgetPlaybackMode = .singleVisibleRotating, previewDuration: Foundation.TimeInterval = 5.0)
   public func resolvedFeedConfig() -> ShortKitSDK.FeedConfig
 }
 public enum WidgetInput : Swift.Sendable {
@@ -1328,3 +1371,4 @@ extension ShortKitSDK.ContentSignal : Swift.Hashable {}
 extension ShortKitSDK.PlayerClickAction : Swift.Equatable {}
 extension ShortKitSDK.PlayerClickAction : Swift.Hashable {}
 extension ShortKitSDK.ShortKitPlayerView : Swift.Sendable {}
+extension ShortKitSDK.WidgetPlaybackMode : Swift.Hashable {}

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

@@ -10,39 +10,39 @@
 		</data>
 		<key>Info.plist</key>
 		<data>
-		c83UUfp8vl8OKNZgemM5Ckeupdw=
+		n0YLuilzX/YSi0+YLLdVwkcv7iY=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.abi.json</key>
 		<data>
-		YIhDAI7GfkS3Bw8cCovcAQ/5bkc=
+		bMjJDoSuuCRYFpWH3EhlvZ0CS50=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface</key>
 		<data>
-		jVb2+supqwkO14hFF9JSxbmcFUI=
+		v3GW9Gub1dJiosTgJ/z5NwmgWnY=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftdoc</key>
 		<data>
-		FQPcCHhpOilSUl89AxPXIKCLN/E=
+		0oQnp4oNo+Ztwgww53FIZhz0zfM=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftinterface</key>
 		<data>
-		jVb2+supqwkO14hFF9JSxbmcFUI=
+		v3GW9Gub1dJiosTgJ/z5NwmgWnY=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.abi.json</key>
 		<data>
-		YIhDAI7GfkS3Bw8cCovcAQ/5bkc=
+		bMjJDoSuuCRYFpWH3EhlvZ0CS50=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface</key>
 		<data>
-		lr+Br5j/UDEGV7GBxg48gH/rncc=
+		Duv2bgxehsG2ZV4wnlh7s8/WzFk=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftdoc</key>
 		<data>
-		rTbauAd6wfGmUohCAGP+wwgmsNc=
+		Cu/J3KUQmcbxz8bCf9NQZ5aVBTM=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftinterface</key>
 		<data>
-		lr+Br5j/UDEGV7GBxg48gH/rncc=
+		Duv2bgxehsG2ZV4wnlh7s8/WzFk=
 		</data>
 		<key>Modules/module.modulemap</key>
 		<data>
@@ -66,56 +66,56 @@
 		<dict>
 			<key>hash2</key>
 			<data>
-			v/uw62M6gyB+9mO/YoZTKs+xDZr5p0ehAwX9vFBOrA0=
+			G1RQHMm3BbfBLq07m9FgoUDszw3xw2Qb1+b9K0VYrr4=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			rxdNx/TSUVd/Pd8Fok5Kgwj/fUtUaq0HgqKC4JVJUx0=
+			HHpbkQ91Av7qOwHoz6asjSQ4d9TzPj7Lg+sxPVOhA30=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftdoc</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			khqs3UMVZ5tpEkBvJa5S2d3uTs80aVX+io6b4/TDNPE=
+			pbR9S11lEANUEhT1e5NkK796Tecps3q6SosOoeuApuQ=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			rxdNx/TSUVd/Pd8Fok5Kgwj/fUtUaq0HgqKC4JVJUx0=
+			HHpbkQ91Av7qOwHoz6asjSQ4d9TzPj7Lg+sxPVOhA30=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.abi.json</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			v/uw62M6gyB+9mO/YoZTKs+xDZr5p0ehAwX9vFBOrA0=
+			G1RQHMm3BbfBLq07m9FgoUDszw3xw2Qb1+b9K0VYrr4=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			o9sGqAin0CW2u4q6wc85avBuxWQyEOnzzDME35fQ3ZY=
+			6nFBIiTjaP5xmdLc7I/x9j4ASiT2UjNnxKmRYUGmLXw=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftdoc</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			HACqT0qILr02nDrz4hMSwIx1+67UnBeq1ote6RrUXWs=
+			Yx9LmEqOq+aeF+mSiKZyfw0FW/BySAPRrQMVzDyEiUU=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			o9sGqAin0CW2u4q6wc85avBuxWQyEOnzzDME35fQ3ZY=
+			6nFBIiTjaP5xmdLc7I/x9j4ASiT2UjNnxKmRYUGmLXw=
 			</data>
 		</dict>
 		<key>Modules/module.modulemap</key>

package/ios/ShortKitWidgetNativeView.swift

@@ -31,11 +31,40 @@ import ShortKitSDK
     /// one is mounted simultaneously.
     @objc public var widgetId: String?
 
+    /// Mirrors `ShortKitWidgetViewController.active`. Hosts use this to
+    /// release the widget's pool tile when it shouldn't be playing
+    /// (e.g. inactive tab, scrolled off-screen). Defaults to `true` so
+    /// existing host integrations behave identically to before.
+    @objc public var active: Bool = true {
+        didSet {
+            guard active != oldValue else { return }
+            widgetVC?.active = active
+        }
+    }
+
+    /// JSON-serialized `FeedInput[]` used to seed the expanded feed when
+    /// a card is tapped and `clickAction == .feed`. See
+    /// `ShortKitWidgetProps.feedItems` in the JS layer for full
+    /// semantics. The parsed list is forwarded to the SDK via
+    /// `ShortKitWidgetViewController.setFeedItems(_:)`.
+    @objc public var feedItems: String? {
+        didSet {
+            guard feedItems != oldValue else { return }
+            applyFeedItems()
+        }
+    }
+
     // MARK: - Child VC
 
     private var widgetVC: ShortKitWidgetViewController?
     private var parsedConfig: WidgetConfig?
     private var parsedItems: [WidgetInput] = []
+    private var parsedFeedItems: [FeedInput] = []
+    /// Parsed feedMask mode pulled out of the serialized config JSON in
+    /// `applyConfig()`. Stored separately because the SDK's
+    /// `ShortKitWidgetViewController.feedMask` is a top-level property,
+    /// not part of `WidgetConfig`.
+    private var parsedFeedMask: FeedMaskMode = .none
 
     // MARK: - Lifecycle
 
@@ -49,7 +78,17 @@ import ShortKitSDK
     public override func willMove(toWindow newWindow: UIWindow?) {
         super.willMove(toWindow: newWindow)
         if newWindow == nil {
-            removeWidgetVC()
+            // The host UIView is leaving the window — typically a
+            // transient detach driven by `react-native-screens` when
+            // a tab blurs or a screen is pushed on top. We must NOT
+            // destroy the widget VC here; doing so causes the user
+            // to see the host's background through the widget on
+            // return, plus a fresh full reload of cards / players /
+            // HLS streams. Suspend instead: detach from the parent
+            // VC hierarchy + pause playback, but keep the VC and
+            // all its loaded state alive so we can re-attach in
+            // `didMoveToWindow` instantly.
+            suspendWidgetVC()
         }
     }
 
@@ -58,18 +97,62 @@ import ShortKitSDK
         widgetVC?.view.frame = bounds
     }
 
+    deinit {
+        // Final teardown when React truly unmounts the bridge UIView.
+        // The instance is going away, so it's safe to release the
+        // child VC's parent-chain references here. Without this, a
+        // suspended widget VC would leak (its parent VC still holds
+        // it as a child until the parent itself is deallocated).
+        destroyWidgetVC()
+    }
+
     // MARK: - VC Containment
 
     private func embedWidgetVCIfNeeded() {
-        guard widgetVC == nil else { return }
-        guard let sdk = ShortKitBridge.shared?.sdk else { return }
         guard let parentVC = findParentViewController() else { return }
 
+        // Re-attach a suspended VC. All loaded state — items, player
+        // pool checkouts, collection-view layout, scroll position —
+        // is preserved across a suspend/resume cycle, so the user
+        // sees the same widget reappear in place rather than a fresh
+        // load. Mirrors `ShortKitPlayerNativeView`.
+        if let vc = widgetVC {
+            parentVC.addChild(vc)
+            vc.view.frame = bounds
+            addSubview(vc.view)
+            vc.didMove(toParent: parentVC)
+            // Re-sync the active prop. While suspended we forced the
+            // VC inactive; restore whatever the JS prop currently says.
+            vc.active = active
+            return
+        }
+
+        // First mount — create a fresh VC.
+        guard let sdk = ShortKitBridge.shared?.sdk else { return }
+
         let widgetConfig = parsedConfig ?? WidgetConfig()
 
         // Pass items at construction so the VC never races the server fetch —
         // analogous to the feed's `feedItems` prop wiring.
         let vc = ShortKitWidgetViewController(shortKit: sdk, config: widgetConfig, items: parsedItems)
+        // Sync the active prop to the freshly-created VC. Without this, a
+        // widget that mounts already with active=false (e.g. on an
+        // unfocused tab) would still go through its initial-load path and
+        // start rotating before the prop change reaches it.
+        vc.active = active
+        // Forward the optional expanded-feed seed list. Set before view
+        // load so it's available the first time `openFeed()` runs —
+        // same ordering rationale as the player's bridge.
+        if !parsedFeedItems.isEmpty {
+            vc.setFeedItems(parsedFeedItems)
+        }
+        // Forward the optional host-supplied feed mask. The SDK's
+        // `feedMask` lives as a top-level VC property (not in
+        // WidgetConfig), so it has to be set after construction. The
+        // factory closure inside the mode is invoked by the SDK each
+        // time `openFeed()` fires — so each expansion gets its own
+        // FeedMaskHostView instance.
+        vc.feedMask = parsedFeedMask
         self.widgetVC = vc
 
         // Wire host-handleable card-tap callback. When the JS wrapper has
@@ -96,7 +179,25 @@ import ShortKitSDK
         vc.didMove(toParent: parentVC)
     }
 
-    private func removeWidgetVC() {
+    /// Detach the widget VC from the parent VC + view hierarchy
+    /// without destroying it. Called when the bridge UIView leaves
+    /// the window (typically a `react-native-screens` tab blur).
+    /// All of the widget's loaded state is preserved so the
+    /// re-attach in `embedWidgetVCIfNeeded` can be instant. Pause
+    /// playback so the SDK pool tiles aren't held while suspended.
+    private func suspendWidgetVC() {
+        guard let vc = widgetVC else { return }
+        vc.active = false
+        vc.willMove(toParent: nil)
+        vc.view.removeFromSuperview()
+        vc.removeFromParent()
+        // Keep widgetVC reference — re-attached in embedWidgetVCIfNeeded.
+    }
+
+    /// Full teardown — called from `deinit` when React unmounts the
+    /// native view, and from `applyConfig` when the config string
+    /// changes and we need to rebuild the VC from scratch.
+    private func destroyWidgetVC() {
         guard let vc = widgetVC else { return }
         vc.willMove(toParent: nil)
         vc.view.removeFromSuperview()
@@ -109,12 +210,37 @@ import ShortKitSDK
     private func applyConfig() {
         guard let json = config else { return }
         parsedConfig = Self.parseWidgetConfig(json)
+        // FeedMask is stored as a sibling field in the serialized
+        // config JSON; extract it here so it's available when the VC
+        // gets (re)constructed in embedWidgetVCIfNeeded.
+        parsedFeedMask = Self.extractFeedMask(json)
         if widgetVC != nil {
-            removeWidgetVC()
+            destroyWidgetVC()
             embedWidgetVCIfNeeded()
         }
     }
 
+    /// Pulls the `feedMask` field out of the raw config JSON without
+    /// re-parsing the rest of `WidgetConfig`. Returns `.none` if the
+    /// JSON is malformed or omits `feedMask`. Mirrors how the
+    /// equivalent value is read on `ShortKitPlayerNativeView`.
+    private static func extractFeedMask(_ json: String) -> FeedMaskMode {
+        guard let data = json.data(using: .utf8),
+              let obj = try? JSONSerialization.jsonObject(with: data) as? [String: Any] else {
+            return .none
+        }
+        // The serializer emits feedMask either as the string "none" or
+        // as a {type, name} object — both arrive nested as a sub-JSON
+        // value (not stringified again, unlike feedConfig).
+        if let mask = obj["feedMask"] {
+            if let data = try? JSONSerialization.data(withJSONObject: mask),
+               let json = String(data: data, encoding: .utf8) {
+                return ShortKitBridge.parseFeedMask(json)
+            }
+        }
+        return .none
+    }
+
     private func applyItems() {
         parsedItems = items.flatMap { Self.parseWidgetInputs($0) } ?? []
         // Post-mount updates: push items through the public API.
@@ -123,6 +249,18 @@ import ShortKitSDK
         }
     }
 
+    private func applyFeedItems() {
+        // Empty / nil JSON ⇒ clear the host seed.
+        guard let json = feedItems,
+              let items = ShortKitBridge.parseFeedInputs(json) else {
+            parsedFeedItems = []
+            widgetVC?.setFeedItems([])
+            return
+        }
+        parsedFeedItems = items
+        widgetVC?.setFeedItems(items)
+    }
+
     // MARK: - Parsing
 
     private static func parseWidgetConfig(_ json: String) -> WidgetConfig {
@@ -138,6 +276,13 @@ import ShortKitSDK
         let muteOnStart = obj["muteOnStart"] as? Bool ?? true
         let loop = obj["loop"] as? Bool ?? true
         let rotationInterval = obj["rotationInterval"] as? TimeInterval ?? 10000
+        let previewDuration = obj["previewDuration"] as? TimeInterval ?? 5
+        let playbackMode: WidgetPlaybackMode
+        switch obj["playbackMode"] as? String {
+        case "allVisibleSimultaneous": playbackMode = .allVisibleSimultaneous
+        case "singleVisibleRotating": playbackMode = .singleVisibleRotating
+        default: playbackMode = .singleVisibleRotating
+        }
 
         let clickAction: PlayerClickAction
         switch obj["clickAction"] as? String {
@@ -180,7 +325,9 @@ import ShortKitSDK
             clickAction: clickAction,
             cardOverlay: overlayMode,
             feedConfig: feedConfig,
-            filter: filter
+            filter: filter,
+            playbackMode: playbackMode,
+            previewDuration: previewDuration
         )
     }
 

package/ios/ShortKitWidgetNativeViewManager.mm

@@ -24,5 +24,7 @@ RCT_EXPORT_MODULE(ShortKitWidgetView)
 RCT_EXPORT_VIEW_PROPERTY(config, NSString)
 RCT_EXPORT_VIEW_PROPERTY(items, NSString)
 RCT_EXPORT_VIEW_PROPERTY(widgetId, NSString)
+RCT_EXPORT_VIEW_PROPERTY(active, BOOL)
+RCT_EXPORT_VIEW_PROPERTY(feedItems, NSString)
 
 @end