@shortkitsdk/react-native 0.2.45 → 0.2.47

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

@@ -252,7 +252,8 @@ 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, 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 var shouldExpandLiveRoom: ((ShortKitSDK.ContentItem) -> Swift.Bool)?
+  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, shouldExpandLiveRoom: ((ShortKitSDK.ContentItem) -> Swift.Bool)? = nil)
   public init(from decoder: any Swift.Decoder) throws
   public func encode(to encoder: any Swift.Encoder) throws
 }
@@ -532,7 +533,7 @@ public enum ShortKitDownloadError : Swift.Error, Foundation.LocalizedError {
   }
 }
 @_hasMissingDesignatedInitializers final public class FeedPreload : @unchecked Swift.Sendable {
-  public init(immediateItems items: [ShortKitSDK.FeedInput])
+  public init(immediateItems items: [ShortKitSDK.FeedInput], isSeed: Swift.Bool = false)
   @objc deinit
 }
 @_Concurrency.MainActor @preconcurrency public struct ShortKitFeedView : SwiftUI.UIViewControllerRepresentable {
@@ -757,7 +758,7 @@ public enum ContentOrigin : Swift.String, Swift.Codable, Swift.Sendable {
   }
 }
 public enum FeedInput : Swift.Sendable {
-  case video(playbackId: Swift.String, origin: ShortKitSDK.ContentOrigin = .other, fallbackUrl: Swift.String? = nil)
+  case video(playbackId: Swift.String, origin: ShortKitSDK.ContentOrigin = .other, fallbackUrl: Swift.String? = nil, contentId: Swift.String? = nil)
   case liveStream(playbackId: Swift.String)
   case imageCarousel(ShortKitSDK.ImageCarouselItem)
   case videoCarousel(ShortKitSDK.VideoCarouselInput)
@@ -1236,6 +1237,7 @@ final public class ShortKit {
   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 preloadFeed(seedItems: [ShortKitSDK.FeedInput]) -> ShortKitSDK.FeedPreload
   final public func fetchContent(limit: Swift.Int = 10, filter: ShortKitSDK.FeedFilter? = nil) async throws -> [ShortKitSDK.ContentItem]
   final public func setUserId(_ id: Swift.String)
   final public func clearUserId()
@@ -1309,8 +1311,12 @@ extension ShortKitSDK.ShortKitPlayerViewController : UIKit.UIViewControllerTrans
   @_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 final public var onContentHeightChange: ((CoreFoundation.CGFloat) -> Swift.Void)?
+  @_Concurrency.MainActor @preconcurrency final public func appendItems(_ inputs: [ShortKitSDK.WidgetInput])
+  @_Concurrency.MainActor @preconcurrency final public func parentScrollViewDidScroll(_ scrollView: UIKit.UIScrollView)
   @_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 viewDidLayoutSubviews()
   @_Concurrency.MainActor @preconcurrency @objc override final public func viewWillDisappear(_ animated: Swift.Bool)
   @objc deinit
 }
@@ -1319,6 +1325,7 @@ extension ShortKitSDK.ShortKitWidgetViewController : UIKit.UICollectionViewDataS
   @_Concurrency.MainActor @preconcurrency @objc final public func collectionView(_ collectionView: UIKit.UICollectionView, cellForItemAt indexPath: Foundation.IndexPath) -> UIKit.UICollectionViewCell
 }
 extension ShortKitSDK.ShortKitWidgetViewController : UIKit.UICollectionViewDelegate {
+  @_Concurrency.MainActor @preconcurrency @objc final public func collectionView(_ collectionView: UIKit.UICollectionView, willDisplay cell: UIKit.UICollectionViewCell, forItemAt indexPath: Foundation.IndexPath)
   @_Concurrency.MainActor @preconcurrency @objc final public func collectionView(_ collectionView: UIKit.UICollectionView, didSelectItemAt indexPath: Foundation.IndexPath)
 }
 extension ShortKitSDK.ShortKitWidgetViewController : UIKit.UIViewControllerTransitioningDelegate {
@@ -1326,15 +1333,26 @@ 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 enum GridSide : Swift.Equatable, Swift.Sendable {
+  case left
+  case right
+  public static func == (a: ShortKitSDK.GridSide, b: ShortKitSDK.GridSide) -> Swift.Bool
   public func hash(into hasher: inout Swift.Hasher)
   public var hashValue: Swift.Int {
     get
   }
 }
+public enum WidgetPlaybackMode : Swift.Equatable, Swift.Sendable {
+  case singleVisibleRotating
+  case allVisibleSimultaneous
+  case gridAlternating(startSide: ShortKitSDK.GridSide = .left)
+  public static func == (a: ShortKitSDK.WidgetPlaybackMode, b: ShortKitSDK.WidgetPlaybackMode) -> Swift.Bool
+}
+public enum WidgetLayout : Swift.Equatable, Swift.Sendable {
+  case carousel
+  case grid(columns: Swift.Int, cellAspectRatio: CoreFoundation.CGFloat, scrollable: Swift.Bool = true)
+  public static func == (a: ShortKitSDK.WidgetLayout, b: ShortKitSDK.WidgetLayout) -> Swift.Bool
+}
 public struct WidgetConfig {
   public var cardCount: Swift.Int
   public var cardSpacing: CoreFoundation.CGFloat
@@ -1349,7 +1367,10 @@ public struct WidgetConfig {
   public var filter: ShortKitSDK.FeedFilter?
   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 var layout: ShortKitSDK.WidgetLayout
+  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, layout: ShortKitSDK.WidgetLayout = .carousel)
+  public func gridCellHeight(forContainerWidth width: CoreFoundation.CGFloat) -> CoreFoundation.CGFloat?
+  public func preferredGridHeight(forContainerWidth width: CoreFoundation.CGFloat, itemCount: Swift.Int) -> CoreFoundation.CGFloat?
   public func resolvedFeedConfig() -> ShortKitSDK.FeedConfig
 }
 public enum WidgetInput : Swift.Sendable {
@@ -1397,4 +1418,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 {}
+extension ShortKitSDK.GridSide : Swift.Hashable {}

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

@@ -252,7 +252,8 @@ 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, 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 var shouldExpandLiveRoom: ((ShortKitSDK.ContentItem) -> Swift.Bool)?
+  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, shouldExpandLiveRoom: ((ShortKitSDK.ContentItem) -> Swift.Bool)? = nil)
   public init(from decoder: any Swift.Decoder) throws
   public func encode(to encoder: any Swift.Encoder) throws
 }
@@ -532,7 +533,7 @@ public enum ShortKitDownloadError : Swift.Error, Foundation.LocalizedError {
   }
 }
 @_hasMissingDesignatedInitializers final public class FeedPreload : @unchecked Swift.Sendable {
-  public init(immediateItems items: [ShortKitSDK.FeedInput])
+  public init(immediateItems items: [ShortKitSDK.FeedInput], isSeed: Swift.Bool = false)
   @objc deinit
 }
 @_Concurrency.MainActor @preconcurrency public struct ShortKitFeedView : SwiftUI.UIViewControllerRepresentable {
@@ -757,7 +758,7 @@ public enum ContentOrigin : Swift.String, Swift.Codable, Swift.Sendable {
   }
 }
 public enum FeedInput : Swift.Sendable {
-  case video(playbackId: Swift.String, origin: ShortKitSDK.ContentOrigin = .other, fallbackUrl: Swift.String? = nil)
+  case video(playbackId: Swift.String, origin: ShortKitSDK.ContentOrigin = .other, fallbackUrl: Swift.String? = nil, contentId: Swift.String? = nil)
   case liveStream(playbackId: Swift.String)
   case imageCarousel(ShortKitSDK.ImageCarouselItem)
   case videoCarousel(ShortKitSDK.VideoCarouselInput)
@@ -1236,6 +1237,7 @@ final public class ShortKit {
   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 preloadFeed(seedItems: [ShortKitSDK.FeedInput]) -> ShortKitSDK.FeedPreload
   final public func fetchContent(limit: Swift.Int = 10, filter: ShortKitSDK.FeedFilter? = nil) async throws -> [ShortKitSDK.ContentItem]
   final public func setUserId(_ id: Swift.String)
   final public func clearUserId()
@@ -1309,8 +1311,12 @@ extension ShortKitSDK.ShortKitPlayerViewController : UIKit.UIViewControllerTrans
   @_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 final public var onContentHeightChange: ((CoreFoundation.CGFloat) -> Swift.Void)?
+  @_Concurrency.MainActor @preconcurrency final public func appendItems(_ inputs: [ShortKitSDK.WidgetInput])
+  @_Concurrency.MainActor @preconcurrency final public func parentScrollViewDidScroll(_ scrollView: UIKit.UIScrollView)
   @_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 viewDidLayoutSubviews()
   @_Concurrency.MainActor @preconcurrency @objc override final public func viewWillDisappear(_ animated: Swift.Bool)
   @objc deinit
 }
@@ -1319,6 +1325,7 @@ extension ShortKitSDK.ShortKitWidgetViewController : UIKit.UICollectionViewDataS
   @_Concurrency.MainActor @preconcurrency @objc final public func collectionView(_ collectionView: UIKit.UICollectionView, cellForItemAt indexPath: Foundation.IndexPath) -> UIKit.UICollectionViewCell
 }
 extension ShortKitSDK.ShortKitWidgetViewController : UIKit.UICollectionViewDelegate {
+  @_Concurrency.MainActor @preconcurrency @objc final public func collectionView(_ collectionView: UIKit.UICollectionView, willDisplay cell: UIKit.UICollectionViewCell, forItemAt indexPath: Foundation.IndexPath)
   @_Concurrency.MainActor @preconcurrency @objc final public func collectionView(_ collectionView: UIKit.UICollectionView, didSelectItemAt indexPath: Foundation.IndexPath)
 }
 extension ShortKitSDK.ShortKitWidgetViewController : UIKit.UIViewControllerTransitioningDelegate {
@@ -1326,15 +1333,26 @@ 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 enum GridSide : Swift.Equatable, Swift.Sendable {
+  case left
+  case right
+  public static func == (a: ShortKitSDK.GridSide, b: ShortKitSDK.GridSide) -> Swift.Bool
   public func hash(into hasher: inout Swift.Hasher)
   public var hashValue: Swift.Int {
     get
   }
 }
+public enum WidgetPlaybackMode : Swift.Equatable, Swift.Sendable {
+  case singleVisibleRotating
+  case allVisibleSimultaneous
+  case gridAlternating(startSide: ShortKitSDK.GridSide = .left)
+  public static func == (a: ShortKitSDK.WidgetPlaybackMode, b: ShortKitSDK.WidgetPlaybackMode) -> Swift.Bool
+}
+public enum WidgetLayout : Swift.Equatable, Swift.Sendable {
+  case carousel
+  case grid(columns: Swift.Int, cellAspectRatio: CoreFoundation.CGFloat, scrollable: Swift.Bool = true)
+  public static func == (a: ShortKitSDK.WidgetLayout, b: ShortKitSDK.WidgetLayout) -> Swift.Bool
+}
 public struct WidgetConfig {
   public var cardCount: Swift.Int
   public var cardSpacing: CoreFoundation.CGFloat
@@ -1349,7 +1367,10 @@ public struct WidgetConfig {
   public var filter: ShortKitSDK.FeedFilter?
   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 var layout: ShortKitSDK.WidgetLayout
+  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, layout: ShortKitSDK.WidgetLayout = .carousel)
+  public func gridCellHeight(forContainerWidth width: CoreFoundation.CGFloat) -> CoreFoundation.CGFloat?
+  public func preferredGridHeight(forContainerWidth width: CoreFoundation.CGFloat, itemCount: Swift.Int) -> CoreFoundation.CGFloat?
   public func resolvedFeedConfig() -> ShortKitSDK.FeedConfig
 }
 public enum WidgetInput : Swift.Sendable {
@@ -1397,4 +1418,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 {}
+extension ShortKitSDK.GridSide : 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>
-		u7j7pZRjQJaDhHv1/MOjq74VqQQ=
+		4WaRBBGBBRc4XhrxQBu2SFhI+xc=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.abi.json</key>
 		<data>
-		9BdFRkFoR7lgfXnYhDL389eJmwo=
+		an3rvkqTPZeLciqR2pkZcZPWM+w=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface</key>
 		<data>
-		kMD88dAC4/UAXQveBEVyu416rZk=
+		+0RV20C+rRANsdpP+V1mZLsFuvw=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftdoc</key>
 		<data>
-		VOTbFDsFlUk+zeSbdHV3CUJ4sbs=
+		5SAMVRYrOK+IFYs6Hu843Xb3VXw=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftinterface</key>
 		<data>
-		kMD88dAC4/UAXQveBEVyu416rZk=
+		+0RV20C+rRANsdpP+V1mZLsFuvw=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.abi.json</key>
 		<data>
-		9BdFRkFoR7lgfXnYhDL389eJmwo=
+		an3rvkqTPZeLciqR2pkZcZPWM+w=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface</key>
 		<data>
-		S7MSFMJ213kJdVpeQfSzi4JI0aY=
+		K8WfRtIQSTA31RrU1KFJ6qwHA68=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftdoc</key>
 		<data>
-		fULOA1HVzJwVPDNXTIp5uNMx9R8=
+		qhnBc0QnFnAXP5FEFWjxlJHTJUM=
 		</data>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftinterface</key>
 		<data>
-		S7MSFMJ213kJdVpeQfSzi4JI0aY=
+		K8WfRtIQSTA31RrU1KFJ6qwHA68=
 		</data>
 		<key>Modules/module.modulemap</key>
 		<data>
@@ -66,56 +66,56 @@
 		<dict>
 			<key>hash2</key>
 			<data>
-			WALbUO/EvUJCytrq1Pf9m/N5otOWV4QoP+MHYYeW/sM=
+			oiGKF61MCOLqiH9prPxCIJwY6kGrQF5SFZQnUdNMlfk=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			4q40ucTr1qUkFbVYoihDDoBnnICmQ/lO/7JH1WKQzcw=
+			dmx4DKe1c9UbFg/w7YSXGDu0Qumdpo4P9UVipvfv3Aw=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftdoc</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			dKQ8XFw0Is3GUAQat76xrMwYPR/5ZRiZoANThtyA56Q=
+			QYDPA36PcdAR3SoZ6cVPFinYcEaAkYIfkJj+894JN2U=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/arm64-apple-ios-simulator.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			4q40ucTr1qUkFbVYoihDDoBnnICmQ/lO/7JH1WKQzcw=
+			dmx4DKe1c9UbFg/w7YSXGDu0Qumdpo4P9UVipvfv3Aw=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.abi.json</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			WALbUO/EvUJCytrq1Pf9m/N5otOWV4QoP+MHYYeW/sM=
+			oiGKF61MCOLqiH9prPxCIJwY6kGrQF5SFZQnUdNMlfk=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			E1GiseiMFLYmROiZwBW1bJ9EOsVO+0XjhLoQF9rW+Gk=
+			8YYsx8F5tk2WnvKQw4lBYCQZIKgw7ANeRK30vGPcMzU=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftdoc</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			T8grir+EcdMC7s5ILrY4dZfCi++IEzyJW4sMxHJ6QYc=
+			8yHerNJHawK5mdiDO7DW8yoKvg80D6EGYDr+CG4uV2g=
 			</data>
 		</dict>
 		<key>Modules/ShortKitSDK.swiftmodule/x86_64-apple-ios-simulator.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			E1GiseiMFLYmROiZwBW1bJ9EOsVO+0XjhLoQF9rW+Gk=
+			8YYsx8F5tk2WnvKQw4lBYCQZIKgw7ANeRK30vGPcMzU=
 			</data>
 		</dict>
 		<key>Modules/module.modulemap</key>

package/package.json

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

package/src/ShortKitCommands.ts

@@ -66,3 +66,42 @@ export const ShortKitCommands = {
   },
   cancelDownload: () => NativeShortKitModule?.cancelDownload(),
 } as const;
+
+/**
+ * Push a host-registered RN component onto the active feed's navigation
+ * controller with a native parallax-push animation.
+ *
+ * Only works when the feed was presented with a `feedMask` (the mask wraps
+ * the feed in a UINavigationController on iOS). Silently no-ops otherwise.
+ *
+ * Call this from an overlay component's author-tap or similar handler:
+ *
+ * ```tsx
+ * import { pushFeedScreen } from '@shortkitsdk/react-native';
+ *
+ * // In your overlay:
+ * pushFeedScreen('ProfileScreen', { author: item.author });
+ * ```
+ *
+ * The target component must be registered with AppRegistry:
+ * ```ts
+ * AppRegistry.registerComponent('ProfileScreen', () => ProfileScreen);
+ * ```
+ */
+export function pushFeedScreen(
+  componentName: string,
+  props?: Record<string, unknown>
+): void {
+  NativeShortKitModule?.pushFeedScreen(componentName, JSON.stringify(props ?? {}));
+}
+
+/**
+ * Pop the screen most recently pushed via `pushFeedScreen` from the feed
+ * modal's navigation stack with a native slide-back animation.
+ *
+ * Call this from within a component registered with AppRegistry and rendered
+ * via `pushFeedScreen` — typically wired to a back button or `navigation.goBack()`.
+ */
+export function popFeedScreen(): void {
+  NativeShortKitModule?.popFeedScreen();
+}

package/src/index.ts

@@ -53,6 +53,11 @@ export { registerOverlayComponent } from './ShortKitOverlaySurface';
 export { registerCarouselOverlayComponent } from './ShortKitCarouselOverlaySurface';
 export { registerVideoCarouselOverlayComponent } from './ShortKitVideoCarouselOverlaySurface';
 export { registerFeedMaskComponent } from './ShortKitFeedMaskSurface';
+export { pushFeedScreen, popFeedScreen } from './ShortKitCommands';
+/** @internal Escape hatch — only use when ShortKitProvider is already initialized by the host app. */
+export { ShortKitInitContext } from './ShortKitContext';
+/** @internal Serialization helpers for use with NativeShortKitModule.preloadFeed in custom surface roots. */
+export { serializeFeedConfig, serializeFeedInputs } from './serialization';
 export type {
   OverlayProps,
   CarouselOverlayProps,

package/src/specs/NativeShortKitModule.ts

@@ -319,6 +319,10 @@ export interface Spec extends TurboModule {
   downloadVideo(itemId: string, mode: string, overlayMode: string): Promise<string>;
   cancelDownload(): void;
 
+  // --- Push navigation ---
+  pushFeedScreen(componentName: string, propsJSON: string): void;
+  popFeedScreen(): void;
+
   // --- Carousel accessors ---
   getCarouselActiveIndex(): Int32;
   getCarouselVideoCount(): Int32;